金蝶云星空和奇门WMS-A接口打通对接实战

数据源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

接通系统：奇门WMS-A

奇门WMS是针对菜鸟WMS、天猫国际保税仓、其它WMS系统（如：百世云仓、巨沃WMS、递四方、中仓仓储等第三方仓储WMS系统），进行对接与管理的模块。奇门WMS包含：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步

数据接口配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：奇门WMS-A的映射，即可启动方案进行测试

金蝶云星空接口明细

接口：executeBillQuery
接口名称：退料申请查询
接口方法：POST

请求参数

字段名称类型描述 FEntity_FEntryIDFEntity_FEntryIDstring FBillNo单据编号string FIDFIDstring FDocumentStatus单据状态string FBillTypeID_Fnumber单据类型string FDate申请日期string FSUPPLIERID_Fnumber供应商string FCreatorId创建人string FCreateDate创建日期string FAPPROVERID审核人string FAPPROVEDATE审核日期string FieldKeys需查询的字段key集合array金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber Limit最大行数string StartRow开始行索引string金蝶的查询分页参数 TopRowCount返回总行数string金蝶的查询分页参数 FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

奇门WMS-A接口明细

API：taobao.qimen.stockout.create
NAME：出库单创建
METHOD：POST

请求参数

接口字段字段名称预设值描述 deliveryOrder出库单信息 deliveryOrder.totalOrderLines单据总行数当单据需要分多个请求发送时;发送方需要将totalOrderLines填入;接收方收到后;根据实际接收到的条数和totalOrderLines进行比对;如果小于;则继续等待接收请求。如果等于;则表示该单据的所有请求发送完成. deliveryOrder.deliveryOrderCode出库单号 deliveryOrder.orderType出库单类型PTCK=普通出库单;DBCK=调拨出库;B2BCK=B2B出库;QTCK=其他出库;CGTH=采购退货出库单;XNCK=虚拟出库单, JITCK=唯品出库 deliveryOrder.relatedOrders关联单据信息 deliveryOrder.relatedOrders.orderType关联的订单类型CG=采购单;DB=调拨单;CK=出库单;RK=入库单;只传英文编码 deliveryOrder.relatedOrders.orderCode关联的订单编号 deliveryOrder.relatedOrders.warehouseCode仓库编码统仓统配等无需ERP指定仓储编码的情况填OTHER deliveryOrder.relatedOrders.createTime出库单创建时间YYYY-MM-DD HH:MM:SS deliveryOrder.relatedOrders.scheduleDate要求出库时间YYYY-MM-DD deliveryOrder.relatedOrders.logisticsCode物流公司编码SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通(ZTO)、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、OTHER=其他;只传英文编码 deliveryOrder.relatedOrders.logisticsName物流公司名称包括干线物流公司等 deliveryOrder.relatedOrders.supplierCode供应商编码 deliveryOrder.relatedOrders.supplierName供应商名称 deliveryOrder.relatedOrders.transportMode提货方式到仓自提、快递、干线物流 deliveryOrder.relatedOrders.pickerInfo提货人信息 deliveryOrder.relatedOrders.pickerInfo.company公司名称 deliveryOrder.relatedOrders.pickerInfo.name姓名 deliveryOrder.relatedOrders.pickerInfo.tel固定电话 deliveryOrder.relatedOrders.pickerInfo.mobile移动电话 deliveryOrder.relatedOrders.pickerInfo.id证件号 deliveryOrder.relatedOrders.pickerInfo.carNo车牌号 deliveryOrder.relatedOrders.pickerInfo.senderInfo发件人信息 deliveryOrder.relatedOrders.pickerInfo.senderInfo.company公司名称 deliveryOrder.relatedOrders.pickerInfo.senderInfo.name姓名 deliveryOrder.relatedOrders.pickerInfo.senderInfo.zipCode邮编 deliveryOrder.relatedOrders.pickerInfo.senderInfo.tel固定电话 deliveryOrder.relatedOrders.pickerInfo.senderInfo.mobile移动电话 deliveryOrder.relatedOrders.pickerInfo.senderInfo.email电子邮箱 deliveryOrder.relatedOrders.pickerInfo.senderInfo.countryCode国家二字码 deliveryOrder.relatedOrders.pickerInfo.senderInfo.province省份 deliveryOrder.relatedOrders.pickerInfo.senderInfo.city城市 deliveryOrder.relatedOrders.pickerInfo.senderInfo.area区域 deliveryOrder.relatedOrders.pickerInfo.senderInfo.town村镇 deliveryOrder.relatedOrders.pickerInfo.senderInfo.detailAddress详细地址 deliveryOrder.relatedOrders.pickerInfo.senderInfo.id证件号 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo收件人信息 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.company公司名称 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.name姓名 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.zipCode邮编 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.tel固定电话 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.mobile移动电话 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.idType收件人证件类型1-身份证、2-军官证、3-护照、4-其他 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.idNumber收件人证件号码 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.email电子邮箱 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.countryCode国家二字码 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.province省份 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.city城市 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.area区域 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.town村镇 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.detailAddress详细地址 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.id证件号 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.remark备注 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.orderSourceType出库单渠道类型VIP=唯品会，FX=分销，SHOP=门店 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.receivingTime到货时间YYYY-MM-DD HH:MM:SS deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.shippingTime送货时间YYYY-MM-DD HH:MM:SS deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.targetWarehouseName入库仓库名称 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.targetWarehouseCode入库仓库编码统仓统配等无需ERP指定仓储编码的情况填OTHER deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.targetEntryOrderCode关联的入库单号ERP分配 deliveryOrder.relatedOrders.pickerInfo.senderInfo.receiverInfo.warehouseName仓库名称 deliveryOrder.orderLines单据信息 deliveryOrder.orderLines.outBizCode外部业务编码消息ID;用于去重;当单据需要分批次发送时使用 deliveryOrder.orderLines.orderLineNo单据行号 deliveryOrder.orderLines.ownerCode货主编码 deliveryOrder.orderLines.itemCode商品编码 deliveryOrder.orderLines.itemId仓储系统商品编码 deliveryOrder.orderLines.inventoryType库存类型ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存;默认为查所有类型的库存 deliveryOrder.orderLines.itemName商品名称 deliveryOrder.orderLines.planQty应发商品数量 deliveryOrder.orderLines.batchCode批次编码 deliveryOrder.orderLines.productDate生产日期YYYY-MM-DD deliveryOrder.orderLines.expireDate过期日期YYYY-MM-DD deliveryOrder.orderLines.produceCode生产批号 deliveryOrder.orderLines.platformCode交易平台商品编码 deliveryOrder.orderLines.unit单位 deliveryOrder.orderLines.extendProps扩展属性 deliveryOrder.orderLines.extendProps扩展属性

系统数据对接

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到奇门WMS-A之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。