createFulfillmentReturn - Amazon Selling Partner API (SP-API)-中文

创建一个履行退货。

使用计划：

速率（每秒请求）	突发
2	30

x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制（如果可用）。上表指示了该操作的默认速率和突发值。业务需求要求更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

sellerFulfillmentOrderId

string

必需

卖方在创建履行订单时分配的标识符。卖方使用自己的记录根据买方要求退货的请求查找正确的 SellerFulfillmentOrderId 值。

Body 参数application/json

`createFulfillmentReturn` 操作为使用 `createFulfillmentOrder` 操作完成的商品创建退货。对于对 `createFulfillmentReturn` 的调用，您必须包括之前对 `listReturnReasonCodes` 操作返回的 `ReturnReasonCode` 值。

items

array[object (CreateReturnItem) {5}]

要返回的项目数组。

必需

sellerReturnItemId

string

必需

由卖方分配给退货物品的标识符。

<= 80 字符

sellerFulfillmentOrderItemId

string

必需

卖方在创建履行订单时分配给该项目的标识符。

amazonShipmentId

string

必需

与退货商品相关的货物标识符。

returnReasonCode

string

必需

卖方为退货项目分配的退货原因代码。

returnComment

string

可选

关于退货物品的附加评论。

<= 1000 字符

示例

{
    "items": [
        {
            "sellerReturnItemId": "string",
            "sellerFulfillmentOrderItemId": "string",
            "amazonShipmentId": "string",
            "returnReasonCode": "string",
            "returnComment": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`createFulfillmentReturn` 操作的响应模式。

payload

object (CreateFulfillmentReturnResult)

可选

createFulfillmentReturn 操作的结果。

returnItems

array[object (ReturnItem) {11}]

可选

亚马逊接受退货的商品数组。如果没有商品被接受退货，则返回空。

invalidReturnItems

array[object (InvalidReturnItem) {3}]

可选

无效退货项目信息的数组。

returnAuthorizations

array[object (ReturnAuthorization) {5}]

一组退货授权信息。

可选

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
    "payload": {
        "returnItems": [
            {
                "sellerReturnItemId": "string",
                "sellerFulfillmentOrderItemId": "string",
                "amazonShipmentId": "string",
                "sellerReturnReasonCode": "string",
                "returnComment": "string",
                "amazonReturnReasonCode": "string",
                "status": "New",
                "statusChangedDate": "2019-08-24T14:15:22Z",
                "returnAuthorizationId": "string",
                "returnReceivedCondition": "Sellable",
                "fulfillmentCenterId": "string"
            }
        ],
        "invalidReturnItems": [
            {
                "sellerReturnItemId": "string",
                "sellerFulfillmentOrderItemId": "string",
                "invalidItemReason": {
                    "invalidItemReasonCode": "InvalidValues",
                    "description": "string"
                }
            }
        ],
        "returnAuthorizations": [
            {
                "returnAuthorizationId": "string",
                "fulfillmentCenterId": "string",
                "returnToAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "districtOrCounty": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "amazonRmaId": "string",
                "rmaPageURL": "string"
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障