De knop «Autorisatiecode uitwisselen» van Shopify: mythes en realiteit

Waar de knop staat en wat hij van begin tot eind doet

De knop Autorisatiecode uitwisselen (Exchange Auth Code) staat in het scherm Shopify-instanties (Shopify Instances), in de Odoo-versies 17, 18, 19 en 20. De winkelfiches open je via het menu Shopify › Configuratie › Winkels (Shopify › Configuration › Stores). Om het gedeelte Configuratie (Configuration) te zien heb je de rol Operator nodig; voor het gedeelte Shopify die van Lezer (Viewer).

In Odoo 20.0 doorloopt de module bij het klikken de geselecteerde winkels en voert de uitwisseling in elke winkel uit. Hij kijkt of de winkel een opgeslagen autorisatiecode heeft; stuurt die code samen met de API-sleutel en het API-geheim van de applicatie naar Shopify; controleert of het antwoord een toegangstoken bevat; en slaat pas dan de wijzigingen op.

Met Odoo in het Nederlands heet de knop Autorisatiecode uitwisselen. In het volgende schema staat de naam in andere talen.

Misverstanden over de uitwisselknop

«De knop staat op de fiche van elke winkel»

De weergave verbergt de knop wanneer het veld Shopify connection de standaardwaarde heeft, dus met de standaardwaarden zie je hem niet. Dat veld is in geen enkele weergave zichtbaar. De knop is zichtbaar wanneer dat veld een andere waarde heeft dan de standaardwaarde. De voorwaarde is hetzelfde in Odoo 17, 18, 19 en 20.

«Klikken opent de autorisatie in Shopify»

Bij het klikken werkt de module met de autorisatiecode die al in de winkel is opgeslagen. Is die code leeg, dan stopt de knop in Odoo 20.0 met Autorisatiecode ontbreekt. (Missing authorization code.) en verandert er niets.

«Als Shopify de uitwisseling weigert, blijft de winkel half ingesteld»

Wanneer de knop met een melding stopt, wordt de actie afgebroken en wordt niets opgeslagen van wat hij zou wijzigen. Naast de vorige melding kan de knop met deze stoppen:

• Shopify OAuth-uitwisseling mislukt: … (Shopify OAuth exchange failed: …). Verschijnt wanneer Shopify antwoordt met een foutstatuscode. In plaats van de beletselteken staat het begin van de tekst waarmee Shopify antwoordde: lees die om te weten wat Shopify heeft gezegd.
• De Shopify OAuth-uitwisselingsreactie bevatte geen toegangstoken. (Shopify OAuth exchange response did not include an access token.). Verschijnt wanneer het antwoord van Shopify geen toegangstoken bevat.

«Het token dat wordt opgeslagen is permanent»

In Odoo 20.0 vraagt de module Shopify om het paar van kortlevend toegangstoken en vernieuwingstoken; de opmerking in de code spreekt van een vernieuwingstoken van 90 dagen. Het vernieuwingstoken wordt alleen opgeslagen als Shopify het teruggeeft, en de vervaldatum van het toegangstoken alleen als Shopify aangeeft hoeveel seconden het geldig is. Ook worden het tijdstip van de uitwisseling als laatste vernieuwing en de verleende rechten opgeslagen: die van het token zelf of, als die ontbreken, die van de gekoppelde gebruiker; als er geen zijn, blijft het leeg.

«Na het uitwisselen kan de code opnieuw worden gebruikt»

Bij het opslaan maakt de module de autorisatiecode en de waarde van de hangende OAuth-status leeg. Volgens de opmerking in de code is die waarde voor eenmalig gebruik: ze wordt daar verbruikt zodat een herhaalde callback niet een tweede keer kan worden afgerond. Tegelijk gaat de winkel naar de status verbonden en wordt de laatste verbindingsfout gewist. Klik je opnieuw op de knop terwijl de code al leeg is, dan stopt hij met Autorisatiecode ontbreekt..

«Met de module kopen ben je klaar»

De knop maakt deel uit van een module met een eenmalige betaling per versie die het abonnement op FlexigoTech Cloud (plan Connector) nodig heeft: € 49 per maand of € 490 per jaar, excl. btw. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als er iets misgaat. Zonder abonnement, of met een opgeschorte dienst, stopt wat het abonnement biedt; de gegevens blijven in jouw Odoo.

De module is gepubliceerd in Odoo Apps voor 17.0, 18.0, 19.0 en 20.0. Met het abonnement is de module voor de nieuwe Odoo-versies inbegrepen als je hem op flexigotech.com hebt gekocht; in de Odoo App Store koop je elke Odoo-versie daar apart. Je vindt de fiche in Odoo Apps en de pagina van de module.

Waar je op moet letten als de knop met een melding stopt

• Bij Autorisatiecode ontbreekt. had de winkel op dat moment geen opgeslagen autorisatiecode (of was die al leeggemaakt bij een eerdere uitwisseling).
• Bij Shopify OAuth-uitwisseling mislukt: … lees je de tekst na de dubbele punt: dat is het antwoord van Shopify.
• Bij De Shopify OAuth-uitwisselingsreactie bevatte geen toegangstoken. antwoordde Shopify zonder het token terug te geven.

In elk van deze gevallen wordt de actie afgebroken en wordt niets opgeslagen van wat de knop zou wijzigen.

Als je een andere knop van de module zoekt

De connector heeft nog meer knoppen met hun eigen verhaal. Als voorraad je interesseert, heb je een ander artikel over de voorraadknop van de connector.

Zo helpt FlexigoTech

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Als je bij het verbinden van je winkel een van deze meldingen tegenkomt en niet weet hoe verder, laat ons weten welke tekst er na de dubbele punt staat en we kijken er samen met je naar.

Lees verder

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

Bronnen

• Broncode van de module: flexigobe_shopify_seller_connector 20.0 (d7e627b4): views/shopify_instance_views.xml
• Broncode van de module: flexigobe_shopify_seller_connector 20.0 (d7e627b4): models/shopify_instance.py
• Broncode van de module: flexigobe_shopify_seller_connector 20.0 (d7e627b4): models/fgt_cloud.py
• apps.odoo.com/apps/modules/20.0/flexigobe_shopify_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html