Wat de knop «Vernieuwen vanuit Shopify» van Shopify Connector doet

Waar staat de knop en wanneer zie je hem

De knop Vernieuwen vanuit Shopify (Refresh from Shopify) staat in het scherm Shopify-bestellingen (Shopify Orders). Om er te komen open je Verkoop (Sales), daarna Shopify, daarna Operations en tot slot Orders. Volgens de voorwaarde in zijn weergave is hij altijd zichtbaar, en hij bestaat in Odoo 17, 18, 19 en 20.

Het label verandert met de taal van Odoo. Met Odoo in het Nederlands is het Vernieuwen vanuit Shopify; in het Duits Von Shopify aktualisieren; in het Frans Actualiser depuis Shopify; in het Italiaans Aggiorna da Shopify; en in het Portugees Atualizar do Shopify.

Eerst: wat de connector doet zonder dat je iets indrukt

De normale weg is automatisch. De geplande taak Shopify Process Webhooks (elke minuut, actief bij installatie) verwerkt de webhookmeldingen van Shopify. Als de melding over een bestelling gaat en het vakje Webhook Sync Orders is aangevinkt, neemt de module de bestellings-ID uit de melding zelf en start dezelfde bestellingssynchronisatie als de knop.

Dat vakje staat op het formulier van Shopify Instances, tabblad Webhooks, en is standaard aangevinkt. Op hetzelfde tabblad staat Webhook Sync Products, dat standaard uitgevinkt is en over producten gaat, niet over bestellingen.

Daarom is de knop de uitzondering: hij dient om een bestelling handmatig opnieuw op te halen. Bovendien kijkt de code van de knop niet naar het vakje Webhook Sync Orders: hij roept rechtstreeks de synchronisatie aan met de instantie en de bestelling die voor je staat.

Een voorbeeld: de bestelling die niet klopt

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

Stel je Cerámicas Ribera voor, een winkel die voor dit voorbeeld verzonnen is en die op Shopify verkoopt en de rest in Odoo doet. Een medewerker administratie opent een bestelling in Odoo en betwijfelt of die weergeeft wat Shopify nu heeft. Zo gaat ze te werk:

1. Ze opent het formulier van Shopify Instances, tabblad Webhooks, en kijkt of Webhook Sync Orders is aangevinkt. Zo ja, dan starten de bestellingsmeldingen die synchronisatie al uit zichzelf; wat zij zoekt is een tweede keer handmatig uitlezen.
2. Ze opent Verkoop, Shopify, Operations en Orders, en gaat de bestelling in. Ze let op het veld Instance en het veld Shopify-bestelling (Shopify Order), want dat zijn de twee gegevens waarmee de knop werkt.
3. Ze klikt op Vernieuwen vanuit Shopify.
4. De module vraagt die bestelling opnieuw op bij Shopify en, als Shopify hem teruggeeft, geeft hij hem aan een andere stap van de module en telt hem als gesynchroniseerd.
5. Ze bekijkt de bestelling in Odoo opnieuw en vergelijkt hem met Shopify.

Wat je ervan leert: kijk eerst naar de automatische weg en zijn vakjes, en gebruik daarna de knop op een specifieke bestelling, met zijn instantie en zijn Shopify-ID voor je.

Wat de knop van binnen doet, in volgorde

1. Hij doorloopt de bestellingen waarop de actie wordt gestart.
2. Van elke bestelling neemt hij de instantie (Instance) en de ID van Shopify-bestelling, en geeft die aan de bestellingssynchronisatie van die instantie.
3. Die synchronisatie bereidt de bestellings-ID voor om op te vragen; als ze er geen krijgt, slaat ze die bestelling over en gaat verder met de volgende.
4. Ze vraagt Shopify naar de bestelling.
5. Als Shopify niets teruggeeft, slaat ze die bestelling over en gaat verder.
6. Als er gegevens terugkomen, geeft ze die aan een andere stap van de module en telt er één bij het aantal gesynchroniseerde bestellingen.
7. De knop eindigt met het teruggeven van waar; dat aantal gebruikt hij niet.

Wat er mis kan gaan en wat je moet checken

Bij de derde en de vijfde stap gaat de code naar de volgende bestelling zonder iets af te geven. Als je op de knop klikt en geen wijzigingen ziet, vergelijk dan met Shopify: mogelijk gaf Shopify niets terug voor die bestelling of is er geen geldige ID verkregen.

Via de automatische weg wordt, als de synchronisatie mislukt, de webhookgebeurtenis als mislukt gemarkeerd met de tekst van de fout en komt ze in de wachtrij voor nieuwe pogingen. Bij overschrijding van het maximum aantal pogingen gaat ze naar uitgeput en wordt ze niet meer automatisch opnieuw geprobeerd; dan laat de module een notitie achter bij de instantie met de melding De Shopify-webhook … (gebeurtenis …) is na … nieuwe pogingen opnieuw mislukt en wordt niet meer automatisch opnieuw geprobeerd: …. Klik bij de gebeurtenis op Opnieuw proberen zodra de oorzaak is opgelost. (Shopify webhook … (event …) failed again after … retries and will not be retried any more: …. Once the cause is fixed, press Retry on the event.)

Wat het kost en hoe FlexigoTech je helpt

De module kost € 9 per Odoo-versie, voor 17, 18, 19 en 20, eenmalige betaling excl. btw (pagina op Odoo Apps), en vereist het abonnement op FlexigoTech Cloud: het Connector-plan kost € 49 per maand of € 490 per jaar excl. btw.

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Wil je nagaan hoe de bestellingen van je winkel in Odoo aankomen, dan helpen we daar ook bij.

Lees verder

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

Bronnen

• Broncode van de module: flexigobe_shopify_connector 20.0 (c7078cd8): views/shopify_order_views.xml
• Broncode van de module: flexigobe_shopify_connector 20.0 (c7078cd8): models/shopify_order.py
• Broncode van de module: flexigobe_shopify_connector 20.0 (c7078cd8): models/shopify_instance.py
• apps.odoo.com/apps/modules/20.0/flexigobe_shopify_connector
• apps.odoo.com/apps/modules/17.0/flexigobe_shopify_connector
• apps.odoo.com/apps/modules/18.0/flexigobe_shopify_connector
• apps.odoo.com/apps/modules/19.0/flexigobe_shopify_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html