purchaseShipment

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/shipping/v2/shipments

购买运输服务并返回与购买相关的详细信息和文件。

注意：您必须在运输服务提供商创建费率后10分钟内完成购买。如果您在10分钟过期后发出请求，将收到错误响应，错误代码为“TOKENS_EXPIRED”。如果收到此错误响应，则必须再次获取该货物的费率。

使用计划：

费率（每秒请求）	突发
80	100

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

请求参数

Header 参数

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"
        ]
    },
    "requestedValueAddedServices": [
        {
            "id": "string"
        }
    ],
    "additionalInputs": {
        "property1": null,
        "property2": null
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

成功。

Headers

Body

示例

{
    "shipmentId": "87852211788104",
    "packageDocumentDetails": [
        {
            "packageClientReferenceId": "abcd",
            "packageDocuments": [
                {
                    "type": "LABEL",
                    "format": "PNG",
                    "contents": "sdioadaiosfhdodsaiufhouafhoudfhdouahfac=="
                }
            ],
            "trackingId": 1578648261977
        }
    ],
    "promise": {
        "pickupWindow": {
            "start": "2019-12-11T07:09:05.513Z",
            "end": "2019-12-11T09:09:05.513Z"
        },
        "deliveryWindow": {
            "start": "2019-12-13T07:09:05.513Z",
            "end": "2019-12-13T09:09:05.513Z"
        }
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-06-15 14:55:06

directPurchaseShipment

oneClickShipment