易仓和金蝶云星空集成接口设计

对接系统:易仓
易仓科技是一家专门做跨境电商软件服务提供商,目前他们有跨境电商ERP、国际物流TMS、海外仓WMS、跨境分销M2C,保税仓BBC等管理系统。
对接目标系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据对接方案
数据集成平台对应的配置易仓与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据易仓的接口参数要求记录在轻易云集成平台。第二步配置易仓与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。

易仓接口明细
- 接口:getReceiving
- 接口名称:WMS-查询入库单信息
- 接口方法:POST
请求参数
字段 | 名称 | 类型 |
dateFor | 大于等于某个时间类型 | string |
code_like | 单号 | string |
receiving_code | 入库单号 | string |
warehouse_id | 仓库Id | string |
order_by | 排序方式(多个)格式 | array |
dateTo | 小于等于某个时间类型 | string |
pagination | 分页 | object |
receiving_add_user | 采购员 | string |
searchDateType | 查询时间类型 | string |
productBarcode | 产品代码 | string |
receiving_type | 类型 | string |
pagination.page | 当前页 | string |
supplier | 供应商ID | array |
tracking_number | 跟踪号 | string |
pagination.pageSize | 每页显示条数 | string |
po_code | 采购单号 | string |
productBarcode_like | 产品代码 | string |
receiving_status | 入库单状态 | string |
reference_no | 客户参考号 | string |
响应参数
字段 | 名称 | 类型 | 描述 |
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}}{{product_info_product_barcode}} |
FBillTypeID | 单据类型 | string | QTRKD02_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 | BM000013 |
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 |
系统数据对接
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线,传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能,已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线,能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。


