Wat de knop Test SP-API Connection van de Amazon-connector voor Odoo doet

Waar de knop zit en wie erbij kan

De accountformulieren open je via het menu Amazon › Configuration › Accounts. Elk stuk van het menu vraagt een recht en als je dat niet hebt, zie je dat stuk niet: Amazon vraagt Viewer, Configuration vraagt Manager en Accounts vraagt ook Manager. De knop Test SP-API Connection staat in het scherm Accounts in de takken 17.0, 18.0, 19.0 en 20.0, en in alle vier is hij altijd zichtbaar.

Een voorbeeld van begin tot eind

Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.

Ferretería Norte is een verzonnen bedrijf dat al Odoo gebruikt en net zijn Amazon-account in de module heeft aangemaakt. Lucía, die het systeem beheert en het recht Manager van de connector heeft, opent Amazon › Configuration › Accounts, gaat naar het formulier van het account en naar het tabblad Identity, groep Marketplace. Daar staat Marketplace ID, dat ook in de lijst van Accounts verschijnt. De help van het veld geeft voor ES als voorbeeld A1RKKUPIHCS9HS, en dat is ook de standaardwaarde in de code. Lucía controleert of de waarde overeenkomt met de marketplace waarop ze verkoopt, want de knop gebruikt die in zijn verzoek, en klikt op Test SP-API Connection.

Omdat Lucía het recht Manager van de connector heeft en het account mag wijzigen, gaat de knop verder: hij vraagt Amazon om de lijst met bestellingen en na afloop krijgt het formulier het bericht Amazon SP-API connection validated successfully.. Als een gebruiker zonder het recht Manager van de connector en zonder dat van Instellingen de actie toch start, stopt de module die voordat hij met Amazon praat en toont hij de melding die hieronder wordt uitgelegd.

Wat de knop doet, in volgorde

Dit is het pad dat de code van Odoo 20.0 volgt, en de knop bestaat met dezelfde naam in de andere gepubliceerde takken:

1. Hij controleert je recht. De superuser van het systeem laat hij door; van elke andere gebruiker eist hij het recht Manager van de connector of dat van Instellingen. Omdat de groepen niet genoeg zijn, controleert hij ook of je schrijfrechten op het account hebt.
2. Voor elk account berekent hij een datum van twee dagen geleden (in UTC) en vraagt hij Amazon, met een leesverzoek, om de lijst met bestellingen die sinds die datum zijn aangemaakt in de marketplace van het account. Hij gebruikt de waarde van Marketplace ID zonder overtollige spaties aan de uiteinden.
3. Als het verzoek klaar is, plaatst hij op het formulier van het account het bericht Amazon SP-API connection validated successfully.

De knop doet verder niets met het antwoord: het verzoek dient als test en wat zichtbaar blijft is dat bericht. Alle SP-API-aanroepen van de module lopen via een gemeenschappelijk punt, en het verzoek van deze knop ook.

Het bericht dat de knop kan stoppen

Bij het klikken op de knop kan de rechtencontrole de actie stoppen met dit bericht:

You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Het verschijnt omdat de gebruiker noch het recht Manager van de connector noch dat van Instellingen heeft. Omdat dit het eerste is wat de knop doet, stopt de actie daar en wordt er niets aan Amazon gevraagd. Wat je moet doen is wat de melding zegt: een manager vragen dat recht toe te kennen.

Wat de knop niet vervangt

Het verzoek van de knop gebruikt dezelfde methode voor SP-API-aanroepen als verschillende geplande taken in de code van Odoo 20.0, zonder dat je ergens op klikt, allemaal actief bij installatie. Maar die taken vragen andere dingen:

• Definities van producttypen: Amazon SP-API - Auto-repair queue v2, elke drie minuten, en Amazon SP-API - Sync pending bindings (price/stock), elke minuut.
• Een specifieke bestelling: Amazon SP-API - Messaging context refresh, elke dertig minuten; Amazon SP-API - Messaging sync, elke vijftien minuten; Amazon SP-API - Retry pending shipments, elke vijf minuten, en Amazon: Import Orders, elke vijftien minuten.
• Een token voor beperkte gegevens: ook Amazon: Import Orders.

Daarom zegt het validatiebericht je dat het verzoek om de bestellijst goed is gegaan, niet dat elk van die taken het ook zal doen.

Wat je van dit voorbeeld leert

• Kijk voor het klikken naar Marketplace ID op het tabblad Identity: dat is de waarde die in het verzoek meegaat.
• De toegangsmelding gaat over rechten, niet over de verbinding met Amazon. De knop gaat alleen verder als de gebruiker het recht Manager van de connector of dat van Instellingen heeft en bovendien het account mag wijzigen.
• Het goede resultaat wordt op het formulier van het account vastgelegd.

Met Odoo in het Nederlands heet de knop Test SP-API Connection.

Kosten en versies

De module is gepubliceerd voor Odoo 17.0, 18.0, 19.0 en 20.0, kent een eenmalige betaling per versie (de prijs van elke versie staat op de Odoo Apps-pagina) en vereist het abonnement op FlexigoTech Cloud. Het plan Conector kost € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts van het platform. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart. De details vind je op de modulepagina.

Hoe FlexigoTech helpt

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Als je het Amazon-account in je Odoo aan het opzetten bent en iemand met je mee wilt laten kijken naar rechten en accountgegevens, neem dan contact met ons op.

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