金蝶云星空对接打通旺店通·旗舰奇门采购退料单查询接口与创建货品档案接口

飞书与ERP对接

来源系统:金蝶云星空

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

对接系统：旺店通·旗舰奇门

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

数据集成方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为旺店通·旗舰奇门，并且选择对应连接器（关于旺店通·旗舰奇门的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的wdt.goods.goods.push接口作为数据写入动作完成第一步的接口配置。

企业微信与ERP对接

金蝶云星空接口明细

API：executeBillQuery
NAME：采购退料单查询
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FEntity_FEntryID	FEntity_FEntryID	FEntity_FEntryID	FEntity_FEntryID
FBillNo	单据编号	FBillNo	单据编号
FID	FID	FID	FID
FDocumentStatus	单据状态	FDocumentStatus	单据状态
FBillTypeID_Fnumber	单据类型	FBillTypeID.Fnumber	单据类型
FDate	申请日期	FDate	申请日期
FPURCHASEORGID_Fnumber	采购组织	FPURCHASEORGID.Fnumber	采购组织
FRMTYPE	退料类型	FRMTYPE	退料类型
FAPPORGID_Fnumber	申请组织	FAPPORGID.Fnumber	申请组织
FAPPDEPTID_Fnumber	申请部门	FAPPDEPTID.Fnumber	申请部门
FRMLOC	退料地点	FRMLOC	退料地点
FSUPPLIERID_Fnumber	供应商	FSUPPLIERID.Fnumber	供应商
FRMMODE	退料方式	FRMMODE	退料方式
FREPLENISHMODE	补料方式	FREPLENISHMODE	补料方式
FCreatorId	创建人	FCreatorId	创建人
FCreateDate	创建日期	FCreateDate	创建日期
FModifierId	最后修改人	FModifierId	最后修改人
FModifyDate	最后修改日期	FModifyDate	最后修改日期
FAPPROVERID	审核人	FAPPROVERID	审核人
FAPPROVEDATE	审核日期	FAPPROVEDATE	审核日期
FCANCELLERID	作废人	FCANCELLERID	作废人
FCANCELDATE	作废日期	FCANCELDATE	作废日期
FCANCELSTATUS	作废状态	FCANCELSTATUS	作废状态
FBusinessType	业务类型	FBusinessType	业务类型
FRemarks	备注	FRemarks	备注
FRMREASON	退料原因	FRMREASON	退料原因
FRequireOrgId_Fnumber	需求组织	FRequireOrgId.Fnumber	需求组织
FCorrespondOrgId_Fnumber	对应组织	FCorrespondOrgId.Fnumber	对应组织
FConfirmerId	确认人	FConfirmerId	确认人
FConfirmDate	确认日期	FConfirmDate	确认日期
FConfirmStatus	确认状态	FConfirmStatus	确认状态
FMATERIALID_Fnumber	物料编码	FMATERIALID.Fnumber	物料编码
FMaterialName	物料名称	FMaterialName	物料名称
FUOM	规格型号	FUOM	规格型号
FMaterialType	存货类别	FMaterialType	存货类别
FMRAPPQTY	申请退料数量	FMRAPPQTY	申请退料数量
FREPLENISHQTY	补料数量	FREPLENISHQTY	补料数量
FKEAPAMTQTY	扣款数量	FKEAPAMTQTY	扣款数量
FMRJOINQTY	退料关联数量	FMRJOINQTY	退料关联数量
FMRQTY	退料数量	FMRQTY	退料数量
FBOMID	BOM版本	FBOMID	BOM版本
FSRCSEQ	源单行号	FSRCSEQ	源单行号
FCONTRACTNO	合同单号	FCONTRACTNO	合同单号
FORDERNO	订单单号	FORDERNO	订单单号
FREQTRACENO	需求跟踪号	FREQTRACENO	需求跟踪号
FBASEUNITQTY	库存基本数量	FBASEUNITQTY	库存基本数量
FBASEUNITID	退料申请基本单位	FBASEUNITID	退料申请基本单位
FUNITID	库存单位	FUNITID	库存单位
FBASEMRJOINQTY	退料关联数量（库存基本）	FBASEMRJOINQTY	退料关联数量（库存基本）
FBASEMRQTY	退料数量(基本单位)	FBASEMRQTY	退料数量(基本单位)
FAUXPROPID	辅助属性	FAUXPROPID	辅助属性
FSRCBILLNO	源单编号	FSRCBILLNO	源单编号
FSRCBILLTYPEID	源单类型	FSRCBILLTYPEID	源单类型
FREPLENISHAMOUNT	补料金额	FREPLENISHAMOUNT	补料金额
FKEAPAMTAMOUNT	扣款金额	FKEAPAMTAMOUNT	扣款金额
FLot	批号	FLot	批号
FBFLowId	业务流程	FBFLowId	业务流程
FMtoNo	计划跟踪号	FMtoNo	计划跟踪号
FGiveAway	是否赠品	FGiveAway	是否赠品
FPriceBaseQty	计价基本数量	FPriceBaseQty	计价基本数量
FPURUNITID	采购单位	FPURUNITID	采购单位
FPurQty	采购数量	FPurQty	采购数量
FPurBaseQty	采购基本数量	FPurBaseQty	采购基本数量
FPURBASENUM	采购基本分子	FPURBASENUM	采购基本分子
FSTOCKBASEDEN	库存基本分母	FSTOCKBASEDEN	库存基本分母
FSRCBIZUNITID	携带的主业务单位	FSRCBIZUNITID	携带的主业务单位
FRETURNSTOCKJNBASEQTY	退料关联数量（采购基本）	FRETURNSTOCKJNBASEQTY	退料关联数量（采购基本）
FEntryTaxRate	税率%	FEntryTaxRate	税率%
FENTRYPRICELISTID	分录价目表	FENTRYPRICELISTID	分录价目表
FPOORDERENTRYID	采购订单分录内码	FPOORDERENTRYID	采购订单分录内码
FStockId_Fnumber	仓库	FStockId.Fnumber	仓库
FISSYNTOTHIRD	是否同步管易(GY)	FISSYNTOTHIRD	是否同步管易(GY)
FRowType	产品类型	FRowType	产品类型
FPARENTMATID	父项产品	FPARENTMATID	父项产品
FPriceDiscount	单价折扣	FPriceDiscount	单价折扣
FSTOCKLOCID	仓位	FSTOCKLOCID	仓位
FPriLstEntryId	价目表分录id	FPriLstEntryId	价目表分录id
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME}}'	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	PUR_MRAPP	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	描述
FEntity_FEntryID	FEntity_FEntryID	FEntity_FEntryID
FBillNo	单据编号	单据编号
FID	FID	FID
FDocumentStatus	单据状态	单据状态
FBillTypeID_Fnumber	单据类型	单据类型
FDate	申请日期	申请日期
FPURCHASEORGID_Fnumber	采购组织	采购组织
FRMTYPE	退料类型	退料类型
FAPPORGID_Fnumber	申请组织	申请组织
FAPPDEPTID_Fnumber	申请部门	申请部门
FRMLOC	退料地点	退料地点
FSUPPLIERID_Fnumber	供应商	供应商
FRMMODE	退料方式	退料方式
FREPLENISHMODE	补料方式	补料方式
FCreatorId	创建人	创建人
FCreateDate	创建日期	创建日期
FModifierId	最后修改人	最后修改人
FModifyDate	最后修改日期	最后修改日期
FAPPROVERID	审核人	审核人
FAPPROVEDATE	审核日期	审核日期
FCANCELLERID	作废人	作废人
FCANCELDATE	作废日期	作废日期
FCANCELSTATUS	作废状态	作废状态
FBusinessType	业务类型	业务类型
FRemarks	备注	备注
FRMREASON	退料原因	退料原因
FRequireOrgId_Fnumber	需求组织	需求组织
FCorrespondOrgId_Fnumber	对应组织	对应组织
FConfirmerId	确认人	确认人
FConfirmDate	确认日期	确认日期
FConfirmStatus	确认状态	确认状态
FMATERIALID_Fnumber	物料编码	物料编码
FMaterialName	物料名称	物料名称
FUOM	规格型号	规格型号
FMaterialType	存货类别	存货类别
FMRAPPQTY	申请退料数量	申请退料数量
FREPLENISHQTY	补料数量	补料数量
FKEAPAMTQTY	扣款数量	扣款数量
FMRJOINQTY	退料关联数量	退料关联数量
FMRQTY	退料数量	退料数量
FBOMID	BOM版本	BOM版本
FSRCSEQ	源单行号	源单行号
FCONTRACTNO	合同单号	合同单号
FORDERNO	订单单号	订单单号
FREQTRACENO	需求跟踪号	需求跟踪号
FBASEUNITQTY	库存基本数量	库存基本数量
FBASEUNITID	退料申请基本单位	退料申请基本单位
FUNITID	库存单位	库存单位
FBASEMRJOINQTY	退料关联数量（库存基本）	退料关联数量（库存基本）
FBASEMRQTY	退料数量(基本单位)	退料数量(基本单位)
FAUXPROPID	辅助属性	辅助属性
FSRCBILLNO	源单编号	源单编号
FSRCBILLTYPEID	源单类型	源单类型
FREPLENISHAMOUNT	补料金额	补料金额
FKEAPAMTAMOUNT	扣款金额	扣款金额
FLot	批号	批号
FBFLowId	业务流程	业务流程
FMtoNo	计划跟踪号	计划跟踪号
FGiveAway	是否赠品	是否赠品
FPriceBaseQty	计价基本数量	计价基本数量
FPURUNITID	采购单位	采购单位
FPurQty	采购数量	采购数量
FPurBaseQty	采购基本数量	采购基本数量
FPURBASENUM	采购基本分子	采购基本分子
FSTOCKBASEDEN	库存基本分母	库存基本分母
FSRCBIZUNITID	携带的主业务单位	携带的主业务单位
FRETURNSTOCKJNBASEQTY	退料关联数量（采购基本）	退料关联数量（采购基本）
FEntryTaxRate	税率%	税率%
FENTRYPRICELISTID	分录价目表	分录价目表
FPOORDERENTRYID	采购订单分录内码	采购订单分录内码
FStockId_Fnumber	仓库	仓库
FISSYNTOTHIRD	是否同步管易(GY)	是否同步管易(GY)
FRowType	产品类型	产品类型
FPARENTMATID	父项产品	父项产品
FPriceDiscount	单价折扣	单价折扣
FSTOCKLOCID	仓位	仓位
FPriLstEntryId	价目表分录id	价目表分录id

旺店通·旗舰奇门接口明细

接口：wdt.goods.goods.push
接口名称：创建货品档案
接口方法：POST

请求参数

字段	名称	类型	描述
goods_no	货品编号	object	代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍
goods_no.goods_type	货品类别	string	货品类别 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它
goods_no.goods_name	货品名称	string	货品名称
goods_no.short_name	货品简称	string	货品简称
goods_no.alias	货品别名	string	别名
goods_no.pinyin	拼音名称	string	拼音名称
goods_no.origin	产地	string	产地
goods_no.class_name	分类	string	分类
goods_no.brand_name	品牌	string	品牌名称
goods_no.unit_name	基本单位	string	基本单位
goods_no.remark	备注	string	备注
goods_no.props1	自定义属性1	string	自定义属性1
goods_no.props2	自定义属性2	string	自定义属性2
goods_no.props3	自定义属性3	string	自定义属性3
goods_no.props4	自定义属性4	string	自定义属性4
goods_no.props5	自定义属性5	string	自定义属性5
goods_no.props6	自定义属性6	string	自定义属性6
goods_no.aux_unit_name	辅助单位名称	string	辅助单位名称
goods_no.flag_name	标记名称	string	标记名称
goods_no.spec_list	单品节点	array	请求参数的2级数据节点，包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list"
goods_no.spec_list.spec_no	商家编码	string	代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍
goods_no.spec_list.spec_code	规格码	string	规格编码
goods_no.spec_list.barcode	主条码	string	主条码
goods_no.spec_list.spec_name	规格名称	string	规格名称
goods_no.spec_list.is_allow_neg_stock	允许负库存	string	是否允许负库存1允许，0不允许（默认为0）
goods_no.spec_list.is_sn_enable	是否启用序列号	string	是否启用序列号，默认不启用，0不启用序列号 1强序列号 2弱序列
goods_no.spec_list.is_single_batch	是否启用同一批次出库	string	是否启用同一批次出库，默认不启用，0不启用1启用
goods_no.spec_list.is_not_need_examine	是否出库不用验货	string	是否出库不用验货，默认不开启该配置，0出库不验货未开启 1出库不验货开启
goods_no.spec_list.is_zero_cost	是否允许0成本	string	是否允许0成本，默认允许，0不允许1允许
goods_no.spec_list.is_lower_cost	是否允许低于成本价	string	是否允许低于成本价，默认不允许，0不允许1允许
goods_no.spec_list.is_not_use_air	是否航空禁运	string	是否航空禁运，默认不开启，0不开启1开启
goods_no.spec_list.is_popular	是否畅销品	string	是否畅销品，默认非畅销，0非畅销 1畅销
goods_no.spec_list.replenish_type	补货	string	补货，默认低于警戒库存补货，0持续补货1不补货2低于警戒库存补货
goods_no.spec_list.large_type	拆分	string	默认普通件，-1非单发件(需和其他类型货品一起发) 0普通件 1普通大件(可与非大件一起发) 2独立大件(必须单独发)
goods_no.spec_list.spec_unit_name	基本单位	string	基本单位名称
goods_no.spec_list.lowest_price	最低价	string	最低价
goods_no.spec_list.img_url	图片url地址	string	图片url地址
goods_no.spec_list.retail_price	零售价	string	商品标价，系统内手工建单时使用，传值时需谨慎
goods_no.spec_list.wholesale_price	批发价	string	批发价
goods_no.spec_list.member_price	会员价	string	会员价
goods_no.spec_list.market_price	市场价	string	市场价
goods_no.spec_list.sale_score	销售积分	string	销售积分
goods_no.spec_list.pack_score	打包积分	string	打包积分
goods_no.spec_list.pick_score	拣货积分	string	拣货积分
goods_no.spec_list.validity_days	有效期天数	int	保质期，天数（不能超过32767天）
goods_no.spec_list.weight	重量	string	重量
goods_no.spec_list.length	长	string	长
goods_no.spec_list.width	宽	string	宽
goods_no.spec_list.height	高	string	高
goods_no.spec_list.tax_rate	税率	string	税率
goods_no.spec_list.prop1	自定义1	string	自定义1
goods_no.spec_list.prop2	自定义2	string	自定义2
goods_no.spec_list.prop3	自定义3	string	自定义3
goods_no.spec_list.prop4	自定义4	string	自定义4
goods_no.spec_list.prop5	自定义5	string	自定义5
goods_no.spec_list.prop6	自定义6	string	自定义6
goods_no.spec_list.custom_price1	自定义价格1	string	自定义价格1
goods_no.spec_list.custom_price2	自定义价格2	string	自定义价格2
goods_no.spec_list.spec_aux_unit_name	单品辅助单位名称	string	单品辅助单位名称
goods_no.spec_list.tax_code	税务编码	string	税务编码
goods_no.spec_list.spec_remark	备注	string	备注

系统集成总览

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。

数据集成方案