Fulfillment Inbound API v2024-03-20 Reference
满足入站 API v2024-03-20 参考文档

Overview 概述

The Selling Partner API for Fulfillment By Amazon (FBA) Inbound. The FBA Inbound API enables building inbound workflows to create, manage, and send shipments into Amazon's fulfillment network. The API has interoperability with the Send-to-Amazon user interface.
亚马逊 FBA 入库销售伙伴 API。FBA 入库 API 允许构建入库工作流程，以创建、管理和发送货物进入亚马逊的履行网络。该 API 与“发送至亚马逊”用户界面具有互操作性。

Version information 版本信息

Version : 2024-03-20 版本：2024-03-20

Contact information 联系方式

Contact : Selling Partner API Developer Support
联系：销售合作伙伴 API 开发者支持
Contact URL : https://sellercentral.amazon.com/gp/mws/contactus.html
联系网址：https://sellercentral.amazon.com/gp/mws/contactus.html

License information 授权信息

License : Apache License 2.0
许可证：Apache 许可证 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0
许可证 URL：http://www.apache.org/licenses/LICENSE2.0

URI scheme URI 方案

Host : sellingpartnerapi-na.amazon.com
主机：sellingpartnerapi-na.amazon.com
Schemes : HTTPS 方案：HTTPS

Consumes 消耗

• application/json

Produces 生产

• application/json

Operations 运营

listInboundPlans 列出入站计划
createInboundPlan 创建进货计划
getInboundPlan 获取入境计划
listInboundPlanBoxes 列表入站计划箱
cancelInboundPlan 取消入站计划
listInboundPlanItems 列出入站计划项
updateInboundPlanName 更新入站计划名称
listPackingGroupBoxes 列表包装分组框
listPackingGroupItems 列出包装组项目
setPackingInformation 设置包装信息
listPackingOptions 列表包装选项
generatePackingOptions 生成包装选项
confirmPackingOption 确认包装选项
listInboundPlanPallets 列出入库计划托盘
listPlacementOptions 列表放置选项
generatePlacementOptions
生成放置选项
confirmPlacementOption 确认放置选项
getShipment 获取货运
listShipmentBoxes 清单运输箱
listShipmentContentUpdatePreviews
列出货运内容更新预览
generateShipmentContentUpdatePreviews
生成发货内容更新预览
getShipmentContentUpdatePreview
获取运输内容更新预览
confirmShipmentContentUpdatePreview
确认发货内容更新预览
getDeliveryChallanDocument
获取送货单据
listDeliveryWindowOptions
列出配送时间选项
generateDeliveryWindowOptions
生成配送时间选项
confirmDeliveryWindowOptions
确认配送时间选项
listShipmentItems 列出货运项目
updateShipmentName 更新运输名称
listShipmentPallets 列出装货托盘
cancelSelfShipAppointment
取消自寄预约
getSelfShipAppointmentSlots
获取自提预约时段
generateSelfShipAppointmentSlots
生成自寄预约时段
scheduleSelfShipAppointment
安排自寄预约
updateShipmentSourceAddress
更新发货源地址
updateShipmentTrackingDetails
更新物流跟踪详情
listTransportationOptions
列出运输选项
generateTransportationOptions
生成运输选项
confirmTransportationOptions
确认运输选项
listItemComplianceDetails
商品合规详情
updateItemComplianceDetails
更新商品合规详情
createMarketplaceItemLabels
创建市场商品标签
listPrepDetails 列表准备详情
setPrepDetails 设置准备详情
getInboundOperationStatus
获取入站操作状态

Paths 路径

GET /inbound/fba/2024-03-20/inboundPlans
获取 /inbound/fba/2024-03-20/inboundPlans

Operation: listInboundPlans
操作：列出入站计划

Description 描述

Provides a list of inbound plans with minimal information.
提供一份包含最少信息的入境计划列表。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

POST /inbound/fba/2024-03-20/inboundPlans

Operation: createInboundPlan
操作：创建进货计划

Description 描述

Creates an inbound plan. An inbound plan contains all the necessary information to send shipments into Amazon's fufillment network.
创建一个入库计划。入库计划包含发送货物到亚马逊履行网络所需的所有必要信息。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Consumes 消耗

• application/json

Produces 生产

• application/json

Example HTTP request 示例 HTTP 请求

Request body 请求体

{
  "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"
  }
}

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

Operation: getInboundPlan
操作：getInboundPlan

Description 描述

Fetches the top level information about an inbound plan.
获取关于入境计划的顶级信息。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

Example HTTP response 示例 HTTP 响应

Response 200 响应 200

{
  "createdAt" : "2024-03-20T12:01:00Z",
  "inboundPlanId" : "wf1234abcd-1234-abcd-5678-1234abcd5678",
  "lastUpdatedAt" : "2024-03-28T13:15:30Z",
  "marketplaceIds" : [ "A2EUQ1WTGCTBG2" ],
  "name" : "FBA (03/20/2024, 12:01 PM)",
  "packingOptions" : [ ],
  "placementOptions" : [ ],
  "shipments" : [ ],
  "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"
  },
  "status" : "ACTIVE"
}

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

Operation: listInboundPlanBoxes
操作：列出入库计划箱

Description 描述

Provides a paginated list of box packages in an inbound plan.
提供进货计划中箱包装的分页列表。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

PUT /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/cancellation
PUT /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/cancellation PUT /入站/fba/2024-03-20/入站计划/{inboundPlanId}/取消

Operation: cancelInboundPlan
操作：取消进货计划

Description 描述

Cancels an Inbound Plan. Charges may apply if the cancellation is performed outside of a void window. The window for Amazon Partnered Carriers is 24 hours for Small Parcel Delivery (SPD) and one hour for Less-Than-Truckload (LTL) carrier shipments.
取消入站计划。如果取消操作在空档期之外进行，可能会产生费用。亚马逊合作伙伴承运人的空档期为小型包裹配送（SPD）24 小时，以及整车运输承运人货物一小时内。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/items
GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/items Translated Text: GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/items

Operation: listInboundPlanItems
操作：列出入站计划项

Description 描述

Provides a paginated list of item packages in an inbound plan.
提供进货计划中项目包装的分页列表。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

PUT /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/name

Operation: updateInboundPlanName
操作：更新进货计划名称

Description 描述

Updates the name of an existing inbound plan.
更新现有入站计划的名称。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Consumes 消耗

• application/json

Produces 生产

• application/json

Example HTTP request 示例 HTTP 请求

Request body 请求体

{
  "name" : "name"
}

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

Operation: listPackingGroupBoxes
操作：listPackingGroupBoxes

Description 描述

Retrieves a page of boxes from a given packing group. These boxes were previously provided through the setPackingInformation operation. This API is used for workflows where boxes are packed before Amazon determines shipment splits.
从指定的包装组中检索一页的箱子。这些箱子之前通过 setPackingInformation 操作提供。此 API 用于在亚马逊确定分装前箱子已打包的工作流程。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

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

Operation: listPackingGroupItems
操作：listPackingGroupItems

Description 描述

Retrieves a page of items in a given packing group. Packing options must first be generated by the corresponding operation before packing group items can be listed.
获取指定包装组的一页商品。在列出包装组商品之前，必须先通过相应操作生成包装选项。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

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

Operation: setPackingInformation
操作：设置包装信息

Description 描述

Sets packing information for an inbound plan. This should be called after an inbound plan is created to populate the box level information required for planning and transportation estimates.
设置进货计划的包装信息。应在创建进货计划后调用，以填充规划及运输估算所需的箱级信息。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Consumes 消耗

• application/json

Produces 生产

• application/json

Example HTTP request 示例 HTTP 请求

Request body 请求体

{
  "packageGroupings" : [ {
    "boxes" : [ {
      "contentInformationSource" : "BOX_CONTENT_PROVIDED",
      "dimensions" : {
        "height" : 5,
        "length" : 3,
        "unitOfMeasurement" : "CM",
        "width" : 4
      },
      "items" : [ {
        "expiration" : "2024-01-01",
        "labelOwner" : "AMAZON",
        "manufacturingLotCode" : "manufacturingLotCode",
        "msku" : "Sunglasses",
        "prepOwner" : "AMAZON",
        "quantity" : 10
      } ],
      "quantity" : 2,
      "weight" : {
        "unit" : "KG",
        "value" : 5.5
      }
    } ],
    "packingGroupId" : "pg1234abcd-1234-abcd-5678-1234abcd5678",
    "shipmentId" : "sh1234abcd-1234-abcd-5678-1234abcd5678"
  } ]
}

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions
GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions Translated Text: GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/包装选项

Operation: listPackingOptions
操作：listPackingOptions

Description 描述

Retrieves a list of all packing options for an inbound plan. Packing options must first be generated by the corresponding operation before becoming available.
获取所有入站计划的包装选项列表。包装选项必须首先由相应的操作生成，然后才能可用。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

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

Operation: generatePackingOptions
操作：生成包装选项

Description 描述

Generates available packing options for the inbound plan.
生成进货计划的可用包装选项。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

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

Operation: confirmPackingOption
操作：确认包装选项

Description 描述

Confirms the packing option for an inbound plan.
确认进货计划的包装选项。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/pallets
GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/pallets GET /入站/fba/2024-03-20/入站计划/{入站计划 ID}/托盘

Operation: listInboundPlanPallets
操作：列出入库计划托盘

Description 描述

Provides a paginated list of pallet packages in an inbound plan. An inbound plan will have pallets when the related details are provided after generating Less-Than-Truckload (LTL) carrier shipments.
提供进货计划中托盘包装的分页列表。在生成不足整车运输（LTL）承运人运输的相关详情后，进货计划将包含托盘。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

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

Operation: listPlacementOptions
操作：列出放置选项

Description 描述

Provides a list of all placement options for an inbound plan. Placement options must first be generated by the corresponding operation before becoming available.
提供所有入站计划的放置选项列表。放置选项必须首先由相应的操作生成，然后才能可用。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

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

Operation: generatePlacementOptions
操作：生成放置选项

Description 描述

Generates placement options for the inbound plan.
生成进件计划的摆放选项。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Consumes 消耗

• application/json

Produces 生产

• application/json

Example HTTP request 示例 HTTP 请求

Request body 请求体

{
  "customPlacement" : [ {
    "items" : [ {
      "expiration" : "2024-01-01",
      "labelOwner" : "AMAZON",
      "manufacturingLotCode" : "manufacturingLotCode",
      "msku" : "Sunglasses",
      "prepOwner" : "AMAZON",
      "quantity" : 10
    } ],
    "warehouseId" : "YYZ14"
  } ]
}

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

Operation: confirmPlacementOption
操作：确认放置选项

Description 描述

Confirms the placement option for an inbound plan. Once confirmed, it cannot be changed for the Inbound Plan.
确认入站计划的放置选项。一旦确认，入站计划将无法更改。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

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

Operation: getShipment 操作：获取运输

Description 描述

Provides the full details for a specific shipment within an inbound plan. The transportationOptionId inside acceptedTransportationSelection can be used to retrieve the transportation details for the shipment.
提供入站计划中特定货物的全部详细信息。在 acceptedTransportationSelection 中的 transportationOptionId 可以用来检索该货物的运输详情。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

Example HTTP response 示例 HTTP 响应

Response 200 响应 200

{
  "destination" : {
    "destinationType" : "AMAZON_OPTIMIZED"
  },
  "freightInformation" : {
    "declaredValue" : {
      "amount" : 5.5,
      "code" : "CAD"
    },
    "freightClass" : "FC_50"
  },
  "inboundPlanId" : "wf1234abcd-1234-abcd-5678-1234abcd5678",
  "placementOptionId" : "pl1234abcd-1234-abcd-5678-1234abcd5678",
  "selectedDeliveryWindow" : {
    "availabilityType" : "AVAILABLE",
    "deliveryWindowOptionId" : "dw1234abcd-1234-abcd-5678-1234abcd5678",
    "editableUntil" : "2024-01-05T20:00:00.000Z",
    "endDate" : "2024-01-05T20:00:00.000Z",
    "startDate" : "2024-01-05T14:00:00.000Z"
  },
  "shipmentConfirmationId" : "shipmentConfirmationId",
  "shipmentId" : "sh1234abcd-1234-abcd-5678-1234abcd5678",
  "source" : {
    "sourceType" : "SELLER_FACILITY"
  }
}

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/boxes
GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/boxes Translated Text: GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/boxes

Operation: listShipmentBoxes
操作：列出货运箱

Description 描述

Provides a paginated list of box packages in a shipment.
提供装运中纸箱包装的分页列表。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews
GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews Translated Text: GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/内容更新预览

Operation: listShipmentContentUpdatePreviews
操作：listShipmentContentUpdatePreviews

Description 描述

Retrieve a paginated list of shipment content update previews for a given shipment. The shipment content update preview is a summary of the requested shipment content changes along with the transportation cost implications of the change that can only be confirmed prior to the expiry date specified.
获取指定运单的 shipment content update 预览的分页列表。shipment content update 预览是请求的运单内容变更的摘要，以及变更带来的运输成本影响，这些影响只能在指定的截止日期之前确认。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews
POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews Translated Text: POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/内容更新预览

Operation: generateShipmentContentUpdatePreviews
操作：生成发货内容更新预览

Description 描述

Generate a shipment content update preview given a set of intended boxes and/or items for a shipment with a confirmed carrier. The shipment content update preview will be viewable with the updated costs and contents prior to confirmation.
生成一个基于已确认承运商的预定包裹和/或物品的运输内容更新预览。运输内容更新预览将在确认前显示更新后的成本和内容。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Consumes 消耗

• application/json

Produces 生产

• application/json

Example HTTP request 示例 HTTP 请求

Request body 请求体

{
  "boxes" : [ {
    "contentInformationSource" : "BOX_CONTENT_PROVIDED",
    "dimensions" : {
      "height" : 5,
      "length" : 3,
      "unitOfMeasurement" : "CM",
      "width" : 4
    },
    "items" : [ {
      "expiration" : "2024-01-01",
      "labelOwner" : "AMAZON",
      "manufacturingLotCode" : "manufacturingLotCode",
      "msku" : "Sunglasses",
      "prepOwner" : "AMAZON",
      "quantity" : 10
    } ],
    "packageId" : "pk1234abcd-1234-abcd-5678-1234abcd5678",
    "quantity" : 2,
    "weight" : {
      "unit" : "KG",
      "value" : 5.5
    }
  } ],
  "items" : [ {
    "expiration" : "2024-01-01",
    "labelOwner" : "AMAZON",
    "manufacturingLotCode" : "manufacturingLotCode",
    "msku" : "Sunglasses",
    "prepOwner" : "AMAZON",
    "quantity" : 10
  } ]
}

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

Operation: getShipmentContentUpdatePreview
操作：getShipmentContentUpdatePreview

Description 描述

Retrieve a shipment content update preview which provides a summary of the requested shipment content changes along with the transportation cost implications of the change that can only be confirmed prior to the expiry date specified.
获取一个装运内容更新预览，该预览提供了所请求的装运内容变更的摘要，以及变更的交通成本影响，这些影响只能在指定的到期日之前确认。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews/{contentUpdatePreviewId}/confirmation

Operation: confirmShipmentContentUpdatePreview
操作：确认发货内容更新预览

Description 描述

Confirm a shipment content update preview and accept the changes in transportation cost.
确认发货内容更新预览并接受运输成本的变更。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复

For error status codes, descriptions and schemas, see Error responses and schemas.
错误状态码、描述和架构信息，请参阅“错误响应和架构”。

Produces 生产

• application/json

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/deliveryChallanDocument
GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/交付单据

Operation: getDeliveryChallanDocument
操作：获取送货单据

Description 描述

Provide delivery challan document for PCP transportation in IN marketplace.
提供 IN 市场 PCP 运输的提货单据。

Usage Plan: 使用计划：

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
返回的 x-amzn-RateLimit-Limit 响应头提供了对请求操作应用的使用计划速率限制（如有）。前表包含此操作的默认速率和突发值。对于业务需求需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处所示。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

Parameters 参数

Responses 回复