从管易云到金蝶K3-WISE通过接口配置打通数据

接入系统：管易云

管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。

写入目标:金蝶K3-WISE

金蝶K/3WISE是一款面向成长型企业，适应企业在快速成长过程中业务与管理的不断变化的信息化平台，实现云服务、ERP、物联网的融合，帮助企业从信息化建设到构建企业工业互联网与数字化管理平台。

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：管易云，并且选择对应的连接器（关于管易云的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的发货单查询2.0接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶K3-WISE，并且选择对应连接器。选择对应的新增销售出库（红蓝字）接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

管易云接口明细

• API：gy.erp.kingdeecloud.delivery.orders.querybydate
• NAME：发货单查询2.0
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_date	创建时间开始段	{{LAST_SYNC_TIME datetime}}
end_date	创建时间结束段	{{CURRENT_TIME datetime}}
del	返回是否作废的单据
delivery	发货状态	1
shop_code	店铺代码
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	默认为10
page_no	页号	{{PAGINATION_START_PAGE}}	默认1
detailApi	详情查询api
detailApi.api	api	gy.erp.kingdeecloud.delivery.details.querybycode

响应参数

接口字段	字段名称	预设值	描述
code	单据编号
tagName	标记名
tagCode	标记码
shop_code	店铺代码
warehouse_code	仓库代码
delivery_time	交货时间
vip_code	会员代码
vip_name	会员名称
receiver_name	收货人姓名
receiver_phone	收货人电话
receiver_mobile	审核人
area_name	收货地区
receiver_address	收货地址
express_code	快递公司代码
express_name	快递公司名称
express_no	快递单号
listId	列表Id
detailApi	详细Api
details	商品列表
details.platform_code	平台单号
details.qty	商品数量
details.price	实际单价
details.amount	商品总价
details.memo	备注
details.batchs	批次
details.sns	社交网络
details.goods_id	商品标识
details.is_gift	是否赠品
details.discount_fee	让利金额
details.amount_after	让利后金额
details.post_fee	物流费用
details.post_cost	物流成本
details.tax_rate	税率
details.cost_price	成本价
details.trade_code	销售订单号
details.other_service_fee	其他服务费
details.tax_amount	税额

金蝶K3-WISE接口明细

• API：Sales_Delivery/Save
• NAME：新增销售出库（红蓝字）
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
Page1	表头
Page1.Fdate	日期	{{delivery_time date}}
Page1.FMarketingStyle	销售业务类型	XSLX01
Page1.FSupplyID	购货单位	{{shop_code}}
Page1.FSaleStyle	销售方式	FXF03
Page1.FExplanation	摘要	{{details.memo}}
Page1.FBillNo	编 号	{{code}}价格
Page1.FFManagerID	发货	findCollection find Femployee_FNumber from 0e70a6e2-190d-379a-8d3e-2bbb6ecc580f where FNumber={{shop_code}}
Page1.FDeptID	部门	_findCollection find Fdepartment_FNumber from 0e70a6e2-190d-379a-8d3e-2bbb6ecc580f where FNumber={{shop_code}}
Page1.FEmpID	业务员	findCollection find Femployee_FNumber from 0e70a6e2-190d-379a-8d3e-2bbb6ecc580f where FNumber={{shop_code}}
Page1.FSManagerID	保管	_findCollection find Femployee_FNumber from 0e70a6e2-190d-379a-8d3e-2bbb6ecc580f where FNumber={{shop_code}}
Page1.FROB	红蓝单标志	1
Page1.FHeadSelfB0160	联系人：	{{receiver_name}}
Page1.FHeadSelfB0162	送货地址：	{{area_name}}-{{receiver_address}}
Page1.FHeadSelfB0164	联系人手机：	{{receiver_phone}}
Page1.Page2	表体	details
Page1.Page2.FConsignPrice	销售单价	{{details_price}}
Page1.Page2.FDCStockID1	发货仓库	{{warehouse_code}}
Page1.Page2.Fauxqty	实发数量	{{details_qty}}
Page1.Page2.FItemID	产品代码	{{details_goods_code}}
Page1.Page2.FConsignAmount	销售金额	{{details_amount}}
Page1.Page2.FUnitID	单位	_findCollection find FOrderUnitID_FNumber from 5d62b9e3-246b-337f-88a6-7b44782b84c4 where FNumber={{details_goods_code}}
Page1.Page2.FBatchNo	批号	{{details_batchs_batch}}
Page1.Page2.FChkPassItem	检验是否良品	Y
Page1.Page2.FEntrySelfB0174	政策	002
Page1.Page2.FEntrySelfB0176	赠品金额	{{details_amount_after}}
Page1.Page2.autoCheck	审核参数
Page1.Page2.autoCheck.api	api	Sales_Delivery/CheckBill
Page1.Page2.autoCheck.FBillNo	FBillNo	{{Data.BillNo}}
Page1.Page2.autoCheck.FChecker	FChecker	administrator
Page1.Page2.autoCheck.FCheckDirection	FCheckDirection	1,2
Page1.Page2.autoCheck.FDealComment	FDealComment	审核

数据对接价值

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。