金蝶云星空与巨益OMS对接集成采购退料查询打通退换货单创建

来源系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

接入系统：巨益OMS

深圳市巨益科技开发有限公司(巨益科技)2013年成立于深圳，专注为中大型零售品牌企业提供全渠道电商中台服务，经过7年多时间的业务沉淀，已助力超过1000+年销售额过亿的行业TOP品牌实现数字化转型，服务口碑获得了客户的一致好评。截至目前，巨益科技服务客户类目涉及服装配饰、数码家电、化妆品、眼镜珠宝、食品保健、母婴用品等十三大行业，并凭借行业领先的中台服务案例先后荣获阿里、京东等平台颁发的“年度十佳服务商”、“京卓越金奖”、“订单压测TOP1”等荣誉奖项。

数据接口配置方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的采购退料查询作为数据对接来源。然后再通过写入目标平台配置目标系统为巨益OMS,并且选择对应连接器（关于巨益OMS的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的退换货单创建接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星空接口明细

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

请求参数

字段字段名称类型配置值 FPURMRBENTRY_FEntryID明细信息IDstringFPURMRBENTRY_FEntryID FID实体主键stringFID FBillNo单据编号stringFBillNo FDocumentStatus单据状态stringFDocumentStatus FStockOrgId_FNumber退料组织stringFStockOrgId.FNumber FDate退料日期stringFDate FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FTAKEDELIVERYNO提货单号stringFTAKEDELIVERYNO FSupplierID_FNumber供应商stringFSupplierID.FNumber FDESCRIPTION备注stringFDESCRIPTION FCarrierID_FNumber承运商stringFCarrierID.FNumber FDELIVERYNO送货单号stringFDELIVERYNO FPurchaseOrgId_FNumber采购组织stringFPurchaseOrgId.FNumber FMRTYPE退料类型stringFMRTYPE FMRMODE退料方式stringFMRMODE FMRREASON退料原因stringFMRREASON FREPLENISHMODE补料方式stringFREPLENISHMODE FCreateDate创建日期stringFCreateDate FModifyDate最后修改日期stringFModifyDate FApproveDate审核日期stringFApproveDate FCreatorId创建人stringFCreatorId FApproverId审核人stringFApproverId FCancelerId作废人stringFCancelerId FCancelDate作废日期stringFCancelDate FCARRYNO运输单号stringFCARRYNO FCancelStatus作废状态stringFCancelStatus FACCEPTORID_FNumber接收方stringFACCEPTORID.FNumber FSettleId_FNumber结算方stringFSettleId.FNumber FBusinessType业务类型stringFBusinessType FAcceptAddress接收方地址stringFAcceptAddress FCHARGEID_FNumber收款方stringFCHARGEID.FNumber FAPSTATUS应付状态stringFAPSTATUS FTransferBizType跨组织业务类型stringFTransferBizType FCorrespondOrgId_FNumber对应组织stringFCorrespondOrgId.FNumber FSupplyOrderNo订单号stringFSupplyOrderNo FPayOrgId_FNumber付款组织stringFPayOrgId.FNumber FSettleOrgId_FNumber结算组织stringFSettleOrgId.FNumber FSETTLETYPEID_FNumber结算方式stringFSETTLETYPEID.FNumber FPAYCONDITIONID_FNumber付款条件stringFPAYCONDITIONID.FNumber FSettleCurrId_FNumber结算币别stringFSettleCurrId.FNumber FBILLTAXAMOUNT税额stringFBILLTAXAMOUNT FBILLCOSTAMOUNT总成本stringFBILLCOSTAMOUNT FBILLALLAMOUNT价税合计stringFBILLALLAMOUNT FEXCHANGETYPEID_FNumber汇率类型stringFEXCHANGETYPEID.FNumber FIsIncludedTax含税stringFIsIncludedTax FBillAmount金额stringFBillAmount FISGENFORIOS跨组织结算生成stringFISGENFORIOS FSettleSupplierID_FNumber结算组织供应商stringFSettleSupplierID.FNumber FISPRICEEXCLUDETAX价外税stringFISPRICEEXCLUDETAX FISINVOICEARLIER先到票后入库stringFISINVOICEARLIER FTHIRDSRCTYPE第三方来源stringFTHIRDSRCTYPE FTHIRDBILLID第三方单据IDstringFTHIRDBILLID FTHIRDBILLNO第三方单据编号stringFTHIRDBILLNO FMATERIALID_FNumber物料编码stringFMATERIALID.FNumber FREPLENISHQTY补料数量stringFREPLENISHQTY FKEAPAMTQTY扣款数量stringFKEAPAMTQTY FSTOCKID_FNumber仓库stringFSTOCKID.FNumber FStockStatusId库存状态stringFStockStatusId FNOTE备注stringFNOTE FProduceDate生产日期stringFProduceDate FEXPIRYDATE到期日stringFEXPIRYDATE FCONTRACTNO合同单号stringFCONTRACTNO FREQTRACENO需求跟踪号stringFREQTRACENO FORDERNO订单单号stringFORDERNO FPRICEUNITQTY计价数量stringFPRICEUNITQTY FCostPrice成本价stringFCostPrice FTAXPRICE含税单价stringFTAXPRICE FDISCOUNTRATE折扣率(%)stringFDISCOUNTRATE FTAXNETPRICE净价stringFTAXNETPRICE FENTRYCOSTAMOUNT总成本stringFENTRYCOSTAMOUNT FENTRYTAXRATE税率stringFENTRYTAXRATE FENTRYTAXAMOUNT税额stringFENTRYTAXAMOUNT FALLAMOUNT价税合计stringFALLAMOUNT FOWNERID_FNumber货主stringFOWNERID.FNumber FJOINQTY关联数量stringFJOINQTY FRMREALQTY实退数量stringFRMREALQTY FRMMUSTQTY应退数量stringFRMMUSTQTY FSTOCKLOCID仓位stringFSTOCKLOCID FSRCBillTypeId源单类型stringFSRCBillTypeId FSRCBillNo源单编号stringFSRCBillNo FLot批号stringFLot FPrice单价stringFPrice FAmount金额stringFAmount FDiscount折扣额stringFDiscount FBFLowId业务流程stringFBFLowId FSRCSeq源单行号stringFSRCSeq FMtoNo计划跟踪号stringFMtoNo FIsStock是否可库存stringFIsStock FGiveAway是否赠品stringFGiveAway FRowId行标识stringFRowId FParentRowId父行标识stringFParentRowId FBarcode零售条形码stringFBarcode FPRICEUNITID计价单位stringFPRICEUNITID FUnitID库存单位stringFUnitID FCarryUnitId采购单位stringFCarryUnitId FCarryQty采购数量stringFCarryQty Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringPUR_MRB

响应参数

字段字段名称类型配置值 FPURMRBENTRY_FEntryID明细信息IDstring FID实体主键string FBillNo单据编号string FDocumentStatus单据状态string FStockOrgId_FNumber退料组织string FDate退料日期string FBillTypeID_FNumber单据类型string FTAKEDELIVERYNO提货单号string FSupplierID_FNumber供应商string FDESCRIPTION备注string FCarrierID_FNumber承运商string FDELIVERYNO送货单号string FPurchaseOrgId_FNumber采购组织string FMRTYPE退料类型string FMRMODE退料方式string FMRREASON退料原因string FREPLENISHMODE补料方式string FCreateDate创建日期string FModifyDate最后修改日期string FApproveDate审核日期string FCreatorId创建人string FApproverId审核人string FCancelerId作废人string FCancelDate作废日期string FCARRYNO运输单号string FCancelStatus作废状态string FACCEPTORID_FNumber接收方string FSettleId_FNumber结算方string FBusinessType业务类型string FAcceptAddress接收方地址string FCHARGEID_FNumber收款方string FAPSTATUS应付状态string FTransferBizType跨组织业务类型string FCorrespondOrgId_FNumber对应组织string FSupplyOrderNo订单号string FPayOrgId_FNumber付款组织string FSettleOrgId_FNumber结算组织string FSETTLETYPEID_FNumber结算方式string FPAYCONDITIONID_FNumber付款条件string FSettleCurrId_FNumber结算币别string FBILLTAXAMOUNT税额string FBILLCOSTAMOUNT总成本string FBILLALLAMOUNT价税合计string FEXCHANGETYPEID_FNumber汇率类型string FIsIncludedTax含税string FBillAmount金额string FISGENFORIOS跨组织结算生成string FSettleSupplierID_FNumber结算组织供应商string FISPRICEEXCLUDETAX价外税string FISINVOICEARLIER先到票后入库string FTHIRDSRCTYPE第三方来源string FTHIRDBILLID第三方单据IDstring FTHIRDBILLNO第三方单据编号string FMATERIALID_FNumber物料编码string FREPLENISHQTY补料数量string FKEAPAMTQTY扣款数量string FSTOCKID_FNumber仓库string FStockStatusId库存状态string FNOTE备注string FProduceDate生产日期string FEXPIRYDATE到期日string FCONTRACTNO合同单号string FREQTRACENO需求跟踪号string FORDERNO订单单号string FPRICEUNITQTY计价数量string FCostPrice成本价string FTAXPRICE含税单价string FDISCOUNTRATE折扣率(%)string FTAXNETPRICE净价string FENTRYCOSTAMOUNT总成本string FENTRYTAXRATE税率string FENTRYTAXAMOUNT税额string FALLAMOUNT价税合计string FOWNERID_FNumber货主string FJOINQTY关联数量string FRMREALQTY实退数量string FRMMUSTQTY应退数量string FSTOCKLOCID仓位string FSRCBillTypeId源单类型string FSRCBillNo源单编号string FLot批号string FPrice单价string FAmount金额string FDiscount折扣额string FBFLowId业务流程string FSRCSeq源单行号string FMtoNo计划跟踪号string FIsStock是否可库存string FGiveAway是否赠品string FRowId行标识string FParentRowId父行标识string FBarcode零售条形码string FPRICEUNITID计价单位string FUnitID库存单位string FCarryUnitId采购单位string FCarryQty采购数量string

巨益OMS接口明细

接口：returnorder.create
接口名称：退换货单创建
接口方法：POST

请求参数

字段名称类型描述 orderCodeorderCodestringorderCode orderLines订单信息array订单信息 orderLines.batchCode批次编码string批次编码,示例值(P123) orderLines.expireDate过期日期string过期日期(YYYY-MM-DD),示例值(2016-09-09) orderLines.inventoryType库存类型string库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP),示例值(ZP) orderLines.itemCode商品编码string商品编码,示例值(I1234) orderLines.itemId仓储系统商品编码string仓储系统商品编码(条件为提供后端（仓储系统）商品编码的仓储系统),示例值(CK1234) orderLines.orderFlag用字符串格式来表示订单标记列表string用字符串格式来表示订单标记列表(比如VISIT^ SELLER_AFFORD^SYNC_RETURN_BILL等;中间用“^{”来隔开订单标记list} (所有字母全部大写) VISIT=上门；SELLER_AFFORD=是否卖家承担运费(默认是)SYNC_RETURN_BILL=同时退回发票),示例值(visit) orderLines.orderLineNo单据行号string单据行号,示例值(D1234) orderLines.ownerCode货主编码string货主编码,示例值(HZ1234) orderLines.planQty应收商品数量string应收商品数量,示例值(12) orderLines.produceCode生产批号string生产批号,示例值(P1234) orderLines.productDate生产日期string生产日期(YYYY-MM-DD),示例值(2016-09-09) orderLines.returnReason退货原因string退货原因,示例值(破损退货) orderLines.sourceOrderCode交易平台订单string交易平台订单,示例值(PD1224) orderLines.subSourceOrderCode交易平台子订单编码string交易平台子订单编码,示例值(PL1234) orderLines.outBizCodeoutBizCodestringoutBizCode orderLines.outCodeoutCodestringoutCode orderLines.returnOrder退货单信息object退货单信息 orderLines.returnOrder.buyerNick买家昵称string买家昵称,示例值(淘宝) orderLines.returnOrder.expressCode运单号string运单号,示例值(YD1234) orderLines.returnOrder.logisticsCode物流公司编码string物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他;只传英文编码),示例值(SF) orderLines.returnOrder.logisticsName物流公司名称string物流公司名称,示例值(顺丰) orderLines.returnOrder.orderFlag1用字符串格式来表示订单标记列表string用字符串格式来表示订单标记列表(比如VISIT^ SELLER_AFFORD^SYNC_RETURN_BILL等;中间用“^{”来隔开订单标记list} (所有字母全部大写) VISIT=上门；SELLER_AFFORD=是否卖家承担运费(默认是)SYNC_RETURN_BILL=同时退回发票),示例值(VISIT) orderLines.returnOrder.orderType单据类型string单据类型(THRK=退货入库;HHRK=换货入库;只传英文编码),示例值(THRK) orderLines.returnOrder.preDeliveryOrderCode原出库单号(ERP分配)string原出库单号(ERP分配),示例值(PD1234) orderLines.returnOrder.preDeliveryOrderId原出库单号(WMS分配)string原出库单号(WMS分配),示例值(PDI1234) orderLines.returnOrder.remark备注信息string备注信息,示例值(备注) orderLines.returnOrder.returnOrderCodeERP的退货入库单编码stringERP的退货入库单编码,示例值(R1234) orderLines.returnOrder.sellerNick卖家名称string卖家名称,示例值(汤姆店铺) orderLines.returnOrder.senderInfo发件人信息object发件人信息 orderLines.returnOrder.senderInfo.area区域string区域,示例值(余杭) orderLines.returnOrder.senderInfo.city城市string城市,示例值(杭州) orderLines.returnOrder.senderInfo.company公司名称string公司名称,示例值(淘宝) orderLines.returnOrder.senderInfo.countryCode国家二字码string国家二字码,示例值(051532) orderLines.returnOrder.senderInfo.detailAddress详细地址string详细地址,示例值(杭州市余杭区989号) orderLines.returnOrder.senderInfo.email电子邮箱string电子邮箱,示例值(345@gmail.com) orderLines.returnOrder.senderInfo.mobile移动电话string移动电话,示例值(13214567869) orderLines.returnOrder.senderInfo.name姓名string姓名,示例值(老王) orderLines.returnOrder.senderInfo.province省份string省份,示例值(浙江省) orderLines.returnOrder.senderInfo.tel固定电话string固定电话,示例值(81020340) orderLines.returnOrder.senderInfo.town村镇string村镇,示例值(横加桥) orderLines.returnOrder.senderInfo.zipCode邮编string邮编,示例值(043300) orderLines.returnOrder.senderInfo.shopNick店铺名称string店铺名称,示例值(汤姆店铺) orderLines.returnOrder.senderInfo.sourcePlatformCode订单来源平台编码string订单来源平台编码, string (50),TB= 淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、OTHERS=其他,示例值(TB) orderLines.returnOrder.senderInfo.sourcePlatformName订单来源平台名称string订单来源平台名称,示例值(淘宝) orderLines.returnOrder.senderInfo.warehouseCode仓库编码string仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER),示例值(W1234)

系统对接概况

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

金蝶云星空与巨益OMS对接集成采购退料查询打通退换货单创建