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

confirmShipment

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/orders/v0/orders/{orderId}/shipmentConfirmation

Orders

更新指定订单的发货确认状态。

使用计划：

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

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

请求参数

Path 参数

orderId

string

必需

亚马逊定义的订单标识符，格式为3-7-7。

Body 参数application/json

货运确认的请求模式。

packageDetail

object (PackageDetail)

包裹的特性

必需

packageReferenceId

string

必需

卖方提供的标识符，在订单范围内唯一标识一个包裹。仅支持正数值。

carrierCode

string

必需

识别将交付包裹的承运人。此字段对于所有市场都是必需的。有关可接受的 CarrierCode 值，请参阅 CarrierCode 的列表。

carrierName

string

可选

将送货包裹的承运人名称。当 carrierCode 为“其他”时必填。

shippingMethod

string

可选

用于发货订单的运输方式。

trackingNumber

string

必需

用于获取追踪和投递信息的追踪号码。

shipDate

string <date-time>

必需

包裹的发货日期。必须采用ISO 8601日期/时间格式。

shipFromSupplySourceId

string

可选

供应来源的唯一标识符。

orderItems

array[object (ConfirmShipmentOrderItem) {3}]

订单项目清单。

必需

codCollectionMethod

enum<string>

可选

仅支持JP的代码收集方法。

枚举值:

DirectPayment

marketplaceId

string

必需

未混淆的市场标识符。

示例

{
    "packageDetail": {
        "packageReferenceId": "string",
        "carrierCode": "string",
        "carrierName": "string",
        "shippingMethod": "string",
        "trackingNumber": "string",
        "shipDate": "2019-08-24T14:15:22Z",
        "shipFromSupplySourceId": "string",
        "orderItems": [
            {
                "orderItemId": "string",
                "quantity": 0,
                "transparencyCodes": [
                    "string"
                ]
            }
        ]
    },
    "codCollectionMethod": "DirectPayment",
    "marketplaceId": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/orders/v0/orders//shipmentConfirmation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "packageDetail": {
        "packageReferenceId": "string",
        "carrierCode": "string",
        "carrierName": "string",
        "shippingMethod": "string",
        "trackingNumber": "string",
        "shipDate": "2019-08-24T14:15:22Z",
        "shipFromSupplySourceId": "string",
        "orderItems": [
            {
                "orderItemId": "string",
                "quantity": 0,
                "transparencyCodes": [
                    "string"
                ]
            }
        ]
    },
    "codCollectionMethod": "DirectPayment",
    "marketplaceId": "string"
}'