系统数据集成方案

金蝶云星空和旺店通·企业奇门接口打通对接实战

接入系统：金蝶云星空

对接目标平台:旺店通·企业奇门

数据对接方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：收料通知单查询，目标系统：旺店通·企业奇门，目标系统 API创建采购单。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

• 接口：executeBillQuery
• 接口名称：收料通知单查询
• 接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	String
FDocumentStatus	单据状态	String
FMaterialId	物料编码	String
FStockOrgId_FNumber	收料组织	String
FMaterialName	物料名称	String
FDate	收料日期	String
FMateriaModel	规格型号	String
FBillTypeID.fnumber	单据类型	String
FAuxPropId	辅助属性	String
FOwnerTypeIdHead	货主类型	String
FOwnerIdHead	货主	String
FMateriaType	物料类别	String
FActlandQty	实到数量	String
FSupplierId	供应商	String
FActReceiveQty	交货数量	String
FSendBillNo	送货单号	String
FStockID	仓库	String
FLadBillNo	提货单号	String
FStockStatusId	库存状态	String
FCarrierId	承运商	String
FBomId	BOM版本	String
FReceiveDeptId	收料部门	String
FStockGroupId	库存组	String
FSupplierLot	供应商批号	String
FProduceDate	生产日期	String
FReceiverId	收料员	String
FExpiryDate	有效期至	String
FPurOrgId	采购组织	String
FPurDeptId.fnumber	采购部门	String
FAuxUnitQty	库存辅单位数量	String
FPurGroupId	采购组	String
FDemandDeptId	需求部门	String
FPurchaserId.fnumber	采购员	String
FCtrlStockInPercent	控制入库数量	String
FNote	备注	String
FStockInMaxQty	入库上限	String
FStockInMinQty	入库下限	String
FCreatorId	创建人	String
FInStockJoinQty	合格入库关联数量	String
FCreateDate	创建日期	String
FModifierId	最后修改人	String
FInStockQty	入库数量	String
FIsFree	免费	String
FModifyDate	最后修改日期	String
FPriceUnitQty	计价数量	String
FApproveDate	审核日期	String
FApproverId	审核人	String
FDiscountRate	折扣率%	String
FCancellerId	作废人	String
FTaxNetPrice	净价	String
FCancelDate	作废日期	String
FAmount	金额	String
FCancelStatus	作废状态	String
FEntryTaxRate	税率%	String
FSupplyContact	供货方联系人(旧)	String
FPrice	单价	String
FSettleId	结算方	String
FEntryTaxAmount	税额	String
FSupplyId	供货方	String
FAllAmount	价税合计	String
FReqTraceNo	需求跟踪号	String
FChargeId	收款方	String
FCloseStatus	整单关闭状态	String
FOrderBillNo	订单单号	String
FBusinessType	业务类型	String
FTaxPrice	含税单价	String
FMinPrice	价格下限	String
FNeedCheck	需要检验	String
FDemandOrgId	需求组织	String
FMaxPrice	价格上限	String
FSupplyAddress	供货方地址	String
FDescription	备注	String
FCorrespondOrgId	对应组织	String
FAmount_LC	金额(本位币)	String
FTaxAmount_LC	税额(本位币)	String
FConfirmStatus	确认状态	String
FAllAmount_LC	价税合计(本位币)	String
FConfirmerId	确认人	String
FConfirmDate	确认日期	String
FIsInsideBill	外部单据	String
FProviderContactId	供货方联系人	String
FIsMobile	来自移动	String
FDetailEntity_FEntryID	FDetailEntity_FEntryID	string
FSrcBillNo	源单编号（采购订单）	string
FID	FID	string
FPOORDERENTRYID	采购订单分录内码	string
FTextWWDDH	委外订单号	string
FQtyWWDDSL	委外订单数量	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如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
FBillNo	单据编号	String
FDocumentStatus	单据状态	String
FMaterialId	物料编码	String
FStockOrgId_FNumber	收料组织	String
FMaterialName	物料名称	String
FDate	收料日期	String
FMateriaModel	规格型号	String
FBillTypeID	单据类型	String
FAuxPropId	辅助属性	String
FOwnerTypeIdHead	货主类型	String
FOwnerIdHead	货主	String
FMateriaType	物料类别	String
FActlandQty	实到数量	String
FSupplierId	供应商	String
FActReceiveQty	交货数量	String
FSendBillNo	送货单号	String
FStockID	仓库	String
FLadBillNo	提货单号	String
FStockStatusId	库存状态	String
FCarrierId	承运商	String
FBomId	BOM版本	String
FReceiveDeptId	收料部门	String
FStockGroupId	库存组	String
FSupplierLot	供应商批号	String
FProduceDate	生产日期	String
FReceiverId	收料员	String
FExpiryDate	有效期至	String
FPurOrgId	采购组织	String
FPurDeptId_fnumber	采购部门	String
FAuxUnitQty	库存辅单位数量	String
FPurGroupId	采购组	String
FDemandDeptId	需求部门	String
FPurchaserId	采购员	String
FCtrlStockInPercent	控制入库数量	String
FNote	备注	String
FStockInMaxQty	入库上限	String
FStockInMinQty	入库下限	String
FCreatorId	创建人	String
FInStockJoinQty	合格入库关联数量	String
FCreateDate	创建日期	String
FModifierId	最后修改人	String
FInStockQty	入库数量	String
FIsFree	免费	String
FModifyDate	最后修改日期	String
FPriceUnitQty	计价数量	String
FApproveDate	审核日期	String
FApproverId	审核人	String
FDiscountRate	折扣率%	String
FCancellerId	作废人	String
FTaxNetPrice	净价	String
FCancelDate	作废日期	String
FAmount	金额	String
FCancelStatus	作废状态	String
FEntryTaxRate	税率%	String
FSupplyContact	供货方联系人(旧)	String
FPrice	单价	String
FSettleId	结算方	String
FEntryTaxAmount	税额	String
FSupplyId	供货方	String
FAllAmount	价税合计	String
FReqTraceNo	需求跟踪号	String
FChargeId	收款方	String
FCloseStatus	整单关闭状态	String
FOrderBillNo	订单单号	String
FBusinessType	业务类型	String
FTaxPrice	含税单价	String
FMinPrice	价格下限	String
FNeedCheck	需要检验	String
FDemandOrgId	需求组织	String
FMaxPrice	价格上限	String
FSupplyAddress	供货方地址	String
FDescription	备注	String
FCorrespondOrgId	对应组织	String
FAmount_LC	金额(本位币)	String
FTaxAmount_LC	税额(本位币)	String
FConfirmStatus	确认状态	String
FAllAmount_LC	价税合计(本位币)	String
FConfirmerId	确认人	String
FConfirmDate	确认日期	String
FIsInsideBill	外部单据	String
FProviderContactId	供货方联系人	String
FIsMobile	来自移动	String
FDetailEntity_FEntryID	FDetailEntity_FEntryID	string
FSrcBillNo	源单编号（采购订单）	string
FID	FID	string
FPOORDERENTRYID	采购订单分录内码	string
FQtyWWDDSL	委外订单数量	string
FTextWWDDH	委外订单号	string

旺店通·企业奇门接口明细

• 接口：wdt.purchase.order.push
• 接口名称：创建采购单
• 接口方法：POST

请求参数

字段	名称	类型	描述
provider_no	供应商编号	string	供应商编号，ERP供应商档案必须存在此编号，否则推送失败
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于创建指定仓库数据信息(不支持一次推送多个仓库编码)
outer_no	API单号	string	API单号（如果【使用API单号作为系统采购单号】，那么该字段长度不能超过20）保证唯一
contact	收货人姓名	string	收货人姓名
purchase_name	采购员	string	采购员
telno	收货人联系电话	string	收货人联系电话
receive_address	收货地址	string	收货地址
expect_arrive_time	预计到货时间	string	采购单对应货品预计到达仓库时间，时间格式：YYYY-MM-DD HH:MM:SS
other_fee	其他费用	string	其他费用
post_fee	邮资	string	邮资
remark	备注	string	采购单备注
details_list	采购明细节点	array	请求参数的2级数据节点，包含采购单所有货品明细信息的数据节点，节点下数据字段详见下述“details_list”
details_list.spec_no	商家编码	string	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.num	采购量	string	采购量
details_list.price	采购价格	string	采购价格,按采购单位，税前单价
details_list.tax	税率	string	货品的税率，传值范围大于等于0小于等于1
details_list.is_check	自动审核	string
details_list.purchase_info	采购列表节点	string	请求参数的1级数据节点，包含采购单所有属性信息的数据节点，节点下数据字段详见下述“purchase_info”

系统数据对接

从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

系统数据对接方案元数据代码