Amazon order retrieval: what is changing and how to switch
Amazon is retiring the current method of sharing orders, Orders API v0, and replacing it with the new Orders API v2026-01-01. This change applies to the order retrieval part of the Amazon integration in Base.com.
The old API will stop working on 27 March 2027. By that date, every Amazon account in Base.com must retrieve orders using the new method.
You can switch to the new API now by changing one option in the integration settings. Until Amazon disables the old API, you can return to the previous version at any time.
What changes in Amazon orders
What you gain
- More data in orders – more complete information for the invoice and shipment.
- VAT ID in Amazon Business orders, which is needed to issue an invoice to a business customer. You can also find information about Amazon Business orders in the Base.com Help Center.
- Faster retrieval of this data.
Shipping method names: what to watch for
The new Amazon API no longer provides the detailed name of the shipping method. Instead, it provides the delivery speed category. As a result, new orders will contain different values in the Shipping method field.
| Before the change (examples) | After the change (examples) |
|---|---|
| Std DE Dom, MFN AD Dom, Std | STANDARD |
| Exp UK Intl, Expedited | EXPEDITED |
Possible values in the new API include: STANDARD, EXPEDITED, PRIORITY, NEXT_DAY, SECOND_DAY, SAME_DAY, SCHEDULED, FREE_ECONOMY.
Who needs to take action
Sellers using Shipping method conditions
The change affects sellers who use automatic actions with a Shipping method condition based on an Amazon shipping method name.
For example, an action may use the condition Shipping method = Std DE Dom to change the order status, issue an invoice, or create a shipment. After switching to the new API, this action will not be triggered for new orders with the value STANDARD until you update the condition.
Sellers without these conditions
If you do not use Shipping method conditions based on Amazon names, no other preparation is required. Simply enable the new order retrieval option in the Amazon integration settings.
How to switch to the new API
Step-by-step instructions
- Check your automatic actions. Go to Orders → Automatic actions and look for actions whose conditions contain Shipping method with an Amazon method name, for example one containing Std, Exp, Dom or Intl. If necessary, review the available order-related system events used to trigger these actions.
- Prepare the conditions for the new values. For every affected action, add the new values, such as STANDARD od EXPEDITED , next to the existing values. This allows the action to work for both orders downloaded before the change and orders downloaded after the change.
- Enable the new order retrieval method. Go to Integrations → Amazon → Orders, where the order settings for the selected account are displayed. Select Download additional data from Amazon, then click Save.
- Check the first new orders. Open the order card and check which Shipping method value was assigned. Verify that the relevant automatic actions were triggered as expected.
- Optionally remove the old values. When everything works correctly, you can remove the old Amazon shipping method names from your automatic-action conditions.
How to return to the previous version
If something does not work correctly, go to Integrations → Amazon → Orders, clear Download additional data from Amazon, and click Save. New orders will then be downloaded using the previous method again.
Report the problem to our support team so that we can investigate and fix it.
Timeline
| When | What happens |
|---|---|
| Now | You can switch to the new method yourself, test it, and return to the previous version if necessary. |
| From January 2027 | Reminders about the required change will appear in the panel. |
| 20 March 2027 | The new order retrieval method will be enabled automatically for accounts that have not changed the setting. |
| 27 March 2027 | Amazon disables the old API, so returning to the previous version will no longer be possible. |
We recommend switching earlier, while you still have time to check your automatic actions and the option to return to the previous version.
Frequently asked questions
- Will my existing orders change?
No. The change applies only to orders downloaded after you enable the new option. - Do I need to change anything if I do not use automatic actions?
No. Simply enable the new order retrieval option. No other changes are required. - Can I restore the previous shipping method names?
No. The new Amazon API no longer provides these names. - What happens if I do nothing?
Before Amazon disables the old API, Base.com will switch your account to the new order retrieval method automatically. Automatic actions based on the old shipping method names will then stop working for new orders, so we recommend updating their conditions in advance.
