旺店通·旗舰奇门与金蝶云星空对接集成退换单查询连通销售退货新增(WDT退换货管理-KD销售退货单)
来源系统:旺店通·旗舰奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展
写入目标:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
配置集成方案
在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用
旺店通·旗舰奇门接口明细
- API：wdt.aftersales.refund.refund.search
- NAME：退换单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| params | params | | params |
| params.shop_nos | 店铺编号 | | 店铺编号 |
| params.tid | 原始单号 | | 原始单号 |
| params.buyer_nick | 客户网名 | | 客户网名 |
| params.trade_no | 系统订单编号 | | 系统订单编号 |
| params.refund_no | 退换单号 | | 退换单号 |
| params.modified_from | 修改起始时间 | {{LAST_SYNC_TIME datetime}} | 修改起始时间 |
| params.modified_to | 修改结束时间 | {{CURRENT_TIME datetime}} | 修改结束时间 |
| params.settle_from | 开始时间 | | 开始时间 |
| params.settle_to | 结束时间 | | 结束时间 |
| params.status | 退换单状态 | 40 | 退换单状态 |
| params.stockin_status | 入库状态 | | 入库状态 |
| params.type | 退换单类型 | | 退换单类型 |
| params.pager | pager | | |
| params.pager.page_size | page_size | 50 | |
| params.pager.page_no | page_no | 1 | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| refund_id | 退换单id | | 退换单id |
| tid_list | 原始单号 | | 原始单号 |
| refund_no | 退换单号 | | 退换单号 |
| remark | 备注 | | 备注 |
| type | 退换单类型 | | 1:退款;2:退货;3:换货;4:退款不退货;6:保价退款 |
| stockin_status | 入库状态 | | 0:未入库;1:待入库;2:部分入库;3:全部入库;4:终止入库 |
| flag_name | 标记名称 | | 标记名称 |
| return_goods_count | 退回货品数量 | | 退回货品数量 |
| receiver_telno | 退款订单中收件人电话 | | 退款订单中收件人电话 |
| receiver_name | 退款订单中收件人姓名 | | 退款订单中收件人姓名 |
| modified | 修改时间 | | 修改时间 |
| note_count | 便签数量 | | 便签数量 |
| shop_no | 店铺编号 | | 店铺编号 |
| from_type | 建单方式 | | 0:API抓单;1:手工建单;2:导入 |
| created | 创建时间 | | 创建时间 |
| settle_time | 结算时间 | | 若无结算时间，返回空字符串 |
| return_logistics_no | 退货物流单号 | | 退货物流单号 |
| trade_no_list | 系统订单号列表 | | 系统订单号列表 |
| guarantee_refund_amount | 担保退款金额 | | 担保退款金额 |
| return_goods_amount | 退回货品金额 | | 退回货品金额 |
| return_logistics_name | 物流公司名称 | | 物流公司名称 |
| reason_name | 退换说明 | | 退换说明 |
| refund_reason | 退款原因 | | 退款原因 |
| buyer_nick | 客户网名 | | 客户网名 |
| operator_name | 制单员姓名 | | 制单员姓名 |
| actual_refund_amount | 实际退款金额 | | 实际退款金额 |
| revert_reason_name | 驳回原因 | | 驳回原因 |
| return_warehouse_no | 退回仓库编号 | | 退回仓库编号 |
| direct_refund_amount | 非担保退款金额 | | 非担保退款金额 |
| receive_amount | 收款金额 | | 收款金额，买家支付给卖家 |
| customer_name | 客户姓名 | | 客户姓名 |
| fenxiao_nick_name | 分销商昵称 | | 分销商昵称，若无值则字段不返回 |
| status | 退换单状态 | | 10:已取消;20:待审核;30:已审核;40已推送:80:已结算;81:待回传;85:待过账;86:已过账;87:成本确认;90:已完成 |
| shop_id | 店铺id | | 店铺id |
| trade_id | 订单id | | 订单id |
| detail_list | 退换单详情 | | 退换单详情 |
| detail_list.rec_id | 退换单明细Id | | 明细唯一键 |
| detail_list.oid | 原始子单号 | | 原始子单号 |
| detail_list.trade_order_id | 订单明细id | | 订单明细id |
| detail_list.platform_id | 平台id | | 平台id，见附件 |
| detail_list.tid | 原始单号 | | 原始单号 |
| detail_list.trade_no | 系统订单编号 | | 系统订单编号 |
| detail_list.num | 数量 | | 实际发出数量 |
| detail_list.price | 价格 | | 价格, 系统订单明细分摊后价格 |
| detail_list.original_price | 原价 | | 原价, 系统订单明细成交价 |
| detail_list.refund_num | 退款数量 | | 退款数量 |
| detail_list.total_amount | 退款货品总额 | | 退款货品总额, 系统订单明细的分摊后金额 |
| detail_list.refund_amount | 退款金额 | | 已经退款的总金额 |
| detail_list.is_guarantee | 是否担保退款 | | 是否担保退款 |
| detail_list.goods_no | 货品编号 | | 货品编号 |
| detail_list.goods_name | 货品名称 | | 货品名称 |
| detail_list.spec_name | 规格名称 | | 规格名称 |
| detail_list.spec_no | 商家编码 | | 商家编码 |
| detail_list.goods_id | 平台货品id | | 平台货品id |
| detail_list.spec_id | 平台规格id | | 平台规格id |
| detail_list.sys_goods_id | 系统货品id | | 系统货品id（旺店通货品档案中货品维度自增生成的id） |
| detail_list.sys_spec_id | 系统规格id | | 系统规格id（旺店通货品档案中单品维度自增生成的id） |
| detail_list.spec_code | 规格码 | | 规格码 |
| detail_list.barcode | 条码 | | 条码 |
| detail_list.stockin_num | 退货入库数量 | | 退货入库数量 |
| detail_list.remark | 备注 | | 备注 |
| detail_list.api_spec_name | 平台规格名称 | | 平台规格名称 |
| detail_list.api_goods_name | 平台货品名称 | | 平台货品名称 |
| detail_list.modified | 最后修改时间 | | 最后修改时间 |
| detail_list.suite_no | 组合装编号 | | 组合装编号（单据中若不包含组合装，该字段不返回） |
| detail_list.suite_name | 组合装名称 | | 组合装名称（单据中若不包含组合装，该字段不返回） |
| detail_list.raw_refund_nos | 原始退款单号 | | 多个原始退款单号之间使用英文逗号隔开 |
| detail_list.swap_order | 换出订单 | | 非换货类型不返回 |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：销售退货新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillTypeID | 单据类型 | string | 单据类型 |
| FBillNo | 单据编号 | string | 单据编号 |
| FSaleOrgId | 销售组织 | string | 组织 |
| FDate | 日期 | string | 日期 |
| FStockOrgId | 库存组织 | string | 组织 |
| FRetcustId | 退货客户 | string | 基础资料 |
| FSaledeptid | 销售部门 | string | 基础资料 |
| FSettleCurrId | 结算币别 | string | 基础资料 |
| F_JHKJ_Text | 原始退款单号 | string | 基础资料 |
| F_JHKJ_Text1 | 退货原因 | string | 单选辅助资料列表 |
| F_JHKJ_Text11 | 退货成功时间 | string | 组织 |
| F_JHKJ_Text111 | 退货时间 | string | 基础资料 |
| FHeadNote | 备注 | string | 多行文本 |
| FEntity | 明细信息 | array | |
| FEntity.FMaterialId | 物料编码 | string | 基础资料 |
| FEntity.FBarcode | 零售条形码 | string | 文本 |
| FEntity.FRealQty | 实退数量 | string | 数量 |
| FEntity.FPrice | 单价 | string | 单价 |
| FEntity.FTaxPrice | 含税单价 | string | 单价 |
| FEntity.FIsFree | 是否赠品 | string | 复选框 |
| FEntity.FEntryTaxRate | 税率% | string | 小数 |
| FEntity.FReturnType | 退货类型 | string | 单选辅助资料列表 |
| FEntity.FOwnerId | 货主 | string | 多类别基础资料 |
| FEntity.FStockId | 仓库 | string | 基础资料 |
| FEntity.FNote | 备注 | string | 文本 |
| FEntity.SubHeadEntity | 财务信息 | object | |
| FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | 组织 |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.SubHeadEntity.Operation | 执行的操作 | string | |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FEntity.SubHeadEntity.SubSystemId | 系统模块 | string | 默认仓库模块 |
数据对接价值
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
