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

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

 

接入系统：金蝶云星空

金蝶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
FISB2C	B2C业务	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	预设基础资料字段1	FPRESETBASE1
FPRESETBASE2	预设基础资料字段2	FPRESETBASE2
FPRESETASSISTANT1	预设辅助资料字段1	FPRESETASSISTANT1
FPRESETASSISTANT2	预设辅助资料字段2	FPRESETASSISTANT2
FPRESETTEXT1	预设文本字段1	FPRESETTEXT1
FPRESETTEXT2	预设文本字段2	FPRESETTEXT2
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_FEntryID	FEntityDetail_FEntryID	FEntityDetail_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	业务对象表单Id	SAL_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	核销方式
FISB2C	B2C业务
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_FEntryID	FEntityDetail_FEntryID

旺店通·企业版接口明细

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

请求参数

字段	名称	类型	描述
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于创建指定仓库单据信息
mode	盘点方式	string	0表示单品盘点，1表示货位盘点，如果mode没有传参或数值无效  默认为0单品盘点
api_outer_no	API单号	string	外部单号唯一标识
is_check	是否审核	string	1：自动审核 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时，必传）

系统集成总览

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