处理售后

API文档最后更新: 2026-10-28

处理售后

通用鉴权、响应、返回字段和错误说明见接入指南。

回复、处理普通售后或微信投诉

POST /openapi/v1/admin/aftersales/5001/process

参数

类型

必填

说明

status

string

是

pending、processing、completed、terminated；微信投诉状态还受平台规则限制

replyContent

string

条件必填

回复正文，最多 255 字符；正文和附件至少一项非空

attachments

string[]

否

图片 URL，最多 5 项；每项为 HTTP/HTTPS URL，最长 255 字符

requestNo

string

是

8～48 位字母、数字、下划线或连字符；重复提交同一回复保持不变

{"status": "processing", "replyContent": "已收到，正在核实", "attachments": [], "requestNo": "reply_20261028_0001"}

普通售后、微信投诉成功响应：

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 1,
    "successCount": 1,
    "failedCount": 0,
    "successList": [{"index": 0, "id": 5001, "action": "processed"}],
    "failedList": []
  },
  "requestId": "req_example"
}

同一售后下，相同 requestNo 必须保持状态、正文和附件内容一致。已结束售后不能继续追加新处理。将售后设为 completed 本身不代表订单退款；退款需另按订单退款能力执行。

微信投诉遇到超时、待确认或处理中时，先查询售后详情及已同步消息，保留 requestId 与原 requestNo 核对结果，不要换编号盲目重复发送。

处理实物售后

仍使用 POST /aftersales/{id}/process。依据详情中的 serviceType、serviceStatus 选择动作，不指定上游或处理渠道。

action

用途

主要参数

reply

回复消息

message 必填，requestNo 必填

approve

同意申请

可传 message；仅当前状态允许时执行

reject

拒绝申请

可传 message

close

关闭售后

可传 message

receive_return

确认收到退货

可传 message；以当前服务状态为准

replacement_ship

寄出换货

carrierCode、trackingNo 必填，可传 message

message 最长 255 字符。实物回复的 requestNo 规则与普通回复相同。快递编码使用详情 physical.carrierOptions[].code，例如 sf_express，不要填写快递名称或第三方快递商编码。

{"action": "reply", "message": "请按约定寄回商品", "requestNo": "physical_reply_0001"}
{"action": "replacement_ship", "carrierCode": "sf_express", "trackingNo": "SFEXAMPLE0001", "message": "换货已寄出"}

实物处理成功时 data 直接为实物售后对象，包括 id、serviceType、serviceStatus、returnAddress、returnLogistics、replacementLogistics、carrierOptions，与普通售后批量结果结构不同。涉及退款的动作可能只受理退款，需继续查询订单确认。

上一篇下一篇