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

数据源平台:易仓
易仓科技是一家专门做跨境电商软件服务提供商,目前他们有跨境电商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 | {{receiving_code}} |
FBillTypeID | 单据类型 | string | QTRKD04_SYS |
FStockOrgId | 库存组织 | string | findCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}} |
FStockDirect | 库存方向 | string | |
FDate | 日期 | string | {{complete_time}} |
FSUPPLIERID | 供应商 | string | |
FDEPTID | 部门 | string | BM000015 |
FOwnerTypeIdHead | 货主类型 | string | BD_OwnerOrg |
FOwnerIdHead | 货主 | string | _findCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}} |
FNOTE | 备注 | string | |
FEntity | 明细信息 | array | |
FEntity.FInStockType | 入库类型 | string | |
FEntity.FMATERIALID | 物料编码 | string | findCollection find FNumber from 32df639a-9c45-3823-8a92-1e2ceb30649e where FOldNumber={{product_info_product_barcode}} |
FEntity.FCMKBarCode | 零售条形码 | string | |
FEntity.FSTOCKID | 收货仓库 | string | _findCollection find warehouseCode from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseId={{warehouse_id}} |
FEntity.FStockLocId | 仓位 | string | |
FEntity.FLOT | 批号 | string | |
FEntity.FQty | 实收数量 | string | {{product_info_rd_receiving_qty}} |
FEntity.FPrice | 成本价 | string | |
FEntity.FEntryNote | 备注 | string | |
FEntity.FSRCBILLNO | 源单编号 | string | |
FEntity.FSRCBILLTYPEID | 源单类型 | string | |
FEntity.FormId | 业务对象表单Id | string | STK_MISCELLANEOUS |
FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
FEntity.Operation | 执行的操作 | string | Save |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
系统打通概况
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。

