Skip to main content
Amazon

Amazon SP-API Listings fields in Odoo: what each one means and what to enter

The Listings fields are filled in by stage: identification in Overview, new-product data, catalogue and offer. Here is each one with what its help says and what is worth entering in Odoo 20.

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
5 min

Before you start

The forms open from the menu Amazon › Catalog › Listings. Each part (Amazon, Catalog and Listings) requires the Viewer permission: if you do not have it, you do not see that part. The module is published on Odoo Apps for Odoo 17, 18, 19 and 20; the tab and group names below are those of Odoo 20.

The module is a one-off payment per Odoo version and needs a FlexigoTech Cloud subscription, Connector plan: €49/month or €490/year excluding VAT. The connection goes through that service, which stores the credentials encrypted. You can see the module on its Odoo Apps page or on its page at flexigotech.com.

Diagram of the Amazon, Catalog, Listings menu and of the form with its fields: product, SKU, marketplace, product type, requirements mode, JSON attributes, manual price and stock, sync strategy and offer price
Diagram built with code from the module's published code, not an Odoo screenshot; the labels are in English, the original text of the code.
  • Check that you can see Amazon › Catalog › Listings and that your user has the Viewer permission on each part.
  • Open a Listings form and tick this list off field by field.
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Video: Your Odoo doesn't talk to Amazon, Temu or Shopify?

Stage one: identify the listing (Overview group)

On the form, the Overview group holds the fields that identify the listing.

  • Product. Its help: "Parent product (template). Used to group listings by product, with their variant listings beneath." Pick the product template the listing belongs to. It also appears as a column in the Listings list.
  • Sku. Its help: "SKU on Amazon. Odoo uses default_code by default." Before changing it, check which SKU you already have on Amazon for that product. It also appears in the list.
  • Marketplace. Its help: "Listing marketplace. Example for ES: A1RKKUPIHCS9HS." The field comes with a default value that the module works out: review it and change it if the listing is for another marketplace. You also see it in the Listings graph view.
  • Amazon Product Type. Its help: "Required by Listings Items PATCH/PUT." Make sure it is filled in on the form. You will see it again on the Catalog tab, in the Catalog Status group: it is the same field.

Stage two: new product on Amazon (GTIN exemption)

This field is not on the form: you see it in the Listings list, on the New product on Amazon tab, in the Product type group. It is hidden once the listing has an ASIN; with the default values, it shows.

  • GTIN exemption approved. Its help: "Tick it only when Amazon approved a GTIN exemption for this brand in Seller Central and the product has no EAN/UPC barcode in Odoo." If either condition is missing, leave it unticked.
Diagram with the help text of the GTIN exemption as read in Spanish, German, French, Italian and Portuguese
Diagram built with code from the module's published translations, not an Odoo screenshot: the help text of GTIN exemption approved according to the language of your Odoo.

Stage three: catalogue (Catalog tab)

  • Requirements Mode. It is in the Catalog Controls group. Its help: "Mode for putListingsItem (full catalog publication)." Its options are LISTING, LISTING_PRODUCT_ONLY and LISTING_OFFER_ONLY, and the default is LISTING. Change it only if you have a specific reason.
  • The content of the Catalog Payload group. This is the JSON attributes field for putListingsItem; it has no label on screen: you only see its content.
  • Amazon Product Type, again. It also shows here, in Catalog Status: it is the same field as in stage one.

Stage four: offer (Offer tab)

On the Offer tab, the Sync Strategy group holds the fields that decide where the price and stock being sent come from.

  • Sync Strategy (the field). Its help: "Defines whether price and stock are pushed only manually, or whether Odoo can queue automatic synchronization on local changes." The default is calculated by the module. It also shows in the Listings list, so you can review many listings at a glance. Read the help before choosing: it distinguishes between pushing only by hand and letting Odoo queue synchronisation on local changes.
  • Use Manual Price. Its help: "If enabled, Push Price and Push Offer use the listing price defined here instead of the Odoo product sale price." It starts unticked. Tick it only if you want a price different from the Odoo sale price.
  • Use Manual Stock. Its help: "If enabled, Push Stock and Push Offer use the listing stock defined here instead of Odoo stock." It also starts unticked. Tick it only if you want a quantity different from Odoo's.
  • Listing Price To Push. Its help: "Effective price that will be sent to Amazon. Editing it enables manual price override for this listing." Editing it is enough to activate the manual price for that listing.
  • Listing Stock To Push. Its help: "Effective stock that will be sent to Amazon. Editing it enables manual stock override for this listing." Same logic as the price, applied to stock.

Stage five: compare before trusting the form

The Offer Comparison group, also on the Offer tab, puts together the values worth reading side by side.

  • Effective Price To Push and Effective Stock To Push. These are the same two fields as in stage four, with these labels. Read them as what will be sent to Amazon.
  • Amazon Offer Price. Its help: "Live offer price returned by Amazon for the listing." It is read-only: the module fills it in, not you. It also shows in the Listings list, so you can compare it with the price to push.
  • Listing Quantity Channels. Its help: "Human-readable view of quantities per fulfillment channel." Read-only too: the module writes it.
  • Compare the effective price to push with the Amazon offer price, and review the quantities per channel, before you accept the listing as correct.

If you want help with your listings

FlexigoTech implements Odoo 17, 18, 19 and 20 and builds connectors and custom integrations. If you want to go through with us which listings should use a manual price or stock, get in touch.

Keep reading

Amazon Connector account fields in Payments & Accounting: what each one means and what to setChecklist of the Payments & Accounting fields on the Amazon Connector account in Odoo: what each one means according to its help and what to decide.Amazon Connector for Odoo SP-API account fields: what each help says and what to setCompare the invoice, reimbursement audit and FBA report fields of the SP-API account in Amazon Connector for Odoo: what each help says and its defaults.
Checked in the connector's source code (version 20.0) and the linked sources

Sources