purchaseShipment

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/shipping/v1/purchaseShipment

购买运输标签。

使用计划：

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

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

请求参数

Body 参数application/json必填

示例

{
    "requestToken": "string",
    "rateId": "string",
    "requestedDocumentSpecification": {
        "format": "PDF",
        "size": {
            "width": 0,
            "length": 0,
            "unit": "INCH"
        },
        "dpi": 0,
        "pageLayout": "string",
        "needFileJoining": true,
        "requestedDocumentTypes": [
            "PACKSLIP"
        ],
        "requestedLabelCustomization": {
            "requestAttributes": [
                "PACKAGE_CLIENT_REFERENCE_ID"
            ]
        }
    },
    "requestedValueAddedServices": [
        {
            "id": "string"
        }
    ],
    "additionalInputs": {
        "property1": "string",
        "property2": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/shipping/v1/purchaseShipment' \
--header 'Content-Type: application/json' \
--data '{
    "requestToken": "string",
    "rateId": "string",
    "requestedDocumentSpecification": {
        "format": "PDF",
        "size": {
            "width": 0,
            "length": 0,
            "unit": "INCH"
        },
        "dpi": 0,
        "pageLayout": "string",
        "needFileJoining": true,
        "requestedDocumentTypes": [
            "PACKSLIP"
        ],
        "requestedLabelCustomization": {
            "requestAttributes": [
                "PACKAGE_CLIENT_REFERENCE_ID"
            ]
        }
    },
    "requestedValueAddedServices": [
        {
            "id": "string"
        }
    ],
    "additionalInputs": {
        "property1": "string",
        "property2": "string"
    }
}'

返回响应

🟢200成功

application/json

成功。

Headers

Bodyapplication/json

示例

{
    "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服务器故障

修改于 2026-08-27 14:11:17

retrieveShippingLabel

getRates