当前位置: API文档
aftersales_refund_create.php(创建系统售后单)
| 1.1 接口描述:创建系统售后单,---目前不支持换货 ,只支退货单,退货单类型只能是退款退货和退款不退货 基于系统单创建退款单 |
| 1.2 适用版本:网页版 |
1. 3注意事项:推送的原始退款单对应的销售订单必须在旺店通ERP内已经存在,否则无法生成系统售后单并进行处理。 注:仅支持自有/其他平台店铺 |
| 2.1 自研商城、分销系统、全渠道等系统对接 |
| 环境 | HTTP地址 |
|---|---|
| 测试环境 | https://openapitest.huice.com/openapi/aftersales_refund_create.php |
| 正式环境 | https://openapi.huice.com/openapi/aftersales_refund_create.php |
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
| 接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里 | |
| 时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
| 签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
| 名称 | 字段 | Y父级字段 | Y类型 | Y枚举 | 是否必须 |
| 退款单主信息 | refund_info | ||||
| 订单编号 | trade_no | refund_info | varchar(64) | 是 | |
| 退换类型 | type | refund_info | int | 2 退货退款 4 退款不退货 | 是 |
| 退回仓库ID | warehouse_id | refund_info | int | 仓库的id | 是 |
| 退回物流单号 | logistics_no | refund_info | varchar(64) | 否 | |
| 退回物流公司ID | logistics_code | refund_info | int | 物流公司的编码 枚举值在 第一页的系统物流公司编码 | 否 |
| 退回物流公司名称 | logisitcs_name | refund_info | varchar(64) | 物流公司名称 | 否 |
| 退回原因 | reason_id | refund_info | int | 1 尺码错误/不喜欢/效果差 2 商品质量问题 3 7 天无理由退货 4 重复购买 5 大小尺寸与描述不符合 6 不想买了 7 买错了 8 其他 | 否,不传为8 其他 |
| 店铺id | shop_id | refund_info | int | 是 | |
| 支付类型 | pay_type | refund_info | int | 1 线下支付 2 微信支付 3 支付宝支付 | 否 默认 1 |
| 退货明细信息 | refund_order_list | refund_info | |||
| trade_item_id | 系统订单明细id | refund_order_list | 是 | ||
| tid | 原始订单id | refund_order_list | varchar(64) | 是 | |
| oid | 原始子单id | refund_order_list | varchar(64) | 是 | |
| 规格id | spec_id | refund_order_list | bigint(20) | 是 | |
| 退款金额 | refund_amount | refund_order_list | decimal(19,4) | 否,不填写使用商品单价*退款数量 | |
| 退款数量 | refund_num | refund_order_list | decimal(19,4) | 是 |
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 | |
| 返回码 | code | int | 是 | 0成功 其他值失败 | 成功为0 异常有其他的编码 | |
| 返回message | message | varchar(255) | 否 | 成功时为空 | 成功为空,错误返回错误消息 | |
| 生成的退款单ID | refund_id | bigint(20) | 否 | 失败时无 |