易仓和金蝶云星空接口打通对接实战|轻易云数据集成平台

易仓和金蝶云星空接口打通对接实战

对接系统易仓

易仓科技是一家专门做跨境电商软件服务提供商，目前他们有跨境电商ERP、国际物流TMS、海外仓WMS、跨境分销M2C，保税仓BBC等管理系统。

对接目标系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

接口方案配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

易仓接口明细

接口：getReceiving
接口名称：WMS-查询入库单信息
接口方法：POST

请求参数

字段	名称	类型	描述
receiving_code	入库单号	string	入库单号,支持多个示例：["R11111111111","R222222222"]
reference_no	客户参考号	string	客户参考号
tracking_number	跟踪号	string	跟踪号
po_code	采购单号	string	采购单号
warehouse_id	仓库Id	string	仓库Id
receiving_type	类型	string	类型： 0标准， 1订单退货， 2指定产品退件， 3中转， 4采购， 5其它， 6借用归还入库， 7初始化库存， 8不良品入库， 9盘盈， 10调拨 11换货， 12同步服务商库存， 13出库单入库， 14同步添加库存， 15赠品入库
receiving_status	入库单状态	string	入库单状态： 0删除， 1草稿， 2确认， 3待审核， 4审核， 5在途， 6收货中， 7收货完成
productBarcode	产品代码	string	产品代码
productBarcode_like	产品代码	string	产品代码（模糊）
receiving_add_user	采购员	string	采购员（用户Id）
code_like	单号	string	单号（入库单、参考号、采购单）
supplier	供应商ID	array	供应商ID（多个），格式：[1,2,3,4,5]
order_by	排序方式（多个）格式	array	排序方式（多个）格式：["receiving_add_time desc","receiving_id desc"]
searchDateType	查询时间类型	string	查询时间类型: receiving_add_time 创建时间， receiving_update_time 更新时间， expected_date 预期时间 ec_create_time 统计数据报表(创建时间) ec_update_time 统计数据报表(更新时间)
dateFor	大于等于某个时间类型	string	大于等于某个时间类型（必须配合 searchDateType 参数使用）
dateTo	小于等于某个时间类型	string	小于等于某个时间类型（必须配合 searchDateType 参数使用）
pagination	分页	object	分页： "pagination":{"page":3,"pageSize":60},
pagination.page	当前页	string	当前页（格式参考pagination）
pagination.pageSize	每页显示条数	string	每页显示条数（默认为：50）（格式参考pagination）

响应参数

字段	名称	类型	描述
receiving_code	入库单号	string	入库单号
reference_no	客户参考号	string	客户参考号
po_code	采购单号	string	采购单号
warehouse_id	仓库Id	string	仓库Id
tracking_number	跟踪号	string	跟踪号
to_warehouse_id	目的仓库Id	string	目的仓库Id
customer_code	客户代码	string	客户代码
receiving_type	类型	string	类型： 0标准， 1订单退货， 2指定产品退件， 3中转， 4采购， 5其它， 6借用归还入库， 7初始化库存， 8不良品入库， 9盘盈， 10调拨， 11换货， 12同步服务商库存， 13出库单入库， 14同步添加库存， 15赠品入库
receiving_transfer_status	中转状态	string	中转状态： 0草稿， 1待处理， 2处理中， 3处理完成
receiving_status	入库单状态	string	入库单状态： 0删除， 1草稿， 2确认， 3待审核， 4审核， 5在途， 6收货中， 7收货完成
receiving_description	备注	string	备注
receiving_add_time	创建时间	string	创建时间
receiving_update_time	更新时间（操作收货/质检/上架时，将更新此时间）	string	更新时间（操作收货/质检/上架时，将更新此时间）
receiving_id	入库单Id	string	入库单Id
expected_date	预计到达时间	string	预计到达时间
warehouse	仓库	string	仓库
receivingExStatus	处理收货异常	string	处理收货异常
purchase_cost	采购成本	string	采购成本
transfer_shipping_fee	程成本	string	程成本
currency_code	币种	string	币种
product_info	产品信息	array	产品信息
product_info.product_barcode	产品代码	string	产品代码
product_info.product_title	产品名称	string	产品名称
product_info.rd_status	状态码	string	状态码
product_info.rd_status_string	状态名称	string	状态名称
product_info.rd_receiving_qty	送货数量	string	送货数量
product_info.rd_received_qty	收货数量	string	收货数量
product_info.dif_receive_num	收货数量差异	string	收货数量差异
product_info.rd_putaway_qty	上架数量	string	上架数量
product_info.is_qc	是否质检	string	是否质检
product_info.is_priority	优先处理	string	优先处理
product_info.rd_update_time	更新时间	string	更新时间
product_info.rd_note	备注	string	备注
product_info.complete_time	收货完成时间	string	收货完成时间
product_info.putaway_time	上架完成时间取值	string	上架完成时间取值
product_info.ec_update_time	更新时间	string	更新时间

金蝶云星空接口明细

接口：batchSave
接口名称：其他入库新增
接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string	单据编号
FBillTypeID	单据类型	string	单据类型
FStockOrgId	库存组织	string	组织
FStockDirect	库存方向	string	下拉列表
FDate	日期	string	日期
FSUPPLIERID	供应商	string	基础资料
FDEPTID	部门	string	基础资料
FOwnerTypeIdHead	货主类型	string	多类别基础资料列表
FOwnerIdHead	货主	string	多类别基础资料
FNOTE	备注	string	多行文本
FEntity	明细信息	array
FEntity.FInStockType	入库类型	string	下拉列表
FEntity.FMATERIALID	物料编码	string	基础资料
FEntity.FCMKBarCode	零售条形码	string	文本
FEntity.FSTOCKID	收货仓库	string	基础资料
FEntity.FStockLocId	仓位	string	维度关联字段
FEntity.FLOT	批号	string	批次
FEntity.FQty	实收数量	string	数量
FEntity.FPrice	成本价	string	单价
FEntity.FEntryNote	备注	string	多行文本
FEntity.FSRCBILLNO	源单编号	string	源单编号
FEntity.FSRCBILLTYPEID	源单类型	string	源单类型
FEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.Operation	执行的操作	string
FEntity.IsAutoSubmitAndAudit	提交并审核	bool

系统对接概况

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