El cas: una samarreta amb talles i colors
Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.
Textiles Marea, una empresa inventada, ven una samarreta amb variants de talla i color. A Odoo és un sol producte amb les seves variants i ja té la seva fitxa a Amazon › Catalog › Listings. Vol que Amazon la mostri com una família: un pare i una fitxa filla per variant. Això és el que passa quan prem Create family on Amazon.


Quan apareix el botó i qui el pot prémer
El botó és a la fitxa de Listings, a Odoo 17, 18, 19 i 20. S'amaga si es compleix qualsevol d'aquestes condicions:
- el producte té menys de dues variants (camp
Product Variant Count); - el camp
Allow New Product Creationno està actiu; - el camp
Amazon Product Typeestà buit.
Amb menys de dues variants tampoc veuràs el camp Variation theme. Per arribar a la llista cal el permís Viewer a cada tram del menú: Amazon, Catalog i Listings. Però veure el menú no n'hi ha prou per executar l'acció: el mòdul exigeix almenys accés d'operador, i si no el tens surt el missatge de la taula de més avall.
Què fa en prémer-lo, per ordre
Textiles Marea obre la fitxa de la seva samarreta i prem el botó. Això és el que fa el mòdul, de principi a fi:
- Demana confirmació amb aquest text:
This creates the parent and every variant on Amazon for real. Continue?. Si acceptes, no és una prova. - Comprova el teu accés: cal almenys el d'operador del connector.
- Comprova que el compte de la fitxa permet crear productes nous a Amazon.
- Comprova que Amazon podrà descarregar les fotos del teu Odoo. Mira l'adreça del lloc web si el comerç electrònic té domini i, si no,
web.base.url. - Prepara la família: crea una fitxa a
Listingsper cada variant que tingui referència i encara no tingui fitxa (les variants sense referència no reben fitxa nova). Si el tema de variació està buit, el mòdul intenta proposar-ne un. - Copia a totes les fitxes de la família el tema, el SKU del pare, el tipus de producte, el mode de requisits i l'exempció de GTIN. Els valors d'atributs que hagis escrit en aquesta fitxa, tret dels del tema, passen a les germanes que els tinguin buits.
- Comprova que ha quedat un tema de variació. Si no, s'atura amb el missatge corresponent.
- Envia el pare a Amazon de debò. Per al seu SKU fa servir el SKU de pare que ja tingui guardat la fitxa; si no n'hi ha, la referència del producte; i si tampoc n'hi ha,
P-seguit del SKU de la fitxa. Anota l'acció amb el nomCreate family (parent)i el missatgeParent …: …, amb el SKU del pare i l'estat que retorna Amazon. - Recorre les fitxes de la família que encara no tenen ASIN llegit d'Amazon i envia cadascuna com a producte nou: amb els valors d'Odoo i els que hagis escrit, i pel mateix camí que
Publish Catalog, amb el mateix registre i reintents. Cada fitxa torna a comprovar que el compte permet crear productes nous i, en alguns casos, que Amazon pugui arribar al teu Odoo per descarregar les fotos. - Mostra l'avís final i recarrega la fitxa amb els valors nous.
Els missatges que pot donar
Aquests són missatges que pot donar el botó, amb el moment en què surten i què fer:
| Missatge | Quan surt | Què fer |
|---|---|---|
You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access. | Just en prémer, si el teu usuari no té accés d'operador. | Demana a un responsable que et doni accés d'operador o de responsable. |
The listing … has no ASIN from Amazon: sending it would create a new product on Amazon, and the account … does not allow it. If it is already on Amazon, press "Refresh Listing" (your SKU) or "Find ASIN by EAN" (a product others sell) first; to create it, a manager ticks "Allow creating new products on Amazon" on the account. | El compte de la fitxa no permet crear productes nous. | Si el producte ja existeix a Amazon, segueix el que diu el missatge. Si el vols crear, un responsable marca la casella al compte. |
Amazon downloads the photos from Odoo and cannot reach it: …. Make Odoo reachable from the Internet (web.base.url or the website domain) before creating the product. | L'adreça base del teu Odoo no resol només a adreces d'Internet; en lloc dels punts suspensius hi va el motiu. | Fes que Odoo sigui accessible des d'Internet, com indica el missatge, i torna a prémer. |
This product has no variants: it goes to Amazon on its own. | En preparar la família, si el producte té menys de dues variants. | Aquest botó no és per a aquest producte. |
Choose the Amazon product type first (button "Suggest type"). | En preparar l'esquema de la família, si la fitxa no té tipus de producte. | Tria el tipus com diu el missatge. |
Choose the variation theme first: no theme of this product type fits the attributes of the variants. | Després de preparar la família, si el tema continua buit. | Omple Variation theme a la fitxa i torna a prémer. |
A la fitxa, l'ajuda de Variation theme diu: How the variants differ on Amazon (SIZE, COLOR, SIZE/COLOR…), from the list the product type allows. Empty: the listing goes on its own.
Si el tema de variació està buit, el mòdul intenta proposar-ne un. Si no en troba cap que encaixi amb els atributs de les variants, surt l'últim missatge de la taula i cal omplir Variation theme a mà. En el cas de Textiles Marea, aquest seria el moment de triar el tema a la fitxa de la samarreta i tornar a prémer el botó.
Què canvia en acabar
Si tot va bé, apareix aquest avís: Family sent to Amazon (parent and … variants). Press "Refresh Listing" on each later to get the ASIN. El nombre és el de fitxes de la família.
A Amazon queda enviat el pare i després cada variant sense ASIN. A Odoo hi ha una fitxa per cada variant amb referència, amb el mateix tema, SKU del pare i tipus de producte, i l'acció del pare queda anotada com a Create family (parent).
L'ordre importa si alguna cosa falla: el pare s'envia abans que les variants. Si una variant s'atura amb un error, l'enviament del pare a Amazon ja s'ha fet.
La comprovació del compte no és només del botó
La comprovació de si el compte permet crear productes nous també s'aplica quan s'envia el catàleg complet d'una fitxa sense ASIN llegit d'Amazon. Això inclou la tasca programada Amazon SP-API - Auto-repair queue v2, que corre cada tres minuts i està activa en instal·lar el mòdul.

Què comprovar després
Quan acaba l'enviament, l'avís et demana prémer Refresh Listing a cada fitxa de la família, més tard, per portar l'ASIN.
Versions, subscripció i ajuda
El mòdul està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20, i el botó existeix a les quatre. És de pagament únic per versió d'Odoo (a la seva fitxa o a flexigotech.com) i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any sense IVA, fins a 3 comptes. Amb la subscripció, el mòdul per a les versions noves d'Odoo va inclòs si el vas comprar a flexigotech.com; a l'Odoo App Store, cada versió es compra allà.
Si vols ajuda per implantar Odoo 17, 18, 19 o 20, o per a un connector o una integració a mida, FlexigoTech ho fa.
Continua llegint
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_variation_views.xml
- Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_variation.py
- Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_product_binding.py
- Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_new_product.py
- apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
