API文档

aftersales_refund_create.php（创建系统售后单）

¥标准

1.接口说明

1.1 接口描述：创建系统售后单，-支持退货和换货类型，退货单类型是退款退货和退款不退货基于系统单创建售后单

1.2 适用版本：网页版

1. 3注意事项：推送的售后单对应的销售订单必须在旺店通ERP内已经存在，否则无法生成系统售后单并进行处理

2.调用场景

2.1 自研商城、分销系统、全渠道等系统对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/aftersales_refund_create.php
正式环境	https://openapi.huice.com/openapi/aftersales_refund_create.php

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	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输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	Y父级字段	Y类型	Y枚举	是否必须
退款单主信息	refund_info
订单编号	trade_no	refund_info	varchar(64)		是
退换类型	type	refund_info	int	2 退货退款 3 换货 4 退款不退货	是
退回仓库ID	warehouse_id	refund_info	int	代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看	是
退回物流单号	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	代表店铺所有属性的唯一id，用于店铺区分，在旺店通ERP【绑定店铺】界面查看	是
支付类型	pay_type	refund_info	int	1 线下支付 2 微信支付 3 支付宝支付	否默认 1
换出收件人姓名	receiver_name	refund_info	varchar	换出收件人姓名	否
换出收件人手机号	receiver_mobile	refund_info	varchar	换出收件人手机号	否
换出收件人详细地址	receiver_address	refund_info	varchar	换出收件人详细地址	否
换出收件人省份	receiver_province	refund_info	varchar	换出收件人省份	否
换出收件人城市	receiver_city	refund_info	varchar	换出收件人城市	否
换出收件人区	receiver_district	refund_info	varchar	换出收件人区	否
退货明细信息	refund_order_list	refund_info
系统订单明细id	trade_item_id	refund_order_list			是
原始订单号	tid	refund_order_list	varchar(64)		否
原始子订单号	oid	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)		是
换货明细信息	exchange_order_list	refund_info		换货类型推送
换出商家编码	spec_no	exchange_order_list	bigint(20)	换出商家编码	否
换出数量	refund_num	exchange_order_list	decimal(19,4)	换出数量	否

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
返回码	code	int		是	0成功其他值失败	成功为0 异常有其他的编码
返回message	message	varchar(255)		否	成功时为空	成功为空，错误返回错误消息
生成的退款单ID	refund_id	bigint(20)		否		失败时无
售后单号	refund_no	varchar				失败时无

5.请求示例

PHP	<?php require_once("../WdtClient.php"); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ""; $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/aftersales_refund_create.php'; $refund_info = array( "trade_no" => "JY2603191166", "type"=> 2, "warehouse_id"=>38, "logistics_no"=> "JD2026032400002", "logistics_code"=> 59, "warehouse_id"=> 38, "reason_id"=> 2, "shop_id"=> 332, "pay_type"=> 2, "refund_order_list"=>array( array( "trade_item_id"=> '2807683938439398427',//trade_query_Y接口返回的rec_id "tid"=> "200733112e1233897", "oid"=> "192uu077890033399", "spec_id"=> "2807660532977371156", "refund_num"=> 2, "refund_amount"=> 45.00 ) ) ); $c->putApiParam('refund_info', json_encode($refund_info, JSON_UNESCAPED_UNICODE)); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON	{ "code": 0, "message": "", "refund_id": "2809436287763742727", "refund_no": "RT2603240022" }

6.2 异常响应示例

JSON	{ "code": 30402, "message": "订单明细id错误，请确认传值是否正确" }