申请售后V2

POST

/v2/afterSale

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

orderSn

string

三方订单号

必需

sku

number

商品sku

必需

num

number

申请售后的商品数量

必需

goodsFee

number

可选

期望退还的商品金额（分），仅退款时不用填写。
退货退款时，需要填写

logisticFee

number

必需

期望退还的运费金额（分）
仅做参考作用，具体以实际为准。

serviceTypeCode

string

必需

售后类型code
必须填写校验接口中serviceType项返回的code

pickTypeCode

string

可选

取件类型code
必须返回校验接口中pickType返回的code

packageTypeCode

string

可选

包装情况code
必须根据校验接口的返回情况，决定该项是否必须
如果必须，必须填写校验接口packageType中返回的code

returnTypeCode

string

可选

反件情况code必须根据校验接口的返回情况，决定该项是否必须如果必须，必须填写校验接口returnType中返回的code

reasonsTypeCode

string

可选

原因类型code
必须根据校验接口的返回情况，决定该项是否必须
如果必须，必须填写校验接口reasonsType中返回的code

reasonsDescription

string

必需

申请售后的原因，详细说明。
限制最长150个文字

serviceTime

string

可选

苏宁上门维修服务时间

vouchers

array[string]

可选

凭证图片列表
必须根据校验接口的返回情况，决定该项是否必须
如果必须，必须填写上传售后凭证接口返回的url
最多填写5个url

userInfo

object

可选

个人信息
仅当取件方式为上门取件、售后类型为维修、换货需要传递此项

consignee

string

联系人姓名

必需

phone

string

联系人电话

必需

province

string

省

必需

city

string

市

必需

area

string

区

必需

street

string

街道

必需

description

string

详细地址

必需

示例

{
    "orderSn": "string",
    "sku": 0,
    "num": 0,
    "goodsFee": 0,
    "logisticFee": 0,
    "serviceTypeCode": "string",
    "pickTypeCode": "string",
    "packageTypeCode": "string",
    "returnTypeCode": "string",
    "reasonsTypeCode": "string",
    "reasonsDescription": "string",
    "serviceTime": "string",
    "vouchers": [
        "string"
    ],
    "userInfo": {
        "consignee": "string",
        "phone": "string",
        "province": "string",
        "city": "string",
        "area": "string",
        "street": "string",
        "description": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/afterSale' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderSn": "string",
    "sku": 0,
    "num": 0,
    "goodsFee": 0,
    "logisticFee": 0,
    "serviceTypeCode": "string",
    "pickTypeCode": "string",
    "packageTypeCode": "string",
    "returnTypeCode": "string",
    "reasonsTypeCode": "string",
    "reasonsDescription": "string",
    "serviceTime": "string",
    "vouchers": [
        "string"
    ],
    "userInfo": {
        "consignee": "string",
        "phone": "string",
        "province": "string",
        "city": "string",
        "area": "string",
        "street": "string",
        "description": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

code

number

必需

msg

string

必需

data

object

必需

integer

必需

售后id号，需要保存，后续其他操作需要传递此id

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "id": 0
    }
}

上传售后凭证（图片）V2

售后列表V2