金蝶云星空与管易云对接集成退料申请查询打通采购退货单新增并审核

对接系统金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

接入系统：管易云

金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。

数据对接方案

数据集成平台对应的配置金蝶云星空与管易云的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与管易云之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星空接口明细

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

请求参数

字段字段名称类型配置值 FBillNo单据编号stringFBillNo FEntity_FEntryIDFEntity_FEntryIDstringFEntity_FEntryID 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 F_mhgj_Base_FNumber仓库stringF_mhgj_Base.FNumber FieldKeys需查询的字段key集合array Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数string FilterString过滤条件stringFAPPROVEDATE>='2022-06-17 00:00:00' and F_mhgj_Base.FNumber = 'A01' or F_mhgj_Base.FNumber = 'A04' FormId业务对象表单IdstringPUR_MRAPP

响应参数

字段字段名称类型配置值 FBillNo单据编号string FEntity_FEntryIDFEntity_FEntryIDstring 实体主键FIDstring FDocumentStatus单据状态string FBillTypeID_Fnumber单据类型string FDate申请日期string FPURCHASEORGID_Fnumber采购组织string FRMTYPE_Fnumber退料类型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 F_mhgj_Base_FNumber仓库string

管易云接口明细

调用接口：gy.erp.purchase.return.add
接口名称：采购退货单新增并审核
方法：POST

请求参数

字段字段名称类型配置值 warehouse_code仓库代码string{{F_mhgj_Base_FNumber}} supplier_code供应商代码string{{FSUPPLIERID_Fnumber}} out_stock_type单据类型代码string ex_cost其他费用string note备注string{{FBillNo}} detail_list商品列表array detail_list.location_code库位代码string detail_list.item_code商品代码string{{FMATERIALID_Fnumber}} detail_list.sku_code商品规格代码string detail_list.qty数量string{{FMRAPPQTY}} detail_list.price实际进价string{{FAPPROVEPRICE_F}} detail_list.note备注string{{FBillNo}}

响应参数

字段字段名称类型配置值 primaryWriteback回写参数object primaryWriteback.codecodestring{{code}}

数据对接效果

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。

金蝶云星空与管易云对接集成退料申请查询打通采购退货单新增并审核