旺店通·旗舰奇门和金蝶云星空接口打通对接实战

对接系统:旺店通·旗舰奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展
对接目标平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
配置集成方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取旺店通·旗舰奇门的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

旺店通·旗舰奇门接口明细
- 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 | 修改起始时间 | 2022-05-30 00:00:00 | 修改起始时间 |
params.modified_to | 修改结束时间 | 2022-05-31 00:00:00 | 修改结束时间 |
params.settle_from | 开始时间 | | 开始时间 |
params.settle_to | 结束时间 | | 结束时间 |
params.status | 退换单状态 | 40 | 退换单状态 |
params.stockin_status | 入库状态 | | 入库状态 |
params.type | 退换单类型 | 2 | 退换单类型 |
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 | 基础资料 |
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.FOwnerTypeId | 货主类型 | string | 多类别基础资料列表 |
FEntity.FOwnerId | 货主 | string | 多类别基础资料 |
FEntity.FStockId | 仓库 | string | 基础资料 |
FEntity.FStocklocId | 仓位 | string | 维度关联字段 |
FEntity.FLot | 批号 | string | 批次 |
FEntity.FDeliveryDate | 退货日期 | string | 长日期 |
FEntity.FNote | 备注 | string | 文本 |
FEntity.SubHeadEntity | 财务信息 | object | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | 组织 |
FEntity.SubHeadEntity.FSettleTypeId | 结算方式 | 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资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。
