金蝶云星空和奇门WMS-A接口打通对接实战
来源系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
目标系统:奇门WMS-A
淘系的相关仓储数据必须要通过奇门和外部数据进行对接例如：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步
数据接口配置方案
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：奇门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 | |
| FAmountSETY | 总成本 | FAmountSETY | |
| 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 = 'Assembly' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber | |
| FormId | 业务对象表单Id | STK_AssembledApp | 必须填写金蝶的表单ID如 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| 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 | 成本价 | ||
| FAmountSETY | 总成本 | ||
| FLOTSETY_FNumber | 批号 | ||
| FProduceDateSETY | 生产日期 | ||
| FEXPIRYDATESETY | 有效期至 | ||
| FSubEntity_FDetailID | FSubEntity_FDetailID |
奇门WMS-A接口明细
- 调用接口：stockout.create
- 接口名称：出库单创建
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| deliveryOrder | 出库单信息 | object | |
| deliveryOrder.totalOrderLines | 单据总行数 | string | |
| deliveryOrder.deliveryOrderCode | 出库单号 | string | {{FBillNo}}-{{FStockIDSETY_FNumber}} |
| deliveryOrder.warehouseCode | 仓库编码 | string | {{FStockIDSETY_FNumber}} |
| deliveryOrder.createTime | 出库单创建时间 | string | {{FDate}} |
| deliveryOrder.orderType | 出库单类型 | string | QTCK |
| deliveryOrder.remark | 备注 | string | 金蝶组装子件出库-{{FBillNo}}-{{FDate}} |
| deliveryOrder.orderLines | 单据信息 | array | details_list |
| deliveryOrder.orderLines.orderLine | orderLine | array | |
| deliveryOrder.orderLines.orderLine.outBizCode | 外部业务编码 | string | {{FBillNo}}-{{FStockIDSETY_FNumber}} |
| deliveryOrder.orderLines.orderLine.orderLineNo | 单据行号 | string | {{details_list.FSubEntity_FDetailID}} |
| deliveryOrder.orderLines.orderLine.ownerCode | 货主编码 | string | GZ202206111 |
| deliveryOrder.orderLines.orderLine.itemCode | 商品编码 | string | {{details_list.FMaterialIDSETY_FNumber}} |
| deliveryOrder.orderLines.orderLine.itemId | 仓储系统商品编码 | string | |
| deliveryOrder.orderLines.orderLine.inventoryType | 库存类型 | string | ZP |
| deliveryOrder.orderLines.orderLine.itemName | 商品名称 | string | |
| deliveryOrder.orderLines.orderLine.planQty | 应发商品数量 | string | {{details_list.FQtySETY}} |
| deliveryOrder.orderLines.orderLine.batchCode | 批次编码 | string | {{details_list.FLOTSETY_FNumber}} |
| deliveryOrder.orderLines.orderLine.productDate | 生产日期 | string | |
| deliveryOrder.orderLines.orderLine.expireDate | 过期日期 | string | |
| deliveryOrder.orderLines.orderLine.produceCode | 生产批号 | string | |
| deliveryOrder.orderLines.orderLine.platformCode | 交易平台商品编码 | string | |
| deliveryOrder.orderLines.orderLine.unit | 单位 | string | |
| deliveryOrder.orderLines.orderLine.extendProps | 扩展属性 | string | |
| deliveryOrder.orderLines.extendProps | 扩展属性 | string |
系统数据集成价值
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
