1688买家提交退款货信息

POST

/v2/alibaba/refund/goods/return

请求参数

Header 参数

access-key

string

必需

默认值:

your-access-key

timestamp

string

必需

默认值:

your-timestamp

user-id

string

必需

默认值:

your-user-id

signature

string

必需

默认值:

your-signature

Body 参数application/json

refundId

string

退款单号，TQ开头

必需

logisticsCompanyNo

string

必需

物流公司编码，调用alibaba.logistics.OpQueryLogisticCompanyList.offline接口查询

freightBill

string

必需

物流公司运单号，请准确填写，否则卖家有权拒绝退款

description

string

可选

发货说明，内容在2-200个字之间

vouchers

array[string]

可选

凭证图片URLs，必须使用API alibaba.trade.uploadRefundVoucher返回的“图片域名/相对路径”，最多可上传 10 张图片；单张大小不超过1M；支持jpg、gif、jpeg、png、和bmp格式。请上传凭证，以便以后续赔所需（不上传将无法理赔）

示例

{
  "refundId": "string",
  "logisticsCompanyNo": "string",
  "freightBill": "string",
  "description": "string",
  "vouchers": [
    "string"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/alibaba/refund/goods/return' \
--header 'access-key;' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "refundId": "string",
    "logisticsCompanyNo": "string",
    "freightBill": "string",
    "description": "string",
    "vouchers": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

requestId

string

请求ID

可选

code

integer

返回码

可选

developId

integer

开发者ID

可选

msg

string

返回码对应信息

可选

data

object (AlibabaRefundReturnGoodSubmitVO)

返回内容

可选

errorCode

string

错误码

可选

errorInfo

string

错误描述

可选

success

boolean

是否提交成功

可选

示例

{
  "requestId": "",
  "code": 0,
  "developId": 0,
  "msg": "",
  "data": {
    "errorCode": "",
    "errorInfo": "",
    "success": false
  }
}

修改于 2025-04-24 09:44:27

1688创建退款退货申请

物流公司列表-所有的物流公司