旺店通·企业奇门与金蝶云星空对接集成查询退换管理连通销售退货新增(WDT-销售退货对接-废)
来源系统:旺店通·企业奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
写入目标:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据集成方案配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：旺店通·企业奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。
旺店通·企业奇门接口明细
- 调用接口：wdt.refund.query
- 接口名称：查询退换管理
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| process_status | 退换单处理状态 | string | |
| time_type | 时间类型 | string | |
| start_time | 开始时间 | string | 2022-11-21 15:00:20 |
| end_time | 结束时间 | string | 2022-11-21 16:00:20 |
| page_size | 分页大小 | string | {{PAGINATION_PAGE_SIZE}} |
| shop_no | 店铺编号 | string | |
| page_no | 页号 | string | |
| refund_no | Erp内退换单编号 | string | |
| src_refund_no | 平台原始退换单号 | string | |
| trade_no | 系统订单编号 | string | JY202211210458 |
| tid | 原始单号 | string | 4987066727038879364 |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| refund_id | 退换单主键 | string | |
| refund_no | erp退换单号 | string | |
| api_outer_no | API单号 | string | |
| platform_id | 平台类型 | string | |
| src_no | 平台退款单号 | string | |
| type | 类型 | string | |
| process_status | 处理状态 | string | |
| status | 平台状态 | string | |
| guarantee_mode | 担保方式 | string | |
| cs_status | 退款阶段 | string | |
| shop_no | 店铺编号 | string | |
| swap_trade_id | 换出原始单id | string | |
| pay_account | 买家支付帐号 | string | |
| pay_no | 支付订单号 | string | |
| goods_amount | 退货金额 | string | |
| refund_amount | 买家申请退款金额 | string | |
| direct_refund_amount | 线下退款金额 | string | |
| guarante_refund_amount | 平台退款金额 | string | |
| actual_refund_amount | 实际退款/收款金额 | string | |
| exchange_amount | 换货金额 | string | |
| post_amount | 邮费金额 | string | |
| other_amount | 其它金额 | string | |
| paid | 已退款/已收款 | string | |
| tid | 订单的原始单号 | string | |
| sales_trade_id | 系统订单ID | string | |
| sales_tid | 系统订单号 | string | |
| buyer_nick | 昵称 | string | |
| receiver_name | 收件人姓名 | string | |
| receiver_address | 收件人地址 | string | |
| receiver_telno | 收件人电话 | string | |
| return_name | 退货人姓名 | string | |
| return_mobile | 退货人手机号 | string | |
| return_telno | 退货人电话 | string | |
| return_address | 退回仓库地址 | string | |
| return_logistics_name | 退回物流公司名称 | string | |
| return_logistics_no | 退回物流单号 | string | |
| swap_receiver | 换货收件人姓名 | string | |
| swap_mobile | 换收发件人姓名手机 | string | |
| swap_telno | 换货收件人姓名电话 | string | |
| swap_province | 换货收件人省份 | string | |
| swap_city | 换货收件人城市 | string | |
| swap_district | 换货收件人区县 | string | |
| swap_area | 换货收件人省市区 | string | |
| swap_warehouse_no | 换出货品出库仓库编号 | string | |
| swap_address | 换货收件人姓名地址 | string | |
| warehouse_no | 期望退回的仓库编号 | string | |
| refund_time | 退款创建时间 | string | |
| remark | 退款说明 | string | |
| refund_reason | 退款原因 | string | |
| swap_trade_no | 换出原始单号 | string | |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：销售退货新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillTypeID | 单据类型 | string | XSTHD01_SYS |
| FBillNo | 单据编号 | string | {{refund_no}} |
| FSaleOrgId | 销售组织 | string | {{shop_no}} |
| FDate | 日期 | string | {{refund_time}} |
| FStockOrgId | 库存组织 | string | {{shop_no}} |
| FRetcustId | 退货客户 | string | {{shop_no}} |
| FSaledeptid | 销售部门 | string | {{shop_no}} |
| FHeadNote | 备注 | string | {{refund_reason}} |
| FEntity | 明细信息 | array | batch_details |
| FEntity.FMaterialId | 物料编码 | string | {{batch_details.spec_no}} |
| FEntity.FBarcode | 零售条形码 | string | |
| FEntity.FRealQty | 实退数量 | string | {{batch_details.stockin_num}} |
| FEntity.FPrice | 单价 | string | |
| FEntity.FTaxPrice | 含税单价 | string | {{batch_details.price}} |
| FEntity.FIsFree | 是否赠品 | string | |
| FEntity.FEntryTaxRate | 税率% | string | |
| FEntity.FReturnType | 退货类型 | string | |
| FEntity.FOwnerTypeId | 货主类型 | string | |
| FEntity.FOwnerId | 货主 | string | |
| FEntity.FStockId | 仓库 | string | {{warehouse_no}} |
| FEntity.FStocklocId | 仓位 | string | |
| FEntity.FLot | 批号 | string | {{batch_details.stockin_num}} |
| FEntity.FDeliveryDate | 退货日期 | string | |
| FEntity.FNote | 备注 | string | |
| FEntity.SubHeadEntity | 财务信息 | object | |
| FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | {{shop_no}} |
| FEntity.SubHeadEntity.FSettleCurrId | 结算币别 | string | PRE001 |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | SAL_RETURNSTOCK |
| FEntity.SubHeadEntity.Operation | 执行的操作 | string | Save |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
| FEntity.SubHeadEntity.SubSystemId | 系统模块 | string | 21 |
数据对接效果
全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。
