抖店售后审核操作
一、接口名称
- 接口名称:抖店售后审核操作
- 接口地址:
https://kf.fw199.com/gateway/dd/after/operate - 请求方式:
POST - Content-Type:
application/x-www-form-urlencoded - 抖店官方文档:售后审核操作 /afterSale/operate
- 操作类型枚举说明:type 枚举值
二、请求参数
公共参数
| 参数名 |
类型 |
是否必需 |
说明 |
| appid |
string |
必需 |
应用 appid |
| timestamp |
string |
必需 |
时间戳(毫秒) |
| sign |
string |
必需 |
参数签名 |
业务参数
| 参数名 |
类型 |
是否必需 |
说明 |
| seller_nick |
string |
必需 |
抖店店铺标识(轻打单授权后的 shop_id) |
| sysid |
string |
否 |
上游应用标识,默认 208(抖店轻打单) |
| request_data |
string |
必需 |
售后审核请求 JSON 字符串,结构见下文 |
request_data 结构
| 参数名 |
类型 |
是否必需 |
说明 |
| type |
number |
必需 |
操作类型,见枚举说明 |
| items |
array |
必需 |
操作售后详情列表,至少 1 条 |
| store_id |
number |
否 |
门店 ID,抖超小时达业务使用 |
items[] 字段说明
| 参数名 |
类型 |
是否必需 |
说明 |
| aftersale_id |
string |
必需 |
售后单号 |
| repair_type |
number |
否 |
维修类型:1 原商品维修;2 商品换新 |
| reason |
string |
否 |
操作原因,拒绝操作必填 |
| remark |
string |
否 |
操作评论,拒绝操作必填 |
| evidence |
array |
否 |
操作凭证,拒绝且 evidence_need=Y 时必填 |
| logistics |
object |
否 |
同意退货/换货物流信息;type=101/301/311 时需传 |
| reject_reason_code |
number |
否 |
售后拒绝原因码,拒绝时必填;通过 /afterSale/rejectReasonCodeList 获取 |
| update_time |
number |
否 |
售后单版本校验,建议传 /afterSale/Detail 或消息推送中的 update_time |
evidence[] 字段说明
| 参数名 |
类型 |
是否必需 |
说明 |
| type |
number |
否 |
凭证类型:1 图片,2 视频(暂不支持),3 音频,4 文字 |
| url |
string |
否 |
凭证 URL |
| desc |
string |
否 |
凭证描述 |
logistics 字段说明
| 参数名 |
类型 |
是否必需 |
说明 |
| company_code |
string |
条件必需 |
物流公司 code,type=311 换货发货时必填 |
| logistics_code |
string |
条件必需 |
物流单号,type=311 换货发货时必填 |
| receiver_address_id |
number |
否 |
商家收件地址 id(推荐),通过 /address/list 获取 |
| sender_address_id |
number |
否 |
已废弃 |
| after_sale_address_detail |
object |
否 |
已废弃,请改用 receiver_address_id |
三、请求示例代码(Java)
@Test
public void ddAfterOperate() throws Exception {
String apiUrl = "https://kf.fw199.com/gateway/dd/after/operate";
String requestData = "{"
+ "\"type\":111,"
+ "\"items\":[{"
+ "\"aftersale_id\":\"6959800000297566494\","
+ "\"reason\":\"商品有破损\","
+ "\"remark\":\"商品有污渍,影响二次销售\""
+ "}]"
+ "}";
Map<String, String> data = new HashMap<>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis();
data.put("timestamp", timestamp.toString());
data.put("seller_nick", "168434755");
data.put("sysid", "208");
data.put("request_data", requestData);
data.put("sign", Utils.Sign(data, Config.AppSecret));
String result = doHttpRequest(apiUrl, data);
System.out.println("result:" + result);
}
说明:最外层 code 为 0 表示蜂巢接口调用成功,非 0 为失败,message 包含失败原因。data 为抖店 /afterSale/operate 业务返回体。
4.1 成功示例
{
"code": 0,
"message": "ok",
"data": {},
"trace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
文档更新时间: 2026-07-29 17:36 作者:admin