抖店售后审核操作

一、接口名称

• 接口名称：抖店售后审核操作

• 接口地址：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 业务返回体。

四、成功示例

{
  "code": 0,
  "message": "ok",
  "data": {},
  "trace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}