金蝶云星空与旺店通·企业奇门对接集成采购退料查询连通创建采购退料单(退料通知单同步旺店通采购退货单)|轻易云数据集成平台

金蝶云星空与旺店通·企业奇门对接集成采购退料查询连通创建采购退料单(退料通知单同步旺店通采购退货单)

接通系统：金蝶云星空

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

接入系统：旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

数据接口配置方案

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

金蝶云星空接口明细

接口：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.return.push
接口名称：创建采购退料单
接口方法：POST

请求参数

字段	名称	类型	描述
provider_no	供应商编号	string	供应商编号
outer_no	外部单号	string	外部单号
is_check	是否审核	string	1：自动审核0：不自动审核默认0
warehouse_no	出库仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
purchaser_no	关联采购员编号	string	关联采购员编号
logistics_code	货运方式	string	货运方式，物流公司编号
receiver_province	省份	string	省份
receiver_city	城市	string	城市
receiver_district	地区	string	地区
contact	联系人	string	联系人
telno	联系电话	string	联系电话
address	详细地址	string	详细地址
post_fee	邮资	string	邮资
remark	备注	string	备注
prop1	自定义属性1	string	自定义属性1
prop2	自定义属性2	string	自定义属性2
detail_list	明细列表节点	array	请求参数的2级数据节点，包含采购退货单所有货品明细属性信息的数据节点，节点下数据字段详见下述“detail_list”列表
detail_list.spec_no	商家编码	string	代表所单品（sku）所有属性的唯一编码，用于获取系统单品的数据，SKU概念介绍，单击这里
detail_list.num	退货数量	string	退货数量
detail_list.price	单价	string	单价
detail_list.discount	折扣	string	折扣
detail_list.detail_remark	备注	string	备注
detail_list.return_info	采购退货单列表节点	string	请求参数的1级数据节点，包含采购退货单所有属性信息的数据节点，节点下数据字段详见下述“return_info”列表

系统集成总览

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。