金蝶云星空对接打通奇门WMS-A组装拆卸单查询(成品)接口与出库单创建接口
接通系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标平台:奇门WMS-A
用于菜鸟的仓库（使用其他支持奇门的仓库同理），故而希望能和仓库的wms系统打通，这样我们采购收货，采购入库，销售出库，采购退货，销售退货等多个场景就能和我们的中台（erp）进行数据同步。
接口方案配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到奇门WMS-A中。轻易云集成平台的可视化配置轻松实现。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：组装拆卸单查询(成品)
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FStockOrgId_FNumber | 库存组织 | FStockOrgId.FNumber | |
| FDate | 日期 | FDate | |
| FBillTypeID | 单据类型 | FBillTypeID | |
| FOwnerTypeIdHead | 成品货主类型 | FOwnerTypeIdHead | |
| FOwnerIdHead_FNumber | 成品货主 | FOwnerIdHead.FNumber | |
| FAffairType | 事务类型 | FAffairType | |
| FEE | 费用 | FEE | |
| FDeptID_FNumber | 部门 | FDeptID.FNumber | |
| FNote | 备注 | FNote | |
| FCreateDate | 创建日期 | FCreateDate | |
| FModifyDate | 最后修改日期 | FModifyDate | |
| FAPPROVEDATE | 审核日期 | FAPPROVEDATE | |
| FCANCELDATE | 作废日期 | FCANCELDATE | |
| FCANCELSTATUS | 作废状态 | FCANCELSTATUS | |
| FSubProOwnTypeIdH | 子件货主类型 | FSubProOwnTypeIdH | |
| FSubProOwnerIdH_FNumber | 子件货主 | FSubProOwnerIdH.FNumber | |
| FMaterialIDSETY_FNumber | 物料编码 | FMaterialIDSETY.FNumber | |
| FMaterialIDSETY_FBARCODE | 物料条码 | FMaterialIDSETY.FBARCODE | |
| FUnitIDSETY_FNumber | 单位 | FUnitIDSETY.FNumber | |
| FQtySETY | 数量 | FQtySETY | |
| FCostProportion | 成本拆分比例 | FCostProportion | |
| FStockIDSETY_FNumber | 仓库 | FStockIDSETY.FNumber | |
| FStockStatusIDSETY | 库存状态 | FStockStatusIDSETY | |
| FDescriptionSETY | 备注 | FDescriptionSETY | |
| FMTONOSETY | 计划跟踪号 | FMTONOSETY | |
| FProjectNoSETY | 项目编号 | FProjectNoSETY | |
| FOwnerTypeIDSETY | 货主类型 | FOwnerTypeIDSETY | |
| FOwnerIDSETY_FNumber | 货主 | FOwnerIDSETY.FNumber | |
| FKeeperTypeIDSETY | 保管者类型 | FKeeperTypeIDSETY | |
| FKeeperIDSETY | 保管者 | FKeeperIDSETY | |
| FPriceSETY | 成本价 | FPriceSETY | |
| FExpirationDateSETY | 保质期 | FExpirationDateSETY | |
| FLOTSETY_FNumber | 批号 | FLOTSETY.FNumber | |
| FProduceDateSETY | 生产日期 | FProduceDateSETY | |
| FEXPIRYDATESETY | 有效期至 | FEXPIRYDATESETY | |
| FSubEntity_FDETAILID | FSubEntity_FDETAILID | FSubEntity_FDETAILID | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FAFFAIRTYPE = 'Dassembly' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | STK_AssembledApp | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDocumentStatus | 单据状态 | | |
| FStockOrgId_FNumber | 库存组织 | | |
| FDate | 日期 | | |
| FBillTypeID | 单据类型 | | |
| FOwnerTypeIdHead | 成品货主类型 | | |
| FOwnerIdHead_FNumber | 成品货主 | | |
| FAffairType | 事务类型 | | |
| FEE | 费用 | | |
| FDeptID_FNumber | 部门 | | |
| FNote | 备注 | | |
| FCreateDate | 创建日期 | | |
| FModifyDate | 最后修改日期 | | |
| FAPPROVEDATE | 审核日期 | | |
| FCANCELDATE | 作废日期 | | |
| FCANCELSTATUS | 作废状态 | | |
| FSubProOwnTypeIdH | 子件货主类型 | | |
| FSubProOwnerIdH_FNumber | 子件货主 | | |
| FMaterialIDSETY_FNumber | 物料编码 | | |
| FMaterialIDSETY_FBARCODE | 物料条码 | | |
| FUnitIDSETY_FNumber | 单位 | | |
| FQtySETY | 数量 | | |
| FCostProportion | 成本拆分比例 | | |
| FStockIDSETY_FNumber | 仓库 | | |
| FStockStatusIDSETY | 库存状态 | | |
| FDescriptionSETY | 备注 | | |
| FMTONOSETY | 计划跟踪号 | | |
| FProjectNoSETY | 项目编号 | | |
| FOwnerTypeIDSETY | 货主类型 | | |
| FOwnerIDSETY_FNumber | 货主 | | |
| FKeeperTypeIDSETY | 保管者类型 | | |
| FKeeperIDSETY | 保管者 | | |
| FPriceSETY | 成本价 | | |
| FExpirationDateSETY | 保质期 | | |
| FLOTSETY_FNumber | 批号 | | |
| FProduceDateSETY | 生产日期 | | |
| FEXPIRYDATESETY | 有效期至 | | |
| FSubEntity_FDETAILID | FSubEntity_FDETAILID | | |
奇门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 | |
系统对接总览
随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。
