Learn how to integrate Amazon's Fulfillment Inbound API with the Send-to-Amazon (STA) interface on Seller Central. This guide includes essential workflow steps, Postman collections, sample code, and insights for managing Fulfillment By Amazon (FBA) shipments across various workflows.
了解如何将亚马逊的 Fulfillment Inbound API 与 Seller Central 上的 Send-to-Amazon (STA) 界面集成。本指南包括基本工作流程步骤、Postman 集合、示例代码以及在各种工作流程中管理亚马逊履行 (FBA) 发货的见解。

Use cases supported 支持的用例

The Fulfillment Inbound v2024 API supports several ways to create shipments:
Fulfillment Inbound v2024 API 支持多种创建货运的方法：

1. Small Parcel Delivery (SPD) with an Amazon-partnered carrier (PCP): Sellers can create inbound shipments using Amazon's partnered carriers for small parcel deliveries (that is, individual boxes).
   使用亚马逊合作承运商 (PCP) 进行小包裹递送 (SPD)：卖家可以使用亚马逊合作承运商创建进站发货，进行小包裹交付（即单个包装盒）。
2. Small Parcel Delivery (SPD) with a non-partnered carrier (nPCP): Sellers can use non-partnered carriers (that is, their own transportation carriers) for small parcel deliveries. Sellers can choose their preferred shipping carriers and still have access to the benefits of FBA.
   使用非合作承运商 (nPCP) 进行小包裹递送 (SPD)：卖家可以使用非合作承运商（即自己的运输承运商）进行小包裹交付。卖家可以选择自己喜欢的运输承运商，同时还能享受 FBA 的好处。
3. Pallets (LTL/FTL) with an Amazon-partnered carrier (PCP): For larger shipments, sellers can create pallet deliveries using Amazon's partnered carriers. This method is ideal for bulk shipments that require less-than-truckload (LTL) or full-truckload (FTL) services.
   使用亚马逊合作承运商 (PCP) 交付托盘（零担/整车）：对于大宗货物，卖家可以使用亚马逊合作承运商创建托盘交付。这种方法非常适合需要零担（LTL）或整车（FTL）服务的大宗货物。
4. Pallets (LTL/FTL) with non-partnered carriers (nPCP): Sellers have greater control over the logistics of larger shipments by using their own non-partnered carriers.
   使用非合作承运商（nPCP）的托盘（零担/整车）：卖方通过使用自己的非合作承运商，可以更好地控制大型货运的物流。
5. Pallet deliveries with the Pack Later option: Sellers can create pallet deliveries even when carton or box packing information isn’t provided upfront. This “Pack Later” flexibility enables sellers to finalize packing details later.
   使用稍后包装选项进行托盘交付：即使事先未提供纸箱或纸盒包装信息，卖家也可以创建托盘交付。这种 "稍后包装 "的灵活性使卖家可以稍后确定包装细节。
6. Retrieve inbound plan details: Sellers can retrieve detailed information about their inbound plans through GET operations, which allows them to track and manage their shipments.
   检索入站计划详细信息：卖家可通过 GET 操作检索入站计划的详细信息，从而跟踪和管理货运。

Postman collections 邮差系列

To help test operations, you can use Postman collections. These Postman collections include requests and responses that you can use to experiment with various endpoints and functionalities.
为帮助测试操作，您可以使用 Postman 集合。这些 Postman 集合包括请求和响应，您可以用它们来试验各种端点和功能。

1. Small Parcel Delivery (SPD) with an Amazon-partnered carrier (PCP)
   使用亚马逊合作承运商 (PCP) 进行小包裹递送 (SPD)
2. Small Parcel Delivery (SPD) with a non-partnered carrier (nPCP)
   使用非合作承运商（nPCP）进行小包裹递送（SPD）
3. Pallets (LTL/FTL) with an Amazon-partnered carrier (PCP)
   使用亚马逊合作承运商 (PCP) 的托盘（零担/整车运输）
4. Pallets (LTL/FTL) with non-partnered carriers (nPCP)
   托盘（零担/整车）与非合作承运商（nPCP）
5. Pallet deliveries with the Pack Later option
   使用稍后包装选项进行托盘交付
6. Retrieve inbound plan details
   检索入站计划详情

Sample code application 应用代码示例

The Fulfillment Inbound Sample Solution Code App includes detailed code samples and all the necessary resources to deploy a fully functional SP-API application that uses the Fulfillment Inbound API v2024-03-20. You can adjust the code to fit your specific requirements.
Fulfillment Inbound 示例解决方案代码应用程序包括详细的代码示例和所有必要资源，可用于部署使用 Fulfillment Inbound API v2024-03-20 的全功能 SP-API 应用程序。您可以调整代码以满足您的特定要求。

For guidance on use cases 1-4, refer to the following tutorials. Before you follow these tutorials, complete the necessary setup and pre-requisites outlined in the use case guide to access the Fulfillment Inbound API.
有关用例 1-4 的指导，请参阅以下教程。在学习这些教程之前，请完成用例指南中列出的必要设置和前提条件，以便访问 Fulfillment Inbound API。

Tutorial 1: Inbound shipments with an Amazon-partnered carrier (PCP)
教程 1：使用亚马逊合作承运商 (PCP) 托运货物

Learn how to inbound Small Parcel Deliveries (SPD) or pallets (LTL/FTL) with an Amazon-partnered transportation carrier using the Fulfillment Inbound API.
了解如何使用 Fulfillment Inbound API 与亚马逊合作的运输承运商一起入站小包裹递送 (SPD) 或托盘（零担/整车）。

Step 1. Create an inbound plan
步骤 1.制定入境计划

Operation 运行

• createInboundPlan

Parameters 参数

• destinationMarketplaces: Target marketplaces for shipment.
  destinationMarketplaces : 目标市场发货。
• sourceAddress: Address from which items are shipped.
  sourceAddress : 发货地址。
• items:
  • prepOwner: Preparation owner.
    prepOwner : 准备工作负责人。
  • labelOwner: Labeling owner.
    labelOwner : 标签所有者。
  • msku: Merchant SKU.
  • itemQuantity: Quantity of items.
    itemQuantity : 物品数量。

Response 回应

• Includes inboundPlanId and operationId to check the status of inbound plan creation.
  包括 inboundPlanId 和 operationId 以检查入站计划的创建状态。

📘

Note 备注

POST operations are asynchronous. Check the status of a POST operation by passing its operationId to getInboundOperationStatus.
POST 操作是异步的。通过将 operationId 传递给 getInboundOperationStatus 来检查 POST 操作的状态。

Step 2. Generate packing options
步骤 2.生成包装选项

Operation 运行

• generatePackingOptions

Parameters 参数

• inboundPlanId: Use the inbound plan ID created in Step 1.
  inboundPlanId ：使用在步骤 1 中创建的入站计划 ID。

Response 回应

• operationId: An ID that you can use to check the status of packing options generation.
  operationId ：用于检查打包选项生成状态的 ID。

Step 3. List packing options
步骤 3.列出包装选项

Operation 运行

• listPackingOptions

Parameters 参数

• inboundPlanId: Input the inbound plan ID.
  inboundPlanId ：输入输入计划 ID。

Response 回应

• Includes available packingOptions. Each packing option is represented by a packingOptionId.
  包括可用的 packingOptions 。每个包装选项用 packingOptionId 表示。
• Each packing option contains one or more packingGroups, identified by packingGroupId. Each packing group includes a list of SKUs that should be packed together.
  每个包装选项包含一个或多个 packingGroups ，由 packingGroupId 标识。每个包装组包括一个应包装在一起的 SKU 列表。

To view the SKU items in a packing group, call listPackingGroupItems with the packing group's packingGroupId.
要查看包装组中的 SKU 项目，请使用包装组的 packingGroupId 调用 listPackingGroupItems 。

📘

Note 备注

Choose only one packing option (packingOptionId).
只选择一个包装选项 ( packingOptionId )。

Response example 响应示例

{
  "packingOptions": [
    {
      "packingGroups": [
        "pg1xxxxxxxxxxxxxxxxxxx",
        "pg2yyyyyyyyyyyyyyyyyyy"
      ],
      "fees": [x],
      "discounts": [x],
      "packingOptionId": "poxxxxxxxxxxxxxxxxxxxx",
      "supportedShippingConfigurations": [x],
      "status": "xxxxxx"
    }
  ],
  "pagination": {}
}

Step 4. Confirm packing option
步骤 4.确认包装选项

Operation 运行

• confirmPackingOption

Parameters 参数

• inboundPlanId: The ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• packingOptionId: The chosen packing option ID. You can only confirm one option per inbound plan.
  packingOptionId ：所选包装选项 ID。每个进货计划只能确认一个选项。

Response 回应

• operationId: An ID that you can use to check the status of the packing confirmation.
  operationId ：用于检查包装确认状态的 ID。

Step 5. Set packing information
步骤 5.设置包装信息

Operation 运行

• setPackingInformation

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• packingGroupId: ID for each packing group within the chosen packing option.
  packingGroupId ：所选包装选项中每个包装组的 ID。
• boxes: Includes box contents source, box dimensions (weight and quantity), items with prep info, and item quantities matching the inbound plan.
  boxes ：包括包装箱内容源、包装箱尺寸（重量和数量）、带有预处理信息的物品以及与进货计划相匹配的物品数量。

Response 回应

• operationId: An ID that you can use to check the status of the API call.
  operationId ：用于检查 API 调用状态的 ID。

Request example 请求示例

{
  "packageGroupings": [
    {
      "boxes": [
        {
          "contentInformationSource": "BOX_CONTENT_PROVIDED",
          "dimensions": {
            "height": 10,
            "length": 10,
            "unitOfMeasurement": "IN",
            "width": 10
          },
          "quantity": 1,
          "weight": {
            "unit": "LB",
            "value": 2
          },
          "items": [
            {
              "labelOwner": "AMAZON",
              "msku": "SKU12345",
              "prepOwner": "AMAZON",
              "quantity": 1
            }
          ]
        }
      ],
      "packingGroupId": "pg1xxxxxxxxxxxxxxxxxxx"
    },
    {
      "boxes": [
        {
          "contentInformationSource": "BOX_CONTENT_PROVIDED",
          "dimensions": {
            "height": 10,
            "length": 10,
            "unitOfMeasurement": "IN",
            "width": 10
          },
          "quantity": 1,
          "weight": {
            "unit": "LB",
            "value": 1
          },
          "items": [
            {
              "labelOwner": "SELLER",
              "msku": "SKU67890",
              "prepOwner": "SELLER",
              "quantity": 1
            }
          ]
        }
      ],
      "packingGroupId": "pg2yyyyyyyyyyyyyyyyyyy"
    }
  ]
}

Step 6. Generate placement options
步骤 6.生成放置选项

Operation 运行

generatePlacementOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。

Response 回应

• operationId: An ID that you can use to check the status of placement options generation.
  operationId ：用于检查放置选项生成状态的 ID。

Step 7. List placement options
第 7 步列出位置选项

Operation 运行

• listPlacementOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。

Response 回应

• Includes available placementOptions, each represented by a placementOptionId.
  包括可用的 placementOptions ，每个 placementOptions 由一个 placementOptionId 表示。
• Each placementOptionId includes one or more shipmentIds and details on fees or discounts.
  每个 placementOptionId 包括一个或多个 shipmentIds 以及费用或折扣详情。

📘

Note 备注

Choose only one placement option (placementOptionId).
只选择一个放置选项 ( placementOptionId )。

Response example 响应示例

"placementOptions": [
  {
    "fees": [
      {
        "description": "Placement service fee represents service to inbound with minimal shipment splits and destinations of skus",
        "type": "FEE",
        "value": {
          "amount": 1.10,
          "code": "USD"
        },
        "target": "Placement Services"
      }
    ],
    "shipmentIds": [
      "shxxxxxxxxxxxxxxx",
      "shxxxxxxxxxxxxxxx"
    ],
    "discounts": [],
    "expiration": "yyyy-mm-ddT00:00:00.00Z",
    "placementOptionId": "plxxxxxxxxxxxxxxx",
    "status": "OFFERED"
  }
]

The following code sample demonstrates how to choose the least expensive placementOption. Customize this code to fit your own selection criteria.
以下代码示例演示了如何选择价格最低的 placementOption 。请根据自己的选择标准定制此代码。

Step 8. Generate transportation options
步骤 8.生成交通方案

Operation 运行

• generateTransportationOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• placementOptionId: The chosen placement option ID.
  placementOptionId ：所选放置选项 ID。
• shipmentTransportationConfigurations: Configuration details including:
  shipmentTransportationConfigurations ：配置详情，包括
  • shipmentId: Each shipment ID within the chosen placement option. Include all shipment IDs within the selected placement option.
    shipmentId ：所选放置选项中的每个货件 ID。包括所选放置选项中的所有货件 ID。
  • readyToShipWindow: Start date for when shipments are ready for delivery.
    readyToShipWindow ：货物准备交付的起始日期。
  • freightInformation (only if you want to ship pallets): The declared value and freight class.
    freightInformation （仅适用于托盘运输）：申报价值和货运等级。
  • pallets (only if you want to ship pallets): Information about the pallets being shipped, including quantity, dimensions, weight, and stackability.
    pallets （仅适用于托盘运输）：有关装运托盘的信息，包括数量、尺寸、重量和可堆叠性。

Response 回应

• Includes an operationId that you can use to check the status of transportation options generation.
  包括一个 operationId ，您可以用它来检查运输选项的生成状态。

Request example for small parcel delivery
小包裹递送申请示例

{
  "placementOptionId": "plxxxxxxxxxxxxxxxxxxxx",
  "shipmentTransportationConfigurations": [
    {
      "readyToShipWindow": {
        "start": "yyyy-mm-ddT00:00:00Z"
      },
      "shipmentId": "sh1xxxxxxxxxxxxxxx"
    },
    {
      "readyToShipWindow": {
        "start": "yyyy-mm-T00:00:00Z"
      },
      "shipmentId": "sh2xxxxxxxxxxxxxx"
    }
  ]
}

Request example for pallet (LTL/FTL) delivery
托盘（零担/整车）交货申请示例

{
  "placementOptionId": "plxxxxxxxxxxxxxxxxxxxx",
  "shipmentTransportationConfigurations": [
    {
      "readyToShipWindow": {
        "start": "yyyy-mm-ddT00:00:00Z"
      },
      "shipmentId": "shxxxxxxxxxxxxxxxx",
      "freightInformation": {
        "declaredValue": {
          "amount": 200,
          "code": "USD"
        },
        "freightClass": "FC_XX"
      },
      "pallets": [
        {
          "quantity": 1,
          "dimensions": {
            "height": 48,
            "length": 48,
            "unitOfMeasurement": "IN",
            "width": 40
          },
          "stackability": "STACKABLE",
          "weight": {
            "unit": "LB",
            "value": 600
          }
        }
      ]
    }
  ]
}

Step 7. List transportation options
第 7 步列出交通选择

Operation 运行

• listTransportationOptions

Parameters 参数

• inboundPlanId: The ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• placementOptionId: The ID of the chosen placement option.
  placementOptionId ：所选放置选项的 ID。

Response 回应

• Includes different available transportationOptions, each represented by transportationOptionId per shipmentId. Each transportation option contains details about:
  包括不同的可用 transportationOptions ，每个 transportationOptions 由 transportationOptionId 和 shipmentId 代表。每个运输选项都包含以下详细信息：
  • carrier: Identifies the carrier.
    carrier ：标识载波。
  • shippingMode: Identifies the shipment type (for example, Small Parcel Delivery or pallets).
    shippingMode ：标识货物类型（例如，小包裹递送或托盘）。
  • shippingSolution: Identifies whether the carrier is Amazon Partnered or your own transportation carrier.
    shippingSolution ：标明承运商是亚马逊合作伙伴还是您自己的运输承运商。
  • preconditions: Conditions that must be met to provide the delivery window. Only applicable to your own carrier options.
    preconditions ：提供送货窗口必须满足的条件。仅适用于您自己的承运商选项。

📘

Note 备注

If you have multiple shipmentIds from listPlacementOptions, choose a transportationOptionId for each shipmentId.
如果有多个来自 listPlacementOptions 的 shipmentIds ，请为每个 shipmentId 选择一个 transportationOptionId 。

To ship using the Amazon Partnered Carrier in this tutorial, you must select the transportationOption based on your shipment type:
要使用本教程中的亚马逊合作承运商发货，您必须根据您的发货类型选择 transportationOption ：

• For small parcel deliveries, choose the option where shippingMode is GROUND_SMALL_PARCEL.
  对于小包裹递送，请选择 shippingMode 为 GROUND_SMALL_PARCEL 的选项。
• For pallet shipments, choose the option where shippingMode is FREIGHT_LTL.
  对于托盘装运，请选择 shippingMode 为 FREIGHT_LTL 的选项。

In both cases, ensure that shippingSolution is AMAZON_PARTNERED_CARRIER.
在这两种情况下，请确保 shippingSolution 是 AMAZON_PARTNERED_CARRIER 。

Response example for small parcel delivery
小包裹递送响应示例

"transportationOptions": [
  {
    "carrier": {
      "name": "United States Postal Service",
      "alphaCode": "USPS"
    },
    "preconditions": [
      "CONFIRMED_DELIVERY_WINDOW"
    ],
    "shipmentId": "shxxxxxxxxxxxxxx",
    "shippingMode": "GROUND_SMALL_PARCEL",
    "transportationOptionId": "toxxxxxxxxxxxxxx",
    "shippingSolution": "USE_YOUR_OWN_CARRIER"
  },
  {
    "carrier": {
      "name": "UPS",
      "alphaCode": "UPSN"
    },
    "quote": {
      "cost": {
        "amount": 19.6,
        "code": "USD"
      }
    },
    "preconditions": [],
    "shipmentId": "shxxxxxxxxxxxxxx",
    "shippingMode": "GROUND_SMALL_PARCEL",
    "transportationOptionId": "toxxxxxxxxxxxxxx",
    "shippingSolution": "AMAZON_PARTNERED_CARRIER"
  }
]

Response example for pallet delivery
托盘运送响应示例

{
  "carrier": {
    "name": "XXXXX",
    "alphaCode": "ABCD"
  },
  "carrierAppointment": {
    "startTime": "2024-10-11T00:00Z",
    "endTime": "2024-10-11T23:59Z"
  },
  "quote": {
    "cost": {
      "amount": 326.54,
      "code": "USD"
    },
    "expiration": "2024-10-09T22:40Z"
  },
  "preconditions": [],
  "shipmentId": "shxxxxxxxxxxxxxx",
  "shippingMode": "FREIGHT_LTL",
  "transportationOptionId": "toxxxxxxxxxxxxxx",
  "shippingSolution": "AMAZON_PARTNERED_CARRIER"
}

Step 8. Get shipment 步骤 8.发货

Operation 运行

• getShipment

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: ID of the shipment for which to retrieve details.
  shipmentId ：要检索详细信息的货件 ID。

Response 回应

• Includes the source address from which the shipment originates.
  包括发货地的源地址。
• Includes the destination warehouse address for the shipment.
  包括货物的目的地仓库地址。
• Includes the current status of the shipment.
  包括货物的当前状态。

📘

Note 备注

If you are not satisfied with the chosen options, you can regenerate and select another placement option or transportation option before final confirmation.
如果您对所选方案不满意，可以在最终确认前重新生成并选择其他安置方案或运输方案。

Step 9. Confirm placement option
第 9 步确认安置选项

Operation 运行

• confirmPlacementOption

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• placementOptionId: The chosen placement option ID to confirm.
  placementOptionId ：确认所选的放置选项 ID。

Response 回应

• operationId: An ID that you can use to check the status of the placement confirmation.
  operationId ：用于检查安置确认状态的 ID。

📘

Note 备注

You can only confirm one placement option per inbound plan.
每个入站计划只能确认一个投放选项。

Step 10. Confirm transportation options
第 10 步确认交通方案

Operation 运行

• confirmTransportationOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• transportationSelections: A list of selected transportation options for each shipment, including:
  transportationSelections ：每批货物的选定运输选项清单，包括
  • shipmentId: The ID of the shipment.
    shipmentId ：货物 ID。
  • transportationOptionId: The chosen transportation option ID for that shipment.
    transportationOptionId ：为该货物选择的运输选项 ID。

Response 回应

• operationId: An ID that you can use to check the status of the transportation confirmation.
  operationId ：用于检查运输确认状态的 ID。

Important considerations 重要考虑因素

If your inbound plan includes multiple shipments:
如果您的进货计划包括多次装运：

• For small parcel deliveries, ensure that all shipments use the same carrier.
  对于小包裹递送，请确保所有货物都使用同一承运商。
• For pallet deliveries, you can choose different carriers for each shipment.
  对于托盘运输，您可以为每批货物选择不同的承运商。

Sample request 样品申请

{
  "transportationSelections": [
    {
      "shipmentId": "sh1xxxxxxxxxxxxxxxxxxx",
      "transportationOptionId": "to1xxxxxxxxxxxxxxxxxxx"
    },
    {
      "shipmentId": "sh2xxxxxxxxxxxxxxxxxxx",
      "transportationOptionId": "to2xxxxxxxxxxxxxxxxxxx"
    }
  ]
}

Step 11. Get shipment 第 11 步获取货物

Operation 运行

• getShipment

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: ID of the shipment.
  shipmentId ：货物 ID。

Response 回应

• Includes the following details of shipment:
  包括以下运输细节：
  • sourceAddress: The origin address of the shipment.
    sourceAddress ：货件的起运地址。
  • destinationWarehouseAddress: The address of the destination warehouse.
    destinationWarehouseAddress ：目的地仓库的地址。
  • amazonReferenceId: Amazon's reference ID for the shipment.
    amazonReferenceId ：亚马逊对货物的参考 ID。
  • selectedTransportationOptionId: The chosen transportation option ID.
    selectedTransportationOptionId ：所选运输选项 ID。
  • placementOptionId: The ID of the chosen placement option.
    placementOptionId ：所选放置选项的 ID。
  • shipmentConfirmationId: The ID confirming the shipment.
    shipmentConfirmationId ：确认货物的 ID。
  • trackingDetails: Information regarding the shipment tracking.
    trackingDetails : 有关货物跟踪的信息。
  • status: The current status of the shipment.
    status ：货物的当前状态。

📘

Note 备注

If your inbound plan includes multiple shipment IDs, call getShipment for each shipment ID.
如果您的入站计划包括多个货件 ID，请为每个货件 ID 调用 getShipment 。

Step 12. Get labels 第 12 步获取标签

Operation 运行

• getLabels

Parameters 参数

• shipmentConfirmationId: The ID that confirms the shipment, retrieved from the getShipment response.
  shipmentConfirmationId ：确认货物的 ID，从 getShipment 响应中获取。
• PageType: Specifies the type of page for the labels.
  PageType ：指定标签的页面类型。
• LabelType: Specifies the type of label to retrieve.
  LabelType ：指定要检索的标签类型。

For Pallet Shipments: 托盘装运：

• NumberOfPallets: The total number of pallets included in the shipment.
  NumberOfPallets ：货物中包含的托盘总数。
• PageSize: The size of the label pages to retrieve.
  PageSize ：要检索的标签页大小。

Response 回应

• Includes a URL that you can use to download the labels associated with each shipment ID within your inbound plan.
  包括一个 URL，可用于下载与入站计划中每个装运 ID 相关的标签。

📘

Note 备注

Call getLabels for each shipment ID and provide the necessary parameters based on whether the shipment is a small parcel delivery or involves pallets.
为每个货件 ID 调用 getLabels 并根据货件是小包裹还是涉及托盘提供必要的参数。

[Only for Pallet Shipments] Step 13. Get bill of lading
[仅适用于托盘装运] 第 13 步。获取提单

Operation 运行

• getBillOfLading

Parameters 参数

• shipmentConfirmationId: The ID that confirms the shipment, retrieved from getShipment response.
  shipmentConfirmationId ：确认货物的 ID，从 getShipment 响应中获取。

Response 回应

• Includes a URL that you can use to download the bill of lading associated with the Less Than Truckload (LTL) or Full Truckload (FTL) pallet shipment.
  包括一个 URL，用于下载与零担（LTL）或整车（FTL）托盘货物相关的提单。

This process completes the creation of your inbound plan, and sends your SKUs as either individual boxes (small parcel delivery) or pallets (LTL/FTL) using the Amazon Partnered Carrier. You can verify this inbound plan through the Seller Central Send to Amazon UI.
此流程将完成入站计划的创建，并使用亚马逊合作承运商以单箱（小包裹递送）或托盘（零担/整车）形式发送您的 SKU。您可以通过 "卖家中心发送到亚马逊用户界面 "验证该入库计划。

Tutorial 2: Inbound shipments with a non-partnered carrier
教程 2：使用非合作承运商进行入境货运

Learn how to inbound Small Parcel Deliveries (SPD) or pallets (LTL/FTL) with a non-partnered carrier using the Fulfillment Inbound API.
了解如何使用 Fulfillment Inbound API 通过非合作承运商入库小包裹 (SPD) 或托盘（零担/整车）。

There are Postman collections for Amazon Partnered Small Parcel or Pallet Shipment Deliveries:
亚马逊合作的小包裹或托盘货物递送有 Postman 系列：

• Small Parcel Delivery (SPD) with a non-partnered carrier
  使用非合作承运商的小包裹递送（SPD）
• Pallets (LTL/FTL) with a non-partnered carrier
  使用非合作承运商的托盘（零担/整车

As a supplement to this guide, the FBA Inbound Sample Solution Code App provides all required resources to deploy a fully functional SP-API application that implements the new Fulfillment Inbound API v2024-03-20.
作为本指南的补充，FBA 入站示例解决方案代码应用程序提供了部署功能齐全的 SP-API 应用程序所需的所有资源，该应用程序实现了新的 Fulfillment Inbound API v2024-03-20。

Step 1. Create an inbound plan
步骤 1.制定入境计划

Operation 运行

• createInboundPlan

Parameters 参数

• destinationMarketplaces: List of marketplaces where the items are sent.
  destinationMarketplaces : 发送物品的市场列表。
• sourceAddress: The address from which the items are shipped.
  sourceAddress ：发货地址。
• items: A list of items to include in the inbound plan. Each item should have the following attributes:
  items ：要包含在入站计划中的项目列表。每个项目应具有以下属性：
  • prepOwner: The one responsible for prepping the item.
    prepOwner ：负责准备物品的人。
  • labelOwner: The one responsible for the labeling process.
    labelOwner ：负责贴标签的人。
  • msku: The Merchant Stock Keeping Unit (SKU) for the item.
    msku ：物品的商家库存单位（SKU）。
  • quantity: The quantity of items to ship.
    quantity ：要运送的物品数量。

Response 回应

• operationId: An ID that you can use to check the status of the inbound plan creation.
  operationId ：用于检查入站计划创建状态的 ID。
• inboundPlanId: An ID that uniquely identifies the inbound plan.
  inboundPlanId ：唯一标识入站计划的 ID。

📘

Note 备注

POST operations are asynchronous. Check the status of a POST operation by passing its operationId to getInboundOperationStatus.
POST 操作是异步的。通过将 operationId 传递给 getInboundOperationStatus 来检查 POST 操作的状态。

Step 2. Generate packing options
步骤 2.生成包装选项

Operation 运行

• generatePackingOptions

Parameters 参数

• inboundPlanId: Use the inbound plan ID created in Step 1.
  inboundPlanId ：使用在步骤 1 中创建的入站计划 ID。

Response 回应

• operationId: An ID that you can use to check the status of packing options generation.
  operationId ：用于检查打包选项生成状态的 ID。

Step 3. List packing options
步骤 3.列出包装选项

Operation 运行

• listPackingOptions

Parameters 参数

• inboundPlanId: The inbound plan ID.
  inboundPlanId ：入站计划 ID。

Response 回应

• Includes available packingOptions. Each packingOption has a packingOptionId.
  包括可用的 packingOptions 。每个 packingOption 都有一个 packingOptionId 。
• Each packing option contains one or more packingGroups, identified by packingGroupId. Each packing group includes a list of SKUs that should be packed together.
  每个包装选项包含一个或多个 packingGroups ，由 packingGroupId 标识。每个包装组包括一个应包装在一起的 SKU 列表。

To view SKU items per packingGroupId, call listPackingGroupItems.
要查看每个 packingGroupId 的 SKU 项目，请调用 listPackingGroupItems 。

📘

Note 备注

Choose only one packing option (packingOptionId).
只选择一个包装选项 ( packingOptionId )。

Response example 响应示例

{
  "packingOptions": [
    {
      "packingGroups": [
        "pgxxxxxxxxxxxxxxxxxxxx"
      ],
      "fees": [x],
      "discounts": [x],
      "packingOptionId": "poxxxxxxxxxxxxxxxxxxxx",
      "supportedShippingConfigurations": [x],
      "status": "xxxxxx"
    }
  ],
  "pagination": {}
}

Step 4. Confirm packing option
步骤 4.确认包装选项

Operation 运行

• confirmPackingOption

Parameters 参数

• inboundPlanId: The ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• packingOptionId: The chosen packing option ID. You can only confirm one option per inbound plan.
  packingOptionId ：所选包装选项 ID。每个进货计划只能确认一个选项。

Response 回应

• operationId: An ID that you can use to check the status of the packing confirmation.
  operationId ：用于检查包装确认状态的 ID。

Step 5. Set packing information
步骤 5.设置包装信息

Operation 运行

• setPackingInformation

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• packingGroupId: ID for each packing group within the chosen packing option.
  packingGroupId ：所选包装选项中每个包装组的 ID。
• boxes: Includes box contents source, box dimensions (weight and quantity), items with prep info, and item quantities that match the inbound plan.
  boxes ：包括包装箱内容源、包装箱尺寸（重量和数量）、带有预处理信息的物品以及与进货计划相匹配的物品数量。

Response 回应

• operationId: An ID that you can use to check the status of the API call.
  operationId ：用于检查 API 调用状态的 ID。

Step 6. Generate placement options
步骤 6.生成放置选项

Operation 运行

• generatePlacementOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。

Response 回应

• operationId: An ID that you can use to check the status of placement options generation.
  operationId ：用于检查放置选项生成状态的 ID。

Step 7. List placement options
第 7 步列出位置选项

Operation 运行

• listPlacementOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。

Response 回应

• Includes available placementOptions, each represented by a placementOptionId.
  包括可用的 placementOptions ，每个 placementOptions 由一个 placementOptionId 表示。
• Each placementOptionId includes one or more shipmentIds and details on fees or discounts.
  每个 placementOptionId 包括一个或多个 shipmentIds 以及费用或折扣详情。

📘

Note 备注

Choose only one placement option (placementOptionId).
只选择一个放置选项 ( placementOptionId )。

Response example 响应示例

"placementOptions": [
  {
    "fees": [
      {
        "description": "Placement service fee represents service to inbound with minimal shipment splits and destinations of skus",
        "type": "FEE",
        "value": {
          "amount": 1.10,
          "code": "USD"
        },
        "target": "Placement Services"
      }
    ],
    "shipmentIds": [
      "shxxxxxxxxxxxxxxx"
    ],
    "discounts": [],
    "expiration": "yyyy-mm-ddT00:00:00.00Z",
    "placementOptionId": "plxxxxxxxxxxxxxxx",
    "status": "OFFERED"
  }
]

The following code sample shows how to calculate and choose the least expensive placementOption. You can modify the code to have your own selection criteria.
以下代码示例展示了如何计算和选择最便宜的 placementOption 。您可以根据自己的选择标准修改代码。

Step 8. Generate transportation options
步骤 8.生成交通方案

Operation 运行

• generateTransportationOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• placementOptionId: Chosen placement option ID.
  placementOptionId ：所选放置选项 ID。
• shipmentTransportationConfigurations: Configuration details, which include:
  shipmentTransportationConfigurations ：配置详细信息，包括
  • shipmentId: Each shipment ID within the chosen placement option. Include all shipment IDs within the selected placement option.
    shipmentId ：所选放置选项中的每个货件 ID。包括所选放置选项中的所有货件 ID。
  • readyToShipWindow: Start date for when shipments are ready for delivery.
    readyToShipWindow ：货物准备交付的起始日期。
  • freightInformation (only if you want to ship pallets): Declared value and freight class.
    freightInformation （仅适用于托盘运输）：申报价值和货运等级。
  • pallets (only if you want to ship pallets): Information about the shipped pallets, including quantity, dimensions, weight, and stackability.
    pallets （仅当您想运送托盘时）：有关装运托盘的信息，包括数量、尺寸、重量和可堆叠性。

Response 回应

• operationId: An ID that you can use to check the status of transportation options generation.
  operationId ：用于检查运输选项生成状态的 ID。

Request example for small parcel delivery
小包裹递送申请示例

{
  "placementOptionId": "plxxxxxxxxxxxxxxxxxxxx",
  "shipmentTransportationConfigurations": [
    {
      "readyToShipWindow": {
        "start": "yyyy-mm-ddT00:00:00Z"
      },
      "shipmentId": "shxxxxxxxxxxxxxxxxxxxx",
      "contactInformation": {
        "name": "xxxxxxxx",
        "phoneNumber": "1234567890",
        "email": "test@email.com"
      }
    }
  ]
}

Request example for pallet delivery
托盘运送申请示例

{
  "placementOptionId": "plxxxxxxxxxxxxxxxxxxxx",
  "shipmentTransportationConfigurations": [
    {
      "readyToShipWindow": {
        "start": "yyyy-mm-ddT00:00:00Z"
      },
      "shipmentId": "shxxxxxxxxxxxxxxxx",
      "contactInformation": {
        "name": "TestName",
        "phoneNumber": "1234567890",
        "email": "test@email.com"
      },
      "freightInformation": {
        "declaredValue": {
          "amount": 200,
          "code": "USD"
        },
        "freightClass": "FC_XX"
      },
      "pallets": [
        {
          "quantity": 1,
          "dimensions": {
            "height": 48,
            "length": 48,
            "unitOfMeasurement": "IN",
            "width": 40
          },
          "stackability": "STACKABLE",
          "weight": {
            "unit": "LB",
            "value": 600
          }
        }
      ]
    }
  ]
}

Step 9. List transportation options
第 9 步列出交通选择

Operation 运行

• listTransportationOptions

Parameters 参数

• inboundPlanId: The ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• placementOptionId: The ID of the chosen placement option.
  placementOptionId ：所选放置选项的 ID。

Response 回应

• Includes different available transportationOptions, each represented by transportationOptionId per shipmentId. Each transportation option contains details about:
  包括不同的可用 transportationOptions ，每个 transportationOptions 由 transportationOptionId 和 shipmentId 代表。每个运输选项都包含以下详细信息：
  • carrier: The carrier.  carrier : 承运人。
  • shippingMode: The shipment type (for example, Small Parcel Delivery vs. pallets).
    shippingMode ：货物类型（例如，小包裹递送与托盘递送）。
  • shippingSolution: The shipping solution. Identifies whether the carrier is Amazon Partnered or your own transportation carrier.
    shippingSolution ：运输解决方案。标识承运商是亚马逊合作伙伴还是您自己的运输承运商。
  • preconditions: Conditions that must be met to provide the delivery window. Only applicable to your own carrier options.
    preconditions ：提供送货窗口必须满足的条件。仅适用于您自己的承运商选项。

📘

Note 备注

If you have multiple shipmentIds from listPlacementOptions, choose a transportationOptionId for each shipmentId.
如果有多个来自 listPlacementOptions 的 shipmentIds ，请为每个 shipmentId 选择一个 transportationOptionId 。

To ship using a non-partnered carrier, you must select the transportationOption based on your shipment type:
要使用非合作承运商发货，您必须根据发货类型选择 transportationOption ：

• For small parcel deliveries, choose the option where shippingMode is GROUND_SMALL_PARCEL.
  对于小包裹递送，请选择 shippingMode 为 GROUND_SMALL_PARCEL 的选项。
• For pallet shipments, choose the option where shippingMode is FREIGHT_LTL.
  对于托盘装运，请选择 shippingMode 为 FREIGHT_LTL 的选项。
• In both cases, ensure that shippingSolution is USE_YOUR_OWN_CARRIER.
  在这两种情况下，请确保 shippingSolution 是 USE_YOUR_OWN_CARRIER 。
• preconditions lists the requirements for confirming the delivery windows. You must generate, list, and confirm a delivery window for each shipment that you send using your own carrier. Follow the tutorial for detailed steps.
  preconditions 列出了确认交货窗口的要求。您必须为使用自己的承运商发送的每件货件生成、列出并确认交货窗口。请按照教程了解详细步骤。

Response example for small parcel delivery
小包裹递送响应示例

"transportationOptions": [
  {
    "carrier": {
      "name": "United States Postal Service",
      "alphaCode": "USPS"
    },
    "preconditions": [
      "CONFIRMED_DELIVERY_WINDOW"
    ],
    "shipmentId": "shxxxxxxxxxxxxxx",
    "shippingMode": "GROUND_SMALL_PARCEL",
    "transportationOptionId": "toxxxxxxxxxxxxxx",
    "shippingSolution": "USE_YOUR_OWN_CARRIER"
  },
  {
    "carrier": {
      "name": "UPS",
      "alphaCode": "UPSN"
    },
    "quote": {
      "cost": {
        "amount": 19.6,
        "code": "USD"
      }
    },
    "preconditions": [],
    "shipmentId": "shxxxxxxxxxxxxxx",
    "shippingMode": "GROUND_SMALL_PARCEL",
    "transportationOptionId": "toxxxxxxxxxxxxxx",
    "shippingSolution": "AMAZON_PARTNERED_CARRIER"
  }
]

Response example for pallet delivery
托盘运送响应示例

{
  "carrier": {
    "name": "XXXX",
    "alphaCode": "ABCD"
  },
  "preconditions": [
    "CONFIRMED_DELIVERY_WINDOW"
  ],
  "shipmentId": "shxxxxxxxxxxxxxx",
  "shippingMode": "FREIGHT_LTL",
  "transportationOptionId": "toxxxxxxxxxxxxxx",
  "shippingSolution": "USE_YOUR_OWN_CARRIER"
}

Step 10. Generate delivery window options
步骤 10.生成交付窗口选项

Operation 运行

• generateDeliveryWindowOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: ID of the specific shipment for which to generate delivery windows.
  shipmentId ：要生成交货窗口的特定货件的 ID。

Response 回应

• operationId: An ID that you can use to check the status of the delivery window options generation.
  operationId ：用于检查交付窗口选项生成状态的 ID。

📘

Note 备注

You must generate delivery windows for all shipmentIds within the inbound plan.
您必须在入站计划中为所有 shipmentId s 生成交付窗口。

Step 11. List Delivery Window Options
步骤 11.列出交付窗口选项

Operation 运行

• listDeliveryWindowOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: ID of the specific shipment for which to retrieve delivery window options.
  shipmentId ：要检索交货窗口选项的特定货件的 ID。

Response 回应

• Includes a list of available deliveryWindowOptions, each represented by a deliveryWindowOptionId.
  包括可用的 deliveryWindowOptions 列表，每个列表由 deliveryWindowOptionId 表示。
• Each option includes startDate and endDate that indicate the time frame during which the shipment must arrive.
  每个选项都包括 startDate 和 endDate ，表示货物必须到达的时间范围。

📘

Note 备注

You must schedule your shipment delivery within 45 days for domestic shipments and 75 days for international shipments. These time frames are reflected in the available delivery window options endDate. For non-partnered carriers, sellers must specify a delivery window of 7 days for domestic shipments or 14 days for international shipments.
国内发货必须在 45 天内安排发货，国际发货必须在 75 天内安排发货。 endDate 中的可用交付窗口选项反映了这些时间框架。对于非合作承运商，卖家必须指定国内发货的交付窗口为 7 天，国际发货的交付窗口为 14 天。

Response example 响应示例

{
  "deliveryWindowOptions": [
    {
      "availabilityType": "AVAILABLE",
      "endDate": "yyyy-mm-ddT00:00Z",
      "validUntil": "yyyy-mm-ddT00:00Z",
      "deliveryWindowOptionId": "dwxxxxxxxxxxxxxxxxxxxx",
      "startDate": "yyyy-mm-ddT00:00Z"
    }
  ]
}

The following code sample shows how to choose the delivery window option with the latest endDate. You can modify the code to have your own selection criteria.
以下代码示例展示了如何使用最新的 endDate 选择交付窗口选项。您可以根据自己的选择标准修改代码。

Step 12. Get shipment 步骤 12.装运

Operation 运行

• getShipment

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: ID of the specific shipment for which to retrieve details.
  shipmentId ：要检索详细信息的特定货件的 ID。

Response 回应

• Includes the details related to the contents of the specified shipment, including:
  包括与指定货物内容相关的详细信息，包括
  • Source address: The address from which the shipment originates.
    源地址：货物来源地址。
  • Destination warehouse address: The address of the chosen destination warehouse.
    目的地仓库地址：所选目的地仓库的地址。
  • Status: The current status of the shipment.
    状态：货物的当前状态。

📘

Note 备注

Before you confirm the placement and transportation options, call getShipment for each shipmentId to ensure all details are satisfactory. If you are not satisfied with your chosen options, you have the option to re-generate and select another placement option or transportation option.
在确认安置和运输选项之前，请致电每个 shipmentId 的 getShipment 以确保所有细节都令人满意。如果您对所选方案不满意，您可以重新生成并选择其他安置方案或运输方案。

Step 13. Confirm placement option
步骤 13.确认安置选项

Operation 运行

• confirmPlacementOption

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• placementOptionId: The chosen placement option ID to confirm.
  placementOptionId ：确认所选的放置选项 ID。

Response 回应

• operationId: An ID that you can use to check the status of the placement confirmation.
  operationId ：用于检查安置确认状态的 ID。

📘

Note 备注

You can only confirm one placement option per inbound plan.
每个入站计划只能确认一个投放选项。

Step 14. Confirm delivery window options
第 14 步确认交付窗口选项

Operation 运行

• confirmDeliveryWindowOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: ID of the specific shipment for which the delivery window option is being confirmed.
  shipmentId ：正在确认交货窗口选项的特定货件的 ID。
• deliveryWindowOptionId: ID of the chosen delivery window option.
  deliveryWindowOptionId ：所选交货窗口选项的 ID。

Response 回应

• operationId: An ID that you can use to check the status of the delivery window confirmation.
  operationId ：用于检查交货窗口确认状态的 ID。

📘

Note 备注

You must confirm delivery windows for every shipmentId in the inbound plan. You can only confirm one delivery window option per shipment for the inbound plan.
您必须为进货计划中的每个 shipmentId 确认交货窗口。对于入站计划，每个货件只能确认一个交货窗口选项。

Step 15. Confirm transportation options
第 15 步确认交通方案

Operation 运行

• confirmTransportationOptions

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• transportationSelections: A list of selected transportation options for each shipment, including:
  transportationSelections ：每批货物的选定运输选项清单，包括
  • shipmentId: The ID of the shipment.
    shipmentId ：货物 ID。
  • transportationOptionId: The chosen transportation option ID for that shipment.
    transportationOptionId ：为该货物选择的运输选项 ID。

Response 回应

• operationId: An ID that you can use to check the status of the transportation confirmation.
  operationId ：用于检查运输确认状态的 ID。

Request example 请求示例

{
  "transportationSelections": [
    {
      "shipmentId": "shxxxxxxxxxxxxxxxxxxxx",
      "transportationOptionId": "toxxxxxxxxxxxxxxxxxxxx"
    }
  ]
}

Step 16. Get shipment 步骤 16.获取货物

Operation 运行

• getShipment

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: The ID of the shipment.
  shipmentId ：货物 ID。

Response 回应

• Includes the details of shipment, including:
  包括运输详情，其中包括
  • sourceAddress: The origin address of the shipment.
    sourceAddress ：货件的起运地址。
  • destinationWarehouseAddress: The address of the destination warehouse.
    destinationWarehouseAddress ：目的地仓库的地址。
  • amazonReferenceId: Amazon's reference ID for the shipment.
    amazonReferenceId ：亚马逊对货物的参考 ID。
  • selectedTransportationOptionId: The chosen transportation option ID.
    selectedTransportationOptionId ：所选运输选项 ID。
  • placementOptionId: The ID of the chosen placement option.
    placementOptionId ：所选放置选项的 ID。
  • shipmentConfirmationId: The ID that confirms the shipment.
    shipmentConfirmationId ：确认货物的 ID。
  • trackingDetails: Information regarding the shipment tracking.
    trackingDetails : 有关货物跟踪的信息。
  • status: The current status of the shipment.
    status ：货物的当前状态。

📘

Note 备注

If your inbound plan includes multiple shipment IDs, call getShipment for each shipment ID.
如果您的入站计划包含多个货件 ID，请为每个货件 ID 调用 getShipment。

Step 17. Get labels 步骤 17.获取标签

Operation 运行

• getLabels

Parameters 参数

• shipmentConfirmationId: The ID confirming the shipment, retrieved from the getShipment response.
  shipmentConfirmationId ：确认货物的 ID，从 getShipment 响应中获取。
• PageType: Specifies the type of page for the labels.
  PageType ：指定标签的页面类型。
• LabelType: Specifies the type of label to retrieve.
  LabelType ：指定要检索的标签类型。

For Pallet Shipments: 托盘装运：

• NumberOfPallets: The total number of pallets included in the shipment.
  NumberOfPallets ：货物中包含的托盘总数。
• PageSize: Specifies the size of the label pages to retrieve.
  PageSize ：指定要检索的标签页大小。

Response 回应

• Includes a URL that you can use to download the labels associated with each shipment ID within your inbound plan.
  包括一个 URL，可用于下载与入站计划中每个装运 ID 相关的标签。

📘

Note 备注

Call getLabels for each shipment ID and provide the necessary parameters based on whether the shipment is a small parcel delivery or involves pallets.
为每个货件 ID 调用 getLabels 并根据货件是小包裹还是涉及托盘提供必要的参数。

Step 18. List inbound plan boxes
第 18 步列出入境计划箱

Operation 运行

• listInboundPlanBoxes

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。

Response 回应

• Includes a list of box package-level information for the specified inbound plan, including box-level information including box IDs, package IDs, box weights, quantities, dimensions, items etc.
  包括指定进货计划的箱包级信息列表，其中包括箱包级信息，包括箱 ID、包 ID、箱重量、数量、尺寸、项目等。

Step 19. [Only for pallet shipments] List inbound plan pallets
步骤 19。[仅适用于托盘装运] 列出进货计划托盘

Call listInboundPlanPallets to retrieve the list of pallet packages per inbound plan. Input should include the inboundPlanId and the response includes all the pallet level information including packageId, dimensions, stackability, etc.
调用 listInboundPlanPallets 检索每个入站计划的托盘包装清单。输入应包括 inboundPlanId ，响应则包括所有托盘级信息，包括包装 ID、尺寸、可堆叠性等。

Operation 运行

• listInboundPlanPallets

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。

Response 回应

• Includes a list of pallet package information for the specified inbound plan, including the package ID, dimensions, stackability, etc.
  包含指定进货计划的托盘货件信息列表，包括货件 ID、尺寸、可堆叠性等。

Step 20. Update shipment tracking details
步骤 20.更新货物跟踪详情

Operation 运行

• updateShipmentTrackingDetails

Parameters 参数

• inboundPlanId: ID of the inbound plan.
  inboundPlanId ：入站计划的 ID。
• shipmentId: ID of the shipment.
  shipmentId ：货物 ID。
• trackingDetails: Details for updating tracking information based on shipment type.
  trackingDetails ：根据货件类型更新跟踪信息的详细信息。
  • For Small Parcel Delivery (SPD):
    用于小包裹递送（SPD）：
    • spdTrackingItems: A list that includes:
      spdTrackingItems ：包括以下内容的清单：
      • boxId: The unique identifier for each box obtained from the listInboundPlanBoxes API.
        boxId ：从 listInboundPlanBoxes API 获取的每个方框的唯一标识符。
      • trackingId: The tracking ID provided by your carrier for each box.
        trackingId ：承运商为每个箱子提供的跟踪 ID。
      • You must update the tracking IDs for all of the boxes within your inbound plan.
        您必须更新入站计划中所有箱子的跟踪 ID。
  • For pallet (LTL/FTL) delivery:
    用于托盘（零担/整车）运输：
    • ltlTrackingDetail: Details that include the freightBillNumber that your carrier provides for the pallet shipment.
      ltlTrackingDetail ：包括承运商为托盘装运提供的 freightBillNumber 的详细信息。

Response 回应

• operationId: An ID that you can use to check the status of the tracking details update.
  operationId ：用于检查跟踪详情更新状态的 ID。

Request example for small parcel delivery
小包裹递送申请示例

{
  "trackingDetails": {
    "spdTrackingDetail": {
      "spdTrackingItems": [
        {
          "boxId": "FBAxxxxxxxxxxxxxxx",
          "trackingId": "{{trackingId}}"
        }
      ]
    }
  }
}

Request example for pallet delivery
托盘运送申请示例

{
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "{{freightBillNumber}}"
      ]
    }
  }
}

This tutorial creates an inbound plan and sends your SKUs as individual boxes (small parcel delivery) or pallets (LTL/FTL) using your own transportation carrier. You can verify this inbound plan on Seller Central with Send to Amazon.
本教程创建一个入站计划，并使用您自己的运输承运商将您的 SKU 以单箱（小包裹递送）或托盘（零担/整车）的形式发送。您可以通过 "发送到亚马逊 "在卖家中心验证该入库计划。