创建售后

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

8. 售后

8.1 创建售后

  • 请求方式：POST

  • 请求地址：/aftersales

请求：

{
  "clientOrderRef": "PO-20260728-0001",
  "issueType": "deliveryMismatch",
  "initialMessage": "请协助核查",
  "evidenceUrls": [
    "https://buyer.example.com/evidence/1.jpg"
  ]
}

请求字段：

字段

JSON 类型

必填

含义

clientOrderRef

string

是

要申请售后的第三方订单号

issueType

string

否

第三方自己的售后分类；1 至 64 个字符，只能使用字母、数字、短横线和下划线；不填时返回 other

initialMessage

string

是

问题说明，1 至 255 个字符

evidenceUrls

string[]

否

公网 HTTPS 图片地址数组，最多 10 个，每个地址最多 255 个字符

返回字段：

字段

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

是

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

返回示例（首次创建，包含问题说明和一张凭证图片）：

{
  "code": 0,
  "message": "success",
  "data": {
    "platformCaseRef": "CP202607290001",
    "clientOrderRef": "PO-20260728-0001",
    "caseState": "submitted",
    "issueType": "deliveryMismatch",
    "revision": 1785217000,
    "createdAt": 1785217000,
    "updatedAt": 1785217000,
    "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
      }
    ]
  },
  "requestId": "req_01K0EXAMPLE"
}

使用规则：

  • initialMessage 最多 255 个字符。

  • evidenceUrls 最多 10 个，只允许 HTTPS，每个 URL 最多 255 个字符。

  • issueType 选填，用于填写第三方自己的售后分类；长度为 1 至 64 个字符，只能使用字母、数字、短横线和下划线；不填写时按 other 处理。

  • 订单必须属于当前账户，且 allowedActions 包含 openCase。

  • 每个订单只会有一笔售后。第一次调用会创建售后并返回平台生成的 platformCaseRef；同一订单再次调用会返回原售后，不会重复添加首条消息或图片。后续补充内容请调用追加售后消息接口。

上一篇下一篇