从管易云到金蝶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资产的可插拔、可复用、可组成。
