The buyer submits the refund information

POST

/alibaba/refund/goods/return

请求参数

Header 参数

access-key

string

必需

默认值:

58c0201dfdf148eca63cbf6bb5e7cf03

nonce-str

string

可选

默认值:

nonce-str

timestamp

string

必需

默认值:

1715669977082

user-id

string

必需

默认值:

2100007341207

signature

string

必需

默认值:

B7F83FE2ADC8D8F044F2E01F0FFE8C80

Body 参数application/json

refundId

string

退款单号，TQ开头

必需

logisticsCompanyNo

string

必需

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

freightBill

string

必需

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

description

string | null

可选

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

vouchers

array[string] | null

可选

凭证图片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 '/alibaba/refund/goods/return' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--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 | null

请求ID

可选

code

integer | null

返回码

可选

developId

integer | null

开发者ID

可选

msg

string | null

返回码对应信息

可选

data

object (AlibabaRefundReturnGoodSubmitVO)

返回内容

可选

errorCode

string | null

错误码

可选

errorInfo

string | null

错误描述

可选

success

boolean | null

是否提交成功

可选

示例

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

修改于 2025-02-24 07:15:01

Create a refund and return application

List of logistics companies - all logistics companies