Fulfillment Inbound API FAQ

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
• Mexico
• Spain
• UK
• France
• Netherlands
• Germany
• Italy
• Sweden
• Poland
• Egypt
• Saudi Arabia
• United Arab Emirates
• Singapore
• Australia
• Japan

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

• Brazil
• Turkey
• 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.