易仓和金蝶云星空接口打通对接实战
接入系统:易仓
易仓作为一家专门服务于跨境电商行业的纯软件服务商,为了更好的服务跨境电商,易仓旗下服务平台“跨境眼”可以帮助卖家轻松对接到各个仓储物流服务商、同时支持财税业务的对接。
对接目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
系统对接接口配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:易仓,并且选择对应的连接器(关于易仓的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的WMS-查询入库单信息接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器。选择对应的其他入库新增接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。
易仓接口明细
- 接口: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 | QTRKD03_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 | BM000005 |
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 |
数据对接价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通易仓到金蝶云星空之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。