Wat de knop Refresh Attributes van Amazon Connector for Odoo doet

Waar de knop staat en wie hem kan gebruiken

De formulieren van listings open je via Amazon › Catalog › Listings. Elk onderdeel van het menu vraagt het recht Viewer; zonder dat recht zie je dat onderdeel niet. In een listing hangt de knop Refresh Attributes van geen enkele voorwaarde in de weergave af: hij is altijd zichtbaar en bestaat in de versies 17, 18, 19 en 20 van Odoo.

Zichtbaar betekent niet dat iedereen hem kan gebruiken. Het eerste wat er na het klikken gebeurt, is een controle van je rechten. Heb je niet minstens Operator-toegang, dan stopt de actie met deze melding: You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access. Naast de toegang controleert de module ook of je naar de listing mag schrijven. Omdat die controle vóór al het andere komt, wijzigt de melding de status van de listing niet en wordt er niets bij Amazon opgevraagd.

Met Odoo in het Nederlands heet de knop Refresh Attributes.

Stap voor stap: wat de knop doet

In Odoo 20 doet de knop het volgende:

1. Houd er vóór het klikken rekening mee dat Odoo zelf ook bij dezelfde actie uitkomt: bij het opslaan van een productformulier en bij het valideren van een leveringsbon (in beide gevallen wanneer aan de voorwaarde van de module voor de producten is voldaan), en ook de knoppen Push Stock, Repair Listing Issue en Run Auto-repair Errors starten haar. Daarnaast lezen de geplande taken Amazon SP-API - Sync pending bindings (price/stock), elke minuut, Amazon SP-API - Auto-repair queue v2, om de 3 minuten, en Amazon SP-API - Nightly auto-bind, één keer per dag, allemaal actief na installatie, de listing zelfstandig opnieuw uit met een andere leesactie van de module (die wordt geregistreerd als Refresh Listing). Ook die leesactie slaat de attributen op als Amazon ze teruggeeft, evenals de meldingen en de status, en past het kanaal aan als het account Auto-detect channel when pulling catalog heeft ingeschakeld. Klikken op Refresh Attributes is de handmatige weg om nu één bepaalde listing opnieuw uit te lezen.
2. Open de listing via het menu en controleer dat er een Account is ingevuld, in de groep Overview van het formulier en ook in de lijst met listings.
3. Klik op Refresh Attributes. Eerst worden je rechten gecontroleerd, zoals hierboven uitgelegd.
4. De module controleert of de listing een account, SKU en marketplace-ID heeft en of het account een Seller ID heeft. Ontbreekt een van die gegevens, dan stopt de actie.
5. Is alles aanwezig, dan vraagt de module bij Amazon de listing van die verkoper, die SKU en die marketplace op, met attributen, meldingen, producttypen en samenvattingen. Het is een leesactie: er worden geen wijzigingen naar Amazon gestuurd.
6. Bevat het antwoord geen attributen, dan stopt de actie. Bevat het wel attributen, dan leest de module er het producttype, de hoeveelheden, de prijzen en de meldingen uit en schrijft alles naar de listing (de details staan in het volgende onderdeel).
7. Heeft het account het vakje Auto-detect channel when pulling catalog ingeschakeld, dan past de module het fulfilmentkanaal van de listing aan (verderop de voorwaarden).
8. De module legt het resultaat vast, geslaagd of met fout, met de gebruiker, de duur en de melding; als het goed gaat, bewaart hij ook het antwoord van Amazon (de rechtenmelding wordt niet geregistreerd).
9. Controleer het resultaat op het formulier: de status van de listing en de valuta's op het tabblad Offer.

Wat er in de listing wijzigt

Als het antwoord attributen bevat, schrijft de module dit naar de listing:

• De attributen van Amazon, opgeslagen als geordende tekst.
• Het producttype, als Amazon het geeft; zo niet, dan blijft het bestaande behouden.
• De hoeveelheid en de hoeveelheid per kanaal.
• De aanbiedingsprijs en de lijstprijs, elk met hun valuta; geeft Amazon de valuta niet, dan blijft de vorige behouden. De valuta's zie je, alleen-lezen, op het tabblad Offer, groep Offer Comparison: Amazon Offer Currency en Amazon List Price Currency.
• De datum van de laatste catalogussynchronisatie.
• Het volledige antwoord van Amazon, in Last Response, tabblad Technical, groep Diagnostics. Alleen systeembeheerders zien het en het kan op het formulier verborgen zijn.
• De meldingen: hoeveel er van het type fout, waarschuwing en informatie zijn, en hun tekst.

De status hangt van die meldingen af: geeft Amazon er een van het type fout terug, dan komt de listing op Error; zo niet, dan is hij actief.

Het fulfilmentkanaal

Deze stap vindt alleen plaats als het vakje Auto-detect channel when pulling catalog is ingeschakeld. Je vindt het op het formulier van Accounts, tabblad Catalog & Listings, groep Auto-bind & Import, en het staat standaard aan. De hulptekst luidt: «If enabled, pulling the catalog on a binding automatically adjusts fulfillment_channel_code.» De module berekent een aanbevolen kanaal en handelt zo:

• Is er geen aanbevolen kanaal, dan verandert er niets.
• Is het kanaal van de listing al het aanbevolen kanaal, dan ook niet.
• Is het anders, dan wijzigt hij het alleen wanneer het kanaal van de listing leeg of DEFAULT is, of wanneer het account het geforceerd vervangen van het kanaal heeft ingeschakeld.

Welke fouten kunnen optreden en wat je eraan doet

• Ontbrekende rechten. Dit is de melding You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access. Vraag een verantwoordelijke om je Operator- of Manager-toegang te geven. Er wijzigt niets in de listing.
• Er ontbreekt een referentiegegeven of Amazon geeft geen attributen terug. Heeft de listing geen account, SKU of marketplace-ID, heeft het account geen Seller ID of komt het antwoord zonder attributen binnen, dan stopt de actie en gaat de listing naar Error. Vul het ontbrekende gegeven aan, of controleer of de SKU en de marketplace overeenkomen met een aanbieding van dat account, en klik opnieuw.
• Elke andere fout tijdens het proces, ook die van het verzoek aan Amazon. De listing gaat naar Error, de module bewaart de foutmelding (ingekort als hij erg lang is), registreert hem en toont hem je.
• Meldingen van het type fout in het antwoord. De actie wordt afgerond, maar de listing komt op Error omdat Amazon meldingen van dat type heeft teruggegeven. De module bewaart hoeveel het er zijn en hun tekst in de listing.

Als je hulp nodig hebt met de connector

De module is een eenmalige aankoop per Odoo-versie (de prijs van elke versie staat op de productpagina) en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar, excl. btw. Hij is gepubliceerd voor Odoo 17, 18, 19 en 20; op de pagina van de module vind je de details over de aankoop. Als je Odoo implementeert en de Amazon-catalogus goed wilt opzetten, implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het connectoren en integraties op maat.

Lees verder

Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen

• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_product_binding_views.xml
• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_product_binding.py
• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_account.py
• Broncode van de module: 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/precios.html
• flexigotech.com/en/services.html