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

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


易仓接口明细
- 接口:getPutAwayList
- 接口名称:WMS-获取上架单列表
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
page | 页码 | Int | 页码 |
pageSize | 每页显示数量 | Int | 每页显示数量(默认:20,不能超过50) |
pdStatus | 上架单状态 | Int | 上架单状态(取值:0.未上架 1.已完成) |
pdType | 上架单类型 | Int | 上架单类型(取值:0.ASN 1.QC 2.BOX ) |
warehouseCode | 仓库代码 | String | 仓库代码 |
receivingType | 入库类型 | Int | 入库类型(取值:0.标准 1.订单退货 2.指定产品退件 3.中转 4.采购 5.其它 6.借用归还入库 7.初始化库存 8.不良品入库 9.盘盈 10.调拨 11.换货 12.同步服务商库存 13.出库单入库 14.同步添加库存 15.赠品入库) |
productSku | 产品SKU | String | 产品SKU |
pdLocation | 临时库位 | String | 临时库位 |
pdPutawayCar | 上架小车 | String | 上架小车 |
orderType | 单据类型 | Int | 单据类型(取值:1.质检单 2.上架单 3.入库单 4.产品代码 5.采购单 6.单据模糊查询 ,默认:取值1,即质检单) |
orderCode | 单据编号 | String | 单据编号 |
supplierCode | 供应商代码 | String | 供应商代码 |
dateType | 日期类型 | Int | 日期类型(取值:1.创建时间 2.上架时间 3.生产日期 4.质检时间 5.预检时间,默认取值1,即创建时间) |
startDate | 开始日期, | String | 开始日期,格式:2020-12-17 |
endDate | 截止日期, | String | 截止日期,格式:2020-12-17 |
operatorCode | 上架员代码 | String | 上架员代码(即登录系统的账号) |
响应参数
字段 | 名称 | 类型 | 描述 |
qcCode | 质检单号 | String | 质检单号 |
putawayCode | 上架单号 | String | 上架单号 |
receivingCode | 入库单号 | String | 入库单号 |
poCode | 采购单号 | String | 采购单号 |
pdLocation | 临时库位 | String | 临时库位 |
pdPutawayCar | 上架小车 | String | 上架小车 |
lcCode | 库位 | String | 库位 |
pdType | 上架类型 | String | 上架类型 |
productBarcode | 产品代码 | String | 产品代码 |
pdQuantity | 数量 | int | 数量 |
warehouseCode | 仓库代码 | String | 仓库代码 |
warehouseName | 仓库名称 | String | 仓库名称 |
operatorName | 上架员 | String | 上架员 |
pdStatus | 上架状态 | String | 上架状态 |
pqcAddTime | 预检时间 | date | 预检时间 |
pdAddTime | QC时间 | datetime | QC时间 |
pdPutawayTime | 上架时间 | datetime | 上架时间 |
pdProductionDate | 生产日期 | datetime | 生产日期 |
金蝶云星空接口明细
- API:batchSave
- NAME:其他入库新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | {{dataList_receivingCode}}{{dataList_productBarcode}} | 单据编号 |
FBillTypeID | 单据类型 | QTRKD02_SYS | 单据类型 |
FStockOrgId | 库存组织 | {{dataList_warehouseCode}} | 组织 |
FStockDirect | 库存方向 | | 下拉列表 |
FDate | 日期 | {{dataList_pdPutawayTime}} | 日期 |
FSUPPLIERID | 供应商 | | 基础资料 |
FDEPTID | 部门 | BM000013 | 基础资料 |
FOwnerTypeIdHead | 货主类型 | BD_OwnerOrg | 多类别基础资料列表 |
FOwnerIdHead | 货主 | {{dataList_warehouseCode}} | 多类别基础资料 |
FNOTE | 备注 | | 多行文本 |
FEntity | 明细信息 | | |
FEntity.FInStockType | 入库类型 | | 下拉列表 |
FEntity.FMATERIALID | 物料编码 | _findCollection find FNumber from 32df639a-9c45-3823-8a92-1e2ceb30649e where FOldNumber={{dataList_productBarcode}} | 基础资料 |
FEntity.FCMKBarCode | 零售条形码 | | 文本 |
FEntity.FSTOCKID | 收货仓库 | {{dataList_warehouseCode}} | 基础资料 |
FEntity.FStockLocId | 仓位 | | 维度关联字段 |
FEntity.FLOT | 批号 | | 批次 |
FEntity.FQty | 实收数量 | {{dataList_pdQuantity}} | 数量 |
FEntity.FPrice | 成本价 | | 单价 |
FEntity.FEntryNote | 备注 | | 多行文本 |
FEntity.FSRCBILLNO | 源单编号 | | 源单编号 |
FEntity.FSRCBILLTYPEID | 源单类型 | | 源单类型 |
FEntity.FormId | 业务对象表单Id | STK_MISCELLANEOUS | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FEntity.Operation | 执行的操作 | Save | |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
系统集成总览
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。

