金蝶云星空对接打通奇门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如 PUR_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治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。