Fulfillment Inbound API v2024-03-20 Use Case Guide
履约入站 API v2024-03-20 使用案例指南

What is the Fulfillment Inbound API?
什么是 "履行入站 API"？

The Selling Partner API for Fulfillment Inbound lets you develop applications that create and update inbound plans to ship inventory to Amazon's fulfillment network, where Amazon can fulfill your customer's orders. You can also request lists of inbound shipments or inbound shipment items based on criteria you specify. After your inventory has been received in the fulfillment network, Amazon can fulfill your orders regardless of whether you are selling on Amazon's retail website or through other retail channels. For details about API operations and associated data types and schemas, refer to the Fulfillment Inbound API reference.
销售合作伙伴 API for Fulfillment Inbound 可让您开发用于创建和更新入站计划的应用程序，以便将库存运送到亚马逊的履行网络，让亚马逊履行您客户的订单。您还可以根据您指定的标准请求入站发货清单或入站发货项目。亚马逊在履行网络收到您的库存后，无论您是在亚马逊的零售网站上销售还是通过其他零售渠道销售，亚马逊都可以履行您的订单。有关 API 操作以及相关数据类型和模式的详细信息，请参阅 Fulfillment Inbound API 参考资料。

Key features 主要特点

• Create an inbound shipment: The Fulfillment Inbound API accepts POST operations to create new inbound plans and select shipping modes and transportation options to determine the shipments.
  创建入站装运：Fulfillment Inbound API 接受 POST 操作，以创建新的入站计划，并选择运输模式和运输选项来确定出货量。
• Retrieve details about inbound shipments: The Fulfillment Inbound API accepts GET operations to return detailed information about an existing shipment.
  读取入站货件的详细信息：Fulfillment Inbound API 接受 GET 操作，以返回现有货件的详细信息。
• Update inbound plans: The Fulfillment Inbound API accepts POST operations to update one or more individual attributes for an existing inbound plan, such as updating the inbound plan name or tracking ID.
  更新入站计划：Fulfillment 入站 API 接受 POST 操作，用于更新现有入站计划的一个或多个单个属性，如更新入站计划名称或跟踪 ID。
• Delete inbound plans: The Fulfillment Inbound API accepts a PUT operation to delete an existing inbound plan.
  删除入站计划：Fulfillment Inbound API 接受删除现有入站计划的 PUT 操作。
• Interoperability: Plans created with the Fulfillment Inbound API can be accessed and edited on Amazon's UI (called Send to Amazon (STA)) once placement and transportation options are confirmed. You can also use the API to access plans that were created in STA after you confirm placement and transportation options.
  互操作性：使用 Fulfillment Inbound API 创建的计划可在确认放置和运输选项后在亚马逊用户界面（称为 "发送到亚马逊"（STA））上访问和编辑。您还可以使用 API 访问在确认放置和运输选项后在 STA 中创建的计划。

⭐

Tip 提示

Use generatePlacementOptions to generate new placement options and generateTransportationOptions to generate new transportation options. If you switch from the API to STA before you confirm your options (with confirmPlacementOption and confirmTransportationOptions), new options are generated in STA and all previous options are discarded.
使用 generatePlacementOptions 生成新的放置选项，使用 generateTransportationOptions 生成新的运输选项。如果在确认选项之前从 API 切换到 STA（使用 confirmPlacementOption 和 confirmTransportationOptions ），新选项将在 STA 中生成，而之前的所有选项将被丢弃。

Terminology 术语

• Amazon-partnered carrier: A carrier who has partnered with Amazon to provide discounted shipping rates.
  亚马逊合作承运商：与亚马逊合作提供折扣运费的承运商。
• Non-Amazon-partnered carrier: A carrier who has not partnered with Amazon to provide discounted shipping rates.
  非亚马逊合作承运商：未与亚马逊合作提供折扣运费的承运商。
• Small parcel shipment: Units packed in individual boxes that are individually labeled for delivery.
  小包裹运输：包装在独立包装箱中并贴有单独标签的产品。
• Less Than Truckload/Full Truckload (LTL/FTL) shipment: Combines individual boxes on pallets for delivery. The truck might contain shipments to other destinations.
  零担/整车（LTL/FTL）运输：将单个箱子装在托盘上运送。卡车上可能装有运往其他目的地的货物。

Considerations 考虑因素

The following are not supported, but will be supported in the future:
不支持以下功能，但将来会支持：

• Creating shipments for the following destination marketplaces:
  为以下目的地市场创建货运：
  • Mexico 墨西哥
  • Brazil 巴西
  • Poland 波兰
  • Egypt 埃及
  • Turkey 土耳其
  • Saudi Arabia 沙特阿拉伯
  • United Arab Emirates 阿联酋
  • India 印度
• Selecting prep category for a SKU
  为 SKU 选择准备类别

This use case guide mentions two v0 operations that are needed for end-to-end shipment creation: getLabels and getBillOfLading. These operations are not deprecated. You must continue to use these operations to print your box label, pallet label, or bill of lading.
本用例指南提到了端到端装运创建所需的两个 v0 操作： getLabels 和 getBillOfLading 。这些操作并未废弃。您必须继续使用这些操作来打印箱标签、托盘标签或提单。

The following v0 operations are not deprecated:
以下 v0 操作未被弃用：

• getLabels
• getBillOfLading
• getPrepInstructions
• getShipments
• getShipmentItemsByShipmentId
• getShipmentItems

Fulfillment Inbound shipment workflow
履行进货装运工作流程

The following diagram shows the steps to ship inventory to Amazon's fulfillment network. This is an illustrative example and does not include all of the optional operations.
下图显示了将库存运送到亚马逊履行网络的步骤。这是一个示例，不包括所有可选操作。

Ship inventory into Amazon's Fulfillment Network
将库存运送到亚马逊的配送网络

There are two processes that a seller can follow to create a shipment, which differ based on whether the seller knows how their cartons will be packed at the time of shipment creation. In most cases, we expect that sellers would have this information, but there are situations where this information wouldn't be readily available.
卖家可以按照两种流程创建货件，不同的流程取决于卖家在创建货件时是否知道纸箱的包装方式。在大多数情况下，我们希望卖家能够掌握这些信息，但在某些情况下，这些信息并不容易获得。

Note that the process for creating a shipment when the carton-level information is not known upfront is only available for LTL shipments at this time. This document provides the steps you can follow to ship inventory to Amazon's fulfillment network using either of these processes.
请注意，在不预先知道纸箱级信息的情况下创建装运的流程目前仅适用于零担装运。本文档提供了使用上述任一流程将库存运送到亚马逊履行网络的步骤。

Tutorial: Creating a shipment when the seller knows the carton-level information up-front
教程：在卖方预先知道纸箱信息的情况下创建货件

Prerequisites 先决条件

To complete this tutorial, you need:
要完成本教程，您需要

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
  您为其拨打电话的销售合作伙伴的授权。有关详细信息，请参阅授权销售合作伙伴 API 应用程序。
• Approval for the Amazon Fulfillment role and the Product Listing role in your developer profile.
  在您的开发人员配置文件中批准 Amazon Fulfillment 角色和 Product Listing 角色。
• The Amazon Fulfillment role and Product Listing role selected in the App registration page for your application.
  在应用程序注册页面为您的应用程序选择的 Amazon Fulfillment 角色和 Product Listing 角色。
• To have created your listings and understand whether your items are eligible to be shipped to Amazon's fulfillment network (instructions included in optional step section)
  创建您的列表，并了解您的商品是否有资格运送到亚马逊的履行网络（说明包含在可选步骤部分）

Step 1. Create an Inbound Plan
步骤 1.制定入境计划

Create an Inbound Plan by calling the asynchronous createInboundPlan operation. An Inbound Plan represents a collection of items that you intend to inbound into Amazon's fulfillment network. By calling the createInboundPlan operation, a seller must specify the following:
通过调用异步 createInboundPlan 操作创建入站计划。入站计划代表您打算入站到亚马逊履行网络的商品集合。通过调用 createInboundPlan 操作，卖家必须指定以下内容：

• The address from which the inbound shipments will be sent
  将从哪个地址发送入境货物
• The marketplace where the product would be shipped
  产品的运输市场
• A summary of the items that they intend to inbound.
  他们打算输入的项目摘要。

The item summary must include MSKU, quantity, and an indication of who will prepare / label the item. Note that AMAZON can only be selected as the label owner if you are enrolled in the FBA Label Service. For more information about the FBA Label Service, refer to Seller Central Help for your marketplace.
商品摘要必须包括 MSKU、数量以及由谁准备/贴标签的说明。请注意， AMAZON 只有在您注册了 FBA 标签服务的情况下才能被选为标签所有者。有关 FBA 标签服务的更多信息，请参阅您所在市场的 "卖家中心帮助"。

Make sure each item you're shipping conforms to Amazon's product packaging requirements. For more information, refer to Packaging and Prep Requirements in Seller Central Help. For more information about Amazon's product packaging requirements for your marketplace, refer to Seller Central URLs. Note that sellers can set the Prep Category for SKUs on Send to Amazon. This can be done one by one or up to 25 at a time. This is a one-time activity per SKU that carries over to all future inbound plans.
确保您运送的每件物品都符合亚马逊的产品包装要求。有关详细信息，请参阅 "卖家中心帮助 "中的 "包装和准备要求"。有关您所在市场的亚马逊产品包装要求的更多信息，请参阅卖家中心 URL。请注意，卖家可以在 "发送至亚马逊 "中为 SKU 设置准备类别。这可以一个一个地设置，也可以一次最多设置 25 个。这是对每个 SKU 进行的一次性活动，可延续到所有未来的入站计划中。

📘

Note 备注

Multiple expiration dates per SKU on a single inbound plan is not supported. To send a SKU with multiple expiration dates to the fulfillment network, you need to create multiple plans.
不支持单个进货计划中每个库存单位有多个过期日期。要将具有多个过期日期的库存单位发送到履行网络，需要创建多个计划。

Optionally, a seller can include each item's expiration date and manufacturing lot code. A successful response includes an inboundPlanId that uniquely identifies the inbound plan, synonymous with the concept of "workflow ID", which is generated on Send to Amazon (the shipment creation workflow on Seller Central).
卖家还可以选择包含每个商品的过期日期和生产批次代码。成功的响应包括一个 inboundPlanId ，唯一标识入站计划，与 "工作流 ID "概念同义，该 ID 在发送到亚马逊（卖家中心的发货创建工作流）上生成。

Body parameters 身体参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans
{
  "destinationMarketplaces" : [ "ATVPDKIKX0DER" ],
  "items" : [ {
    "expiration" : "2024-01-01",
    "labelOwner" : "AMAZON",
    "manufacturingLotCode" : "manufacturingLotCode",
    "msku" : "Sunglasses",
    "prepOwner" : "AMAZON",
    "quantity" : 10
  } ],
  "name" : "My inbound plan",
  "sourceAddress" : {
    "addressLine1" : "123 example street",
    "addressLine2" : "Floor 19",
    "city" : "Toronto",
    "companyName" : "Acme",
    "countryCode" : "CA",
    "email" : "email@email.com",
    "name" : "name",
    "phoneNumber" : "1234567890",
    "postalCode" : "M1M1M1",
    "stateOrProvinceCode" : "ON"
  }
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "operationId1234",
  "inboundPlanId": "PlanID1234"
}

Check the status of a call
检查通话状态

Check the status of an inbound request by using the getInboundOperationStatus operation. For asynchronous operations, this operation provides the processing status. We omit this step for other asynchronous operations in this tutorial. By calling getInboundOperationStatus, a seller passes the operationId, which is a Universal Unique Identifier (UUID) for the operation.
使用 getInboundOperationStatus 操作检查入站请求的状态。对于异步操作，该操作提供处理状态。对于本教程中的其他异步操作，我们将省略这一步骤。通过调用 getInboundOperationStatus 操作，卖方会传递 operationId 操作的通用唯一标识符 (UUID)。

A successful response includes the request status and any non-blocking errors associated with the request. Non-blocking errors are warnings that can be ignored (for example, when the address is suspected to be wrong, but progression is allowed anyway).
成功响应包括请求状态和与请求相关的任何非阻塞错误。非阻塞性错误是可以忽略的警告（例如，当怀疑地址有误，但允许继续前进时）。

Path parameters 路径参数

Request example 请求示例

GET /inbound/fba/2024-03-20/operations/{operationId}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operation": "string",
  "operationId": "string",
  "operationProblems": [
    {
      "code": "Error code 1234",
      "message": "Box volume does not meet the expected minimum cubic cm 144,815",
      "details": "Additional error details",
      "severity": "WARNING"
    }
  ],
  "status": "SUCCESS",
}

Step 2. Determine which SKUs can be packed together
步骤 2.确定哪些 SKU 可以打包在一起

This step is necessary to determine which items can be packed together. Some items cannot be packed together due to differing handling or fulfillment center requirements. There might be a discount for further separating items.
此步骤对于确定哪些物品可以打包在一起很有必要。由于处理方式或履行中心的要求不同，有些物品不能包装在一起。进一步分离物品可能会有折扣。

📘

Note 备注

There are only discounted options for Small Parcel Delivery (SPD) shipments in the EU. These discounted options can include additional requirements, including that each package must weigh less than 15 kilograms.
欧盟境内的小包裹递送（SPD）货运只有折扣选项。这些折扣选项可能包含额外要求，包括每个包裹的重量必须小于 15 公斤。

To determine which SKUs can be physically packed together, use the following operations:
要确定哪些 SKU 可以物理包装在一起，请使用以下操作：

• generatePackingOptions
• listPackingOptions
• listPackingGroupItems
• confirmPackingOption

A PackingGroup represents a set of SKUs that can be packed together. SKUs that cannot be packed together go into different pack groups. For example, SKUs that are classified as dangerous goods cannot be packed with other SKUs, because dangerous goods SKUs are shipped to special fulfillment centers that can receive them safely. Other factors that determine which SKUs can and cannot be packed together include SKU weights and dimensions, prep and labelling requirements, and barcode requirements.
PackingGroup 表示一组可以包装在一起的 SKU。不能包装在一起的 SKU 则归入不同的包装组。例如，被归类为危险品的 SKU 不能与其他 SKU 包装在一起，因为危险品 SKU 要运送到能安全接收它们的特殊履行中心。决定哪些 SKU 可以和哪些不可以包装在一起的其他因素包括 SKU 重量和尺寸、准备和标签要求以及条形码要求。

The PackingOptions object represents the set of options for how items are mapped to packing groups. Each PackingOption includes a set of PackingGroups, which each contain a list of SKUs. Each of these options can have discounts or fees associated with them. Also, each option can be limited to a subset of all possible shipping modes. These packing operations enable the seller to review and select an option.
PackingOptions 对象表示物品如何映射到包装组的选项集。每个 PackingOption 都包含一组 PackingGroups ，每个 PackingGroups 都包含一个 SKU 列表。每个选项都可以有与之相关的折扣或费用。此外，每个选项还可以仅限于所有可能发货模式的子集。通过这些打包操作，卖方可以查看并选择一个选项。

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

First, generate packing options with the generatePackingOptions operation.
首先，使用 generatePackingOptions 操作生成打包选项。

Path parameters 路径参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素

Response example 响应示例

{
  "operationId": "string",
  "inboundPlanId": "string"
}

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

Next, review a list of the packing options with the listPackingOptions operation. Packing options contain sets of pack groups that a seller can choose, along with additional information that can help a seller choose between these options. Additional information includes fees/discounts associated with each option, shipping modes supported by each option, and the expiration date of each option.
接下来，使用 listPackingOptions 操作查看包装选项列表。包装选项包含卖家可以选择的包装组，以及可以帮助卖家在这些选项中做出选择的附加信息。附加信息包括与每个选项相关的费用/折扣、每个选项支持的运输模式以及每个选项的过期日期。

Path parameters 路径参数

Query parameters 查询参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素

Response example 响应示例

{
  "pagination": {
    "nextToken": "string"
  },
  "packingOptions": [
    {
      "inboundPlanId": "string",
      "packingOptionId": "string",
      "packingGroups": [
        "string"
      ],
      "fees": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "discounts": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "expiration": "2019-08-24T14:15:22Z",
      "status": "OFFERED",
      "supportedShippingModes": [
        {
          "shippingSolution": "AMAZON_PARTNERED_CARRIER",
          "shippingMode": "GROUND_SMALL_PARCEL"
        }
      ]
    }
  ]
}

Step 2c. List items in each packing option
步骤 2c.列出每个包装选项中的物品

To view the items in each packing group, use the listPackingGroupItems operation.
要查看每个包装组中的项目，请使用 listPackingGroupItems 操作。

Path parameters 路径参数

Query parameters 查询参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingGroups/{packingGroupId}/items

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素

Response example 响应示例

{
  "pagination": {
    "nextToken": "string"
  },
  "items": [
    {
      "msku": "string",
      "asin": "string",
      "fnsku": "string",
      "labelOwner": "AMAZON",
      "quantity": 1,
      "prepOwner": "AMAZON"
    }
  ]
}

Step 2d. Select a packing option
步骤 2d.选择包装选项

Choose a packing option with the confirmPackingOption operation.
使用 confirmPackingOption 操作选择包装选项。

Path parameters 路径参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions/{packingOptionId}/confirmation

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素

Response example 响应示例

{
  "operationId": "string"
}

Step 3. Provide box content information
步骤 3.提供包装盒内容信息

To provide information related to the items that will be packed into each box, use the setPackingInformation operation. Providing this information ensures that the shipment splits generated in the subsequent step (generatePlacementOptions) are accurate. If no box information is provided at this step, the shipment splits generated in the next step are based only on the unit information passed to Amazon as part of createInboundPlan. By calling setPackingInformation, a seller must pass the following information for each box that they intend to inbound:
要提供与将装入每个箱子的物品相关的信息，请使用 setPackingInformation 操作。提供此信息可确保在后续步骤（ generatePlacementOptions ）中生成的分箱信息准确无误。如果在此步骤中未提供包装箱信息，则下一步生成的货物分拆将仅基于作为 createInboundPlan 的一部分传递给亚马逊的单位信息。通过调用 setPackingInformation ，卖家必须为其打算进货的每个箱子传递以下信息：

• Packing group ID 包装组 ID
• Box content information source
  箱体内容信息源
• Box contents (items, item quantities, prep/label owners for each item)
  箱内物品（物品、物品数量、每个物品的预制/标签所有者）
• Box information (dimensions, weight, and quantity of boxes)
  包装箱信息（尺寸、重量和数量）

📘

Note 备注

If a seller provides box packing information using setPackingInformation, generates placement options, and then edits their box packing information using setPackingInformation, then the seller needs to call generatePlacementOptions again prior to calling confirmPlacementOption. If a seller inputs their box packing information using setPackingInformation and then decides that they want to discard this information entirely, they need to start a new inbound plan with createInboundPlan. Discarding packing information is not currently supported.
如果卖方使用 setPackingInformation 提供包装箱信息，生成放置选项，然后使用 setPackingInformation 编辑包装箱信息，那么卖方需要在调用 confirmPlacementOption 之前再次调用 generatePlacementOptions 。如果卖家使用 setPackingInformation 输入包装信息，然后决定完全放弃该信息，则需要使用 createInboundPlan 启动新的入站计划。目前不支持丢弃包装信息。

Box content information source indicates how the seller intends to provide box content information, which could be through one of three options:
包装盒内容信息来源表示卖方打算如何提供包装盒内容信息，可以通过三个选项之一来提供：

• Populating the Contents field (BOX_CONTENT_PROVIDED)
  填充内容字段 ( BOX_CONTENT_PROVIDED )
• Paying Amazon a fee to enter this information during the receiving process (MANUAL_PROCESS)
  向亚马逊支付费用，以便在收货过程中输入此信息 ( MANUAL_PROCESS )
• Affixing 2D barcodes to the boxes (BARCODE_2D)
  在包装箱上粘贴二维条形码 ( BARCODE_2D )

The seller must also provide box dimensions, box weight, and the quantity of each box. When boxAttribute is set toBARCODE_2D or MANUAL_PROCESS:
卖方还必须提供每箱的尺寸、重量和数量。当 boxAttribute 设置为 BARCODE_2D 或 MANUAL_PROCESS 时：

• You don't need to provide SKUs and quantities.
  您无需提供 SKU 和数量。
• You must leave items empty (provide a null value).
  您必须将 items 留空（提供 null 值）。

A successful response includes the operationId that can be used to determine the status of the operation using getInboundOperationStatus.
成功响应包括 operationId ，可用于使用 getInboundOperationStatus 确定操作状态。

📘

Note 备注

In this flow, pass in the PackingGroupId but omit the ShipmentId.
在此流程中，输入 PackingGroupId 但省略 ShipmentId 。

Path parameters 路径参数

Body parameters 身体参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingInformation
{
  "packageGroupings": [
    {
      "packingGroupId": "string",
      "boxes": [
        {
          "weight": {
            "unit": "LB",
            "value": 0
          },
          "dimensions": {
            "unitOfMeasurement": "IN",
            "length": 0,
            "width": 0,
            "height": 0
          },
          "quantity": 1,
          "boxId": "string",
          "items": [
            {
              "msku": "string",
              "quantity": 1,
              "expiration": "string",
              "prepOwner": "AMAZON",
              "labelOwner": "AMAZON",
              "manufacturingLotCode": "string"
            }
          ],
          "contentInformationSource": "BOX_CONTENT_PROVIDED"
        }
      ]
    }
  ]
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "string"
}

Step 4. Generate and view options for destination fulfillment centers
步骤 4.生成并查看目的地履行中心的选项

Generate placement options for an inbound plan by calling the generatePlacementOptions operation. The PlacementOptions object represents the set of available placement options for an inbound plan, where each placement option describes the destination FCs and shipping options for each item in your inbound plan. These options help reduce the time it takes to receive a seller's items and make them available for sale (refer to Seller Central Help for more details).
通过调用 generatePlacementOptions 操作生成入站计划的放置选项。 PlacementOptions 对象表示入站计划的一组可用放置选项，其中每个放置选项描述了入站计划中每个商品的目的地 FC 和发货选项。这些选项有助于缩短接收卖家商品并将其出售所需的时间（更多详情请参考卖家中心帮助）。

📘

Note 备注

This operation generates initial shipment IDs for the shipments within each inbound plan. These IDs are different from the shipmentConfirmationIDs that confirmPlacementOption generates. The shipmentConfirmationID is the ID that is present on labels (for example, FBA1234ABCD). You can retrieve both of these shipment ID types with the getShipment operation.
此操作为每个入站计划中的货件生成初始货件 ID。这些 ID 与 confirmPlacementOption 生成的 shipmentConfirmationIDs 不同。 shipmentConfirmationID 是标签上的 ID（例如 FBA1234ABCD ）。您可以使用 getShipment 操作检索这两种装运 ID 类型。

Some of your options can include multiple destinations (refer to Seller Central Help for details). Each option can include fees or discounts, which are determined using an algorithm when your shipment is being created, and is not calculated using a set rate. The algorithm for the rebate value and the ship-to location uses multiple factors to optimize your shipments, including expected volume, the availability of carrier appointments, and fulfillment speed. The rebate that your shipment is eligible for is provided during shipment creation.
您的某些选项可以包括多个目的地（详情请参考 "卖家中心帮助"）。每个选项都可能包含费用或折扣，这些费用或折扣是在创建货件时通过算法确定的，而不是通过固定费率计算的。回扣值和发货地点的算法使用多种因素来优化您的货件，包括预期数量、承运商预约的可用性和履行速度。您的货件有资格获得的返利将在创建货件时提供。

The terms and conditions can change. Review the current Seller Central terms and conditions, including the Amazon Services Business Solutions Agreement.
条款和条件可能会更改。请查看当前的卖家中心条款和条件，包括《亚马逊服务业务解决方案协议》。

Path parameters 路径参数

Body parameters 身体参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions
{
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "string"
}

To view the options for shipment splits, call the listPlacementOptions operation. This operation provides the list of available placement options, which include:
要查看装运拆分选项，请调用 listPlacementOptions 操作。该操作提供了可用的分装选项列表，其中包括

• A placement option ID
  一个安置选项 ID
• The option status ("offered" or "accepted")
  选项状态（"提供 "或 "接受）
• Any fees/discounts associated with this option
  与该选项相关的任何费用/折扣
• The expiration date of the option
  期权到期日
• The shipment IDs associated with each option
  与每个选项相关的装运 ID

When a placement option expires, you must regenerate placement options by calling generatePlacementOption. The placement option ID is required to generate transportation options with generateTransportationOptions, while shipment IDs are used to understand the contents of each shipment using getShipment.
当配载选项过期时，必须调用 generatePlacementOption 重新生成配载选项。使用 generateTransportationOptions 生成运输选项时需要配售选项 ID，而使用 getShipment 了解每批货物的内容时则需要货物 ID。

Path parameters 路径参数

Query parameters 查询参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "pagination": {
    "nextToken": "string"
  },
  "placementOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "status": "OFFERED",
      "fees": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "discounts": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "expiration": "2019-08-24T14:15:22Z",
      "shipmentIds": [
        "string"
      ]
    }
  ]
}

Step 5. Input transportation data and generate transportation options
步骤 5.输入交通数据并生成交通方案

Generate transportation options with the generateTransportationOptions operation. A transportation option represents the list of shipping mode and carrier options that are available for each shipment within each placement option. By calling generateTransportationOptions, a seller must pass the following information:
使用 generateTransportationOptions 操作生成运输选项。运输选项表示每个配货选项中每个货件可用的运输模式和承运商选项列表。调用 generateTransportationOptions 时，卖方必须传递以下信息：

• Placement option ID 安置选项 ID
• Shipment ID 货物 ID
• Ready to ship date
  准备发货日期
• Ship from address 发货地址

Path parameters 路径参数

Body parameters 身体参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions
{
  "placementOptionId": "string",
  "shipmentTransportationConfigurations": [
    {
      "shipmentId": "string",
      "readyToShipWindow": {
        "start": "2019-08-24T14:15:22Z"
      },
      "contactInformation": {
        "phoneNumber": "string",
        "email": "string",
        "name": "string"
      },
      "palletInformation": {
        "pallets": [
          {
            "weight": {
              "unit": "LB",
              "value": 0
            },
            "dimensions": {
              "unitOfMeasurement": "IN",
              "length": 0,
              "width": 0,
              "height": 0
            },
            "quantity": 1,
            "stackability": "STACKABLE"
          }
        ],
        "freightClass": "string",
        "declaredValue": {
          "code": "str",
          "amount": 0
        }
      }
    }
  ]
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "string"
}

Step 6. Generate delivery window options with the generateDeliveryWindowOptions operation
步骤 6.使用 generateDeliveryWindowOptions 操作生成交付窗口选项

🚧

Important 重要

Sellers must confirm transportation options for all shipment types. For non-partnered shipments, sellers must also specify a delivery window.
卖家必须确认所有发货类型的运输选项。对于非合作货运，卖家还必须指定交付窗口。

Delivery windows are periods during which a seller can deliver their shipment to the destination fulfillment center. If the seller uses a non-partnered carrier, they must specify a seven-day delivery window for domestic shipments or a 14-day window for international shipments. The window is used to provide a shipment's expected arrival date and time at an Amazon fulfillment center. An available delivery window option is necessary for shipments that don't have an appointment slot with a fulfillment center. For example, shipments through non-partnered carriers need a confirmed delivery window.
交付窗口是卖家向目的地履行中心交付货物的时间段。如果卖家使用非合作承运商，则必须为国内货物指定 7 天的交付窗口，为国际货物指定 14 天的窗口。该窗口用于提供货物到达亚马逊履行中心的预计日期和时间。对于没有与履行中心预约时间段的货物，必须提供可用的交付窗口选项。例如，通过非合作承运商运送的货物需要确认交付窗口。

generateDeliveryWindowOptions requires the seller to pass the shipmentID for the shipment for which they intend to generate delivery windows.
generateDeliveryWindowOptions 要求卖方为其打算生成交货窗口的货物通过 shipmentID 。

Path parameters 路径参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/deliveryWindowOptions

Response 回应

Response example 响应示例

{
  "operationId": "string"
}

Step 7. Review shipment splits and transportation options
第 7 步审查分批装运和运输方案

Review shipment and transportation options by calling the listPlacementOptions, listTransportationOptions, and getShipment operations.
调用 listPlacementOptions 、 listTransportationOptions 和 getShipment 操作，查看装运和运输选项。

listPlacementOptions provides the list of available placement options, which includes a placement option ID, the status of the option (that is, offered vs. accepted), any fees/discounts associated with this option, the expiration date of the option, and the shipment IDs associated with each option.
listPlacementOptions 提供可用配售选项列表，其中包括配售选项 ID、选项状态（即提供与接受）、与该选项相关的任何费用/折扣、选项到期日期以及与每个选项相关的装运 ID。

To call listTransportationOptions, a seller needs to pass the placement option ID and shipment ID for which they want to view transportation options. A successful response includes all available transportation quotes for all available ship modes and carrier options. Shipping modes include:
要调用 listTransportationOptions ，卖方需要传递其希望查看运输选项的配载选项 ID 和货件 ID。成功的响应包括所有可用装运模式和承运商选项的所有可用运输报价。运输模式包括

• Ground small parcel 地面小包裹
• Less-than-truckload freight
  零担货运
• Full truckload freight (palletized)
  整车货物（托盘装运）
• Full truckload freight (non-palletized)
  整车货运（非托运）
• Less than container load ocean
  小于集装箱装载量的海运
• Full container load ocean
  满载海运集装箱
• Air small parcel 航空小包裹
• Air small parcel express
  航空小包裹快递

Carrier options include Amazon-partnered and non-partnered carriers. Quotes include:
承运商选项包括亚马逊合作和非合作承运商。报价包括

• Cost 费用
• A void window (the period where a seller can cancel a shipment and receive a refund for their transportation quote)
  无效窗口（卖方可以取消货运并获得运输报价退款的期限）
• Expiration 到期

In regions where fulfillment center appointments are mandatory (for example, India), we provide available appointment slots.
在必须预约履行中心的地区（如印度），我们会提供可用的预约时段。

Where the Partnered Carrier Program (PCP) is available, sellers can take advantage of discounted rates by using an Amazon-partnered carrier for their inbound shipments. To use an Amazon-partnered carrier for an inbound shipment, select the transportation option where shippingSolution is AMAZON_PARTNERED_CARRIER.
如果有合作承运商计划 (PCP)，卖家可以通过使用与亚马逊合作的承运商来运输入站货物，从而享受折扣价。要使用与亚马逊合作的承运商进行进货，请选择 shippingSolution 为 AMAZON_PARTNERED_CARRIER 的运输选项。

📘

Note 备注

Before you use an Amazon-partnered carrier for an inbound shipment, you must read the Seller Central Help about Amazon's PCP to help ensure that you successfully follow the program instructions and guidelines (Europe) (US).
在使用亚马逊合作的承运商进行入站发货之前，您必须阅读有关亚马逊 PCP 的卖家中心帮助，以帮助确保您成功遵守项目说明和指南（欧洲）（美国）。

In the EU region, you must first review and accept the terms and conditions of the carrier and the terms and conditions of Amazon's PCP. You can do this on Seller Central. If you attempt to use Amazon Selling Partner APIs to create an inbound shipment by using an Amazon-partnered carrier before accepting these terms and conditions, the service returns an error.
在欧盟地区，您必须首先查看并接受承运商的条款和条件以及亚马逊 PCP 的条款和条件。您可以在卖家中心进行此操作。如果您在接受这些条款和条件之前，尝试使用亚马逊销售合作伙伴 API 来使用亚马逊合作的承运商创建入站货物，则服务会返回错误。

If a seller doesn't want to participate in the PCP, they can view Choose your own carrier transportation options and available shipping modes.
如果卖家不想参与 PCP，他们可以查看 Choose your own carrier 运输选项和可用的运输模式。

Amazon filters out partnered carrier transportation options in certain situations. For example, if there is a partnered carrier transportation option at a lower price for a placement option that has identical shipment splits, then Amazon filters out the more expensive transportation option. If you plan to use a partnered carrier, call listTransportationOptions for each placement option to see the available partnered carrier options.
在某些情况下，亚马逊会过滤掉合作承运商的运输选项。例如，如果有一个合作承运商运输选项的价格更低，而投放选项的货物分拆情况完全相同，那么亚马逊就会筛选出价格更高的运输选项。如果您计划使用合作承运商，请致电 listTransportationOptions 查看每个配售选项的可用合作承运商选项。

📘

Note 备注

You can include a mix of Small Parcel Delivery (SPD) and LTL shipments in one inbound plan. You can also include a mix of PCP and non-PCP shipments in one inbound plan if:
您可以在一个进货计划中混合包含小包裹递送 (SPD) 和零担货运。在以下情况下，您也可以在一个进货计划中混合使用 PCP 和非 PCP 货物：

• The different carrier selections are assigned to different shipping modes (for example SPD and LTL).
  不同的承运商选择被分配给不同的运输模式（例如 SPD 和 LTL）。
• All shipments in the inbound plan are eligible for PCP.
  入境计划中的所有货运均符合 PCP 条件。

For example, you can create an inbound plan with one PCP SPD shipment and one non-PCP LTL shipment, assuming that all shipments within the inbound plan are eligible for PCP.
例如，您可以创建一个入站计划，其中包含一个 PCP SPD 托运和一个非 PCP LTL 托运，假设入站计划中的所有托运都符合 PCP 条件。

For more information about PCP eligibility, refer to the PCP help page.
有关初级保健医生资格的更多信息，请参阅初级保健医生帮助页面。

Path parameters 路径参数

Query parameters 查询参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "pagination": {
    "nextToken": "string"
  },
  "transportationOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "shipmentId": "string",
      "transportationOptionId": "string",
      "shippingSolution": "AMAZON_PARTNERED_CARRIER",
      "carrier": {
        "name": "string",
        "alphaCode": "string"
      },
      "shippingMode": "GROUND_SMALL_PARCEL",
      "quote": {
        "cost": {
          "code": "string",
          "amount": 0
        },
        "voidableUntil": "2019-08-24T14:15:22Z",
        "expiration": "2019-08-24T14:15:22Z"
      },
      "appointmentSlot": {
        "startDate": "2019-08-24T14:15:22Z",
        "endDate": "2019-08-24T14:15:22Z",
        "startTime": "2019-08-24T14:15:22Z",
        "endTime": "2019-08-24T14:15:22Z"
      }
    }
  ]
}

Review available delivery window options for each shipment within an inbound plan using the listDeliveryWindowOptions operation. To make this call, a seller passes the shipmentID. A successful response provides the startDate and endDate for each available delivery window and the level of congestion (availabilityType) for each option.
使用 listDeliveryWindowOptions 操作查看进货计划中每个货件的可用交货窗口选项。要进行此调用，卖方需要传递 shipmentID 。成功的响应将提供每个可用交付窗口的 startDate 和 endDate 以及每个选项的拥塞程度 ( availabilityType )。

🚧

Important 重要

Sellers must confirm transportation options for all shipment types. For non-Amazon partnered shipments, they must also specify a delivery window.
卖家必须确认所有发货类型的运输选项。对于非亚马逊合作的货物，卖家还必须指定交付窗口。

Each option has an expiration date (validUntil). You must confirm the delivery before this date. If you don't confirm the window by the validUntil date, you must generate a new window using listDeliveryWindowOptions.
每个期权都有一个到期日 ( validUntil )。必须在此日期前确认交付。如果您没有在 validUntil 日期前确认窗口，则必须使用 listDeliveryWindowOptions 生成一个新窗口。

Path parameters 路径参数

Query parameters 查询参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/deliveryWindowOptions

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素

Response example 响应示例

{
  "pagination": {
    "nextToken": "string"
  },
  "deliveryWindowOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "shipmentId": "string",
      "deliveryWindowOptionId": "string",
      "startDate": "2019-08-24T14:15:22Z",
      "endDate": "2019-08-24T14:15:22Z",
      "availabilityType": "string",
      "validUntil": "2019-08-24T14:15:22Z"
    }
  ]
}

Review details related to the contents of a shipment within an inbound plan using the getShipment operation. To call getShipment, a seller needs to pass the inbound plan ID and shipment ID. A successful response includes the following:
使用 getShipment 操作查看进货计划中与货件内容相关的详细信息。要调用 getShipment ，卖方需要传递入站计划 ID 和货件 ID。成功的响应包括以下内容：

• Placement option ID 安置选项 ID
• Shipment confirmed ID (the ID that shows up on labels)
  货物确认 ID（标签上显示的 ID）
• Shipment ID (the identifier for a shipment prior to the confirmPlacementOption operation)
  货物 ID（ confirmPlacementOption 操作前货物的标识符）
• Amazon reference ID (identifier for scheduling fulfillment center appointments for truck deliveries)
  亚马逊参考 ID（用于安排履行中心预约卡车送货的标识符）
• Selected transportation option ID
  所选交通方案 ID
• Name 名称
• Source 资料来源
• Destination FC 目的地 FC
• Ship date 发货日期
• Estimated delivery date 预计交付日期
• Status 现状
• Tracking details 跟踪详情
• Pallet information 托盘信息
• Contact information 联系信息
• Destination region 目的地区域
• FC appointment details FC 任命详情

Path parameters 路径参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素

Response example 响应示例

{
  "inboundPlanId": "string",
  "placementOptionId": "string",
  "shipmentId": "string",
  "shipmentConfirmationId": "string",
  "amazonReferenceId": "string",
  "selectedTransportationOptionId": "string",
  "name": "string",
  "source": {
    "sourceType": "SELLER_FACILITY",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    }
  },
  "destination": {
    "destinationType": "AMAZON_OPTIMIZED",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    },
    "warehouseId": "string"
  },
  "dates": {
    "readyToShipWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    },
    "deliveryWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    }
  },
  "status": "ABANDONED",
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "string"
      ],
      "billOfLadingNumber": "string"
    },
    "spdTrackingDetail": {
      "spdTrackingItems": [
        {
          "boxId": "string",
          "trackingId": "string",
          "trackingNumberValidationStatus": "VALIDATED"
        }
      ]
    }
  },
  "palletInformation": {
    "pallets": [
      {
        "weight": {
          "unit": "LB",
          "value": 0
        },
        "dimensions": {
          "unitOfMeasurement": "IN",
          "length": 0,
          "width": 0,
          "height": 0
        },
        "quantity": 1,
        "stackable": true
      }
    ],
    "freightClass": "NONE",
    "declaredValue": {
      "code": "string",
      "amount": 0
    }
  },
  "contactInformation": {
    "phoneNumber": "string",
    "email": "string",
    "name": "string"
  },
  "selfShipAppointmentDetails": [
    {
      "appointmentId": 0,
      "appointmentSlotTime": {
        "startTime": "2019-08-24T14:15:22Z",
        "endTime": "2019-08-24T14:15:22Z"
      },
      "appointmentStatus": "string"
    }
  ]
}

Step 8. Select shipping option
第 8 步选择运输选项

Select shipment option (that is, shipment splits) with the confirmPlacementOption operation. This operation selects the placement splits for an inbound plan and creates confirmed shipment IDs for shipments within the inbound plan. The shipmentConfirmationID is the shipment identifier that appears on labels (for example, FBA1234ABCD). This ID is different from the shipment ID that is generated with createInboundPlan, which is used as an input to other operations, such as getShipment. This option cannot be reversed after it is selected. To call confirmPlacementOption, a seller must pass the inbound plan ID and the selected placement option ID.
使用 confirmPlacementOption 操作选择装运选项（即装运分拆）。该操作为入库计划选择分装，并为入库计划中的货件创建确认的货件 ID。 shipmentConfirmationID 是出现在标签上的货件标识符（例如 FBA1234ABCD ）。该 ID 不同于用 createInboundPlan 生成的货件 ID，后者被用作其他操作（如 getShipment ）的输入。该选项被选中后不能更改。要调用 confirmPlacementOption ，卖方必须传递进货计划 ID 和所选配料选项 ID。

📘

Note 备注

createInboundPlan generates initial shipment IDs for the shipments in each inbound plan. These IDs are different from the shipmentConfirmationIDs that confirmPlacementOption generates. The shipmentConfirmationID is the identifier that is present on labels (for example, FBA1234ABCD). You can retrieve both types of shipment IDs with the getShipment operation.
createInboundPlan 为每个入站计划中的货件生成初始货件 ID。这些 ID 与 confirmPlacementOption 生成的 shipmentConfirmationIDs 不同。 shipmentConfirmationID 是标签上的标识符（例如 FBA1234ABCD ）。您可以使用 getShipment 操作检索这两种类型的货件 ID。

Path parameters 路径参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions/{placementOptionId}/confirmation

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "string"
}

Step 9. Select transportation options
第 9 步选择运输方式

Select delivery windows for each shipment within a plan using the confirmDeliveryWindowOptions operation. To call this operation, pass the shipmentID and deliveryWindowOptionId (provided by listDeliveryWindowOptions).
使用 confirmDeliveryWindowOptions 操作为计划中的每个货运选择交货窗口。要调用此操作，需要传递 shipmentID 和 deliveryWindowOptionId （由 listDeliveryWindowOptions 提供）。

You must confirm a placement option for the shipment before you call this operation. After you confirm the delivery window, new delivery window options cannot be generated. However, you can update the selected delivery window option before shipment closure. For all transportation options that have the program DELIVERY_WINDOW_REQUIRED, you must confirm a delivery window before you confirm the transportation option. If you need to update your delivery window after you confirm the transportation option, you can call confirmDeliveryWindow.
在调用此操作前，您必须确认货件的放置选项。确认交货窗口后，将无法生成新的交货窗口选项。但是，您可以在货运结束前更新所选的交货窗口选项。对于具有程序 DELIVERY_WINDOW_REQUIRED 的所有运输选项，必须在确认运输选项前确认交货窗口。如果需要在确认运输选项后更新交货窗口，可以调用 confirmDeliveryWindow 。

Path parameters 路径参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/deliveryWindowOptions/confirmation
{
  "transportationSelections": [
    {
      "shipmentId": "string",
      "transportationOptionId": "string",
      "contactInformation": {
        "phoneNumber": "string",
        "email": "string",
        "name": "string"
      }
    }
  ]
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素

Response example 响应示例

{
  "operationId": "string"
}

This mandatory step allows you to select transportation options for each shipment within an inbound plan using the confirmTransportationOptions operation. For Amazon-partnered transportation options, this operation confirms that the seller accepts the Amazon-partnered shipping estimate, agrees to allow Amazon to charge their account for the shipping cost, and requests that the Amazon-partnered carrier ships the inbound shipment. Before this call, a seller must confirm a placement option for their inbound plan. To call confirmTransportationOptions, a seller must pass the shipment ID, selected transportation option ID, and contact information (needed for partnered carriers for LTL shipments). When a transportation option is confirmed, new transportation options cannot be generated or confirmed for an inbound plan. You must confirm a transportation option before printing labels.
此强制步骤允许您使用 confirmTransportationOptions 操作为入库计划中的每个货物选择运输选项。对于 Amazon-partnered 运输选项，此操作确认卖家接受 Amazon-partnered 运输估价，同意允许 Amazon 从其账户中收取运输费用，并要求 Amazon-partnered 承运人运送入站货物。在呼叫之前，卖家必须确认其进货计划的放置选项。要呼叫 confirmTransportationOptions ，卖家必须传递货物 ID、所选运输选项 ID 和联系信息（零担货物的合作承运商需要）。确认运输选项后，就不能为入库计划生成或确认新的运输选项。您必须在打印标签前确认运输选项。

📘

Note 备注

If a seller confirms the transportation request, then decides they don't want the Amazon-partnered carrier to ship the inbound shipment, they can use cancelInboundPlan to cancel the transportation request. For Small Parcel shipments, the seller has 24 hours after confirming a transportation request to void the request. For Less Than Truckload/Full Truckload (LTL/FTL) shipments, the seller has one hour after confirming a transportation request to void the request. After the relevant time period expires, the seller's account is charged for the shipping cost.
如果卖家确认了运输请求，然后决定不希望由 Amazon-partnered 承运商运送入站货物，则可以使用 cancelInboundPlan 取消运输请求。对于小包裹货物，卖家可在确认运输请求后 24 小时内取消请求。对于零担/整车（LTL/FTL）货物，卖方可在确认运输请求后一小时内取消请求。相关时间到期后，卖方账户将被收取运费。

Path parameters 路径参数

Body parameters 身体参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions/confirmation
{
  "transportationSelections" : [ {
    "contactInformation" : {
      "email" : "email@email.com",
      "name" : "John Smithy",
      "phoneNumber" : "1234567890"
    },
    "deliveryWindow" : {
      "start" : "2024-01-01T00:00Z"
    },
    "shipmentId" : "sh1234abcd-1234-abcd-5678-1234abcd5678",
    "transportationOptionId" : "to1234abcd-1234-abcd-5678-1234abcd5678"
  } ]
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "string"
}

Step 10. Printing labels 步骤 10.打印标签

Call the getLabels operation to request unique shipping labels for your inbound shipments. Each shipping label returned by the getLabels operation should be affixed to the package in the shipment that it corresponds to, so the labels indicate the package contents. This helps to ensure that your shipment is processed at the Amazon fulfillment center quickly and accurately.
调用 getLabels 操作可为入站货件申请唯一的货运标签。 getLabels 操作返回的每个装运标签都应贴在其对应的货件中的包裹上，以便标签显示包裹内容。这有助于确保亚马逊履行中心快速准确地处理您的货物。

❗️

Warning 警告

The value of shipmentId in the getLabels request must be the shipmentId (from v0) or the shipmentConfirmationId (from v2024-03-20). Do not use the shipmentId from v2024-03-20.
getLabels 请求中 shipmentId 的值必须是 shipmentId （v0 版）或 shipmentConfirmationId （v2024-03-20 版）。请勿使用 v2024-03-20 中的 shipmentId 。

To print labels for a specific box, specify the boxID (from the listShipmentBoxes response) as the PackageLabelsToPrint value.
要打印特定方框的标签，请将 boxID （来自 listShipmentBoxes 响应）指定为 PackageLabelsToPrint 值。

Note that the shipment status does not become ready_to_ship if you retrieve carton labels with getLabels. For a shipment status to become ready_to_ship, you must generate labels on Send to Amazon.
请注意，如果使用 getLabels 检索纸箱标签，发货状态不会变为 ready_to_ship 。要使装运状态变成 ready_to_ship ，您必须在 "发送到亚马逊 "中生成标签。

For detailed instruction, refer to Request shipping labels for your inbound shipment.
有关详细说明，请参阅申请进港货物的运输标签。

Step 11. Send your shipments to Amazon's fulfillment network
第 11 步将您的货物发送到亚马逊的履行网络

Send your shipments to Amazon's fulfillment network using an Amazon-Partnered carrier or a non-Amazon-Partnered carrier that is registered with Amazon. For more information about sending shipments to Amazon's fulfillment network, refer to the Seller Central Help for your marketplace.
使用亚马逊合作承运商或已在亚马逊注册的非亚马逊合作承运商将您的货物发送到亚马逊的履行网络。有关将货物发送到亚马逊履行网络的更多信息，请参阅您所在市场的 "卖家中心帮助"。

As you prepare your shipment, you can retrieve all of the box-level information that you have entered for an inbound plan using the listInboundPlanBoxes operation.
在准备装运时，您可以使用 listInboundPlanBoxes 操作检索为入库计划输入的所有箱级信息。

Path parameters 路径参数

Query parameters 查询参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/boxes

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "pagination": {
    "nextToken": "string"
  },
  "boxes": [
    {
      "packageId": "string",
      "weight": {
        "unit": "LB",
        "value": 0
      },
      "dimensions": {
        "unitOfMeasurement": "IN",
        "length": 0,
        "width": 0,
        "height": 0
      },
      "quantity": 0,
      "boxId": "string",
      "templateName": "string",
      "items": [
        {
          "msku": "string",
          "asin": "string",
          "fnsku": "string",
          "labelOwner": "AMAZON",
          "quantity": 1,
          "expiration": "string",
          "manufacturingLotCode": "string",
          "prepInstructions": [
            {
              "prepType": "string",
              "prepOwner": "AMAZON",
              "fee": {
                "code": "string",
                "amount": 0
              }
            }
          ]
        }
      ],
      "shipmentId": "string",
    }
  ]
}

Step 12. Providing tracking information
步骤 12.提供跟踪信息

After sending a shipment to Amazon's fulfillment network using a non-partnered carrier, a seller must share the tracking ID using the updateShipmentTrackingDetails operation. To call this operation, a seller must pass the shipment ID and tracking details for their less-than-truckload or small parcel shipment. For less-than-truckload shipments, the seller must provide a PRO number (also known as Freight Bill number) and can optionally provide a BOL number. For small parcel shipments, the seller must share an array of box IDs and associated tracking IDs.
使用非合作承运商将货物发送到亚马逊的履行网络后，卖家必须使用 updateShipmentTrackingDetails 操作共享跟踪 ID。要调用此操作，卖家必须为其零担货物或小包裹货物传递货物 ID 和跟踪详细信息。对于零担货物，卖方必须提供 PRO 编号（也称为货运单号），并可选择提供 BOL 编号。对于小包裹货物，卖方必须共享一系列箱子 ID 和相关的跟踪 ID。

Path parameters 路径参数

Body parameters 身体参数

Request example 请求示例

PUT /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/trackingDetails
{
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "string"
      ],
      "billOfLadingNumber": "string"
    },
    "spdTrackingDetail": {
      "spdTrackingItems": [
        {
          "boxId": "string",
          "trackingId": "string"
        }
      ]
    }
  }
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "string"
}

Tutorial: Creating a shipment when the seller does not know the carton level information up-front
教程：在卖方事先不知道纸箱级别信息的情况下创建货件

Step 1. Create an Inbound Plan
步骤 1.制定入境计划

📘

Note 备注

The process for creating a shipment when the carton-level information is not known upfront is only available for LTL shipments.
在前期不知道纸箱级信息的情况下创建装运的流程仅适用于零担货物。

Create an Inbound Plan by calling the asynchronous createInboundPlan operation. An Inbound Plan represents a collection of inbound shipments that contain items you intend to inbound into Amazon's fulfillment network. By calling the createInboundPlan operation, a seller must specify:
通过调用异步 createInboundPlan 操作创建入站计划。入站计划代表入站货物的集合，其中包含您打算入站到亚马逊履行网络的商品。通过调用 createInboundPlan 操作，卖家必须指定：

• The address from which the inbound shipments will be sent
  将从哪个地址发送入境货物
• The marketplace where the product would be shipped
  产品的运输市场
• Contact information (needed for partnered carriers for LTL shipments)
  联系信息（零担货运合作承运商需要的信息）
• A summary of the items they intend to inbound
  他们打算输入的项目摘要

The item summary must include MSKU, quantity, and an indication of who will prepare/label the item. Note that AMAZON_LABEL is available only if you are enrolled in the FBA Label Service. For more information about the FBA Label Service, refer to the Seller Central Help for your marketplace.
项目摘要必须包括 MSKU、数量以及由谁准备/标记项目的说明。请注意， AMAZON_LABEL 只有在您注册了 FBA 标签服务后才可用。有关 FBA 标签服务的更多信息，请参阅您所在市场的 "卖家中心帮助"。

Make sure each item you ship conforms to Amazon's product packaging requirements. For more information, refer to Packaging and Prep Requirements in Seller Central Help. For more information about Amazon's product packaging requirements for your marketplace, refer to Seller Central URLs. You can set the Prep Category for SKUs on Send to Amazon Step 1. You can do this one at a time or up to 25 at a time. This is a one-time activity per SKU that carries over to all future inbound plans.
确保您运送的每件物品都符合亚马逊的产品包装要求。有关详细信息，请参阅 "卖家中心帮助 "中的 "包装和准备要求"。有关您所在市场的亚马逊产品包装要求的更多信息，请参阅 "卖家中心 URL"。您可以在 "发送到亚马逊 "步骤 1 中为 SKU 设置准备类别。您可以一次设置一个，也可以一次设置多达 25 个。这是对每个 SKU 进行的一次性活动，会延续到所有未来的入站计划中。

📘

Note 备注

Multiple expiration dates per SKU on a single inbound plan is not supported. To send a SKU with multiple expiration dates to the fulfillment network, you need to create multiple plans.
不支持单个进货计划中每个库存单位有多个过期日期。要将具有多个过期日期的库存单位发送到履行网络，需要创建多个计划。

Optionally, a seller can include each item's expiration date and manufacturing lot code. A successful response includes an inboundPlanId, which is a unique identifier for the inbound plan, synonymous with the concept of "workflow ID", which is generated on Send to Amazon (the shipment creation workflow on Seller Central).
卖家还可以选择包含每个商品的过期日期和生产批次代码。成功的响应包括一个 inboundPlanId ，它是入站计划的唯一标识符，与 "工作流 ID "概念同义，后者在发送到亚马逊（卖家中心的发货创建工作流）中生成。

📘

Note 备注

createInboundPlan generates initial shipment IDs for the shipments within each inbound plan. These IDs are different from the shipmentConfirmationIDs that are generated with the confirmPlacementOption operation. The shipmentConfirmationID is the identifier that appears on labels (for example, FBA1234ABCD). Both of these types of shipment IDs can be retrieved with the getShipment operation.
createInboundPlan 为每个入站计划中的货件生成初始货件 ID。这些 ID 与 confirmPlacementOption 操作生成的 shipmentConfirmationIDs 不同。 shipmentConfirmationID 是出现在标签上的标识符（例如 FBA1234ABCD ）。这两种类型的货件 ID 都可以通过 getShipment 操作来检索。

Body parameters 身体参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans
{
  "contactInformation" : {
    "email" : "email@email.com",
    "name" : "name",
    "phoneNumber" : "1234567890"
  },
  "destinationMarketplaces" : [ "ATVPDKIKX0DER" ],
  "items" : [ {
    "expiration" : "2024-01-01",
    "labelOwner" : "AMAZON",
    "manufacturingLotCode" : "manufacturingLotCode",
    "msku" : "Sunglasses",
    "prepOwner" : "AMAZON",
    "quantity" : 10
  } ],
  "name" : "My inbound plan",
  "sourceAddress" : {
    "addressLine1" : "123 example street",
    "addressLine2" : "Floor 19",
    "city" : "Toronto",
    "companyName" : "Acme",
    "countryCode" : "CA",
    "email" : "email@email.com",
    "name" : "name",
    "phoneNumber" : "1234567890",
    "postalCode" : "M1M1M1",
    "stateOrProvinceCode" : "ON"
  }
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "operationID1234",
  "inboundPlanId": "PlanID1234"
}

Check the status of a call
检查通话状态

Check the status of an inbound request by using the getInboundOperationStatus operation. For asynchronous operations, this operation provides the processing status. We omit this step for other asynchronous operations in this tutorial. By calling getInboundOperationStatus, a seller passes the operationId, which is a Universal Unique Identifier (UUID) for the operation. A successful response includes the request status and can include a list of errors associated with the request.
使用 getInboundOperationStatus 操作检查入站请求的状态。对于异步操作，该操作提供处理状态。对于本教程中的其他异步操作，我们将省略这一步骤。通过调用 getInboundOperationStatus 操作，卖方会传递 operationId 操作的通用唯一标识符 (UUID)。成功的响应包括请求状态，还可能包括与请求相关的错误列表。

Path parameters 路径参数

Request example 请求示例

GET /inbound/fba/2024-03-20/operations/{operationId}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operation": "string",
  "operationId": "string",
  "operationProblems": [
    {
      "code": "Error code 1234",
      "message": "Box volume does not meet the expected minimum cubic cm 144,815",
      "details": "Additional error details",
      "severity": "WARNING"
    }
  ],
  "status": "SUCCESS",
}

Step 2. Generate and view options for destination fulfillment centers
步骤 2.生成并查看目的地履行中心选项

Generate and view placement options for an inbound plan by calling the generatePlacementOptions, listPlacementOptions, and getShipment operations.
通过调用 generatePlacementOptions 、 listPlacementOptions 和 getShipment 操作，生成并查看入站计划的放置选项。

❗

Warning 警告

Sellers cannot provide packing information using Send to Amazon after confirming placement options. They will not be able to access API-created shipments on Send to Amazon during this step.
确认放置选项后，卖家无法使用 "发送到亚马逊 "提供包装信息。在此步骤中，卖家将无法访问 "发送到亚马逊 "中 API 创建的货物。

The placementOptions object represents the set of available placement options for an inbound plan, where each placement option describes the destination FCs and shipping options for each item in your inbound plan. These options are designed to help reduce the time that it takes to receive a seller's items and make them available for sale (refer to Seller Central Help for more details).
placementOptions 对象表示入站计划的一组可用放置选项，其中每个放置选项描述了入站计划中每个商品的目的地 FC 和发货选项。这些选项旨在帮助缩短接收卖家商品并将其出售所需的时间（更多详情，请参阅 "卖家中心帮助"）。

Some of your options can include multiple destinations (refer to Seller Central Help for details). Each option can include fees or discounts, which are determined using an algorithm when your shipment is being created, and is not calculated using a set rate. The algorithm for the rebate value and the ship-to location uses multiple factors to optimize your shipments, including expected volume, the availability of carrier appointments, and fulfillment speed. The rebate that your shipment is eligible for is provided during shipment creation.
您的某些选项可以包括多个目的地（详情请参考 "卖家中心帮助"）。每个选项都可能包含费用或折扣，这些费用或折扣是在创建货件时通过算法确定的，而不是通过固定费率计算的。回扣值和发货地点的算法使用多种因素来优化您的货件，包括预期数量、承运商预约的可用性和履行速度。您的货件有资格获得的返利将在创建货件时提供。

The terms and conditions can change. Review the current Seller Central terms and conditions, including the Amazon Services Business Solutions Agreement.
条款和条件可能会更改。请查看当前的卖家中心条款和条件，包括《亚马逊服务业务解决方案协议》。

📘

Note 备注

When a seller calls generatePlacementOptions without inputting box content information, Amazon provides placement options that are optimized for unit-level data (because Amazon does not yet have box data). These options can differ from the placement options that are generated after a seller provides box content information (using setPackingInformation).
当卖家在未输入包装盒内容信息的情况下调用 generatePlacementOptions 时，亚马逊会提供针对单元级数据进行优化的放置选项（因为亚马逊尚未掌握包装盒数据）。这些选项可能不同于卖家提供包装盒内容信息（使用 setPackingInformation ）后生成的放置选项。

Path parameters 路径参数

Body parameters 身体参数

Request example 请求示例

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions
{
}

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "operationId": "string"
}

View the options for shipment splits by calling the listPlacementOptions operation. This operation provides the list of available placement options, which include:
通过调用 listPlacementOptions 操作查看装运拆分选项。该操作提供了可用的分装选项列表，其中包括

• A placement option ID
  一个安置选项 ID
• The option status ("offered" or "accepted")
  选项状态（"提供 "或 "接受）
• Any fees/discounts associated with this option
  与该选项相关的任何费用/折扣
• The expiration date of the option
  期权到期日
• The shipment IDs associated with each option
  与每个选项相关的装运 ID

When a placement option expires, you must regenerate placement options by calling generatePlacementOption. The placement option ID is required to generate transportation options with generateTransportationOptions, while shipment IDs are used to understand the contents of each shipment using getShipment (refer to the following).
当配载选项过期时，必须调用 generatePlacementOption 重新生成配载选项。使用 generateTransportationOptions 生成运输选项时需要配售选项 ID，而使用 getShipment 了解每批货物的内容时则需要货物 ID（请参阅下文）。

Path parameters 路径参数

Query parameters 查询参数

Request example 请求示例

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions

Response 回应

A successful response includes the following elements:
成功的应对措施包括以下要素：

Response example 响应示例

{
  "pagination": {
    "nextToken": "string"
  },
  "placementOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "status": "OFFERED",
      "fees": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "discounts": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "expiration": "2019-08-24T14:15:22Z",
      "shipmentIds": [
        "string"
      ]
    }
  ]
}

Review details related to the contents of a shipment within an inbound plan using the getShipment operation. To call getShipment, a seller needs to pass the inbound plan ID and shipment ID. A successful response includes placement option ID, shipment confirmed ID (that is, the ID that shows up on labels, created after confirmPlacementOption), shipment ID (that is, identifier for a shipment prior to the confirmPlacementOption operation), Amazon reference ID (identifier for scheduling fulfillment center appointments for truck deliveries), selected transportation option ID, name, source, destination FC, ship date, estimated delivery date, status, tracking details, pallet information, contact information, destination region, and FC appointment details.
使用 getShipment 操作查看进货计划中与货件内容相关的详细信息。要调用 getShipment ，卖方需要传递入站计划 ID 和货件 ID。成功的响应包括放置选项 ID、货件确认 ID（即显示在标签上的 ID，在 confirmPlacementOption 之后创建）、货件 ID（即 confirmPlacementOption 操作之前的货件标识符）、亚马逊参考 ID（用于安排履行中心预约卡车交货的标识符）、所选运输选项 ID、名称、货源、目的地 FC、发货日期、预计交货日期、状态、跟踪详情、托盘信息、联系信息、目的地区域和 FC 预约详情。

Path parameters 路径参数