金蝶云星空对接打通百胜ME3采购入库查询接口与采购入库单明细更新接口

来源系统:金蝶云星空

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

对接目标系统:百胜ME3

通过ME3云中台系统，商品从入库到销售，各个环节通过批号来管理，记录商品的生产日期、到期日、临期日。对于批次管理商品强制要求出库必须与入库的批次对应，不允许负出库的存在。在出库时可选择先进先出或后进先出，系统根据批次策略自动匹配批次号。总之，在整个系统里做到批次清、数量清、质量清、责任清，ME3云中台通过简化批次管理的难度，让商品管理更加便捷、有效。

配置集成方案

通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为百胜ME3，并且选择对应连接器。选择好对应的pms.spjhd.mx_update接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：采购入库查询
方法：POST

请求参数

字段字段名称类型配置值 FInStockEntry_FEntryIdidstringFInStockEntry_FEntryId FID实体主键stringFID FBillNo单据编号stringFBillNo FDocumentStatus单据状态stringFDocumentStatus FStockOrgId_FNumber收料组织stringFStockOrgId.FNumber FDate入库日期stringFDate FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FOwnerTypeIdHead货主类型stringFOwnerTypeIdHead FOwnerIdHead_FNumber货主stringFOwnerIdHead.FNumber FDemandOrgId_FNumber需求组织stringFDemandOrgId.FNumber FPurchaseOrgId_FNumber采购组织stringFPurchaseOrgId.FNumber FSupplierId_FNumber供应商stringFSupplierId.FNumber FStockerGroupId_FNumber库存组stringFStockerGroupId.FNumber FStockDeptId_FNumber收料部门stringFStockDeptId.FNumber FCreateDate创建日期stringFCreateDate FCancelDate作废日期stringFCancelDate FDeliveryBill送货单号stringFDeliveryBill FTakeDeliveryBill提货单号stringFTakeDeliveryBill FApproveDate审核日期stringFApproveDate FCancelStatus作废状态stringFCancelStatus FSupplyId_FNumber供货方stringFSupplyId.FNumber FSettleId_FNumber结算方stringFSettleId.FNumber FChargeId_FNumber收款方stringFChargeId.FNumber FBusinessType业务类型stringFBusinessType FSupplyAddress供货方地址stringFSupplyAddress FAPSTATUS应付状态stringFAPSTATUS FTransferBizType跨组织业务类型stringFTransferBizType FDisassemblyFlag拆单新单标识stringFDisassemblyFlag FConfirmDate确认日期stringFConfirmDate FConfirmStatus确认状态stringFConfirmStatus FSplitBillType拆单类型stringFSplitBillType FPayOrgId_FNumber付款组织stringFPayOrgId.FNumber FSettleOrgId_FNumber结算组织stringFSettleOrgId.FNumber FSettleCurrId_FNumber结算币别stringFSettleCurrId.FNumber FBillCost整单费用stringFBillCost FBillTaxAmount税额stringFBillTaxAmount FBillCostAmount总成本stringFBillCostAmount FBillAllAmount价税合计stringFBillAllAmount FSettleTypeId结算方式stringFSettleTypeId FExchangeRate汇率stringFExchangeRate FLocalCurrId_FNumber本位币stringFLocalCurrId.FNumber FBillAmount金额stringFBillAmount FIsIncludedTax含税stringFIsIncludedTax FOwnerCustomerID_FNumber货主客户stringFOwnerCustomerID.FNumber FSettleSupplierID_FNumber结算组织供应商stringFSettleSupplierID.FNumber FISGENFORIOS跨组织结算生成stringFISGENFORIOS FISPRICEEXCLUDETAX价外税stringFISPRICEEXCLUDETAX FISINVOICEARLIER先到票后入库stringFISINVOICEARLIER FMaterialId_FNumber物料编码stringFMaterialId.FNumber FStockId_FNumber仓库stringFStockId.FNumber FProduceDate生产日期stringFProduceDate FNote备注stringFNote FSupplierLot供应商批号stringFSupplierLot FGrossWeight毛重stringFGrossWeight FNetWeight净重stringFNetWeight FContractlNo合同单号stringFContractlNo FReqTraceNo需求跟踪号stringFReqTraceNo FMustQty应收数量stringFMustQty FRealQty实收数量stringFRealQty FSRCRowId源单行内码stringFSRCRowId FExpiryDate有效期至stringFExpiryDate FIsFree免费stringFIsFree FStockStatusId库存状态stringFStockStatusId FBOMIdBOM版本stringFBOMId FTaxPrice含税单价stringFTaxPrice FCostPrice成本价stringFCostPrice FEntryTaxRate税率(%)stringFEntryTaxRate FEntryTaxAmount税额stringFEntryTaxAmount FDiscountRate折扣率(%)stringFDiscountRate FPriceCoefficient价格系数stringFPriceCoefficient FPriceUnitQty计价数量stringFPriceUnitQty FTaxNetPrice净价stringFTaxNetPrice FEntryCostAmount总成本stringFEntryCostAmount FAllAmount价税合计stringFAllAmount FStockFlag入库库存更新标志stringFStockFlag FPOOrderNo订单单号stringFPOOrderNo FEXPUnit保质期单位stringFEXPUnit FExpPeriod保质期stringFExpPeriod FSRCBILLTYPEID源单类型stringFSRCBILLTYPEID FSRCBillNo源单编号stringFSRCBillNo FINVOICEDQTY已开票数量stringFINVOICEDQTY FBaseAPJoinQty关联应付数量（计价基本）stringFBaseAPJoinQty FReceiveStockFlag收货库存更新标志stringFReceiveStockFlag FProcessFee加工费stringFProcessFee FMaterialCosts材料成本stringFMaterialCosts FLot批号stringFLot FPrice单价stringFPrice FAmount金额stringFAmount FDiscount折扣额stringFDiscount FReturnJoinQty退料关联数量stringFReturnJoinQty FBFLowId业务流程stringFBFLowId FGiveAway是否赠品stringFGiveAway FWWInType入库类型stringFWWInType FRowId行标识stringFRowId Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSTK_InStock

响应参数

字段字段名称类型配置值 FInStockEntry_FEntryIdidstring FID实体主键string FBillNo单据编号string FDocumentStatus单据状态string FStockOrgId_FNumber收料组织string FDate入库日期string FBillTypeID_FNumber单据类型string FOwnerTypeIdHead货主类型string FOwnerIdHead_FNumber货主string FDemandOrgId_FNumber需求组织string FPurchaseOrgId_FNumber采购组织string FSupplierId_FNumber供应商string FStockerGroupId_FNumber库存组string FStockDeptId_FNumber收料部门string FCreateDate创建日期string FCancelDate作废日期string FDeliveryBill送货单号string FTakeDeliveryBill提货单号string FApproveDate审核日期string FCancelStatus作废状态string FSupplyId_FNumber供货方string FSettleId_FNumber结算方string FChargeId_FNumber收款方string FBusinessType业务类型string FSupplyAddress供货方地址string FAPSTATUS应付状态string FTransferBizType跨组织业务类型string FDisassemblyFlag拆单新单标识string FConfirmDate确认日期string FConfirmStatus确认状态string FSplitBillType拆单类型string FPayOrgId_FNumber付款组织string FSettleOrgId_FNumber结算组织string FSettleCurrId_FNumber结算币别string FBillCost整单费用string FBillTaxAmount税额string FBillCostAmount总成本string FBillAllAmount价税合计string FSettleTypeId结算方式string FExchangeRate汇率string FLocalCurrId_FNumber本位币string FBillAmount金额string FIsIncludedTax含税string FOwnerCustomerID_FNumber货主客户string FSettleSupplierID_FNumber结算组织供应商string FISGENFORIOS跨组织结算生成string FISPRICEEXCLUDETAX价外税string FISINVOICEARLIER先到票后入库string FMaterialId_FNumber物料编码string FStockId_FNumber仓库string FProduceDate生产日期string FNote备注string FSupplierLot供应商批号string FGrossWeight毛重string FNetWeight净重string FContractlNo合同单号string FReqTraceNo需求跟踪号string FMustQty应收数量string FRealQty实收数量string FSRCRowId源单行内码string FExpiryDate有效期至string FIsFree免费string FStockStatusId库存状态string FBOMIdBOM版本string FTaxPrice含税单价string FCostPrice成本价string FEntryTaxRate税率(%)string FEntryTaxAmount税额string FDiscountRate折扣率(%)string FPriceCoefficient价格系数string FPriceUnitQty计价数量string FTaxNetPrice净价string FEntryCostAmount总成本string FAllAmount价税合计string FStockFlag入库库存更新标志string FPOOrderNo订单单号string FEXPUnit保质期单位string FExpPeriod保质期string FSRCBILLTYPEID源单类型string FSRCBillNo源单编号string FINVOICEDQTY已开票数量string FBaseAPJoinQty关联应付数量（计价基本）string FReceiveStockFlag收货库存更新标志string FProcessFee加工费string FMaterialCosts材料成本string FLot批号string FPrice单价string FAmount金额string FDiscount折扣额string FReturnJoinQty退料关联数量string FBFLowId业务流程string FGiveAway是否赠品string FWWInType入库类型string FRowId行标识string

百胜ME3接口明细

接口：pms.spjhd.mx_update
接口名称：采购入库单明细更新
接口方法：GET

请求参数

字段名称类型 record_code采购入库单号string num数量string detail明细array update_mode明细数量更新方式string barcode条码string

响应参数

字段名称类型描述 record_code单据编号string total_num总数量string detail明细array detail.goods_code商品代码string detail.goods_name商品名称string detail.商品规格goods_specstring detail.barcode商品条码string detail.scan_barcode传入\扫描条码string detail.num商品数量string

系统对接总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。