API文档

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

1.接口说明

1.1 接口描述：创建无源（无原销售单）售后单，目前仅支持来源为「手工建单」场景

1.2 适用版本：网页版

1. 3注意事项：

①针对线下批发业务，售后批量退回时，可向系统推送无源售后单

②不依赖原销售订单，按店铺 + 商家编码（新）+ 数量直接建单

③当前仅支持退换类型：2-退货退款、4-退款不退货

④单据来源固定为手工建单，无需入参

2.调用场景

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

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/aftersales_refund_sourceless_create.php
正式环境	https://openapi.huice.com/openapi/aftersales_refund_sourceless_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
店铺编号	shop_no	refund_info	varchar(40)	代表店铺所有属性的唯一编号，用于店铺区分，在旺店通ERP【绑定店铺】界面查看	是
退换类型	type	refund_info	int	2 退货退款 4 退款不退货	是
退货金额（货品金额）	return_spu_amount	refund_info	decimal(19,4)	退货金额（货品金额）	否
平台售后单号	platform_refund_n	refund_info	string	外部/平台侧售后单号，可空	否
退货仓库编码	warehouse_no	refund_info	string	退货仓库编码（系统仓库编号）	是
是否确认	is_check	refund_info	int	0：仅保存（默认）；1：确认	否
退款原因	reason_id	refund_info	int	1、尺码错误/不喜欢/效果差 2、商品质量问题3、7天无理由退货4、重复购买5、大小尺寸与描述不符合6、不想买了7、买错了8、其他（不传默认8-其他）	否
退回快递单号	logistics_no	refund_info	string(64)	退货物流单号	否
退回物流公司类型	logisitcs_code	refund_info	string	退回物流公司类型，物流类型枚举单击此处	否
退货明细信息	refund_order_list	refund_info
商家编	spec_no	refund_order_list		系统货品商家编码	是
退款金额	refund_amoun	refund_order_list	decimal(19,4)	不传时按「商品零售价 × 退款数量」计算；若商品未维护零售价则必传	否
退款数量	refund_num	refund_order_list	decimal(19,4)	退款数量	是

4.响应参数

4.1 公共响应参数

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_sourceless_create.php'; $refund_info = array( "trade_no" => "JY2603191166", "type"=> 2, "warehouse_no"=>38, "reason_id"=> 2, "shop_no"=> 332, "refund_order_list"=>array( array( "spec_no"=> "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

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

JSON	{ "code": 30402, "message": "请确认传值是否正确" }