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

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

对接系统：金蝶云星空

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

集成系统:旺店通·企业奇门

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

数据接口配置

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

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：采购退料查询
• 方法：POST

请求参数

字段字段名称类型配置值 FEntity_FEntryIDFEntity_FEntryIDstringFEntity_FEntryID FBillNo单据编号stringFBillNo FIDFIDstringFID FDocumentStatus单据状态stringFDocumentStatus FBillTypeID_Fnumber单据类型stringFBillTypeID.Fnumber FDate申请日期stringFDate FPURCHASEORGID_Fnumber采购组织stringFPURCHASEORGID.Fnumber FRMTYPE退料类型stringFRMTYPE FAPPORGID_Fnumber申请组织stringFAPPORGID.Fnumber FAPPDEPTID_Fnumber申请部门stringFAPPDEPTID.Fnumber FRMLOC退料地点stringFRMLOC FSUPPLIERID_Fnumber供应商stringFSUPPLIERID.Fnumber FRMMODE退料方式stringFRMMODE FREPLENISHMODE补料方式stringFREPLENISHMODE FCreatorId创建人stringFCreatorId FCreateDate创建日期stringFCreateDate FModifierId最后修改人stringFModifierId FModifyDate最后修改日期stringFModifyDate FAPPROVERID审核人stringFAPPROVERID FAPPROVEDATE审核日期stringFAPPROVEDATE FCANCELLERID作废人stringFCANCELLERID FCANCELDATE作废日期stringFCANCELDATE FCANCELSTATUS作废状态stringFCANCELSTATUS FBusinessType业务类型stringFBusinessType FRemarks备注stringFRemarks FRMREASON退料原因stringFRMREASON FRequireOrgId_Fnumber需求组织stringFRequireOrgId.Fnumber FCorrespondOrgId_Fnumber对应组织stringFCorrespondOrgId.Fnumber FConfirmerId确认人stringFConfirmerId FConfirmDate确认日期stringFConfirmDate FConfirmStatus确认状态stringFConfirmStatus FMATERIALID_Fnumber物料编码stringFMATERIALID.Fnumber FMaterialName物料名称stringFMaterialName FUOM规格型号stringFUOM FMaterialType存货类别stringFMaterialType FMRAPPQTY申请退料数量stringFMRAPPQTY FREPLENISHQTY补料数量stringFREPLENISHQTY FKEAPAMTQTY扣款数量stringFKEAPAMTQTY FMRJOINQTY退料关联数量stringFMRJOINQTY FMRQTY退料数量stringFMRQTY FNOTE_M备注stringFNOTE_M FBOMIDBOM版本stringFBOMID FPRICEQTY_F计价数量stringFPRICEQTY_F FPRICE_F单价stringFPRICE_F FPRICECOEFFICIENT_F价格系数stringFPRICECOEFFICIENT_F FDISCOUNTRATE_F折扣率stringFDISCOUNTRATE_F FDISCOUNT_F折扣额stringFDISCOUNT_F FTAXNETPRICE_F净价stringFTAXNETPRICE_F FAMOUNT_F退料金额stringFAMOUNT_F FALLAMOUNT_F退料含税金额stringFALLAMOUNT_F FAPPROVEPRICE_F含税单价stringFAPPROVEPRICE_F FSRCSEQ源单行号stringFSRCSEQ FCONTRACTNO合同单号stringFCONTRACTNO FORDERNO订单单号stringFORDERNO FREQTRACENO需求跟踪号stringFREQTRACENO FBASEUNITQTY库存基本数量stringFBASEUNITQTY FBASEUNITID退料申请基本单位stringFBASEUNITID FUNITID库存单位stringFUNITID FPRICEUNITID_F计价单位stringFPRICEUNITID_F FBASEMRJOINQTY退料关联数量（库存基本）stringFBASEMRJOINQTY FBASEMRQTY退料数量(基本单位)stringFBASEMRQTY FAUXPROPID辅助属性stringFAUXPROPID FSRCBILLNO源单编号stringFSRCBILLNO FSRCBILLTYPEID源单类型stringFSRCBILLTYPEID FREPLENISHAMOUNT补料金额stringFREPLENISHAMOUNT FKEAPAMTAMOUNT扣款金额stringFKEAPAMTAMOUNT FLot批号stringFLot FRMREASON_M退料原因stringFRMREASON_M FBFLowId业务流程stringFBFLowId FMtoNo计划跟踪号stringFMtoNo FGiveAway是否赠品stringFGiveAway FPriceBaseQty计价基本数量stringFPriceBaseQty FPURUNITID采购单位stringFPURUNITID FPurQty采购数量stringFPurQty FPurBaseQty采购基本数量stringFPurBaseQty FPURBASENUM采购基本分子stringFPURBASENUM FSTOCKBASEDEN库存基本分母stringFSTOCKBASEDEN FSRCBIZUNITID携带的主业务单位stringFSRCBIZUNITID FRETURNSTOCKJNBASEQTY退料关联数量（采购基本）stringFRETURNSTOCKJNBASEQTY FEntryTaxRate税率%stringFEntryTaxRate FENTRYPRICELISTID分录价目表stringFENTRYPRICELISTID FPOORDERENTRYID采购订单分录内码stringFPOORDERENTRYID FStockId_Fnumber仓库stringFStockId.Fnumber FISSYNTOTHIRD是否同步管易(GY)stringFISSYNTOTHIRD FRowType产品类型stringFRowType FPARENTMATID父项产品stringFPARENTMATID FPriceDiscount单价折扣stringFPriceDiscount FSTOCKLOCID仓位stringFSTOCKLOCID FPriLstEntryId价目表分录idstringFPriLstEntryId FEntity_Link_FFlowId业务流程图stringFEntity_Link_FFlowId FEntity_Link_FFlowLineId推进路线stringFEntity_Link_FFlowLineId FEntity_Link_FRuleId转换规则stringFEntity_Link_FRuleId FEntity_Link_FSTableId源单表内码stringFEntity_Link_FSTableId FEntity_Link_FSTableName源单表stringFEntity_Link_FSTableName FEntity_Link_FSBillId源单内码stringFEntity_Link_FSBillId FEntity_Link_FSId源单分录内码stringFEntity_Link_FSId FEntity_Link_FBASEUNITQTYOld原始携带量stringFEntity_Link_FBASEUNITQTYOld FEntity_Link_FBASEUNITQTY修改携带量stringFEntity_Link_FBASEUNITQTY FEntity_Link_FPurBaseQtyOld原始携带量stringFEntity_Link_FPurBaseQtyOld FEntity_Link_FPurBaseQty修改携带量stringFEntity_Link_FPurBaseQty FEntity_Link_FLnkTrackerId迁移图stringFEntity_Link_FLnkTrackerId FEntity_Link_FLnkSState上游状态stringFEntity_Link_FLnkSState FEntity_Link_FLnkAmount数量FLnkstringFEntity_Link_FLnkAmount Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FPURCHASEORGID.Fnumber='106' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringPUR_MRAPP

响应参数

字段字段名称类型配置值 FEntity_FEntryIDFEntity_FEntryIDstring FBillNo单据编号string FIDFIDstring 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 FBOMIDBOM版本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价目表分录idstring 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数量FLnkstring

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

• API：wdt.purchase.return.push
• NAME：创建采购退料单
• METHOD：POST

请求参数

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

数据对接价值

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