奇门WMS-A和金蝶云星空单据接口对接

奇门WMS-A和金蝶云星空单据接口对接

对接系统金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

对接目标系统:奇门WMS-A

淘系的相关仓储数据必须要通过奇门和外部数据进行对接例如：基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步

数据对接方案

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：奇门WMS-A，把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

• API：executeBillQuery

• NAME：销售订单查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID
FID	FID	FID
FBillNo	单据编号	FBillNo
FDocumentStatus	单据状态	FDocumentStatus
FSaleOrgId_FNumber	销售组织	FSaleOrgId.FNumber
FDate	日期	FDate
FCustId_FNumber	客户	FCustId.FNumber
FSaleDeptId_Fnumber	销售部门	FSaleDeptId.Fnumber
FSaleGroupId	销售组	FSaleGroupId
FSalerId	销售员	FSalerId
FReceiveId	收货方	FReceiveId
FSettleId	结算方	FSettleId
FSettleAddress	结算方地址	FSettleAddress
FChargeId	付款方	FChargeId
FCreatorId	创建人	FCreatorId
FCreateDate	创建日期	FCreateDate
FModifierId	最后修改人	FModifierId
FModifyDate	最后修改日期	FModifyDate
FApproverId	审核人	FApproverId
FApproveDate	审核日期	FApproveDate
FCloseStatus	关闭状态	FCloseStatus
FCloserId	关闭人	FCloserId
FCloseDate	关闭日期	FCloseDate
FCancelStatus	作废状态	FCancelStatus
FCancellerId	作废人	FCancellerId
FCancelDate	作废日期	FCancelDate
FVersionNo	版本号	FVersionNo
FChangerId	变更人	FChangerId
FChangeDate	变更日期	FChangeDate
FChangeReason	变更原因	FChangeReason
FBillTypeID_Fnumber	单据类型	FBillTypeID.Fnumber
FBusinessType	业务类型	FBusinessType
FHeadDeliveryWay	交货方式	FHeadDeliveryWay
FReceiveAddress	收货方地址	FReceiveAddress
FHEADLOCID	交货地点	FHEADLOCID
FCreditCheckResult	信用检查结果	FCreditCheckResult
FReceiveContact	收货方联系人	FReceiveContact
FNetOrderBillNo	移动销售订单编号	FNetOrderBillNo
FNetOrderBillId	移动销售订单ID	FNetOrderBillId
FOppID	商机内码	FOppID
FSalePhaseID	销售阶段	FSalePhaseID
FISINIT	是否期初单据	FISINIT
FNote	备注	FNote
FSignStatus	签收状态	FSignStatus
FManualClose	是否手工关闭	FManualClose
FLinkMan	收货人姓名	FLinkMan
FLinkPhone	联系电话	FLinkPhone
FSOFrom	订单来源	FSOFrom
FMaterialId_Fnumber	物料编码	FMaterialId.Fnumber
FMaterialName	物料名称	FMaterialName
FMaterialModel	规格型号	FMaterialModel
FMaterialType	物料类别	FMaterialType
FUnitID_Fnumber	销售单位	FUnitID.Fnumber
FPrice	单价	FPrice
FTaxPrice	含税单价	FTaxPrice
FBomId	BOM版本	FBomId
FPriceUnitId	计价单位	FPriceUnitId
FPriceUnitQty	计价数量	FPriceUnitQty
FPriceCoefficient	价格系数	FPriceCoefficient
FDiscountRate	折扣率%	FDiscountRate
FDiscount	折扣额	FDiscount
FEntryTaxRate	税率%	FEntryTaxRate
FEntryTaxAmount	税额	FEntryTaxAmount
FAllAmount	价税合计	FAllAmount
FTaxNetPrice	净价	FTaxNetPrice
FBaseUnitQty	销售基本数量	FBaseUnitQty
FDeliveryControl	控制发货数量	FDeliveryControl
FDeliveryMaxQty	发货上限	FDeliveryMaxQty
FDeliveryMinQty	发货下限	FDeliveryMinQty
FTransportLeadTime1	运输提前期	FTransportLeadTime1
FBefDisAllAmt	折前价税合计	FBefDisAllAmt
FBefDisAmt	折前金额	FBefDisAmt
FTaxAmount_LC	税额（本位币）	FTaxAmount_LC
FAmount_LC	金额（本位币）	FAmount_LC
FAllAmount_LC	价税合计（本位币）	FAllAmount_LC
FMrpCloseStatus	业务关闭	FMrpCloseStatus
FMrpFreezeStatus	业务冻结	FMrpFreezeStatus
FFreezerId	冻结人	FFreezerId
FFreezeDate	冻结日期	FFreezeDate
FMrpTerminateStatus	业务终止	FMrpTerminateStatus
FTerminaterId	终止人	FTerminaterId
FTerminateDate	终止日期	FTerminateDate
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）	FBaseDeliJoinQty
FDeliQty	累计发货通知数量	FDeliQty
FStockOutQty	累计出库数量	FStockOutQty
FRetNoticeQty	累计退货通知数量（销售）	FRetNoticeQty
FReturnQty	累计退货数量（销售）	FReturnQty
FRemainOutQty	剩余未出数量（销售）	FRemainOutQty
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	FBaseInvoiceJoinQty
FInvoiceJoinQty	关联开票数量(作废)	FInvoiceJoinQty
FInvoiceQty	累计开票数量(作废)	FInvoiceQty
FInvoiceAmount	累计开票金额(作废)	FInvoiceAmount
FReceiveAmount	累计收款金额	FReceiveAmount
FBasePurJoinQty	关联采购/生产数量（销售基本）	FBasePurJoinQty
FPurJoinQty	关联采购/生产数量	FPurJoinQty
FPurReqQty	累计采购申请数量	FPurReqQty
FPurOrderQty	累计采购订单数量	FPurOrderQty
FReceiptOrgId	收款组织	FReceiptOrgId
FSettleOrgIds	结算组织	FSettleOrgIds

响应参数

接口字段	字段名称	预设值	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID
FID	FID
FBillNo	单据编号
FDocumentStatus	单据状态
FSaleOrgId_FNumber	销售组织
FDate	日期
FCustId_FNumber	客户
FSaleDeptId_Fnumber	销售部门
FSaleGroupId	销售组
FSalerId	销售员
FReceiveId	收货方
FSettleId	结算方
FSettleAddress	结算方地址
FChargeId	付款方
FCreatorId	创建人
FCreateDate	创建日期
FModifierId	最后修改人
FModifyDate	最后修改日期
FApproverId	审核人
FApproveDate	审核日期
FCloseStatus	关闭状态
FCloserId	关闭人
FCloseDate	关闭日期
FCancelStatus	作废状态
FCancellerId	作废人
FCancelDate	作废日期
FVersionNo	版本号
FChangerId	变更人
FChangeDate	变更日期
FChangeReason	变更原因
FBillTypeID_Fnumber	单据类型
FBusinessType	业务类型
FHeadDeliveryWay	交货方式
FReceiveAddress	收货方地址
FHEADLOCID	交货地点
FCreditCheckResult	信用检查结果
FReceiveContact	收货方联系人
FNetOrderBillNo	移动销售订单编号
FNetOrderBillId	移动销售订单ID
FOppID	商机内码
FSalePhaseID	销售阶段
FISINIT	是否期初单据
FNote	备注
FSignStatus	签收状态
FManualClose	是否手工关闭
FLinkMan	收货人姓名
FLinkPhone	联系电话
FSOFrom	订单来源
FMaterialId_Fnumber	物料编码
FMaterialName	物料名称
FMaterialModel	规格型号
FMaterialType	物料类别
FUnitID_Fnumber	销售单位
FPrice	单价
FTaxPrice	含税单价
FBomId	BOM版本
FPriceUnitId	计价单位
FPriceUnitQty	计价数量
FPriceCoefficient	价格系数
FDiscountRate	折扣率%
FDiscount	折扣额
FEntryTaxRate	税率%
FEntryTaxAmount	税额
FAllAmount	价税合计
FTaxNetPrice	净价
FBaseUnitQty	销售基本数量
FDeliveryControl	控制发货数量
FDeliveryMaxQty	发货上限
FDeliveryMinQty	发货下限
FTransportLeadTime1	运输提前期
FBefDisAllAmt	折前价税合计
FBefDisAmt	折前金额
FTaxAmount_LC	税额（本位币）
FAmount_LC	金额（本位币）
FAllAmount_LC	价税合计（本位币）
FMrpCloseStatus	业务关闭
FMrpFreezeStatus	业务冻结
FFreezerId	冻结人
FFreezeDate	冻结日期
FMrpTerminateStatus	业务终止
FTerminaterId	终止人
FTerminateDate	终止日期
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）
FDeliQty	累计发货通知数量
FStockOutQty	累计出库数量
FRetNoticeQty	累计退货通知数量（销售）
FReturnQty	累计退货数量（销售）
FRemainOutQty	剩余未出数量（销售）
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)
FInvoiceJoinQty	关联开票数量(作废)
FInvoiceQty	累计开票数量(作废)
FInvoiceAmount	累计开票金额(作废)
FReceiveAmount	累计收款金额
FBasePurJoinQty	关联采购/生产数量（销售基本）
FPurJoinQty	关联采购/生产数量
FPurReqQty	累计采购申请数量
FPurOrderQty	累计采购订单数量
FReceiptOrgId	收款组织
FSettleOrgIds	结算组织

奇门WMS-A接口明细

• API：stockout.create

• NAME：出库单创建

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
deliveryOrder	出库单信息
deliveryOrder.totalOrderLines	单据总行数		当单据需要分多个请求发送时;发送方需要将totalOrderLines填入;接收方收到后;根据实际接收到的条数和totalOrderLines进行比对;如果小于;则继续等待接收请求。如果等于;则表示该单据的所有请求发送完成.
deliveryOrder.deliveryOrderCode	出库单号	{{FBillNo}}-{{FSOStockId_Fnumber}}
deliveryOrder.orderType	出库单类型	B2BCK	PTCK=普通出库单;DBCK=调拨出库;B2BCK=B2B出库;QTCK=其他出库;CGTH=采购退货出库单;XNCK=虚拟出库单, JITCK=唯品出库
deliveryOrder.warehouseCode	仓库编码	{{FSOStockId_Fnumber}}	统仓统配等无需ERP指定仓储编码的情况填OTHER
deliveryOrder.createTime	出库单创建时间	{{FDate}}	YYYY-MM-DD HH:MM:SS
deliveryOrder.supplierCode	供应商编码	{{FCustId_FNumber}}
deliveryOrder.receiverInfo	收件人信息
deliveryOrder.receiverInfo.company	公司名称
deliveryOrder.receiverInfo.name	姓名	张三
deliveryOrder.receiverInfo.zipCode	邮编
deliveryOrder.receiverInfo.tel	固定电话
deliveryOrder.receiverInfo.mobile	移动电话	1234567890
deliveryOrder.receiverInfo.idType	收件人证件类型		1-身份证、2-军官证、3-护照、4-其他
deliveryOrder.receiverInfo.idNumber	收件人证件号码
deliveryOrder.receiverInfo.email	电子邮箱
deliveryOrder.receiverInfo.countryCode	国家二字码
deliveryOrder.receiverInfo.province	省份	广东省
deliveryOrder.receiverInfo.city	城市	番禺区
deliveryOrder.receiverInfo.area	区域
deliveryOrder.receiverInfo.town	村镇
deliveryOrder.receiverInfo.detailAddress	详细地址	广东省广州市番禺区汉溪长隆
deliveryOrder.receiverInfo.id	证件号
deliveryOrder.receiverInfo.remark	备注
deliveryOrder.receiverInfo.orderSourceType	出库单渠道类型		VIP=唯品会，FX=分销 ，SHOP=门店
deliveryOrder.receiverInfo.receivingTime	到货时间		YYYY-MM-DD HH:MM:SS
deliveryOrder.receiverInfo.shippingTime	送货时间		YYYY-MM-DD HH:MM:SS
deliveryOrder.receiverInfo.targetWarehouseName	入库仓库名称
deliveryOrder.receiverInfo.targetWarehouseCode	入库仓库编码		统仓统配等无需ERP指定仓储编码的情况填OTHER
deliveryOrder.receiverInfo.targetEntryOrderCode	关联的入库单号		ERP分配
deliveryOrder.receiverInfo.warehouseName	仓库名称
deliveryOrder.orderLines	单据信息	details_list
deliveryOrder.orderLines.orderLine	orderLine
deliveryOrder.orderLines.orderLine.outBizCode	外部业务编码	{{FSaleOrderEntry_FEntryID}}	消息ID;用于去重;当单据需要分批次发送时使用
deliveryOrder.orderLines.orderLine.orderLineNo	单据行号
deliveryOrder.orderLines.orderLine.ownerCode	货主编码	GZ202206111
deliveryOrder.orderLines.orderLine.itemCode	商品编码	{{details_list.FMaterialId_Fnumber}}
deliveryOrder.orderLines.orderLine.itemId	仓储系统商品编码
deliveryOrder.orderLines.orderLine.inventoryType	库存类型		ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存;默认为查所有类型的库存
deliveryOrder.orderLines.orderLine.itemName	商品名称
deliveryOrder.orderLines.orderLine.planQty	应发商品数量	{{details_list.FQty}}
deliveryOrder.orderLines.orderLine.batchCode	批次编码	{{details_list.FLot}}
deliveryOrder.orderLines.orderLine.productDate	生产日期	{{details_list.FProduceDate}}	YYYY-MM-DD
deliveryOrder.orderLines.orderLine.expireDate	过期日期		YYYY-MM-DD
deliveryOrder.orderLines.orderLine.produceCode	生产批号
deliveryOrder.orderLines.orderLine.platformCode	交易平台商品编码
deliveryOrder.orderLines.orderLine.unit	单位
deliveryOrder.orderLines.orderLine.extendProps	扩展属性
deliveryOrder.orderLines.extendProps	扩展属性

系统对接总览

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：奇门WMS-A与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。