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

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

对接系统易仓

易仓科技是一家专门做跨境电商软件服务提供商，目前他们有跨境电商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产品SKUString产品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预检时间 pdAddTimeQC时间datetimeQC时间 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业务对象表单IdSTK_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资产的可插拔、可复用、可组成。