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

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

使用计划：

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

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

请求参数

Body 参数application/json

提交货物确认操作的请求架构。

shipmentConfirmations

array[object (ShipmentConfirmation) {17}]

可选

一份一个或多个发货确认的清单。

shipmentIdentifier

string

必需

独特的货运ID（在过去365天内未使用）。

shipmentConfirmationType

enum<string>

必需

指示此货件确认是否为初始确认，或旨在替代已经发布的货件确认。如果替代现有的货件确认，请确保提供与之前确认中相同的shipmentIdentifier和sellingParty信息。

枚举值:

OriginalReplace

shipmentType

enum<string>

运输类型。

可选

枚举值:

TruckLoadLessThanTruckLoadSmallParcel

shipmentStructure

enum<string>

运输层级结构。

可选

枚举值:

PalletizedAssortmentCaseLooseAssortmentCasePalletOfItemsPalletizedStandardCaseLooseStandardCaseMasterPalletMasterCase

transportationDetails

object (TransportationDetailsForShipmentConfirmation)

此货物的运输详情。

可选

amazonReferenceNumber

string

可选

亚马逊参考编号是亚马逊为所有Collect/WePay发货在您提交路由请求时生成的唯一标识符。此字段对于Collect/WePay发货是必填的。

shipmentConfirmationDate

string <date-time>

必需

提交发货确认的日期。

shippedDate

string <date-time>

可选

货物从供应商位置出发的日期和时间。供应商需在离开其仓库/分销中心后30分钟内或至少在买方目的地仓库预约时间前6小时发送ASN，以先到者为准。发货确认中提及的发货日期不得为未来日期。

estimatedDeliveryDate

string <date-time>

可选

预计货物到达买方仓库的日期和时间。该估计需要基于发货地点与目的地之间的平均运输时间。在创建货物确认时，确切的预约时间将由买方提供，可能无法得知。

sellingParty

object (PartyIdentification)

必需

当事人的姓名/地址和税务详情。

shipFromParty

object (PartyIdentification)

必需

当事人的姓名/地址和税务详情。

shipToParty

object (PartyIdentification)

必需

当事人的姓名/地址和税务详情。

shipmentMeasurements

object (ShipmentMeasurements)

装运测量细节。

可选

importDetails

object (ImportDetails)

可选

仅在此货物为直接进口时提供这些字段。

shippedItems

array[object (Item) {5}]

必需

此运输中物品及其相关细节的清单。如果任何物品的详细信息字段在纸箱或托盘级别上是通用的，请在相应的纸箱或托盘级别提供它们。

cartons

array[object (Carton) {6}]

可选

本次发货的纸箱清单。

pallets

array[object (Pallet) {7}]

可选

这批货物中的托盘清单。

示例

{
    "shipmentConfirmations": [
        {
            "shipmentIdentifier": "string",
            "shipmentConfirmationType": "Original",
            "shipmentType": "TruckLoad",
            "shipmentStructure": "PalletizedAssortmentCase",
            "transportationDetails": {
                "carrierScac": "string",
                "carrierShipmentReferenceNumber": "string",
                "transportationMode": "Road",
                "billOfLadingNumber": "string"
            },
            "amazonReferenceNumber": "string",
            "shipmentConfirmationDate": "2019-08-24T14:15:22Z",
            "shippedDate": "2019-08-24T14:15:22Z",
            "estimatedDeliveryDate": "2019-08-24T14:15:22Z",
            "sellingParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipFromParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipToParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipmentMeasurements": {
                "grossShipmentWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "shipmentVolume": {
                    "unitOfMeasure": "CuFt",
                    "value": "string"
                },
                "cartonCount": 0,
                "palletCount": 0
            },
            "importDetails": {
                "methodOfPayment": "PaidByBuyer",
                "sealNumber": "string",
                "route": {
                    "stops": [
                        {
                            "functionCode": "PortOfDischarge",
                            "locationIdentification": {
                                "type": "string",
                                "locationCode": "string",
                                "countryCode": "string"
                            },
                            "arrivalTime": "2019-08-24T14:15:22Z",
                            "departureTime": "2019-08-24T14:15:22Z"
                        }
                    ]
                },
                "importContainers": "string",
                "billableWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "estimatedShipByDate": "2019-08-24T14:15:22Z",
                "handlingInstructions": "Oversized"
            },
            "shippedItems": [
                {
                    "itemSequenceNumber": "string",
                    "amazonProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "shippedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Cases",
                        "unitSize": 0
                    },
                    "itemDetails": {
                        "purchaseOrderNumber": "string",
                        "lotNumber": "string",
                        "expiry": {
                            "manufacturerDate": "2019-08-24T14:15:22Z",
                            "expiryDate": "2019-08-24T14:15:22Z",
                            "expiryAfterDuration": {
                                "durationUnit": "Days",
                                "durationValue": 0
                            }
                        },
                        "maximumRetailPrice": {
                            "currencyCode": "string",
                            "amount": "string"
                        },
                        "handlingCode": "Oversized"
                    }
                }
            ],
            "cartons": [
                {
                    "cartonIdentifiers": [
                        {
                            "containerIdentificationType": "SSCC",
                            "containerIdentificationNumber": "string"
                        }
                    ],
                    "cartonSequenceNumber": "string",
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "In"
                    },
                    "weight": {
                        "unitOfMeasure": "G",
                        "value": "string"
                    },
                    "trackingNumber": "string",
                    "items": [
                        {
                            "itemReference": "string",
                            "shippedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "itemDetails": {
                                "purchaseOrderNumber": "string",
                                "lotNumber": "string",
                                "expiry": {
                                    "manufacturerDate": "2019-08-24T14:15:22Z",
                                    "expiryDate": "2019-08-24T14:15:22Z",
                                    "expiryAfterDuration": {
                                        "durationUnit": "Days",
                                        "durationValue": 0
                                    }
                                },
                                "maximumRetailPrice": {
                                    "currencyCode": "string",
                                    "amount": "string"
                                },
                                "handlingCode": "Oversized"
                            }
                        }
                    ]
                }
            ],
            "pallets": [
                {
                    "palletIdentifiers": [
                        {
                            "containerIdentificationType": "SSCC",
                            "containerIdentificationNumber": "string"
                        }
                    ],
                    "tier": 0,
                    "block": 0,
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "In"
                    },
                    "weight": {
                        "unitOfMeasure": "G",
                        "value": "string"
                    },
                    "cartonReferenceDetails": {
                        "cartonCount": 0,
                        "cartonReferenceNumbers": [
                            "string"
                        ]
                    },
                    "items": [
                        {
                            "itemReference": "string",
                            "shippedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "itemDetails": {
                                "purchaseOrderNumber": "string",
                                "lotNumber": "string",
                                "expiry": {
                                    "manufacturerDate": "2019-08-24T14:15:22Z",
                                    "expiryDate": "2019-08-24T14:15:22Z",
                                    "expiryAfterDuration": {
                                        "durationUnit": "Days",
                                        "durationValue": 0
                                    }
                                },
                                "maximumRetailPrice": {
                                    "currencyCode": "string",
                                    "amount": "string"
                                },
                                "handlingCode": "Oversized"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipmentConfirmations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipmentConfirmations": [
        {
            "shipmentIdentifier": "string",
            "shipmentConfirmationType": "Original",
            "shipmentType": "TruckLoad",
            "shipmentStructure": "PalletizedAssortmentCase",
            "transportationDetails": {
                "carrierScac": "string",
                "carrierShipmentReferenceNumber": "string",
                "transportationMode": "Road",
                "billOfLadingNumber": "string"
            },
            "amazonReferenceNumber": "string",
            "shipmentConfirmationDate": "2019-08-24T14:15:22Z",
            "shippedDate": "2019-08-24T14:15:22Z",
            "estimatedDeliveryDate": "2019-08-24T14:15:22Z",
            "sellingParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipFromParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipToParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipmentMeasurements": {
                "grossShipmentWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "shipmentVolume": {
                    "unitOfMeasure": "CuFt",
                    "value": "string"
                },
                "cartonCount": 0,
                "palletCount": 0
            },
            "importDetails": {
                "methodOfPayment": "PaidByBuyer",
                "sealNumber": "string",
                "route": {
                    "stops": [
                        {
                            "functionCode": "PortOfDischarge",
                            "locationIdentification": {
                                "type": "string",
                                "locationCode": "string",
                                "countryCode": "string"
                            },
                            "arrivalTime": "2019-08-24T14:15:22Z",
                            "departureTime": "2019-08-24T14:15:22Z"
                        }
                    ]
                },
                "importContainers": "string",
                "billableWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "estimatedShipByDate": "2019-08-24T14:15:22Z",
                "handlingInstructions": "Oversized"
            },
            "shippedItems": [
                {
                    "itemSequenceNumber": "string",
                    "amazonProductIdentifier": "string",
                    "vendorProductIdentifier": "string",
                    "shippedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Cases",
                        "unitSize": 0
                    },
                    "itemDetails": {
                        "purchaseOrderNumber": "string",
                        "lotNumber": "string",
                        "expiry": {
                            "manufacturerDate": "2019-08-24T14:15:22Z",
                            "expiryDate": "2019-08-24T14:15:22Z",
                            "expiryAfterDuration": {
                                "durationUnit": "Days",
                                "durationValue": 0
                            }
                        },
                        "maximumRetailPrice": {
                            "currencyCode": "string",
                            "amount": "string"
                        },
                        "handlingCode": "Oversized"
                    }
                }
            ],
            "cartons": [
                {
                    "cartonIdentifiers": [
                        {
                            "containerIdentificationType": "SSCC",
                            "containerIdentificationNumber": "string"
                        }
                    ],
                    "cartonSequenceNumber": "string",
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "In"
                    },
                    "weight": {
                        "unitOfMeasure": "G",
                        "value": "string"
                    },
                    "trackingNumber": "string",
                    "items": [
                        {
                            "itemReference": "string",
                            "shippedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "itemDetails": {
                                "purchaseOrderNumber": "string",
                                "lotNumber": "string",
                                "expiry": {
                                    "manufacturerDate": "2019-08-24T14:15:22Z",
                                    "expiryDate": "2019-08-24T14:15:22Z",
                                    "expiryAfterDuration": {
                                        "durationUnit": "Days",
                                        "durationValue": 0
                                    }
                                },
                                "maximumRetailPrice": {
                                    "currencyCode": "string",
                                    "amount": "string"
                                },
                                "handlingCode": "Oversized"
                            }
                        }
                    ]
                }
            ],
            "pallets": [
                {
                    "palletIdentifiers": [
                        {
                            "containerIdentificationType": "SSCC",
                            "containerIdentificationNumber": "string"
                        }
                    ],
                    "tier": 0,
                    "block": 0,
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "In"
                    },
                    "weight": {
                        "unitOfMeasure": "G",
                        "value": "string"
                    },
                    "cartonReferenceDetails": {
                        "cartonCount": 0,
                        "cartonReferenceNumbers": [
                            "string"
                        ]
                    },
                    "items": [
                        {
                            "itemReference": "string",
                            "shippedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "itemDetails": {
                                "purchaseOrderNumber": "string",
                                "lotNumber": "string",
                                "expiry": {
                                    "manufacturerDate": "2019-08-24T14:15:22Z",
                                    "expiryDate": "2019-08-24T14:15:22Z",
                                    "expiryAfterDuration": {
                                        "durationUnit": "Days",
                                        "durationValue": 0
                                    }
                                },
                                "maximumRetailPrice": {
                                    "currencyCode": "string",
                                    "amount": "string"
                                },
                                "handlingCode": "Oversized"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢202成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

SubmitShipmentConfirmations 操作的响应架构。

payload

object (TransactionReference)

可选

提交装运确认操作的响应有效负载。

transactionId

string

可选

买方分配给该交易的GUID。此值可与交易状态API一起使用，以返回该交易的状态。

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
    "payload": {
        "transactionId": {
            "description": "亚马逊分配给此交易的GUID。它将在交易状态API中作为参考用于获取此交易的状态。",
            "type": "string"
        }
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障