金蝶云星空与易仓对接集成WMS-查询入库单信息连通分布式调入单新增(R(采购)入库单-分布式调入单)

来源系统:易仓
易仓科技是一家专门做跨境电商软件服务提供商,目前他们有跨境电商ERP、国际物流TMS、海外仓WMS、跨境分销M2C,保税仓BBC等管理系统。
对接目标平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置方案
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:易仓,源系统 API:WMS-查询入库单信息,目标系统:金蝶云星空,目标系统 API分布式调入单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

易仓接口明细
- API:getReceiving
- NAME:WMS-查询入库单信息
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
receiving_code | 入库单号 | | 入库单号,支持多个示例:["R11111111111","R222222222"] |
reference_no | 客户参考号 | | 客户参考号 |
tracking_number | 跟踪号 | | 跟踪号 |
po_code | 采购单号 | | 采购单号 |
warehouse_id | 仓库Id | | 仓库Id |
receiving_type | 类型 | 4 | 类型: 0标准, 1订单退货, 2指定产品退件, 3中转, 4采购, 5其它, 6借用归还入库, 7初始化库存, 8不良品入库, 9盘盈, 10调拨 11换货, 12同步服务商库存, 13出库单入库, 14同步添加库存, 15赠品入库 |
receiving_status | 入库单状态 | 7 | 入库单状态: 0删除, 1草稿, 2确认, 3待审核, 4审核, 5在途, 6收货中, 7收货完成 |
productBarcode | 产品代码 | | 产品代码 |
productBarcode_like | 产品代码 | | 产品代码(模糊) |
receiving_add_user | 采购员 | | 采购员(用户Id) |
code_like | 单号 | | 单号(入库单、参考号、采购单) |
supplier | 供应商ID | | 供应商ID(多个),格式:[1,2,3,4,5] |
order_by | 排序方式(多个)格式 | | 排序方式(多个)格式:["receiving_add_time desc","receiving_id desc"] |
searchDateType | 查询时间类型 | receiving_update_time | 查询时间类型: receiving_add_time 创建时间, receiving_update_time 更新时间, expected_date 预期时间 ec_create_time 统计数据报表(创建时间) ec_update_time 统计数据报表(更新时间) |
dateFor | 大于等于某个时间类型 | function DATE_SUB(now(),INTERVAL 5 DAY) | 大于等于某个时间类型(必须配合 searchDateType 参数使用) |
dateTo | 小于等于某个时间类型 | {{CURRENT_TIME datetime}} | 小于等于某个时间类型 (必须配合 searchDateType 参数使用) |
pagination | 分页 | pagination | 分页: "pagination":{"page":3,"pageSize":60}, |
pagination.page | 当前页 | _function 11 | |
pagination.pageSize | 每页显示条数 | _function 20*1 | |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
receiving_code | 入库单号 | | 入库单号 |
reference_no | 客户参考号 | | 客户参考号 |
po_code | 采购单号 | | 采购单号 |
warehouse_id | 仓库Id | | 仓库Id |
tracking_number | 跟踪号 | | 跟踪号 |
to_warehouse_id | 目的仓库Id | | 目的仓库Id |
customer_code | 客户代码 | | 客户代码 |
receiving_type | 类型 | | 类型: 0标准, 1订单退货, 2指定产品退件, 3中转, 4采购, 5其它, 6借用归还入库, 7初始化库存, 8不良品入库, 9盘盈, 10调拨, 11换货, 12同步服务商库存, 13出库单入库, 14同步添加库存, 15赠品入库 |
receiving_transfer_status | 中转状态 | | 中转状态: 0草稿, 1待处理, 2处理中, 3处理完成 |
receiving_status | 入库单状态 | | 入库单状态: 0删除, 1草稿, 2确认, 3待审核, 4审核, 5在途, 6收货中, 7收货完成 |
receiving_description | 备注 | | 备注 |
receiving_add_time | 创建时间 | | 创建时间 |
receiving_update_time | 更新时间(操作收货/质检/上架时,将更新此时间) | | 更新时间(操作收货/质检/上架时,将更新此时间) |
receiving_id | 入库单Id | | 入库单Id |
expected_date | 预计到达时间 | | 预计到达时间 |
warehouse | 仓库 | | 仓库 |
receivingExStatus | 处理收货异常 | | 处理收货异常 |
purchase_cost | 采购成本 | | 采购成本 |
transfer_shipping_fee | 程成本 | | 程成本 |
currency_code | 币种 | | 币种 |
product_info | 产品信息 | | 产品信息 |
product_info.product_barcode | 产品代码 | | 产品代码 |
product_info.product_title | 产品名称 | | 产品名称 |
product_info.rd_status | 状态码 | | 状态码 |
product_info.rd_status_string | 状态名称 | | 状态名称 |
product_info.rd_receiving_qty | 送货数量 | | 送货数量 |
product_info.rd_received_qty | 收货数量 | | 收货数量 |
product_info.dif_receive_num | 收货数量差异 | | 收货数量差异 |
product_info.rd_putaway_qty | 上架数量 | | 上架数量 |
product_info.is_qc | 是否质检 | | 是否质检 |
product_info.is_priority | 优先处理 | | 优先处理 |
product_info.rd_update_time | 更新时间 | | 更新时间 |
product_info.rd_note | 备注 | | 备注 |
product_info.complete_time | 收货完成时间 | | 收货完成时间 |
product_info.putaway_time | 上架完成时间取值 | | 上架完成时间取值 |
product_info.ec_update_time | 更新时间 | | 更新时间 |
金蝶云星空接口明细
- 接口:batchSave
- 接口名称:分布式调入单新增
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FBillNo | 单据编号 | string | |
FStockOrgID | 调入库存组织 | string | |
FOwnerTypeIdHead | 调入货主类型 | string | |
FOwnerIdHead | 调入货主 | string | |
FDate | 日期 | string | |
FBillTypeID | 单据类型 | string | |
FTransferDirect | 调拨方向 | string | |
FNOTE | 备注 | string | |
FCreateDate | 创建日期 | string | |
FTransferBizType | 调拨类型 | string | |
FOwnerTypeOutIdHead | 调出货主类型 | string | |
FOwnerOutIdHead | 调出货主 | string | |
FStockOutOrgID | 调出库存组织 | string | |
FCustID | 对应客户 | string | |
FSUPPLIERID | 对应供应商 | string | |
FSTKTRSINENTRY | 明细信息 | array | |
FSTKTRSINENTRY.FMaterialID | 物料编码 | string | |
FSTKTRSINENTRY.FSrcMaterialId | 调出物料 | string | |
FSTKTRSINENTRY.FCMKBarCode | 零售条形码 | string | |
FSTKTRSINENTRY.FSrcStockID | 调出仓库 | string | |
FSTKTRSINENTRY.FDestStockID | 调入仓库 | string | |
FSTKTRSINENTRY.FPlanTransferQty | 计划调拨数量 | string | |
FSTKTRSINENTRY.FQty | 调入数量 | string | |
FSTKTRSINENTRY.FOwnerID | 调入货主 | string | |
FSTKTRSINENTRY.FDestStockLocId | 调入仓位 | string | |
FSTKTRSINENTRY.FSRCStockLocId | 调出仓位 | string | |
FSTKTRSINENTRY.FOwnerOutID | 调出货主 | string | |
FSTKTRSINENTRY.FLOT | 调出批号 | string | |
FSTKTRSINENTRY.FEntryNote | 备注 | string | |
FSTKTRSINENTRY.FSrcBillTypeId | 源单类型 | string | |
FSTKTRSINENTRY.FSrcBillNo | 源单编号 | string | |
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link | 关联关系表 | array | |
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FRuleId | 转换规则 | string | |
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSTableName | 源单表 | string | |
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSBillId | 源单内码 | string | |
FSTKTRSINENTRY.FSTKTSTKRANSFERINENTRY_Link.FSTKTSTKRANSFERINENTRY_Link_FSId | 源单分录内码 | string | |
FSTKTRSINENTRY.F_ABCD_Text_ck | 参考号 | string | |
FSTKTRSINENTRY.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FSTKTRSINENTRY.Operation | 执行的操作 | string | |
FSTKTRSINENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | |
FSTKTRSINENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统对接概况
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。

