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

来源系统:金蝶云星空

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

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

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

数据集成方案配置

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

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FEntity_FEntryIDFEntity_FEntryIDFEntity_FEntryIDFEntity_FEntryID FBillNo单据编号FBillNo单据编号 FIDFIDFIDFID 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退料数量 FBOMIDBOM版本FBOMIDBOM版本 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价目表分录idFPriLstEntryId价目表分录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业务对象表单IdPUR_MRAPP必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FEntity_FEntryIDFEntity_FEntryIDFEntity_FEntryID FBillNo单据编号单据编号 FIDFIDFID 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退料数量退料数量 FBOMIDBOM版本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自定义属性1string自定义属性1 goods_no.props2自定义属性2string自定义属性2 goods_no.props3自定义属性3string自定义属性3 goods_no.props4自定义属性4string自定义属性4 goods_no.props5自定义属性5string自定义属性5 goods_no.props6自定义属性6string自定义属性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自定义1string自定义1 goods_no.spec_list.prop2自定义2string自定义2 goods_no.spec_list.prop3自定义3string自定义3 goods_no.spec_list.prop4自定义4string自定义4 goods_no.spec_list.prop5自定义5string自定义5 goods_no.spec_list.prop6自定义6string自定义6 goods_no.spec_list.custom_price1自定义价格1string自定义价格1 goods_no.spec_list.custom_price2自定义价格2string自定义价格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架构转向微服务架构的服务总线解决方案。

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