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

返回响应

🟢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服务器故障