金蝶云星空与巨益OMS对接集成采购退料查询打通退换货单创建|轻易云数据集成平台

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

接通系统：金蝶云星空

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

对接系统：巨益OMS

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

数据接口配置

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

金蝶云星空接口明细

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

请求参数

字段	名称	类型	描述
FPURMRBENTRY_FEntryID	明细信息ID	string
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	第三方单据ID	string
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
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

响应参数

字段	名称	类型	描述
FPURMRBENTRY_FEntryID	明细信息ID	string
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	第三方单据ID	string
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

请求参数

字段	名称	类型	描述
orderCode	orderCode	string	orderCode
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.outBizCode	outBizCode	string	outBizCode
orderLines.outCode	outCode	string	outCode
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.returnOrderCode	ERP的退货入库单编码	string	ERP的退货入库单编码,示例值(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服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。