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

此API调用仅供供应商自有承运人（VOC）供应商使用。调用此API将提交供应商已发货包裹的运输状态更新。这将为亚马逊客户在包裹不在亚马逊网络可见性时提供其订单的可见性。

使用计划：

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

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

请求参数

Body 参数application/json

表示用于提交货物状态更新的请求有效载荷，包含一个或多个 `ShipmentStatusUpdate` 对象的数组。

shipmentStatusUpdates

array[object (ShipmentStatusUpdate) {4}]

可选

包含一个或多个 ShipmentStatusUpdate 对象的列表，每个对象代表特定货物状态的更新。

>= 1 items

purchaseOrderNumber

string

必需

更新货物状态的发货采购订单编号。

正则匹配:

^[a-zA-Z0-9]+$

sellingParty

object (PartyIdentification)

必需

一方的名称、地址和税务详情。

shipFromParty

object (PartyIdentification)

必需

一方的名称、地址和税务详情。

statusUpdateDetails

object (StatusUpdateDetails)

必需

供应商提供的特定包裹的运输状态更新详情。

示例

{
    "shipmentStatusUpdates": [
        {
            "purchaseOrderNumber": "string",
            "sellingParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string",
                        "taxRegistrationAddress": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "taxRegistrationMessages": "string"
                    }
                ]
            },
            "shipFromParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string",
                        "taxRegistrationAddress": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "taxRegistrationMessages": "string"
                    }
                ]
            },
            "statusUpdateDetails": {
                "trackingNumber": "string",
                "statusCode": "string",
                "reasonCode": "string",
                "statusDateTime": "2019-08-24T14:15:22Z",
                "statusLocationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "shipmentSchedule": {
                    "estimatedDeliveryDateTime": "2019-08-24T14:15:22Z",
                    "apptWindowStartDateTime": "2019-08-24T14:15:22Z",
                    "apptWindowEndDateTime": "2019-08-24T14:15:22Z"
                }
            }
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shipmentStatusUpdates' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipmentStatusUpdates": [
        {
            "purchaseOrderNumber": "string",
            "sellingParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string",
                        "taxRegistrationAddress": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "taxRegistrationMessages": "string"
                    }
                ]
            },
            "shipFromParty": {
                "partyId": "string",
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string",
                        "taxRegistrationAddress": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "taxRegistrationMessages": "string"
                    }
                ]
            },
            "statusUpdateDetails": {
                "trackingNumber": "string",
                "statusCode": "string",
                "reasonCode": "string",
                "statusDateTime": "2019-08-24T14:15:22Z",
                "statusLocationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "shipmentSchedule": {
                    "estimatedDeliveryDateTime": "2019-08-24T14:15:22Z",
                    "apptWindowStartDateTime": "2019-08-24T14:15:22Z",
                    "apptWindowEndDateTime": "2019-08-24T14:15:22Z"
                }
            }
        }
    ]
}'

返回响应

🟢202成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`submitShipmentStatusUpdates` 操作的响应架构。

payload

object (TransactionReference)

可选

包含交易ID的响应。

transactionId

string

可选

用于识别此事务的GUID。此值可以与事务状态API一起使用，以返回此事务的状态。

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
    "payload": {
        "transactionId": "string"
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障