系统数据集成方案

金蝶云星空与旺店通·旗舰奇门对接集成退料申请查询连通采购退货单新建(柏为金蝶退料申请退料开单08.03)

接入系统：金蝶云星空

对接目标系统:旺店通·旗舰奇门

数据接口配置方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的退料申请查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为旺店通·旗舰奇门，并且选择对应连接器。选择对应的采购退货单新建接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

• 接口：executeBillQuery
• 接口名称：退料申请查询
• 接口方法：POST

请求参数

字段	名称	类型	描述
FEntity_FEntryID	FEntity_FEntryID	string
FBillNo	单据编号	string
FID	FID	string
FDocumentStatus	单据状态	string
FBillTypeID_Fnumber	单据类型	string
FDate	申请日期	string
FPURCHASEORGID_Fnumber	采购组织	string
FRMTYPE	退料类型	string
FAPPORGID_Fnumber	申请组织	string
FAPPDEPTID_Fnumber	申请部门	string
FRMLOC	退料地点	string
FSUPPLIERID_Fnumber	供应商	string
FRMMODE	退料方式	string
FREPLENISHMODE	补料方式	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FAPPROVERID	审核人	string
FAPPROVEDATE	审核日期	string
FCANCELLERID	作废人	string
FCANCELDATE	作废日期	string
FCANCELSTATUS	作废状态	string
FBusinessType	业务类型	string
FRemarks	备注	string
FRMREASON	退料原因	string
FRequireOrgId_Fnumber	需求组织	string
FCorrespondOrgId_Fnumber	对应组织	string
FConfirmerId	确认人	string
FConfirmDate	确认日期	string
FConfirmStatus	确认状态	string
FMATERIALID_Fnumber	物料编码	string
FMaterialName	物料名称	string
FUOM	规格型号	string
FMaterialType	存货类别	string
FMRAPPQTY	申请退料数量	string
FREPLENISHQTY	补料数量	string
FKEAPAMTQTY	扣款数量	string
FMRJOINQTY	退料关联数量	string
FMRQTY	退料数量	string
FNOTE_M	备注	string
FBOMID	BOM版本	string
FPRICEQTY_F	计价数量	string
FPRICE_F	单价	string
FPRICECOEFFICIENT_F	价格系数	string
FDISCOUNTRATE_F	折扣率	string
FDISCOUNT_F	折扣额	string
FTAXNETPRICE_F	净价	string
FAMOUNT_F	退料金额	string
FALLAMOUNT_F	退料含税金额	string
FAPPROVEPRICE_F	含税单价	string
FSRCSEQ	源单行号	string
FCONTRACTNO	合同单号	string
FORDERNO	订单单号	string
FREQTRACENO	需求跟踪号	string
FBASEUNITQTY	库存基本数量	string
FBASEUNITID	退料申请基本单位	string
FUNITID	库存单位	string
FPRICEUNITID_F	计价单位	string
FBASEMRJOINQTY	退料关联数量（库存基本）	string
FBASEMRQTY	退料数量(基本单位)	string
FAUXPROPID	辅助属性	string
FSRCBILLNO	源单编号	string
FSRCBILLTYPEID	源单类型	string
FREPLENISHAMOUNT	补料金额	string
FKEAPAMTAMOUNT	扣款金额	string
FLot	批号	string
FRMREASON_M	退料原因	string
FBFLowId	业务流程	string
FMtoNo	计划跟踪号	string
FGiveAway	是否赠品	string
FPriceBaseQty	计价基本数量	string
FPURUNITID	采购单位	string
FPurQty	采购数量	string
FPurBaseQty	采购基本数量	string
FPURBASENUM	采购基本分子	string
FSTOCKBASEDEN	库存基本分母	string
FSRCBIZUNITID	携带的主业务单位	string
FRETURNSTOCKJNBASEQTY	退料关联数量（采购基本）	string
FEntryTaxRate	税率%	string
FENTRYPRICELISTID	分录价目表	string
FPOORDERENTRYID	采购订单分录内码	string
FStockId_Fnumber	仓库	string
FISSYNTOTHIRD	是否同步管易(GY)	string
FRowType	产品类型	string
FPARENTMATID	父项产品	string
FPriceDiscount	单价折扣	string
FSTOCKLOCID	仓位	string
FPriLstEntryId	价目表分录id	string
FEntity_Link_FFlowId	业务流程图	string
FEntity_Link_FFlowLineId	推进路线	string
FEntity_Link_FRuleId	转换规则	string
FEntity_Link_FSTableId	源单表内码	string
FEntity_Link_FSTableName	源单表	string
FEntity_Link_FSBillId	源单内码	string
FEntity_Link_FSId	源单分录内码	string
FEntity_Link_FBASEUNITQTYOld	原始携带量	string
FEntity_Link_FBASEUNITQTY	修改携带量	string
FEntity_Link_FPurBaseQtyOld	原始携带量	string
FEntity_Link_FPurBaseQty	修改携带量	string
FEntity_Link_FLnkTrackerId	迁移图	string
FEntity_Link_FLnkSState	上游状态	string
FEntity_Link_FLnkAmount	数量FLnk	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

响应参数

字段	名称	类型	描述
FEntity_FEntryID	FEntity_FEntryID	string
FBillNo	单据编号	string
FID	FID	string
FDocumentStatus	单据状态	string
FBillTypeID_Fnumber	单据类型	string
FDate	申请日期	string
FPURCHASEORGID_Fnumber	采购组织	string
FRMTYPE	退料类型	string
FAPPORGID_Fnumber	申请组织	string
FAPPDEPTID_Fnumber	申请部门	string
FRMLOC	退料地点	string
FSUPPLIERID_Fnumber	供应商	string
FRMMODE	退料方式	string
FREPLENISHMODE	补料方式	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FAPPROVERID	审核人	string
FAPPROVEDATE	审核日期	string
FCANCELLERID	作废人	string
FCANCELDATE	作废日期	string
FCANCELSTATUS	作废状态	string
FBusinessType	业务类型	string
FRemarks	备注	string
FRMREASON	退料原因	string
FRequireOrgId_Fnumber	需求组织	string
FCorrespondOrgId_Fnumber	对应组织	string
FConfirmerId	确认人	string
FConfirmDate	确认日期	string
FConfirmStatus	确认状态	string
FMATERIALID_Fnumber	物料编码	string
FMaterialName	物料名称	string
FUOM	规格型号	string
FMaterialType	存货类别	string
FMRAPPQTY	申请退料数量	string
FREPLENISHQTY	补料数量	string
FKEAPAMTQTY	扣款数量	string
FMRJOINQTY	退料关联数量	string
FMRQTY	退料数量	string
FNOTE_M	备注	string
FBOMID	BOM版本	string
FPRICEQTY_F	计价数量	string
FPRICE_F	单价	string
FPRICECOEFFICIENT_F	价格系数	string
FDISCOUNTRATE_F	折扣率	string
FDISCOUNT_F	折扣额	string
FTAXNETPRICE_F	净价	string
FAMOUNT_F	退料金额	string
FALLAMOUNT_F	退料含税金额	string
FAPPROVEPRICE_F	含税单价	string
FSRCSEQ	源单行号	string
FCONTRACTNO	合同单号	string
FORDERNO	订单单号	string
FREQTRACENO	需求跟踪号	string
FBASEUNITQTY	库存基本数量	string
FBASEUNITID	退料申请基本单位	string
FUNITID	库存单位	string
FPRICEUNITID_F	计价单位	string
FBASEMRJOINQTY	退料关联数量（库存基本）	string
FBASEMRQTY	退料数量(基本单位)	string
FAUXPROPID	辅助属性	string
FSRCBILLNO	源单编号	string
FSRCBILLTYPEID	源单类型	string
FREPLENISHAMOUNT	补料金额	string
FKEAPAMTAMOUNT	扣款金额	string
FLot	批号	string
FRMREASON_M	退料原因	string
FBFLowId	业务流程	string
FMtoNo	计划跟踪号	string
FGiveAway	是否赠品	string
FPriceBaseQty	计价基本数量	string
FPURUNITID	采购单位	string
FPurQty	采购数量	string
FPurBaseQty	采购基本数量	string
FPURBASENUM	采购基本分子	string
FSTOCKBASEDEN	库存基本分母	string
FSRCBIZUNITID	携带的主业务单位	string
FRETURNSTOCKJNBASEQTY	退料关联数量（采购基本）	string
FEntryTaxRate	税率%	string
FENTRYPRICELISTID	分录价目表	string
FPOORDERENTRYID	采购订单分录内码	string
FStockId_Fnumber	仓库	string
FISSYNTOTHIRD	是否同步管易(GY)	string
FRowType	产品类型	string
FPARENTMATID	父项产品	string
FPriceDiscount	单价折扣	string
FSTOCKLOCID	仓位	string
FPriLstEntryId	价目表分录id	string
FEntity_Link_FFlowId	业务流程图	string
FEntity_Link_FFlowLineId	推进路线	string
FEntity_Link_FRuleId	转换规则	string
FEntity_Link_FSTableId	源单表内码	string
FEntity_Link_FSTableName	源单表	string
FEntity_Link_FSBillId	源单内码	string
FEntity_Link_FSId	源单分录内码	string
FEntity_Link_FBASEUNITQTYOld	原始携带量	string
FEntity_Link_FBASEUNITQTY	修改携带量	string
FEntity_Link_FPurBaseQtyOld	原始携带量	string
FEntity_Link_FPurBaseQty	修改携带量	string
FEntity_Link_FLnkTrackerId	迁移图	string
FEntity_Link_FLnkSState	上游状态	string
FEntity_Link_FLnkAmount	数量FLnk	string

旺店通·旗舰奇门接口明细

• 接口：wdt.purchase.purchasereturn.createorder
• 接口名称：采购退货单新建
• 接口方法：POST

请求参数

字段	名称	类型	描述
orderInfo	采购退货单单据信息	object	采购退货单单据信息
orderInfo.outer_no	外部单号	string	外部单号
orderInfo.warehouse_no	仓库编码	string	仓库编码
orderInfo.provider_no	供应商编号	string	供应商编号
orderInfo.post_fee	邮费	string	邮费
orderInfo.other_fee	其他费用	string	其他费用
orderInfo.contact	联系人	string	联系人（若未传该参数，使用供应商默认的联系人）
orderInfo.telno	联系电话	string	联系电话（若未传该参数，使用供应商默认的电话）
orderInfo.receive_address	收件地址	string	收件地址（当省份、城市、区域、地址字段皆为空时，默认使用供应商的省市区及地址信息）
orderInfo.receive_province	省	string	省编码，可以查看城市代码表
orderInfo.receive_city	市	string	市编码，可以查看城市代码表
orderInfo.receive_district	区	string	区编码，可以查看城市代码表
orderInfo.remark	备注	string	备注
orderInfo.detailList	采购退货单明细信息	array	采购退货单明细信息
orderInfo.detailList.spec_no	单品信息	string	单品信息
orderInfo.detailList.num	退货数量	string	退货数量
orderInfo.detailList.discount	折扣	string	折扣，不传为默认值1
orderInfo.detailList.tax_rate	税率	string	税率，不传默认值0
orderInfo.detailList.price	金额	string	金额，不传为默认值0
orderInfo.detailList.unit_name	基本单位	string	基本单位
orderInfo.detailList.defect	是否残次品	string	是否残次品true:残次品false:正品
orderInfo.detailList.remark	备注	string	备注
orderInfo.detailList.is_check	是否审核	string	是否审核

数据对接价值

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

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