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

提交一个或多个供应商订单的发货确认。

使用计划：

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

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

请求参数

Body 参数application/json

`submitShipmentConfirmations` 请求模式。

shipmentConfirmations

array[object (ShipmentConfirmation) {6}]

可选

一系列 ShipmentConfirmation 对象，每个对象表示特定运输的确认详情。

purchaseOrderNumber

string

必需

与发货相对应的采购订单编号。

正则匹配:

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

shipmentDetails

object (ShipmentDetails)

必需

货物运输的详细信息。

sellingParty

object (PartyIdentification)

必需

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

shipFromParty

object (PartyIdentification)

必需

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

items

array[object (Item) {4}]

必需

提供该装shipment中物品的详细信息。如果任何物品的详细字段在包装或托盘级别上是共同的，则在相应的包装中提供它们。

containers

array[object (Container) {12}]

可选

提供该装shipment中物品的详细信息。如果任何物品的详细字段在包装或托盘级别上是共同的，则在相应的包装中提供它们。

示例

{
    "shipmentConfirmations": [
        {
            "purchaseOrderNumber": "string",
            "shipmentDetails": {
                "shippedDate": "2019-08-24T14:15:22Z",
                "shipmentStatus": "SHIPPED",
                "isPriorityShipment": true,
                "vendorOrderNumber": "string",
                "estimatedDeliveryDate": "2019-08-24T14:15:22Z"
            },
            "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"
                    }
                ]
            },
            "items": [
                {
                    "itemSequenceNumber": 0,
                    "buyerProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "shippedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "string"
                    }
                }
            ],
            "containers": [
                {
                    "containerType": "Carton",
                    "containerIdentifier": "string",
                    "trackingNumber": "string",
                    "manifestId": "string",
                    "manifestDate": "string",
                    "shipMethod": "string",
                    "scacCode": "string",
                    "carrier": "string",
                    "containerSequenceNumber": 0,
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "IN"
                    },
                    "weight": {
                        "unitOfMeasure": "KG",
                        "value": "string"
                    },
                    "packedItems": [
                        {
                            "itemSequenceNumber": 0,
                            "buyerProductIdentifier": "string",
                            "pieceNumber": 0,
                            "vendorProductIdentifier": "string",
                            "packedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "string"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shipmentConfirmations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipmentConfirmations": [
        {
            "purchaseOrderNumber": "string",
            "shipmentDetails": {
                "shippedDate": "2019-08-24T14:15:22Z",
                "shipmentStatus": "SHIPPED",
                "isPriorityShipment": true,
                "vendorOrderNumber": "string",
                "estimatedDeliveryDate": "2019-08-24T14:15:22Z"
            },
            "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"
                    }
                ]
            },
            "items": [
                {
                    "itemSequenceNumber": 0,
                    "buyerProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "shippedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "string"
                    }
                }
            ],
            "containers": [
                {
                    "containerType": "Carton",
                    "containerIdentifier": "string",
                    "trackingNumber": "string",
                    "manifestId": "string",
                    "manifestDate": "string",
                    "shipMethod": "string",
                    "scacCode": "string",
                    "carrier": "string",
                    "containerSequenceNumber": 0,
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "IN"
                    },
                    "weight": {
                        "unitOfMeasure": "KG",
                        "value": "string"
                    },
                    "packedItems": [
                        {
                            "itemSequenceNumber": 0,
                            "buyerProductIdentifier": "string",
                            "pieceNumber": 0,
                            "vendorProductIdentifier": "string",
                            "packedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "string"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢202成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

包含交易ID的响应。

transactionId

string

可选

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

示例

{
    "transactionId": "string"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障