从金蝶云星空到旺店通·旗舰奇门通过接口配置打通数据

对接源平台:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

集成系统:旺店通·旗舰奇门

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

数据接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：退货通知单，目标系统：旺店通·旗舰奇门，目标系统 API创建货品档案。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

• API：executeBillQuery

• NAME：退货通知单

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FID	FID		FID
FSRCBILLNO	源单单号		源单单号
FBillNo	单据编号		单据编号
FDate	日期		日期
FRETCUSTID_Fnumber	客户		客户
FSALEORGID_Fname	销售组织		销售组织
FSALEORGID_Fnumber	销售组织编码		销售组织编码
FMaterialID_Fnumber	物料编码		物料编码
FQty	销售数量		销售数量
FTAXPRICE	含税单价		含税单价
FStockID_Fnumber	仓库编码		仓库编码
FEntryDescription	单据体备注		单据体备注
FDESCRIPTION	备注		备注
FSalesManID	销售员		销售员
FSalesMan	销售员名称		销售员名称
FPRODUCEDATE	生产日期		生产日期
FExpiryDate	有效期至		有效期至
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶最大行数
FieldKeys	需查询的字段key集合		金蝶需查询的字段key集合
TopRowCount	返回行数		金蝶返回行数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME}}'	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FormId	业务对象表单Id	SAL_RETURNNOTICE	业务对象表单Id

响应参数

接口字段	字段名称	预设值	描述
FID	FID		FID
FSRCBILLNO	源单单号		源单单号
FBillNo	单据编号		单据编码
FDate	日期		日期
FRETCUSTID_Fnumber	客户		客户
FSALEORGID_Fname	销售组织		销售组织
FSALEORGID_Fnumber	销售组织编码		销售组织编码
FMaterialID_Fnumber	物料编码		物料编码
FQty	销售数量		销售数量
FTAXPRICE	含税单价		含税单价
FStockID_Fnumber	仓库编码		仓库编码
FEntryDescription	单据体备注		单据体备注
FDESCRIPTION	备注		备注
FSalesManID	销售员		销售员
FSalesMan	销售员名称		销售员名称
FPRODUCEDATE	生产日期		生产日期
FExpiryDate	有效期至		有效期至

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

• 接口：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	备注

数据对接价值

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