Skip to main content
Amazon

What Amazon Connector adds to the Inventory delivery: fields, button and when it acts

The module adds a button, Enviar tracking Amazon, and a group of fields, Amazon SP-API, to the Inventory delivery so Amazon gets the shipment tracking; Odoo sends it on its own when you validate the delivery or change the tracking, depending on two account checkboxes, and the button is there to resend it by hand.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 5 November 2026

Key facts

Module
Amazon
Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0 · against the sources linked at the end
Reading time
6 min

What the module adds to the delivery

The module extends the standard delivery of the Inventory app with a button and a group of fields. The condition that shows or hides the button is the same in Odoo 17, 18, 19 and 20.

Diagram with the Inventory app at the top and, below it, the button and fields the module adds
Diagram built with code from the module's published code, not an Odoo screen; labels are in English.

On the delivery form, inside the Amazon SP-API group, the module adds these fields:

  • Amazon SP-API Account: the SP-API account linked to the delivery.
  • Amazon Order ID: the order identifier on Amazon.
  • Amazon Sync State: read-only. Its values are Pending, Synced and Error; the default is Pending. The code writes it, not you.
  • Last Amazon Sync: date and time, read-only.
  • Tracking sent to Amazon: read-only.
  • Amazon confirmShipment sent at: date and time, read-only. Its help text says that once it is set, the automatic send is not repeated, neither on a tracking edit nor on a scheduled retry; only a forced manual send can resend it.
  • Last Amazon error: text, read-only.
  • Payload Amazon and Amazon Response: read-only, and visible only to users with administration permission for Settings.

The whole group is hidden when the module cannot identify an Amazon order ID for that delivery. To look for it, the module checks the delivery's own Amazon Order ID field first, then the linked sales order and, last, other data on the delivery. The Enviar tracking Amazon button is also hidden when the delivery is not in the Done state or does not belong to an Amazon order.

Your Odoo doesn't talk to Amazon, Temu or Shopify?
Video: Your Odoo doesn't talk to Amazon, Temu or Shopify?

Step by step: when the module acts and what to do

  1. Check the three account checkboxes. They are on the account form (Accounts), in the Orders & Fulfillment tab, inside the Order Sync group. Auto sync on picking validation and Auto sync al cambiar tracking are on by default; Send confirmShipment asynchronously (via cron) is off by default. Each account field is explained in the SP-API account fields.
  2. Create the delivery. When it is created, the module tries to identify the Amazon order and, if it succeeds, fills in Amazon Order ID and Amazon SP-API Account where they are empty. For the account it uses the delivery's own or the sales order's, if active; otherwise it looks for the company's active accounts and, if there is only one, uses it. If there are several, it tries to work out which one matches. If it cannot identify an Amazon order, it fills in nothing.
  3. Validate the delivery or change its tracking. This is the normal route and there is nothing to press. On validation, Odoo tries to confirm the shipment to Amazon if Auto sync on picking validation is on. When you save a delivery that is already Done with a changed tracking, it tries if Auto sync al cambiar tracking is on. With the matching checkbox off, that trigger does nothing.
  4. If you use asynchronous mode, wait for the retry. With Send confirmShipment asynchronously (via cron) on, validation only leaves the delivery as Pending and the scheduled action Amazon SP-API - Retry pending shipments (every five minutes, active on install) is the only sender. The checkbox help says that action has to be active.
  5. Look at the Amazon SP-API group after validating. Amazon Sync State tells you where the delivery stands. If it is Pending, wait for the next attempt. If it is Error, read Last Amazon error.
  6. Resend by hand only when needed. The Enviar tracking Amazon button appears when the delivery is Done and belongs to an Amazon order. It skips the "already sent" check and the "already synced with the same tracking" check, which the automatic route does respect. The help of Amazon confirmShipment sent at explains that this latch prevents a double notification to the buyer; think twice before bypassing it. If the send fails, the button stops with Error while syncing Amazon: ….
  7. Check the result. After Amazon accepts a send, the module fills in Amazon Sync State, Last Amazon Sync, Tracking sent to Amazon and Amazon confirmShipment sent at, and clears Last Amazon error. It also stores Payload Amazon and Amazon Response, visible only to users with administration permission for Settings.
Diagram with the text of the Enviar tracking Amazon button in German, French and Italian
Diagram built with code from the published translations, not an Odoo screen: in German Amazon-Tracking senden, in French Envoyer le suivi Amazon, in Italian Invia tracking Amazon.

What the module checks before sending

On the automatic route, the module stops silently before sending anything in these cases:

  • The delivery is not outgoing: the module only confirms outgoing deliveries to Amazon, not returns.
  • The delivery is not Done.
  • It cannot find the Amazon order ID or a matching active account.
  • Amazon confirmShipment sent at already has a value.
  • The delivery has no tracking number. If there are several separated by spaces, commas, semicolons or line breaks, the module takes the first.
  • The delivery is already Synced with that same tracking.

There is one more case: if Amazon already reports the order as shipped, the module does not send. It tries to fill in the state fields from that external status, but only if this delivery is the only outgoing one for the order. With several outgoing deliveries for the same order it does not mark it by itself, because the external status is ambiguous. That Amazon check also applies when you press the button.

For the carrier, the module looks up the account's carrier mapping. If there is none, the send carries Other as the carrier code.

Pending, Error and a suspended service

If the automatic send fails, the module sets the delivery to Error and stores the text in Last Amazon error. If what is missing is shipping data (tracking or carrier), the delivery stays Pending and the last-error field is cleared, so it can be retried once the data is complete or Amazon reports it as shipped.

If the account works through FlexigoTech Cloud and the connector has no service, the delivery validation carries on and the confirmation stays Pending (unless it is already synced or sent). The retry action sends it once the service is back, and nothing is marked as an error. Without a subscription, or with the service suspended, what the subscription provides stops; your data stays in your Odoo.

Subscription and FlexigoTech help

The module is a one-off purchase per Odoo version (17, 18, 19 and 20) and needs the FlexigoTech Cloud subscription: the Connector plan costs €49/month or €490/year excluding VAT. You can see it on the Odoo Apps listing or on the module page. If you are implementing Odoo and want to tune the delivery flow with Amazon, FlexigoTech implements Odoo 17, 18, 19 and 20 and builds custom connectors and integrations.

Keep reading

Amazon Connector for Odoo: SP-API account fields glossaryGlossary of the Amazon Connector account fields in Odoo: what each help text says, the default value and what to set, grouped by tab.
Checked in the connector's source code (version 20.0) and the linked sources

Sources