金蝶云星空对接打通网店管家婆采购入库查询接口与提交进货入库单接口

源系统:金蝶云星空

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

接通系统：网店管家婆

目前网上管家婆已服务超十万家海内外企业级用户，覆盖了服装配饰、食品酒水、数码3C、美妆日护、医疗保健、母婴用品、五金工具等等行业。

数据接口配置方案

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：网店管家婆的映射，即可启动方案进行测试

金蝶云星空接口明细

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 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批号FLot FPrice单价FPrice FAmount金额FAmount FDiscount折扣额FDiscount FReturnJoinQty退料关联数量FReturnJoinQty FBFLowId业务流程FBFLowId FGiveAway是否赠品FGiveAway FWWInType入库类型FWWInType FRowId行标识FRowId FISSale是否允许销售FMaterialId.FIsSale FMaterialId_FName物料名称FMaterialId.FName FBaseUnitID_FNumber基本单位(编码)FBaseUnitID.FNumber FBaseUnitID_FName基本单位(名称)FBaseUnitID.FName FExtAuxUnitId_FNumber辅单位FExtAuxUnitId.FNumber FExtAuxUnitId_FName辅单位(名称)FExtAuxUnitId.FName FMaterialId_FBoxStandardQty单箱标准数量FMaterialId.FBoxStandardQty FLot_FNumber批号FLot.FNumber Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FBillTypeID.FNumber in ('RKD01_SYS','RKD03_SYS') and FMaterialId.FISsale=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物料编码 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批号 FPrice单价 FAmount金额 FDiscount折扣额 FReturnJoinQty退料关联数量 FBFLowId业务流程 FGiveAway是否赠品 FWWInType入库类型 FRowId行标识 FISSale是否允许销售 FMaterialId_FName物料名称 FBaseUnitID_FNumber基本单位(编码) FBaseUnitID_FName基本单位(名称) FExtAuxUnitId_FNumber辅单位(编码) FExtAuxUnitId_FName辅单位(名称) FMaterialId_FBoxStandardQty单箱标准数量 FLot_FNumber批号

网店管家婆接口明细

调用接口：erp.purchasebill.save
接口名称：提交进货入库单
方法：POST

请求参数

字段字段名称类型配置值 purchasebill进货入库单object purchasebill.date创建时间datetime{{FDate}} purchasebill.total单据金额float{{FAllAmount}} purchasebill.btypeid往来单位idintfindCollection find id from efd80ff2-2b2d-323f-8749-944ebf158d9c where usercode={{FSupplierId_FNumber}} purchasebill.ktypeid仓库idint{{FStockId_FNumber}} purchasebill.etypeid经手人idint purchasebill.deptid部门idint purchasebill.comment附加说明string来自金蝶采购入库单，API推送，对应单据号({{FBillNo}}) purchasebill.details明细array purchasebill.details.ptypeid商品idint_findCollection find ptypeid from 31d935d7-371c-364d-8d19-b90feca1222c where usercode={{FMaterialId_FNumber}} purchasebill.details.pfullname商品名称string{{FMaterialId_FNumber}} purchasebill.details.prop1颜色idint purchasebill.details.prop2尺码idint purchasebill.details.unit商品单位string1 purchasebill.details.unitrate单位换算率float1 purchasebill.details.assqty数量float{{FRealQty}} purchasebill.details.assdpprice折前单价float{{FPrice}} purchasebill.details.asstpprice折后单价float{{FPrice}} purchasebill.details.tax税率(%)string{{FEntryTaxRate}} purchasebill.details.batchno批次号string{{FLot_FNumber}}

系统集成总览

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和网店管家婆，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

金蝶云星空对接打通网店管家婆采购入库查询接口与提交进货入库单接口