Pre-Launch Announcement: Fulfilled By Merchant Ship+ functionality in Shipping APIs and Merchant Fulfillment APIs

We are excited to pre-announce the availability of Fulfilled by Merchant (FBM) Ship+ functionality in Shipping APIs and Merchant Fulfillment APIs. FBM Ship+ is a fulfillment solution for sellers shipping seller-fulfilled orders, designed to boost their sales by showing customers accurate and fast delivery dates. It makes faster shipping more affordable through discounted Amazon Buy Shipping rates from partnered carriers and offers cash-back to help cover expedited shipping costs. The details of the Ship+ program, including eligible sellers, enrollment process, and specifics of the cash-back program, will be communicated during the launch.

What are the changes for FBM Ship+ integration?

Amazon offers two Buy Shipping APIs – Shipping V2 API and Merchant Fulfillment API. FBM Ship+ related constructs will be available in both APIs with the following changes:

Shipping V2 API Changes

When the getRates API is invoked, the Rate.totalCharge will contain the full shipping label cost that the carrier will charge for the shipment. Additionally, a new Rate.AdjustmentItemList array will contain the details and attributes for FBM Ship+ cashback amount, while a new Rate.totalChargeWithAdjustments field will show the charge minus cashback.
For each carrier and ship-method, the Rate.benefits field contains the benefits that are included or excluded. When a ship-method is FBM Ship+ eligible, the Rate.benefits.includedBenefits will contain a new flag FBM_SHIP_PLUS to confirm Ship+ benefits eligibility.

Merchant Fulfillment API Changes

When the getEligibleShippingServices API is invoked, the ShippingService.Rate will contain the full amount the carrier will charge for the shipment. Similar to the Shipping V2 API, a new ShippingService.AdjustmentItemList array will contain the FBM Ship+ cashback amount, and a new ShippingService.RateWithAdjustments field will show the charge minus cashback.
For each carrier and ship-method, the ShippingService.Benefits field contains the included or excluded benefits. When a ship-method is FBM Ship+ eligible, the ShippingService.Benefits.IncludedBenefits will contain a new flag FBM_SHIP_PLUS to indicate Ship+ benefits eligibility.

Key Updates:

APIs Affected: Shipping V2 API and Merchant Fulfillment API

Launch Timeline: The scheduled launch date is September 1, 2025.
Marketplaces:This change will be applicable to the US and European (UK, IT, FR, ES, DE) marketplaces, for
orders that are shipped from China to these marketplaces.

Schema Changes

Shipping V2 APIs: Get Rates API

{
  "payload": {
    "ineligibleRates": [],
    "rates": [
      {
        // Existing fields
        "carrierId": "XXXX",
        "carrierName": "XXXX Shipping",
        "rateId": "977b287870bb91af13b89ed5a218bXXX1737750774761",
        "rateItemList": [
          {
             "......" : "..."
          }

        ],
        "serviceId": "XXX-PREM",
        "serviceName": "XXX express",
        "totalCharge": {                      // Existing field: shipping label cost
           "value": 7,
           "unit": "USD"
        },
        "totalChargeWithAdjustments": {       // New field: shipping label cost after cashback
           "value": 6,
           "unit": "USD"
        },
        "adjustmentItemList": [               // New field: FBM Ship+ cashback attributes
          {
            "rateItemCharge": {
              "unit": "USD",
              "value": "1.00"
            },
            "rateItemID": "FBM_SHIP_PLUS_CREDIT",
            "rateItemType": "INCLUDED",
            "rateItemNameLocalization": "FBM Ship Plus Credit"
          }
        ],
        "benefits": {
          "includedBenefits": [
            "FBM_SHIP_PLUS"                    // New benefit value
          ]
        }
      }
    ]
  }
}

Merchant Fulfillment APIs: Eligible Shipping Services API

{
  "ShippingService": {
      "Rate": {                       // Existing field: shipping label cost
          "CurrencyCode": "USD",
          "Amount": 100
        },
      "RateWithAdjustments": {        // New field: shipping label cost after cashback
          "CurrencyCode": "USD",
          "Amount": 33.73
        },
      "AdjustmentItemList": [         // New field: FBM Ship+ cashback attributes
          {
              "RateItemID": "FBM_SHIP_PLUS_CREDIT",
              "RateItemType": "INCLUDED",
              "RateItemCharge": {
                  "CurrencyCode": "USD",
                  "Amount": 1.00
                },
              "RateItemNameLocalization": "FBM Ship Plus Credit"
            }
        ],
      "Benefits": {
      "IncludedBenefits": [
              "FBM_SHIP_PLUS"          // New benefit value
            ] 
    }
  }
}

Notes:

The original rate fields will continue to show the full shipping cost
Adjustment amounts will be shown separately in the new fields
FBM_SHIP_PLUS flag indicates eligibility for Ship+ benefits

FAQs:

Do I need to update my integration?
A: Yes, if you want to leverage FBM Ship+ functionality and display adjusted rates to sellers.
Will existing rate calculations be affected?
A: No, existing totalCharge in Shipping APIs and Rate MFN APIs fields will continue to work as before.
When will program details be available?
A: Complete program details, including seller eligibility and enrollment process, will be communicated during launch.
Where can I find more information about Amazon Buy Shipping?
A: Visit Amazon Buy Shipping for more details.