Fulfillment Inbound API FAQ

With the launch of Fulfillment Inbound v2024-03-20, we are deprecating 10 operations within Fulfillment Inbound API v0, which will be removed on December 20, 2024. If you use Fulfillment Inbound API v0, use the Fulfillment Inbound v2024-03-20 API use case guide to migrate your workloads and integrate with this new version.

For more information about the new APIs and how to integrate your systems, refer to the Migration Guide and Use Case Guide. For additional support or to provide feedback, go to Developer Support or contact your account manager.

The following table provides all Fulfillment Inbound v0 operations and their planned removal date:

Deprecated APIs will not be supported after their deprecation date. Calls to deprecated APIs will fail as of their removal date.

The Fulfillment Inbound v2024-03-20 API supports FBA inbound shipment creation, which you can use to:

• Select from multiple inbound placement service options
• Access and edit a shipment interchangeably on both Send to Amazon and via API
• Create larger plans, 1,500 SKUs per plan, instead of 200 SKUs per plan on APIs today
• Retrieve shipment information (for example: amazon reference number, shipment status)
• Print SKU labels for your shipments

No. You must upload carton information using setPackingInformation. For more information, refer to Submit carton content information in the Migration Guide.

When you confirm the placement option (confirmPlacementOption), shipmentConfirmationID (v2024-03-20) is generated. shipmentConfirmationID (for example, FBA1234ABCD) is the identifier that appears on labels. This value must be used in all retained v0 operations as shipmentID.

Use getShipments (v0) to get EstimatedBoxContentFee. Use getShipmentItemsByShipmentId (v0) to get quantity shipped and quantity received.

These v0 operations will remain operational past the deprecation date. You can call them with a shipment confirmation ID (shipmentConfirmationID), which is generated after you confirm the placement option (confirmPlacementOption) as input.

You don't need to mark your shipments as shipped. Amazon automatically tracks the shipments based on the carrier and tracking details. For shipments with non-Amazon partnered carriers, you must input the tracking ID with updateShipmentTrackingDetails.

Fulfillment Inbound API v2024-03-20 supports the following features:

• New feature: View and select one of the available delivery windows for a shipment arrival at an Amazon facility.
• New feature: Print SKU labels for your shipments
• Select partnered carriers for less-than-truckload shipments
• Update the name of inbound plans and shipments
• Update the quantity of units of a SKU after shipment confirmation

The ability to create inbound shipments with the new Fulfillment Inbound API v2024-03-20 is available in the following marketplaces:

• Canada
• US
• Spain
• UK
• France
• Netherlands
• Germany
• Italy
• Sweden
• Singapore
• Australia
• Japan

We will announce support for these marketplaces as they become available:

• Mexico
• Brazil
• Poland
• Egypt
• Turkey
• Saudi Arabia
• United Arab Emirates
• India

No. Multiple expiration dates per SKU within a single inbound plan is not supported. To send a SKU with multiple expiration dates to the fulfillment network, you must create multiple inbound plans.

If you don't know the carton-level information upfront, you can only create a Less Than Truckload/Full Truckload (LTL/FTL) shipment. Refer to the Use Case Guide for more information.

listPackingOptions returns one option because it is designed to provide the most optimized packing solution based on the input criteria. This is the expected behavior.

Yes. To print unique shipment labels, use the Fulfillment Inbound API v0 getLabels operation. You need to provide {{baseUrl}}/fba/inbound/v0/shipments/:shipmentId/labels?PageType={{PageType}}&PageSize={{PageSize}}, where shipmentId is shipmentConfirmationId.

The generateSelfShipAppointmentSlots operation generates an appointment slots list. This is applicable for the MX, BR, EG, SA, AE, and IN marketplaces.

To update the quantities and box contents after your shipments are confirmed, use the following steps.

1. Use generateShipmentContentUpdatePreviews to update item quantities and generate a preview of the updated shipment contents and transportation costs.

2. Use listShipmentContentUpdatePreviews to retrieve a paginated list of previews, which summarizes the changes and cost implications.

3. Use confirmShipmentContentUpdatePreview to confirm a shipment content update preview and accept the changes in transportation costs.

To determine if a shipment used an Amazon Partnered Carrier or your own carrier, use the listTransportationOptions. If Amazon confirms your shipment, then listTransportationOptions returns a list with only one confirmed transportation option (AMAZON_PARTNERED_CARRIER or USE_YOUR_OWN_CARRIER) in the shippingSolution field.

For shipments created with the Send to Amazon UI, you can retrieve all inbound details with the listInboundPlans operation and the Fulfillment Inbound API v2024-03-20 GET operations:

1. Use listInboundPlans to retrieve your inbound plans, shipment IDs, packing IDs, placement IDs, and transportation IDs.

2. Use the values from step 1 to call the Fulfillment Inbound API v2024-03-20 GET operations. For more information about the GET operations, refer to Fulfillment Inbound API v2024-03-20.

Yes. To combine SPD and LTL shipments in to one inbound plan, use the following steps.

1. Use the generateTransportationOptions operation to generate a list of SPD and LTL transportation options. You must use generateTransportationOptions to generate transportation options before they're available to the listTransportationOptions operation in the next step.

2. Use the listTransportationOptions operation to retrieve all transportation options for the shipment. Retrieve the shipmentId and transportationOptionId for the SPD and LTL shipments.

Example response:

{
   "transportationOptions":[
      {
         "carrier":{
            "name":"United States Postal Service",
            "alphaCode":"USPS"
         },
         "preconditions":[
            "CONFIRMED_DELIVERY_WINDOW"
         ],
         "shipmentId":"sh1xxxxxxxxxxxxxx",
         "shippingMode":"GROUND_SMALL_PARCEL",
         "transportationOptionId":"to1xxxxxxxxxxxxxx", ---> choose to confirm
         "shippingSolution":"USE_YOUR_OWN_CARRIER"
      },
      {
         "carrier":{
            "name":"XXXXX",
            "alphaCode":"ABCD"
         },
         "carrierAppointment":{
            "startTime":"2024-10-11T00:00Z",
            "endTime":"2024-10-11T23:59Z"
         },
         "quote":{
            "cost":{
               "amount":326.54,
               "code":"USD"
            },
            "expiration":"2024-10-09T22:40Z"
         },
         "preconditions":[
            
         ],
         "shipmentId":"sh2xxxxxxxxxxxxxx",
         "shippingMode":"FREIGHT_LTL",
         "transportationOptionId":"to2xxxxxxxxxxxxxx", ---> choose to confirm
         "shippingSolution":"AMAZON_PARTNERED_CARRIER"
      }
   ]
}

3. Use the confirmTransportationOptions operation and pass in the shipmentId and transportationOptionId for the SPD and LTL shipments.

Example request:

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

No. The discrepancy is intentional and is based on the carrier that is used for the shipment:

• Amazon Freight or first-party PCP LTL carriers: These shipments don't show detailed address information, but have an extra barcode at the bottom of the label. The absence of the address is by design and is accepted by Amazon's fulfillment centers.

• Third-party LTL PCP carriers: For shipments handled by third-party carriers, the labels show detailed address information which includes the company name.

To check a shipment's carrier in Seller Central, navigate to the shipment summary page, select the shipment, and choose Show More.

To avoid cancellation charges, you must cancel the inbound shipment within the specific SLAs, which vary based on the type of shipment:

• SPD: You must cancel the inbound plan within 24 hours after shipment creation for Amazon Partnered Carriers.

• Pallet shipments (LTL/FTL): You must cancel within 1 hour after shipment creation for Amazon Partnered Carriers.

The charge restrictions don’t apply for non-partnered carrier options.

To review eligibility dimensions and weight requirements for SPD, refer to Small-parcel delivery to Amazon. To review eligibility dimensions and weight requirements for LTL options, refer to Pallets (LTL/FTL) delivery.

For one inbound plan, you can add a maximum of 1,500 SKUs and a maximum of 10,000 items for each SKU.