金蝶云星空和聚水潭集成接口设计

金蝶云星空和聚水潭集成接口设计

对接系统金蝶云星空

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

对接目标系统:聚水潭

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

系统对接接口配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：聚水潭，把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：采购入库查询
• METHOD：POST

请求参数

接口字段名称预设值 FInStockEntry_FEntryIdidFInStockEntry_FEntryId FID实体主键FID FBillNo单据编号FBillNo FDocumentStatus单据状态FDocumentStatus FStockOrgId_FNumber收料组织FStockOrgId.FNumber FDate入库日期FDate FBillTypeID_FNumber单据类型FBillTypeID.FNumber FOwnerTypeIdHead货主类型FOwnerTypeIdHead FOwnerIdHead_FNumber货主FOwnerIdHead.FNumber FDemandOrgId_FNumber需求组织FDemandOrgId.FNumber FPurchaseOrgId_FNumber采购组织FPurchaseOrgId.FNumber FSupplierId_FNumber供应商FSupplierId.FNumber FStockerGroupId_FNumber库存组FStockerGroupId.FNumber FStockDeptId_FNumber收料部门FStockDeptId.FNumber FCreateDate创建日期FCreateDate FCancelDate作废日期FCancelDate FDeliveryBill送货单号FDeliveryBill FTakeDeliveryBill提货单号FTakeDeliveryBill FApproveDate审核日期FApproveDate FCancelStatus作废状态FCancelStatus FSupplyId_FNumber供货方FSupplyId.FNumber FSettleId_FNumber结算方FSettleId.FNumber FChargeId_FNumber收款方FChargeId.FNumber FBusinessType业务类型FBusinessType FSupplyAddress供货方地址FSupplyAddress FAPSTATUS应付状态FAPSTATUS FTransferBizType跨组织业务类型FTransferBizType FDisassemblyFlag拆单新单标识FDisassemblyFlag FConfirmDate确认日期FConfirmDate FConfirmStatus确认状态FConfirmStatus FSplitBillType拆单类型FSplitBillType FPayOrgId_FNumber付款组织FPayOrgId.FNumber FSettleOrgId_FNumber结算组织FSettleOrgId.FNumber FSettleCurrId_FNumber结算币别FSettleCurrId.FNumber FBillCost整单费用FBillCost FBillTaxAmount税额FBillTaxAmount FBillCostAmount总成本FBillCostAmount FBillAllAmount价税合计FBillAllAmount FSettleTypeId结算方式FSettleTypeId FExchangeRate汇率FExchangeRate FLocalCurrId_FNumber本位币FLocalCurrId.FNumber FBillAmount金额FBillAmount FIsIncludedTax含税FIsIncludedTax FOwnerCustomerID_FNumber货主客户FOwnerCustomerID.FNumber FSettleSupplierID_FNumber结算组织供应商FSettleSupplierID.FNumber FISGENFORIOS跨组织结算生成FISGENFORIOS FISPRICEEXCLUDETAX价外税FISPRICEEXCLUDETAX FISINVOICEARLIER先到票后入库FISINVOICEARLIER FMaterialId_FNumber物料编码FMaterialId.FNumber FStockId_FNumber仓库FStockId.FNumber FProduceDate生产日期FProduceDate FNote备注FNote FSupplierLot供应商批号FSupplierLot FGrossWeight毛重FGrossWeight FNetWeight净重FNetWeight FContractlNo合同单号FContractlNo F_sms_BaseProperty69码F_sms_BaseProperty FMustQty应收数量FMustQty FRealQty实收数量FRealQty FSRCRowId源单行内码FSRCRowId FExpiryDate有效期至FExpiryDate FIsFree免费FIsFree FStockStatusId库存状态FStockStatusId FBOMIdBOM版本FBOMId FTaxPrice含税单价FTaxPrice FCostPrice成本价FCostPrice FEntryTaxRate税率(%)FEntryTaxRate FEntryTaxAmount税额FEntryTaxAmount FDiscountRate折扣率(%)FDiscountRate FPriceCoefficient价格系数FPriceCoefficient FPriceUnitQty计价数量FPriceUnitQty FTaxNetPrice净价FTaxNetPrice FEntryCostAmount总成本FEntryCostAmount FAllAmount价税合计FAllAmount FStockFlag入库库存更新标志FStockFlag FPOOrderNo订单单号FPOOrderNo FEXPUnit保质期单位FEXPUnit FExpPeriod保质期FExpPeriod FSRCBILLTYPEID源单类型FSRCBILLTYPEID FSRCBillNo源单编号FSRCBillNo FINVOICEDQTY已开票数量FINVOICEDQTY FBaseAPJoinQty关联应付数量（计价基本）FBaseAPJoinQty FReceiveStockFlag收货库存更新标志FReceiveStockFlag FProcessFee加工费FProcessFee FMaterialCosts材料成本FMaterialCosts FLot批号FLot FPrice单价FPrice FAmount金额FAmount FDiscount折扣额FDiscount FReturnJoinQty退料关联数量FReturnJoinQty FBFLowId业务流程FBFLowId FGiveAway是否赠品FGiveAway FWWInType入库类型FWWInType FRowId行标识FRowId Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FPurchaseOrgId.FNumber in('103','104','105','106','107','108','109','110') and FDocumentStatus = 'C' and FCreatorId.Fname not in('Administrator') and FSupplierId.FNumber not in('103','104','105','106','107','108','109','110') FieldKeys需查询的字段key集合 FormId业务对象表单IdSTK_InStock

响应参数

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

聚水潭接口明细

• API：/open/jushuitan/otherinout/upload
• NAME：新建其它出入库（新）
• METHOD：POST

请求参数

接口字段名称预设值 is_confirm是否自动确认单据false wms_co_id分仓编号function left("{{FStockId_FNumber}}",8) type出入库类型: in是入库 out是出库in external_id外部单号{{FBillNo}}cgin{{FDate}} warehouse主仓=1，销退仓=2， 进货仓=3，次品仓 = 4_function right("{{FStockId_FNumber}}",1) remark备注{{FBillNo}} drp_co_name出库类型金蝶采购入库对接 receiver_name收件人姓名 receiver_mobile收件人手机号 receiver_state收件地址省 receiver_city收件地址市 receiver_district收件地址区县 receiver_address收件详细地址 items商品列表items items.sku_id商品编码{{F_sms_BaseProperty}} items.qty数量{{FRealQty}} items.batch_id批次单号，系统中需开启相关配置 items.produced_date生产日期，系统中需开启相关配置 items.expiration_date有效期至，系统中需开启相关配置 items.remark备注

响应参数

接口字段名称预设值 code非0失败 msg错误描述 data返回内容 data.external_id外部单号 data.io_id系统内部单号

系统数据集成价值

使用全界面可视化配置集成流，快速应对企业的集成需求使得金蝶云星空与聚水潭之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。