查询售后详情

API文档最后更新: 2026-08-31

8.2 查询售后详情

  • 请求方式:GET

  • 请求地址:/aftersales/{platformCaseRef}

请求字段:

字段

位置

JSON 类型

必填

含义

platformCaseRef

Path

string

是

创建售后后由平台返回的售后编号

返回售后详情和消息列表:

{
  "code": 0,
  "message": "success",
  "data": {
    "platformCaseRef": "CP202607290001",
    "clientOrderRef": "PO-20260728-0001",
    "caseState": "handling",
    "issueType": "deliveryMismatch",
    "revision": 1785217100,
    "createdAt": 1785217000,
    "updatedAt": 1785217100,
    "messages": [
      {
        "messageRef": 501,
        "authorRole": "buyer",
        "format": "text",
        "body": "请协助核查",
        "createdAt": 1785217000
      },
      {
        "messageRef": 502,
        "authorRole": "buyer",
        "format": "image",
        "body": "https://buyer.example.com/evidence/1.jpg",
        "createdAt": 1785217000
      },
      {
        "messageRef": 503,
        "authorRole": "merchant",
        "format": "text",
        "body": "已收到,正在核查",
        "createdAt": 1785217100
      }
    ]
  },
  "requestId": "req_01K0EXAMPLE"
}

返回字段:

字段

JSON 类型

必填

含义

code

integer

是

固定为 0,表示请求成功

message

string

是

本次请求的处理说明

data

object

是

售后详情和消息列表

data.platformCaseRef

string

是

平台售后编号

data.clientOrderRef

string

是

售后关联的第三方订单号

data.caseState

string

是

submitted 已提交;handling 处理中;resolved 已处理完成;closed 已关闭

data.issueType

string

是

第三方提交的售后分类;未提交时为 other

data.revision

integer

是

售后最后更新时间,10 位 Unix 秒级时间戳

data.createdAt

integer

是

售后创建时间,10 位 Unix 秒级时间戳

data.updatedAt

integer

是

售后最后更新时间,10 位 Unix 秒级时间戳

data.messages

object[]

是

当前售后的全部第三方可见消息

data.messages[].messageRef

integer

是

售后消息编号

data.messages[].clientMessageRef

string

否

第三方追加消息时提交的消息编号;商户消息不返回

data.messages[].authorRole

string

是

buyer 第三方采购方发送;merchant 供货商发送

data.messages[].format

string

是

text 文字消息;image 公网 HTTPS 图片地址

data.messages[].body

string

是

消息正文;图片消息时是公网 HTTPS 图片地址

data.messages[].createdAt

integer

是

消息创建时间,10 位 Unix 秒级时间戳

requestId

string

是

本次请求编号,排查问题时提供给平台