从金蝶云星空到旺店通·企业版通过接口配置打通数据

从金蝶云星空到旺店通·企业版通过接口配置打通数据

接入系统：金蝶云星空

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

对接目标平台:旺店通·企业版

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

多系统对接方案配置

数据集成平台对应的配置金蝶云星空与旺店通·企业版的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与旺店通·企业版之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：应收单查询1
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FID实体主键FID FBillNo单据编号FBillNo FDocumentStatus单据状态FDocumentStatus FRelateHadPayAmount表头基本 - 收（退）款单的关联金额FRelateHadPayAmount FDATE业务日期FDATE FSETTLEORGID结算组织FSETTLEORGID FNOTWRITTENOFFAMOUNTFOR表头基本 -未收款核销金额（作废）FNOTWRITTENOFFAMOUNTFOR FCURRENCYID币别FCURRENCYID FBillTypeID单据类型FBillTypeID FModifierId修改人FModifierId FAPPROVEDATE审核日期FAPPROVEDATE FCreateDate创建日期FCreateDate FModifyDate修改日期FModifyDate FAPPROVERID审核人FAPPROVERID FWRITTENOFFSTATUS表头基本 - 收款核销状态FWRITTENOFFSTATUS FOPENSTATUS表头基本 - 开票核销状态FOPENSTATUS FCreatorId创建人FCreatorId FALLAMOUNTFOR价税合计FALLAMOUNTFOR FENDDATE_H到期日FENDDATE_H FOWNERTYPE货主类型FOWNERTYPE FOWNERID货主FOWNERID FACCOUNTSYSTEM会计核算体系FACCOUNTSYSTEM FISTAX按含税单价录入FISTAX FCancellerId作废人FCancellerId FCancelDate作废日期FCancelDate FCancelStatus作废状态FCancelStatus FPayConditon收款条件FPayConditon FCUSTOMERID客户FCUSTOMERID FSALEORGID销售组织FSALEORGID FSALEDEPTID销售部门FSALEDEPTID FSALEGROUPID销售组FSALEGROUPID FSALEERID销售员FSALEERID FCreditCheckResult信用检查结果FCreditCheckResult FISINIT是否期初单据FISINIT FSALESBUSTYPE销售业务类型FSALESBUSTYPE FPAYORGID收款组织FPAYORGID FBUSINESSTYPE业务类型FBUSINESSTYPE FCASHSALE现销FCASHSALE FISRETAIL零售FISRETAIL FMatchMethodID核销方式FMatchMethodID FISB2CB2C业务FISB2C FISPRICEEXCLUDETAX价外税FISPRICEEXCLUDETAX FAR_Remark备注FAR_Remark FSetAccountType立账类型FSetAccountType FISHookMatch参与暂估应收核销FISHookMatch FIsWriteOff转销FIsWriteOff FISINVOICEARLIER先到票后出库FISINVOICEARLIER FRedBlue红蓝字FRedBlue FByVerify生成方式FByVerify FScanPoint扫描点FScanPoint FOUTCUSTOMERID转出客户FOUTCUSTOMERID FBILLMATCHLOGID开票核销记录序号FBILLMATCHLOGID FBranchId销售门店FBranchId FWBOPENQTY反写开票数量FWBOPENQTY FGetCostLastedDate获取成本时间FGetCostLastedDate FCOSTCALDATE获取到的成本核算时间FCOSTCALDATE FMOBRECBARCODETEXT二维码链接FMOBRECBARCODETEXT FMOBRECBILLNO聚合收款通知单号FMOBRECBILLNO FPRESETBASE1预设基础资料字段1FPRESETBASE1 FPRESETBASE2预设基础资料字段2FPRESETBASE2 FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2 FPRESETTEXT1预设文本字段1FPRESETTEXT1 FPRESETTEXT2预设文本字段2FPRESETTEXT2 FISFROMGY来源管易FISFROMGY FOrderDiscountAmountFor整单折扣金额FOrderDiscountAmountFor FISGENERATEPLANBYCOSTITEM按费用项目生成计划FISGENERATEPLANBYCOSTITEM FEntryID实体主键FEntryID FMATERIALID物料编码FMATERIALID FMaterialName物料名称FMaterialName FModel规格型号FModel FMaterialType物料类别FMaterialType FPrice单价FPrice FTaxPrice含税单价FTaxPrice FPriceCoefficient价格系数FPriceCoefficient FPriceQty计价数量FPriceQty FDISCOUNTAMOUNTFOR折扣额FDISCOUNTAMOUNTFOR FEntryDiscountRate折扣率(%)FEntryDiscountRate FNoTaxAmountFor_D不含税金额FNoTaxAmountFor_D FEntryTaxRate税率(%)FEntryTaxRate FTAXAMOUNTFOR_D税额FTAXAMOUNTFOR_D FALLAMOUNTFOR_D价税合计FALLAMOUNTFOR_D FComment备注FComment FIVALLAMOUNTFOR销售发票价税合计FIVALLAMOUNTFOR FDISCOUNTAMOUNT折扣额本位币FDISCOUNTAMOUNT FTAXAMOUNT_D税额本位币FTAXAMOUNT_D FALLAMOUNT_D价税合计本位币FALLAMOUNT_D FNOTAXAMOUNT_D不含税金额本位币FNOTAXAMOUNT_D FOPENSTATUS_D表体明细 - 开票核销状态FOPENSTATUS_D FOPENAMOUNTFOR_D表体明细 - 已开票核销金额FOPENAMOUNTFOR_D FORDERNUMBER销售订单号FORDERNUMBER FPRICEUNITID计价单位FPRICEUNITID FBASICUNITID基本单位FBASICUNITID FBASICUNITQTY计价基本数量FBASICUNITQTY FPriceWithTax含税净价FPriceWithTax FBaseJoinQty基本单位关联数量FBaseJoinQty FSOURCETYPE源单类型FSOURCETYPE FSourceBillNo源单编号FSourceBillNo FTaxCombination税组合FTaxCombination FBUYIVBASICQTY销售发票数量（基本单位）FBUYIVBASICQTY FBUYIVQTY销售发票数量FBUYIVQTY FOPENQTY_D已开票核销数量FOPENQTY_D FTEMPTAXRATE卖家代扣增值税税率FTEMPTAXRATE FMatchNotTaxAmtFor已核销不含税金额FMatchNotTaxAmtFor FHadMatchAmountFor已开票金额（下推审核反写、核销反写）FHadMatchAmountFor FSettleTran结算清单调拨类型FSettleTran FSpecialQTY特殊核销数量FSpecialQTY FSpecialAmountFor特殊核销金额FSpecialAmountFor FBizEntryId业务单据分录内码FBizEntryId FBizID业务单据内码FBizID FBizBillTypeId业务单据类型FBizBillTypeId FBizBillNo业务单据编号FBizBillNo FBizFormId业务单据名称FBizFormId FMaterialDesc物料说明FMaterialDesc FSaleOrderID销售订单内码（删除）FSaleOrderID FBaseDeliveryMaxQty发货上限（基本单位）FBaseDeliveryMaxQty FBaseStockOutJoinQty关联出库数量（基本单位）FBaseStockOutJoinQty FDeliveryControl控制发货数量FDeliveryControl FAUXPROPID辅助属性FAUXPROPID FF100003幅宽FF100003 FF100002生产类型FF100002 FF100001供应商FF100001 FLot批号FLot FBFLowId业务流程FBFLowId FSTOCKORGID库存组织FSTOCKORGID FCOSTID费用项目编码FCOSTID FCOSTNAME费用项目名称FCOSTNAME FASSETID卡片编码FASSETID FAssetName资产名称FAssetName FCOSTDEPARTMENTID费用承担部门FCOSTDEPARTMENTID FMONUMBER生产订单编号FMONUMBER FMOENTRYSEQ生产订单行号FMOENTRYSEQ FOPNO工序计划号FOPNO FSEQNUMBER序列号FSEQNUMBER FOPERNUMBER工序号FOPERNUMBER FPROCESSID作业FPROCESSID FFPRODEPARTMENTID生产车间FFPRODEPARTMENTID FSRCROWID源单行内码FSRCROWID FIsFree是否赠品FIsFree FStockUnitId库存单位FStockUnitId FStockQty库存数量FStockQty FStockBaseQty库存基本数量FStockBaseQty FSalUnitId销售单位FSalUnitId FSalBaseQty销售基本数量FSalBaseQty FPriceBaseDen计价基本分母FPriceBaseDen FSalBaseNum销售基本分子FSalBaseNum FStockBaseNum库存基本分子FStockBaseNum FSalQty销售数量FSalQty FCOSTAMTSUM成本金额FCOSTAMTSUM FORDERENTRYID销售订单行内码FORDERENTRYID FSOURCEBILLTYPEID源单单据类型FSOURCEBILLTYPEID FORDERENTRYSEQ销售订单行号FORDERENTRYSEQ FRECEIVEAMOUNT已结算金额FRECEIVEAMOUNT FBUYIVINIQTY销售发票数量期初FBUYIVINIQTY FBUYIVINIBASICQTY销售发票数量（基本单位）期初FBUYIVINIBASICQTY FIVINIALLAMOUNTFOR销售发票价税合计期初FIVINIALLAMOUNTFOR FPushRedQty已下推负数财务应收数量FPushRedQty FSALFINBASEQTY销售基本数量(财务)FSALFINBASEQTY FCustMatID客户物料编码FCustMatID FCustMatName客户物料名称FCustMatName FBarcode零售条形码FBarcode FDIFFAMOUNT不含税差异金额FDIFFAMOUNT FDIFFALLAMOUNT价税合计差异金额FDIFFALLAMOUNT FDIFFAMOUNTEXRATE不含税汇率差异金额FDIFFAMOUNTEXRATE FDIFFALLAMOUNTEXRATE价税合计汇率差异金额FDIFFALLAMOUNTEXRATE FISINVOICEALLARRIVED已完全到票FISINVOICEALLARRIVED FROWID行标识FROWID FPARENTROWID父行标识FPARENTROWID FNORECEIVEAMOUNT未结算金额FNORECEIVEAMOUNT FNOINVOICEAMOUNT未开票核销金额FNOINVOICEAMOUNT FNOINVOICEQTY未开票核销数量FNOINVOICEQTY FOUTSTOCKID出库单号FOUTSTOCKID FROOTSETACCOUNTTYPE源立账类型（用于反写控制，请勿改动）FROOTSETACCOUNTTYPE FROOTSOURCETYPE源应收单源单类型（用于反写控制，请勿改动）FROOTSOURCETYPE FROOTSOURCEBILLTYPEID源应收单源单单据类型（用于反写控制，请勿改动）FROOTSOURCEBILLTYPEID FOPENAMOUNT已开票核销金额本位币FOPENAMOUNT Fmatchnottaxamt已核销不含税金额本位币Fmatchnottaxamt F_ZYKF_Base转嫁供应商F_ZYKF_Base FEntityDetail_FEntryIDFEntityDetail_FEntryIDFEntityDetail_FEntryID Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdSAL_SaleOrder必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FID实体主键 FBillNo单据编号 FDocumentStatus单据状态 FRelateHadPayAmount表头基本 - 收（退）款单的关联金额 FDATE业务日期 FSETTLEORGID结算组织 FNOTWRITTENOFFAMOUNTFOR表头基本 -未收款核销金额（作废） FCURRENCYID币别 FBillTypeID单据类型 FModifierId修改人 FAPPROVEDATE审核日期 FCreateDate创建日期 FModifyDate修改日期 FAPPROVERID审核人 FWRITTENOFFSTATUS表头基本 - 收款核销状态 FOPENSTATUS表头基本 - 开票核销状态 FCreatorId创建人 FALLAMOUNTFOR价税合计 FENDDATE_H到期日 FOWNERTYPE货主类型 FOWNERID货主 FACCOUNTSYSTEM会计核算体系 FISTAX按含税单价录入 FCancellerId作废人 FCancelDate作废日期 FCancelStatus作废状态 FPayConditon收款条件 FCUSTOMERID客户 FSALEORGID销售组织 FSALEDEPTID销售部门 FSALEGROUPID销售组 FSALEERID销售员 FCreditCheckResult信用检查结果 FISINIT是否期初单据 FSALESBUSTYPE销售业务类型 FPAYORGID收款组织 FBUSINESSTYPE业务类型 FCASHSALE现销 FISRETAIL零售 FMatchMethodID核销方式 FISB2CB2C业务 FISPRICEEXCLUDETAX价外税 FAR_Remark备注 FSetAccountType立账类型 FISHookMatch参与暂估应收核销 FIsWriteOff转销 FISINVOICEARLIER先到票后出库 FRedBlue红蓝字 FByVerify生成方式 FScanPoint扫描点 FOUTCUSTOMERID转出客户 FBILLMATCHLOGID开票核销记录序号 FBranchId销售门店 FWBOPENQTY反写开票数量 FGetCostLastedDate获取成本时间 FCOSTCALDATE获取到的成本核算时间 FMOBRECBARCODETEXT二维码链接 FMOBRECBILLNO聚合收款通知单号 FPRESETBASE1预设基础资料字段1 FPRESETBASE2预设基础资料字段2 FPRESETASSISTANT1预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2 FPRESETTEXT1预设文本字段1 FPRESETTEXT2预设文本字段2 FISFROMGY来源管易 FOrderDiscountAmountFor整单折扣金额 FISGENERATEPLANBYCOSTITEM按费用项目生成计划 FEntryID实体主键 FMATERIALID物料编码 FMaterialName物料名称 FModel规格型号 FMaterialType物料类别 FPrice单价 FTaxPrice含税单价 FPriceCoefficient价格系数 FPriceQty计价数量 FDISCOUNTAMOUNTFOR折扣额 FEntryDiscountRate折扣率(%) FNoTaxAmountFor_D不含税金额 FEntryTaxRate税率(%) FTAXAMOUNTFOR_D税额 FALLAMOUNTFOR_D价税合计 FComment备注 FIVALLAMOUNTFOR销售发票价税合计 FDISCOUNTAMOUNT折扣额本位币 FTAXAMOUNT_D税额本位币 FALLAMOUNT_D价税合计本位币 FNOTAXAMOUNT_D不含税金额本位币 FOPENSTATUS_D表体明细 - 开票核销状态 FOPENAMOUNTFOR_D表体明细 - 已开票核销金额 FORDERNUMBER销售订单号 FPRICEUNITID计价单位 FBASICUNITID基本单位 FBASICUNITQTY计价基本数量 FPriceWithTax含税净价 FBaseJoinQty基本单位关联数量 FSOURCETYPE源单类型 FSourceBillNo源单编号 FTaxCombination税组合 FBUYIVBASICQTY销售发票数量（基本单位） FBUYIVQTY销售发票数量 FOPENQTY_D已开票核销数量 FTEMPTAXRATE卖家代扣增值税税率 FMatchNotTaxAmtFor已核销不含税金额 FHadMatchAmountFor已开票金额（下推审核反写、核销反写） FSettleTran结算清单调拨类型 FSpecialQTY特殊核销数量 FSpecialAmountFor特殊核销金额 FBizEntryId业务单据分录内码 FBizID业务单据内码 FBizBillTypeId业务单据类型 FBizBillNo业务单据编号 FBizFormId业务单据名称 FMaterialDesc物料说明 FSaleOrderID销售订单内码（删除） FBaseDeliveryMaxQty发货上限（基本单位） FBaseStockOutJoinQty关联出库数量（基本单位） FDeliveryControl控制发货数量 FAUXPROPID辅助属性 FF100003幅宽 FF100002生产类型 FF100001供应商 FLot批号 FBFLowId业务流程 FSTOCKORGID库存组织 FCOSTID费用项目编码 FCOSTNAME费用项目名称 FASSETID卡片编码 FAssetName资产名称 FCOSTDEPARTMENTID费用承担部门 FMONUMBER生产订单编号 FMOENTRYSEQ生产订单行号 FOPNO工序计划号 FSEQNUMBER序列号 FOPERNUMBER工序号 FPROCESSID作业 FFPRODEPARTMENTID生产车间 FSRCROWID源单行内码 FIsFree是否赠品 FStockUnitId库存单位 FStockQty库存数量 FStockBaseQty库存基本数量 FSalUnitId销售单位 FSalBaseQty销售基本数量 FPriceBaseDen计价基本分母 FSalBaseNum销售基本分子 FStockBaseNum库存基本分子 FSalQty销售数量 FCOSTAMTSUM成本金额 FORDERENTRYID销售订单行内码 FSOURCEBILLTYPEID源单单据类型 FORDERENTRYSEQ销售订单行号 FRECEIVEAMOUNT已结算金额 FBUYIVINIQTY销售发票数量期初 FBUYIVINIBASICQTY销售发票数量（基本单位）期初 FIVINIALLAMOUNTFOR销售发票价税合计期初 FPushRedQty已下推负数财务应收数量 FSALFINBASEQTY销售基本数量(财务) FCustMatID客户物料编码 FCustMatName客户物料名称 FBarcode零售条形码 FDIFFAMOUNT不含税差异金额 FDIFFALLAMOUNT价税合计差异金额 FDIFFAMOUNTEXRATE不含税汇率差异金额 FDIFFALLAMOUNTEXRATE价税合计汇率差异金额 FISINVOICEALLARRIVED已完全到票 FROWID行标识 FPARENTROWID父行标识 FNORECEIVEAMOUNT未结算金额 FNOINVOICEAMOUNT未开票核销金额 FNOINVOICEQTY未开票核销数量 FOUTSTOCKID出库单号 FROOTSETACCOUNTTYPE源立账类型（用于反写控制，请勿改动） FROOTSOURCETYPE源应收单源单类型（用于反写控制，请勿改动） FROOTSOURCEBILLTYPEID源应收单源单单据类型（用于反写控制，请勿改动） FOPENAMOUNT已开票核销金额本位币 Fmatchnottaxamt已核销不含税金额本位币 F_ZYKF_Base转嫁供应商 FEntityDetail_FEntryIDFEntityDetail_FEntryID

旺店通·企业版接口明细

• 接口：stock_sync_by_pd
• 接口名称：创建盘点单
• 接口方法：POST

请求参数

字段名称类型描述 warehouse_no仓库编号string代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于创建指定仓库单据信息 mode盘点方式string0表示单品盘点，1表示货位盘点，如果mode没有传参或数值无效  默认为0单品盘点 api_outer_noAPI单号string外部单号唯一标识 is_check是否审核string1：自动审核 0：不自动审核 默认0 is_post_error严格模式string盘点明细推送严格模式，可选值：0或1，不传本参数默认输入值为1。0 非严格模式：表示盘点单货品明细允许部分推送成功（盘点单内spec_no在ERP货品档案存在的部分创建成功，不存在的部分创建失败）；1严格模式：表示盘点单货品明细不允许部分推送成功（盘点单内所有spec_no，其中一个或多个spec_no在ERP货品档案不存在，整单推送失败） is_create_stock是否添加库存记录string可选值：0 或1，不传本参数默认输入值为0。0表示不自动添加库存记录，1表示自动添加库存记录 。 goods_list货品明细列表节点array货品明细列表节点 goods_list.spec_no商家编码string代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 goods_list.stock_num库存数量string库存数量（盘点推送的库存数量指覆盖数量，不是调整数量） goods_list.position_no货位string货位（当mode为1时，必传）

系统集成总览

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