奇门WMS-A和金蝶云星空单据接口对接
奇门WMS-A和金蝶云星空单据接口对接
对接系统金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:奇门WMS-A
淘系的相关仓储数据必须要通过奇门和外部数据进行对接例如：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步
数据集成方案配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：奇门WMS-A的映射，即可启动方案进行测试
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：调拨单查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| FBillEntry_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 调入库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID_FNumber | 单据类型 | string | |
| FTransferBizType | 调拨类型 | string | |
| FStockOutOrgId_FNumber | 调出库存组织 | string | |
| FTransferDirect | 调拨方向 | string | |
| FNote | 备注 | string | |
| FBizType | 业务类型 | string | |
| FSaleOrgId_FNumber | 销售组织 | string | |
| FSettleOrgId_FNumber | 结算组织 | string | |
| FCustID_FNumber | 对应客户 | string | |
| FSUPPLIERID_FNumber | 对应供应商 | string | |
| FThirdSrcId | 第三方源单内码 | string | |
| FThirdSrcBillNo | 第三方源单编码 | string | |
| FThirdSystem | 第三方系统 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FLot | 调出批号 | string | |
| FSrcStockId_FNumber | 调出仓库 | string | |
| FSrcStockLocId | 调出仓位 | string | |
| FDestStockId_FNumber | 调入仓库 | string | |
| FDestStockLocId | 调入仓位 | string | |
| FQty | 调拨数量 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FBomId | BOM版本 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 有效期至 | string | |
| FExpPeriod | 保质期 | string | |
| FSrcStockStatusId | 调出库存状态 | string | |
| FDestStockStatusId | 调入库存状态 | string | |
| FOwnerId_FNumber | 调入货主 | string | |
| FOwnerOutId_FNumber | 调出货主 | string | |
| FSrcBillTypeId | 源单类型 | string | |
| FSrcSeq | 源单行号 | string | |
| FOrderNo | 订单编号 | string | |
| FNoteEntry | 备注 | string | |
| FSrcBillNo | 源单编号 | string | |
| FBFLowId | 业务流程 | string | |
| FConsignPrice | 单价 | string | |
| FTaxPrice | 含税单价 | string | |
| FTaxRate | 税率% | string | |
| FDestLot | 调入批号 | string | |
| FQmEntryId | 库存请检单EntryId | string | |
| FConvertEntryId | 库存状态转换EntryId | string | |
| FSOEntryId | 销售订单EntryId | string | |
| FThirdSrcEntryId | 第三方源单分录编码 | string | |
| FISFREE | 赠品 | string | |
| Limit | 最大行数 | string | 金蝶的查询分页参数 |
| FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如
|
| StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| FBillEntry_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 调入库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID_FNumber | 单据类型 | string | |
| FTransferBizType | 调拨类型 | string | |
| FStockOutOrgId_FNumber | 调出库存组织 | string | |
| FTransferDirect | 调拨方向 | string | |
| FNote | 备注 | string | |
| FBizType | 业务类型 | string | |
| FSaleOrgId_FNumber | 销售组织 | string | |
| FSettleOrgId_FNumber | 结算组织 | string | |
| FCustID_FNumber | 对应客户 | string | |
| FSUPPLIERID_FNumber | 对应供应商 | string | |
| FThirdSrcId | 第三方源单内码 | string | |
| FThirdSrcBillNo | 第三方源单编码 | string | |
| FThirdSystem | 第三方系统 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FLot | 调出批号 | string | |
| FSrcStockId_FNumber | 调出仓库 | string | |
| FSrcStockLocId | 调出仓位 | string | |
| FDestStockId_FNumber | 调入仓库 | string | |
| FDestStockLocId | 调入仓位 | string | |
| FQty | 调拨数量 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FBomId | BOM版本 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 有效期至 | string | |
| FExpPeriod | 保质期 | string | |
| FSrcStockStatusId | 调出库存状态 | string | |
| FDestStockStatusId | 调入库存状态 | string | |
| FOwnerId_FNumber | 调入货主 | string | |
| FOwnerOutId_FNumber | 调出货主 | string | |
| FSrcBillTypeId | 源单类型 | string | |
| FSrcSeq | 源单行号 | string | |
| FOrderNo | 订单编号 | string | |
| FNoteEntry | 备注 | string | |
| FSrcBillNo | 源单编号 | string | |
| FBFLowId | 业务流程 | string | |
| FConsignPrice | 单价 | string | |
| FTaxPrice | 含税单价 | string | |
| FTaxRate | 税率% | string | |
| FDestLot | 调入批号 | string | |
| FQmEntryId | 库存请检单EntryId | string | |
| FConvertEntryId | 库存状态转换EntryId | string | |
| FSOEntryId | 销售订单EntryId | string | |
| FThirdSrcEntryId | 第三方源单分录编码 | string | |
| FISFREE | 赠品 | string |
奇门WMS-A接口明细
- 接口：entryorder.create
- 接口名称：入库单创建
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| entryOrder | 入库单信息 | object | |
| entryOrder.entryOrderCode | 入库单号 | string | |
| entryOrder.ownerCode | 货主编码 | string | |
| entryOrder.purchaseOrderCode | 采购单号 | string | 当orderType=CGRK时使用 |
| entryOrder.warehouseCode | 入库仓库编码 | string | 统仓统配等无需ERP指定仓储编码的情况填OTHER |
| entryOrder.orderCreateTime | 订单创建时间 | string | YYYY-MM-DD HH:MM:SS |
| entryOrder.orderType | 业务类型 | string | SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入 库;XNRK=虚拟入库;只传英文编码 |
| entryOrder.remark | 备注 | string | |
| entryOrder.orderLines | 入库单详情 | array | |
| entryOrder.orderLines.orderLine | orderLine | array | |
| entryOrder.orderLines.orderLine.outBizCode | 外部业务编码 | string | 消息ID;用于去重;当单据需要分批次发送时使用 |
| entryOrder.orderLines.orderLine.orderLineNo | 入库单的行号 | string | |
| entryOrder.orderLines.orderLine.ownerCode | 货主编码 | string | |
| entryOrder.orderLines.orderLine.itemCode | 商品编码 | string | |
| entryOrder.orderLines.orderLine.itemId | 仓储系统商品ID | string | |
| entryOrder.orderLines.orderLine.itemName | 商品名称 | string | |
| entryOrder.orderLines.orderLine.planQty | 应收商品数量 | string | |
| entryOrder.orderLines.orderLine.skuProperty | 商品属性 | string | |
| entryOrder.orderLines.orderLine.purchasePrice | 采购价 | string | |
| entryOrder.orderLines.orderLine.retailPrice | 零售价 | string | |
| entryOrder.orderLines.orderLine.inventoryType | 库存类型 | string | ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP |
| entryOrder.orderLines.orderLine.batchCode | 批次编码 | string | |
| entryOrder.orderLines.orderLine.productDate | 商品生产日期 | string | YYYY-MM-DD |
| entryOrder.orderLines.orderLine.expireDate | 商品过期日期 | string | YYYY-MM-DD |
| entryOrder.orderLines.orderLine.produceCode | 生产批号 | string | |
| entryOrder.orderLines.orderLine.unit | 单位 | string |
系统数据对接
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到奇门WMS-A之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
