帮助中心GitHub

创建退货

创建新的退货请求

创建新的退货请求。退货可通过以下来源创建:

  • LABEL - 基于现有的面单(反转地址)
  • ORDER - 基于订单
  • MANUAL - 使用自定义地址手动录入

参数

请求体参数

sourceType string
来源类型:LABEL、ORDER 或 MANUAL
originalLabelId string
原始面单的 ID(用于 LABEL 来源)
returnFromAddress object
退货发出的客户地址
returnToAddress object
退货送达的仓库地址
reasonCategory string 必填
原因类别:DEFECTIVE、WRONG_ITEM、NOT_AS_DESCRIBED、CHANGE_OF_MIND、SIZE_ISSUE、DAMAGED_IN_SHIPPING、LATE_DELIVERY、OTHER
reasonDetails string
关于退货原因的补充说明

返回

200 退货创建成功
400 请求错误 - 缺少必填字段
401 需要身份验证

相关

returns
create
POST/api/returns
atoship © 2026