抖店售后审核操作

一、接口名称

  • 接口名称:抖店售后审核操作
  • 接口地址: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);
}

说明:最外层 code0 表示蜂巢接口调用成功,非 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