从旺店通·旗舰奇门到金蝶云星空通过接口配置打通数据接入系统：旺店通·旗舰奇门慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。接通系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。接口方案配置集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：旺店通·旗舰奇门，源系统 API：退货入库单查询，目标系统：金蝶云星空，目标系统 API销售退货单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。旺店通·旗舰奇门接口明细接口： wdt.wms.stockin.refund.querywithdetail 接口名称：退货入库单查询接口方法： POST 请求参数字段名称类型描述 pager 分页参数 object pager.page_size 分页大小 string pager.page_no 页号 string pager.params 业务参数 object pager.params.start_time 开始时间 string pager.params.end_time 结束时间 string pager.params.status 入库单状态 string 英文逗号拼接的状态值:10=已取消；20=编辑中；30=待审核；37=待质检；40=质检确认； 60=待结算；70=暂估结算；80=已完成 pager.params.time_type 时间条件类型 string 查询的时间条件类型, 0:修改时间; 1:入库时间不传默认为0 pager.params.warehouse_no 仓库编码 string pager.params.shop_nos 店铺编号 string 多个店铺编号使用英文逗号分隔 pager.params.stockin_no 入库单号 string 响应参数字段名称类型描述 order_no 入库单号 string status 入库单状态 string warehouse_no 仓库编号 string warehouse_name 仓库名称 string created_time 入库单创建时间 string fenxiao_nick 分销商昵称 string operator_name 退换建单人 string logistics_type 物流方式 string check_time 审核时间 string refund_no 退换单号 string goods_count 货品总数 string actual_refund_amount 退换单实际退款金额 string customer_no 客户编码 string customer_name 退货人姓名 string nick_name 客户网名 string shop_name 店铺名称 string shop_no 店铺编号 string shop_remark 店铺备注 string flag_name 标记名称 string trade_no_list 订单编号 string total_price 入库单总金额 string modified 最后修改时间 string details_list 入库单明细 array details_list.remark 明细备注 string details_list.rec_id 明细id(主键) string details_list.stockin_id 入库单id string details_list.num 数量 string details_list.total_cost 总成本 string details_list.right_num 调整后数量 string details_list.goods_name 货品名称 string details_list.goods_no 货品编码 string details_list.spec_no 商家编码 string details_list.defect 是否残次品 string details_list.prop2 自定义属性2 string details_list.spec_name 规格名 string details_list.spec_code 规格码 string details_list.brand_no 品牌编号 string details_list.brand_name 品牌名称 string details_list.goods_unit 入库单位名称 string details_list.basic_unit_name 基本单位名称 string details_list.batch_no 批次号 string details_list.expire_date 有效期 string details_list.position_no 货位 string details_list.shop_platform_id 店铺平台id string 金蝶云星空接口明细 API： batchSave NAME：销售退货单新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillTypeID 单据类型 DSXSTHD07 单据类型 FBillNo 单据编号 {{order_no}} 单据编号 FStockOrgId 库存组织 106 组织 FSaleOrgId 销售组织 findCollection find zip from ec445d8c-9d91-3845-9175-79fb0588e1b3 where shop_no={{shop_no}} 组织 FDate 日期 {{check_time datetime}} 日期 FRetcustId 退货客户 {{shop_no}} 基础资料 FSaledeptid 销售部门基础资料 FSettleCurrId 结算币别 PRE001 基础资料 FBranchId 销售门店基础资料 FReturnReason 退货原因单选辅助资料列表 FCorrespondOrgId 对应组织组织 FHeadNote 备注 {{remark}} 多行文本 FPayCustId 付款方基础资料 FEntity 明细信息 details_list FEntity.FMaterialId 物料编码 {{details_list.goods_no}} 基础资料 FEntity.FBarcode 零售条形码文本 FEntity.FRealQty 实退数量 {{details_list.num}} 数量 FEntity.FPrice 单价单价 FEntity.FTaxPrice 含税单价 {{details_list.refund_order_detail_list.0.price}} 单价 FEntity.FIsFree 是否赠品复选框 FEntity.FEntryTaxRate 税率% 13 小数 FEntity.FReturnType 退货类型单选辅助资料列表 FEntity.FOwnerTypeId 货主类型 BD_OwnerOrg 多类别基础资料列表 FEntity.FOwnerId 货主 100 多类别基础资料 FEntity.FStockId 仓库 _findCollection find FNumber from 9c02adb6-7e63-326e-b5b3-dea634490062 where F_KD_WDTSTOCK={{warehouse_no}} 基础资料 FEntity.FStocklocId 仓位维度关联字段 FEntity.FLot 批号批次 FEntity.FDeliveryDate 退货日期 {{created_time datetime}} 长日期 FEntity.FNote 备注 {{details_list.remark}} 文本 FEntity.F_POIH_ZD 子单原始订单号 {{tid_list}} FEntity.F_POIH_TH 退换单号 {{refund_no}} FEntity.FSoorDerno 原始单号 {{tid_list}} FEntity.FETHIRDBILLNO 第三方平台单号 {{trade_no_list}} FEntity.SubHeadEntity 财务信息 FEntity.SubHeadEntity.FSettleOrgId 结算组织 _findCollection find zip from ec445d8c-9d91-3845-9175-79fb0588e1b3 where shop_no={{shop_no}} 组织 FEntity.SubHeadEntity.FSettleTypeId 结算方式基础资料 FEntity.SubHeadEntity.FOwnerIdHead 货主 106 FEntity.SubHeadEntity.FOwnerTypeIdHead 货主类型 BD_OwnerOrg FEntity.SubHeadEntity.Freamount 退货金额 {{actual_refund_amount}} FEntity.SubHeadEntity.FBuyerNo 客户编码 {{customer_no}} FEntity.SubHeadEntity.FLogisticsNos 物流单号 {{logistics_no}} FEntity.SubHeadEntity.FLogComName 物流公司 {{logistics_name}} FEntity.SubHeadEntity.FThirdBillNo 第三方单据编号 {{refund_no}} 对接退货入库单号 FEntity.SubHeadEntity.FormId 业务对象表单Id KD_DSSAL_RTNSTOCK 必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation 执行的操作 Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.SubSystemId 系统模块 21 默认仓库模块系统打通概况可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。

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

庄颜_qeasy

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

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

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

接通系统：金蝶云星空

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

接口方案配置

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

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

接口：wdt.wms.stockin.refund.querywithdetail
接口名称：退货入库单查询
接口方法：POST

请求参数

字段	名称	类型	描述
pager	分页参数	object
pager.page_size	分页大小	string
pager.page_no	页号	string
pager.params	业务参数	object
pager.params.start_time	开始时间	string
pager.params.end_time	结束时间	string
pager.params.status	入库单状态	string	英文逗号拼接的状态值:10=已取消；20=编辑中；30=待审核；37=待质检；40=质检确认；
60=待结算；70=暂估结算；80=已完成
pager.params.time_type	时间条件类型	string	查询的时间条件类型, 0:修改时间; 1:入库时间不传默认为0
pager.params.warehouse_no	仓库编码	string
pager.params.shop_nos	店铺编号	string	多个店铺编号使用英文逗号分隔
pager.params.stockin_no	入库单号	string

响应参数

字段	名称	类型
order_no	入库单号	string
status	入库单状态	string
warehouse_no	仓库编号	string
warehouse_name	仓库名称	string
created_time	入库单创建时间	string
fenxiao_nick	分销商昵称	string
operator_name	退换建单人	string
logistics_type	物流方式	string
check_time	审核时间	string
refund_no	退换单号	string
goods_count	货品总数	string
actual_refund_amount	退换单实际退款金额	string
customer_no	客户编码	string
customer_name	退货人姓名	string
nick_name	客户网名	string
shop_name	店铺名称	string
shop_no	店铺编号	string
shop_remark	店铺备注	string
flag_name	标记名称	string
trade_no_list	订单编号	string
total_price	入库单总金额	string
modified	最后修改时间	string
details_list	入库单明细	array
details_list.remark	明细备注	string
details_list.rec_id	明细id(主键)	string
details_list.stockin_id	入库单id	string
details_list.num	数量	string
details_list.total_cost	总成本	string
details_list.right_num	调整后数量	string
details_list.goods_name	货品名称	string
details_list.goods_no	货品编码	string
details_list.spec_no	商家编码	string
details_list.defect	是否残次品	string
details_list.prop2	自定义属性2	string
details_list.spec_name	规格名	string
details_list.spec_code	规格码	string
details_list.brand_no	品牌编号	string
details_list.brand_name	品牌名称	string
details_list.goods_unit	入库单位名称	string
details_list.basic_unit_name	基本单位名称	string
details_list.batch_no	批次号	string
details_list.expire_date	有效期	string
details_list.position_no	货位	string
details_list.shop_platform_id	店铺平台id	string

金蝶云星空接口明细

API：batchSave
NAME：销售退货单新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	DSXSTHD07	单据类型
FBillNo	单据编号	{{order_no}}	单据编号
FStockOrgId	库存组织	106	组织
FSaleOrgId	销售组织	findCollection find zip from ec445d8c-9d91-3845-9175-79fb0588e1b3 where shop_no={{shop_no}}	组织
FDate	日期	{{check_time datetime}}	日期
FRetcustId	退货客户	{{shop_no}}	基础资料
FSaledeptid	销售部门		基础资料
FSettleCurrId	结算币别	PRE001	基础资料
FBranchId	销售门店		基础资料
FReturnReason	退货原因		单选辅助资料列表
FCorrespondOrgId	对应组织		组织
FHeadNote	备注	{{remark}}	多行文本
FPayCustId	付款方		基础资料
FEntity	明细信息	details_list
FEntity.FMaterialId	物料编码	{{details_list.goods_no}}	基础资料
FEntity.FBarcode	零售条形码		文本
FEntity.FRealQty	实退数量	{{details_list.num}}	数量
FEntity.FPrice	单价		单价
FEntity.FTaxPrice	含税单价	{{details_list.refund_order_detail_list.0.price}}	单价
FEntity.FIsFree	是否赠品		复选框
FEntity.FEntryTaxRate	税率%	13	小数
FEntity.FReturnType	退货类型		单选辅助资料列表
FEntity.FOwnerTypeId	货主类型	BD_OwnerOrg	多类别基础资料列表
FEntity.FOwnerId	货主	100	多类别基础资料
FEntity.FStockId	仓库	_findCollection find FNumber from 9c02adb6-7e63-326e-b5b3-dea634490062 where F_KD_WDTSTOCK={{warehouse_no}}	基础资料
FEntity.FStocklocId	仓位		维度关联字段
FEntity.FLot	批号		批次
FEntity.FDeliveryDate	退货日期	{{created_time datetime}}	长日期
FEntity.FNote	备注	{{details_list.remark}}	文本
FEntity.F_POIH_ZD	子单原始订单号	{{tid_list}}
FEntity.F_POIH_TH	退换单号	{{refund_no}}
FEntity.FSoorDerno	原始单号	{{tid_list}}
FEntity.FETHIRDBILLNO	第三方平台单号	{{trade_no_list}}
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	_findCollection find zip from ec445d8c-9d91-3845-9175-79fb0588e1b3 where shop_no={{shop_no}}	组织
FEntity.SubHeadEntity.FSettleTypeId	结算方式		基础资料
FEntity.SubHeadEntity.FOwnerIdHead	货主	106
FEntity.SubHeadEntity.FOwnerTypeIdHead	货主类型	BD_OwnerOrg
FEntity.SubHeadEntity.Freamount	退货金额	{{actual_refund_amount}}
FEntity.SubHeadEntity.FBuyerNo	客户编码	{{customer_no}}
FEntity.SubHeadEntity.FLogisticsNos	物流单号	{{logistics_no}}
FEntity.SubHeadEntity.FLogComName	物流公司	{{logistics_name}}
FEntity.SubHeadEntity.FThirdBillNo	第三方单据编号	{{refund_no}}	对接退货入库单号
FEntity.SubHeadEntity.FormId	业务对象表单Id	KD_DSSAL_RTNSTOCK	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	21	默认仓库模块

系统打通概况

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。