从金蝶云星空到小仓WMS通过接口配置打通数据
对接源平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接入系统：小仓WMS
小仓科技专注于仓储物流相关产品研发、咨询规划、集成管理的国家高新技术企业；为电商、时尚、居家日用、快消品、生鲜冷链、零售、3C电子、母婴及第三方物流等行业，以及国内外知名品牌客户提供仓储物流专业解决方案，广泛得到行业及客户的认可。
数据接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：组装拆卸单查询(成品)，目标系统：小仓WMS，目标系统 API创建商品。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：组装拆卸单查询(成品)
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FOwnerTypeIdHead | 成品货主类型 | string | |
| FOwnerIdHead_FNumber | 成品货主 | string | |
| FAffairType | 事务类型 | string | |
| FEE | 费用 | string | |
| FDeptID_FNumber | 部门 | string | |
| FNote | 备注 | string | |
| FCreateDate | 创建日期 | string | |
| FModifyDate | 最后修改日期 | string | |
| FAPPROVEDATE | 审核日期 | string | |
| FCANCELDATE | 作废日期 | string | |
| FCANCELSTATUS | 作废状态 | string | |
| FSubProOwnTypeIdH | 子件货主类型 | string | |
| FSubProOwnerIdH_FNumber | 子件货主 | string | |
| FMaterialIDSETY_FNumber | 物料编码 | string | |
| FMaterialIDSETY_FBARCODE | 物料条码 | string | |
| FUnitIDSETY_FNumber | 单位 | string | |
| FQtySETY | 数量 | string | |
| FCostProportion | 成本拆分比例 | string | |
| FStockIDSETY_FNumber | 仓库 | string | |
| FStockStatusIDSETY | 库存状态 | string | |
| FDescriptionSETY | 备注 | string | |
| FMTONOSETY | 计划跟踪号 | string | |
| FProjectNoSETY | 项目编号 | string | |
| FOwnerTypeIDSETY | 货主类型 | string | |
| FOwnerIDSETY_FNumber | 货主 | string | |
| FKeeperTypeIDSETY | 保管者类型 | string | |
| FKeeperIDSETY | 保管者 | string | |
| FPriceSETY | 成本价 | string | |
| FAmountSETY | 总成本 | string | |
| FLOTSETY_FNumber | 批号 | string | |
| FProduceDateSETY | 生产日期 | string | |
| FEXPIRYDATESETY | 有效期至 | string | |
| FSubEntity_FDetailID | FSubEntity_FDetailID | string | |
| Limit | 最大行数 | string | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FOwnerTypeIdHead | 成品货主类型 | string | |
| FOwnerIdHead_FNumber | 成品货主 | string | |
| FAffairType | 事务类型 | string | |
| FEE | 费用 | string | |
| FDeptID_FNumber | 部门 | string | |
| FNote | 备注 | string | |
| FCreateDate | 创建日期 | string | |
| FModifyDate | 最后修改日期 | string | |
| FAPPROVEDATE | 审核日期 | string | |
| FCANCELDATE | 作废日期 | string | |
| FCANCELSTATUS | 作废状态 | string | |
| FSubProOwnTypeIdH | 子件货主类型 | string | |
| FSubProOwnerIdH_FNumber | 子件货主 | string | |
| FMaterialIDSETY_FNumber | 物料编码 | string | |
| FMaterialIDSETY_FBARCODE | 物料条码 | string | |
| FUnitIDSETY_FNumber | 单位 | string | |
| FQtySETY | 数量 | string | |
| FCostProportion | 成本拆分比例 | string | |
| FStockIDSETY_FNumber | 仓库 | string | |
| FStockStatusIDSETY | 库存状态 | string | |
| FDescriptionSETY | 备注 | string | |
| FMTONOSETY | 计划跟踪号 | string | |
| FProjectNoSETY | 项目编号 | string | |
| FOwnerTypeIDSETY | 货主类型 | string | |
| FOwnerIDSETY_FNumber | 货主 | string | |
| FKeeperTypeIDSETY | 保管者类型 | string | |
| FKeeperIDSETY | 保管者 | string | |
| FPriceSETY | 成本价 | string | |
| FAmountSETY | 总成本 | string | |
| FLOTSETY_FNumber | 批号 | string | |
| FProduceDateSETY | 生产日期 | string | |
| FEXPIRYDATESETY | 有效期至 | string | |
| FSubEntity_FDetailID | FSubEntity_FDetailID | string | |
小仓WMS接口明细
- API：createOutOrder_R
- NAME：创建商品
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| Body | Body | | |
| Body.OutOrder | 订单编号 | | |
| Body.OutOrder.OrderNo | 平台单号 | {{FBillNo}}-1 | |
| Body.OutOrder.WarehouseCode | 仓库代号 | 大姐头仓 | |
| Body.OutOrder.ShipperCode | 货主代号 | 大姐头 | |
| Body.OutOrder.OrderTypeCode | 订单类型代号 | 1004 | |
| Body.OutOrder.ReceiptAddress | 收货地址 | 1 | |
| Body.OutOrder.ReceiptCountry | 收货国家 | 1 | |
| Body.OutOrder.ReceiptProvince | 收货省 | 1 | |
| Body.OutOrder.ReceiptCity | 收货市 | 1 | |
| Body.OutOrder.ReceiptContacts | 收货联系人 | 1 | |
| Body.OutOrder.ReceiptPhoneNumber | 收货联系电话 | 1 | |
| Body.OutOrder.EMS | 快递单号 | 1 | |
| Body.OutOrder.OrderTime | 下单时间 | {{FCreateDate}} | |
| Body.OutOrder.CreateUser | 创建人 | 1 | |
| Body.OutOrder.OrderItems | OrderItems | | |
| Body.OutOrder.OrderItems.item | 子项 | goods_list | |
| Body.OutOrder.OrderItems.item.OrderNo | 订单号 | {{FBillNo}}-1 | |
| Body.OutOrder.OrderItems.item.GoodsCode | 货品代码 | {{FMaterialIDSETY_FNumber}} | |
| Body.OutOrder.OrderItems.item.GoodsState | 货品状态 | 1013 | |
| Body.OutOrder.OrderItems.item.Number | 数量 | {{FQtySETY}} | |
| Body.OutOrder.OrderItems.item.GoodsName | 货品名称 | {{FMaterialIDSETY_FNumber}} | |
| Body.OutOrder.OrderItems.item.UnReceivedNumber | 待收货数量 | {{FQtySETY}} | |
| Body.OutOrder.OrderItems.item.Stockpile | 可分配库存 | | |
| Body.OutOrder.OrderItems.item.ContainerNo | 箱数 | 1 | |
| Body.OutOrder.OrderItems.item.Description | 商品名称 | {{FMaterialIDSETY_FNumber}} | |
| Body.OutOrder.OrderItems.item.Batch | 批次 | {{FLOTSETY_FNumber}} | |
数据对接效果
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
