金蝶云星空对接打通聚水潭采购入库查询接口与新增采购入库接口

对接系统金蝶云星空

金蝶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个城镇，为客户提供及时、周到和专业的服务。

数据对接方案

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

金蝶云星空接口明细

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 FMaterialId_FBARCODE条码FMaterialId.FBARCODE FStockId_FNumber仓库FStockId.FNumber FProduceDate生产日期FProduceDate FNote备注FNote FSupplierLot供应商批号FSupplierLot FGrossWeight毛重FGrossWeight FNetWeight净重FNetWeight FContractlNo合同单号FContractlNo FReqTraceNo需求跟踪号FReqTraceNo 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_FNumber批号FLot.FNumber FPrice单价FPrice FAmount金额FAmount FDiscount折扣额FDiscount FReturnJoinQty退料关联数量FReturnJoinQty FBFLowId业务流程FBFLowId FGiveAway是否赠品FGiveAway FWWInType入库类型FWWInType FRowId行标识FRowId FStockId_FGROUP仓库分组FStockId.FGROUP Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FStockId.FGROUP='现货仓库' AND FISGENFORIOS != 1示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdSTK_InStock必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 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物料编码 FMaterialId_FBARCODE条码 FStockId_FNumber仓库 FProduceDate生产日期 FNote备注 FSupplierLot供应商批号 FGrossWeight毛重 FNetWeight净重 FContractlNo合同单号 FReqTraceNo需求跟踪号 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_FNumber批号 FPrice单价 FAmount金额 FDiscount折扣额 FReturnJoinQty退料关联数量 FBFLowId业务流程 FGiveAway是否赠品 FWWInType入库类型 FRowId行标识 FStockId_FGROUP仓库名称

聚水潭接口明细

接口：jushuitan.purchasein.upload
接口名称：新增采购入库
接口方法：POST

请求参数

字段名称类型描述 is_confirm是否自动确认单据string wms_co_id分仓编号string supplier_id供应商string po_id采购单号string external_id外部单号string remark备注string tax_rate税率string co_id货主仓库编号string items商品列表array items.sku_idSKUstring items.qty数量string items.price单价string items.batch_id批次号string items.produced_date生产日期string items.expiration_date有效期至string items.remark备注string

数据对接效果

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与聚水潭之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

金蝶云星空对接打通聚水潭采购入库查询接口与新增采购入库接口