从金蝶云星空到聚水潭通过接口配置打通数据

接通系统：金蝶云星空

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

目标系统:聚水潭

聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的采购入库查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为聚水潭，并且选择对应连接器。选择对应的新建其它出入库（新）接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

调用接口：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 F_sms_BaseProperty69码stringF_sms_BaseProperty 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}}' and FPurchaseOrgId.FNumber in('103','104','105','106','107','108','109','110') and FDocumentStatus = 'C' 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 F_sms_BaseProperty69码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

聚水潭接口明细

接口：/open/jushuitan/otherinout/upload
接口名称：新建其它出入库（新）
接口方法：POST

请求参数

字段名称类型描述 is_confirm是否自动确认单据string是否自动确认单据 wms_co_id分仓编号string分仓编号 type出入库类型: in是入库 out是出库string出入库类型: in是入库 out是出库 external_id外部单号string外部单号 warehouse主仓=1，销退仓=2，进货仓=3，次品仓 = 4string主仓=1，销退仓=2，进货仓=3，次品仓 = 4 remark备注string备注 drp_co_name出库类型string出库类型 receiver_name收件人姓名string收件人姓名 receiver_mobile收件人手机号string收件人手机号 receiver_state收件地址省string收件地址省 receiver_city收件地址市string收件地址市 receiver_district收件地址区县string收件地址区县 receiver_address收件详细地址string收件详细地址 items商品列表array商品列表 items.sku_id商品编码string商品编码 items.qty数量string数量 items.batch_id批次单号，系统中需开启相关配置string批次单号，系统中需开启相关配置 items.produced_date生产日期，系统中需开启相关配置string生产日期，系统中需开启相关配置 items.expiration_date有效期至，系统中需开启相关配置string有效期至，系统中需开启相关配置 items.remark备注string备注

响应参数

字段名称类型描述 code非0失败string非0失败 msg错误描述string错误描述 data返回内容array返回内容 data.external_id外部单号string外部单号 data.io_id系统内部单号string系统内部单号

数据对接效果

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

从金蝶云星空到聚水潭通过接口配置打通数据