金蝶云星空与管易云对接集成委外退料单连通其他入库单新增完结接口v2(管易--委外退料对接其他入)

对接源平台:金蝶云星空

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

目标系统:管易云

管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品

数据集成方案配置

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

金蝶云星空接口明细

接口：executeBillQuery
接口名称：委外退料单
接口方法：POST

请求参数

字段名称类型描述 Fentity_FEntryIDFentity_FEntryIDstringFentity_FEntryID FBillNo单据编号string单据编号 FDocumentStatus单据状态string单据状态 FApproverId审核人string审核人 FApproveDate审核日期string审核日期 FModifierId修改人string修改人 FCreateDate创建日期string创建日期 FCreatorId创建人string创建人 FModifyDate修改日期string修改日期 FCancelDate作废日期string作废日期 FCanceler作废人string作废人 FCancelStatus作废状态string作废状态 FDescription备注string备注 FBillType单据类型string单据类型 FStockOrgId收料组织string收料组织 FOwnerId0货主string货主 FStockId0仓库string仓库 Fdate日期string日期 FSubOrgId委外组织string委外组织 FSubSupplierId供应商string供应商 FOwnerTypeId0货主类型string货主类型 FCurrId本位币string本位币 FTransferBizType跨组织业务类型string跨组织业务类型 FSTOCKERID仓管员string仓管员 FReturnerId退料人string退料人 FIsCrossTrade跨法人交易string跨法人交易 FVmiBusinessVMI业务stringVMI业务 FSourceType倒冲来源string倒冲来源 FIsOwnerTInclOrg货主含组织string货主含组织 FMaterialId物料编码string物料编码 FPPBOMEntryId委外用料清单分录IDstring委外用料清单分录ID FMaterialName物料名称string物料名称 FSpecification规格型号string规格型号 FUnitID单位string单位 FBomIdBOM版本stringBOM版本 FAPPQty申请数量string申请数量 FQty实退数量string实退数量 FSelRePickedQty补料选单数string补料选单数 FReturnType退料类型string退料类型 FReturnReason退料原因string退料原因 FStockId_FNumber仓库string仓库 FStockLocId仓位string仓位 FSUBReqBillNo委外订单string委外订单 FSUBReqId委外订单IDstring委外订单ID FSUBReqEntrySeq委外订单行号string委外订单行号 FSubReqEntryId委外订单分录IDstring委外订单分录ID FAuxPropId辅助属性string辅助属性 FOwnerTypeId货主类型string货主类型 FOwnerId货主string货主 FSrcBillType系统源单类型string系统源单类型 FSrcBillNo系统源单编号string系统源单编号 FSrcBillId系统源单内码string系统源单内码 FSrcEntrySeq系统源单行号string系统源单行号 FSrcEntryId系统源单分录内码string系统源单分录内码 FBaseUnitId基本单位string基本单位 FBaseSelRePickedQty基本单位补料选单数string基本单位补料选单数 FBaseAppQty基本单位申请数量string基本单位申请数量 FBaseQty基本单位实退数量string基本单位实退数量 FStockUnitId主库存单位string主库存单位 FStockAppQty主库存申请数量string主库存申请数量 FStockQty主库存实退数量string主库存实退数量 FSecUnitId辅库存单位string辅库存单位 FSecStockQty辅库存实退数量string辅库存实退数量 FMtoNo计划跟踪号string计划跟踪号 FStockStatusId库存状态string库存状态 FProduceDate生产日期string生产日期 FExpPeriod保质期string保质期 FExpiryDate有效期至string有效期至 FKeeperTypeId保管者类型string保管者类型 FKeeperId保管者string保管者 FOperId工序号string工序号 FProcessId作业string作业 FMemo备注string备注 FPrice成本价string成本价 FAmount总成本string总成本 FStockFlag更新库存标志位string更新库存标志位 FLot批号string批号 FPPBomBillNo委外用料清单编号string委外用料清单编号 FParentOwnerTypeId产品货主类型string产品货主类型 FParentOwnerId产品货主string产品货主 FSRCBIZBILLTYPE业务源单类型string业务源单类型 FSRCBIZBILLNO业务源单编号string业务源单编号 FSRCBIZINTERID业务源单内码string业务源单内码 FSRCBIZENTRYID业务源单分录内码string业务源单分录内码 FSRCBIZENTRYSEQ业务源单行号string业务源单行号 FBFLowId业务流程string业务流程 FParentMaterialId产品编码string产品编码 FSNUnitID序列号单位string序列号单位 FSNQty序列号单位数量string序列号单位数量 FReserveType预留类型string预留类型 FSettleOrgId结算组织string结算组织 FBaseStockQty主库存基本单位实退数量string主库存基本单位实退数量 FConsome消耗汇总string消耗汇总 FEntryVmiBusinessVMI业务stringVMI业务 FReqSrc需求来源string需求来源 FReqBillNo需求单据string需求单据 FReqBillId需求单据内码string需求单据内码 FReqEntrySeq需求单据行号string需求单据行号 FReqEntryId需求单据分录内码string需求单据分录内码 FPOOrderBillNo采购订单string采购订单 FPOOrderSeq采购订单行号string采购订单行号 FSupplierId供应商string供应商 FIsUpdateQty不更新未领string不更新未领 Limit最大行数string金蝶的查询分页参数 StartRow开始行索引string金蝶的查询分页参数 TopRowCount返回总行数int金蝶的查询分页参数 FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合array金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

字段名称类型描述 Fentity_FEntryIDFentity_FEntryIDstringFentity_FEntryID FBillNo单据编号string单据编号 FDocumentStatus单据状态string单据状态 FApproverId审核人string审核人 FApproveDate审核日期string审核日期 FModifierId修改人string修改人 FCreateDate创建日期string创建日期 FCreatorId创建人string创建人 FModifyDate修改日期string修改日期 FCancelDate作废日期string作废日期 FCanceler作废人string作废人 FCancelStatus作废状态string作废状态 FDescription备注string备注 FBillType单据类型string单据类型 FStockOrgId收料组织string收料组织 FOwnerId0货主string货主 FStockId0仓库string仓库 Fdate日期string日期 FSubOrgId委外组织string委外组织 FSubSupplierId供应商string供应商 FOwnerTypeId0货主类型string货主类型 FCurrId本位币string本位币 FTransferBizType跨组织业务类型string跨组织业务类型 FSTOCKERID仓管员string仓管员 FReturnerId退料人string退料人 FIsCrossTrade跨法人交易string跨法人交易 FVmiBusinessVMI业务stringVMI业务 FSourceType倒冲来源string倒冲来源 FIsOwnerTInclOrg货主含组织string货主含组织 FMaterialId_FNumber物料编码string物料编码 FPPBOMEntryId委外用料清单分录IDstring委外用料清单分录ID FMaterialName物料名称string物料名称 FSpecification规格型号string规格型号 FUnitID单位string单位 FBomIdBOM版本stringBOM版本 FAPPQty申请数量string申请数量 FQty实退数量string实退数量 FSelRePickedQty补料选单数string补料选单数 FReturnType退料类型string退料类型 FReturnReason退料原因string退料原因 FStockId_FNumber仓库string仓库 FStockLocId仓位string仓位 FSUBReqBillNo委外订单string委外订单 FSUBReqId委外订单IDstring委外订单ID FSUBReqEntrySeq委外订单行号string委外订单行号 FSubReqEntryId委外订单分录IDstring委外订单分录ID FAuxPropId辅助属性string辅助属性 FOwnerTypeId货主类型string货主类型 FOwnerId货主string货主 FSrcBillType系统源单类型string系统源单类型 FSrcBillNo系统源单编号string系统源单编号 FSrcBillId系统源单内码string系统源单内码 FSrcEntrySeq系统源单行号string系统源单行号 FSrcEntryId系统源单分录内码string系统源单分录内码 FBaseUnitId基本单位string基本单位 FBaseSelRePickedQty基本单位补料选单数string基本单位补料选单数 FBaseAppQty基本单位申请数量string基本单位申请数量 FBaseQty基本单位实退数量string基本单位实退数量 FStockUnitId主库存单位string主库存单位 FStockAppQty主库存申请数量string主库存申请数量 FStockQty主库存实退数量string主库存实退数量 FSecUnitId辅库存单位string辅库存单位 FSecStockQty辅库存实退数量string辅库存实退数量 FMtoNo计划跟踪号string计划跟踪号 FStockStatusId库存状态string库存状态 FProduceDate生产日期string生产日期 FExpPeriod保质期string保质期 FExpiryDate有效期至string有效期至 FKeeperTypeId保管者类型string保管者类型 FKeeperId保管者string保管者 FOperId工序号string工序号 FProcessId作业string作业 FMemo备注string备注 FPrice成本价string成本价 FAmount总成本string总成本 FStockFlag更新库存标志位string更新库存标志位 FLot批号string批号 FPPBomBillNo委外用料清单编号string委外用料清单编号 FParentOwnerTypeId产品货主类型string产品货主类型 FParentOwnerId产品货主string产品货主 FSRCBIZBILLTYPE业务源单类型string业务源单类型 FSRCBIZBILLNO业务源单编号string业务源单编号 FSRCBIZINTERID业务源单内码string业务源单内码 FSRCBIZENTRYID业务源单分录内码string业务源单分录内码 FSRCBIZENTRYSEQ业务源单行号string业务源单行号 FBFLowId业务流程string业务流程 FParentMaterialId产品编码string产品编码 FSNUnitID序列号单位string序列号单位 FSNQty序列号单位数量string序列号单位数量 FReserveType预留类型string预留类型 FSettleOrgId结算组织string结算组织 FBaseStockQty主库存基本单位实退数量string主库存基本单位实退数量 FConsome消耗汇总string消耗汇总 FEntryVmiBusinessVMI业务stringVMI业务 FReqSrc需求来源string需求来源 FReqBillNo需求单据string需求单据 FReqBillId需求单据内码string需求单据内码 FReqEntrySeq需求单据行号string需求单据行号 FReqEntryId需求单据分录内码string需求单据分录内码 FPOOrderBillNo采购订单string采购订单 FPOOrderSeq采购订单行号string采购订单行号 FSupplierId供应商string供应商 FIsUpdateQty不更新未领string不更新未领

管易云接口明细

调用接口：gy.erp.stock.other.in.add
接口名称：其他入库单新增完结接口v2
方法：POST

请求参数

字段字段名称类型配置值 warehouse_code仓库代码string{{FStockId_FNumber}} type入库类型代码string note备注string委外退料单{{FBillNo}}{{FStockId_FNumber}} details入库明细arraydetails details.item_code商品代码string{{details.FMaterialId_FNumber}} details.sku_code规格代码string{{details.FMaterialId_FNumber}} details.barcode商品条码string details.qty数量string{{details.FQty}} details.uniqueCode唯一码string details.batchNumber批次号string details.manufacturingDate生产日期string details.shelfLife有效期string details.stockDate入库日期string details.wms_bizcode第三方系统单号string{{FBillNo}}{{FStockId_FNumber}}

响应参数

字段字段名称类型配置值 success成功与否string errorCode错误代码string subErrorCode子错误代码string errorDesc错误描述string subErrorDesc子错误描述string requestMethod请求方法string code其他入库单单据编号string

系统对接概况

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

金蝶云星空与管易云对接集成委外退料单连通其他入库单新增完结接口v2(管易--委外退料对接其他入)