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

购买运输标签。

使用计划：

速率（每秒请求数）	突发
5	15

有关更多信息，请参阅销售合作伙伴 API 文档中的“使用计划和速率限制”。

请求参数

Body 参数application/json

示例

{
    "clientReferenceId": "string",
    "shipTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "st",
        "postalCode": "string",
        "email": "string",
        "copyEmails": [
            "string"
        ],
        "phoneNumber": "string"
    },
    "shipFrom": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "st",
        "postalCode": "string",
        "email": "string",
        "copyEmails": [
            "string"
        ],
        "phoneNumber": "string"
    },
    "shipDate": "2019-08-24T14:15:22Z",
    "serviceType": "Amazon Shipping Ground",
    "containers": [
        {
            "containerType": "PACKAGE",
            "containerReferenceId": "string",
            "value": {
                "value": 0,
                "unit": "str"
            },
            "dimensions": {
                "length": 0,
                "width": 0,
                "height": 0,
                "unit": "IN"
            },
            "items": [
                {
                    "quantity": 0,
                    "unitPrice": {
                        "value": 0,
                        "unit": "str"
                    },
                    "unitWeight": {
                        "unit": "g",
                        "value": 0
                    },
                    "title": "string"
                }
            ],
            "weight": {
                "unit": "g",
                "value": 0
            }
        }
    ],
    "labelSpecification": {
        "labelFormat": "PNG",
        "labelStockSize": "4x6"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/shipping/v1/purchaseShipment' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientReferenceId": "string",
    "shipTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "st",
        "postalCode": "string",
        "email": "string",
        "copyEmails": [
            "string"
        ],
        "phoneNumber": "string"
    },
    "shipFrom": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "st",
        "postalCode": "string",
        "email": "string",
        "copyEmails": [
            "string"
        ],
        "phoneNumber": "string"
    },
    "shipDate": "2019-08-24T14:15:22Z",
    "serviceType": "Amazon Shipping Ground",
    "containers": [
        {
            "containerType": "PACKAGE",
            "containerReferenceId": "string",
            "value": {
                "value": 0,
                "unit": "str"
            },
            "dimensions": {
                "length": 0,
                "width": 0,
                "height": 0,
                "unit": "IN"
            },
            "items": [
                {
                    "quantity": 0,
                    "unitPrice": {
                        "value": 0,
                        "unit": "str"
                    },
                    "unitWeight": {
                        "unit": "g",
                        "value": 0
                    },
                    "title": "string"
                }
            ],
            "weight": {
                "unit": "g",
                "value": 0
            }
        }
    ],
    "labelSpecification": {
        "labelFormat": "PNG",
        "labelStockSize": "4x6"
    }
}'

返回响应

🟢200成功

application/json

成功。

Headers

Body

示例

{
    "shipmentId": "89108749065090",
    "serviceRate": {
        "billableWeight": {
            "value": 4,
            "unit": "kg"
        },
        "totalCharge": {
            "value": 3.5,
            "unit": "GBP"
        },
        "serviceType": "Amazon Shipping Standard",
        "promise": {
            "deliveryWindow": {
                "start": "2018-08-25T20:22:30.737Z",
                "end": "2018-08-26T20:22:30.737Z"
            },
            "receiveWindow": {
                "start": "2018-08-23T09:22:30.737Z",
                "end": "2018-08-23T11:22:30.737Z"
            }
        }
    },
    "labelResults": [
        {
            "containerReferenceId": "CRI123456789",
            "trackingId": "1512748795322",
            "label": {
                "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)",
                "labelSpecification": {
                    "labelFormat": "PNG",
                    "labelStockSize": "4x6"
                }
            }
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障