Wat de Shopify-connector toevoegt aan Odoo-verkooporders

Wat de module toevoegt aan de verkooporder

De module breidt de verkooporder uit van de app Verkoop (Sales). Bovenop de standaard Odoo-order plaatst hij een groep Shopify-gegevens, een leveringsstatus in de lijst en drie knoppen.

De velden op het formulier

Met de standaardwaarden zie je ze niet: de groep Shopify op het orderformulier verschijnt alleen als de order een Shopify-orderref. heeft. Daarin staan:

• Shopify-orderref. (Shopify Order Ref) en Shopify-instantie (Shopify Instance), beide alleen-lezen.
• Shopify-tags (Shopify Tags): de tags van de Shopify-bestelling.
• Shopify-notitie (Shopify Note): de klantnotitie van de Shopify-bestelling.
• Shopify-winkelprefix (Shopify Store Prefix), alleen-lezen: het prefix van de winkel van herkomst, bij het importeren overgenomen van de Shopify-instantie.
• Shopify totaalbedrag (Shopify Amount Total), alleen-lezen: het totaal dat Shopify meldt, bewaard om het af te stemmen op het Odoo-totaal.
• Shopify-totaalafwijking (Shopify Total Mismatch), alleen-lezen: wordt bij het importeren gezet wanneer het ordertotaal in Odoo meer dan een afrondingsverschil afwijkt van dat van Shopify.

Buiten die groep zijn er nog twee. Terugbetalingen (Refunds) staat op het formulier, is verborgen zolang de waarde nul is en toont het aantal Shopify-terugbetalingen dat aan de order hangt. Shopify-leveringsstatus (Shopify Delivery Status) staat in de lijst met verkooporders.

Stap voor stap: van order naar acties

1. Open de order in Verkoop en bekijk de groep Shopify. Vergelijk Shopify totaalbedrag met het Odoo-totaal: als Shopify-totaalafwijking is aangevinkt, weken de totalen bij het importeren meer dan een afrondingsverschil af.
2. Raadpleeg in de lijst met verkooporders Shopify-leveringsstatus. Hieronder lees je hoe die wordt berekend.
3. Bepaal of wijzigingen aan orderregels vanzelf worden doorgestuurd. Bij Shopify-instanties (Shopify Instances), tabblad Bewerkingen (Operations), groep Synchronisatie-instellingen (Sync Settings), staat het vakje Orderbewerkingen automatisch naar Shopify pushen (Auto-push order edits to Shopify), standaard uitgeschakeld. Als het aan staat, stuurt Odoo bij het opslaan van een aan Shopify gekoppelde order in status Verkooporder (Sales Order) met gewijzigde regels de wijziging naar Shopify via de API voor orderbewerking. Mislukt die aanroep, dan wordt de fout in het serverlogboek genoteerd en gaat het opslaan gewoon door.
4. Om de regels handmatig te sturen, klik je op Pushen naar Shopify (Push to Shopify). De knop verschijnt alleen als de order een Shopify-orderref. heeft en in status Verkooporder staat. Hij vraagt om bevestiging: «De huidige bestelregels (hoeveelheden, toegevoegde/verwijderde producten) naar de gekoppelde Shopify-bestelling pushen?». De module doorloopt de orderregels (zonder secties, notities en verzendregels) en zoekt elke regel tussen die van Shopify op via de Shopify-variant van het product of een overeenkomende SKU. Wijkt de hoeveelheid af, dan wordt die aangepast met het verzoek aan Shopify om voorraad terug te zetten; ontbreekt de regel in Shopify en heeft het product een variant, dan wordt ze toegevoegd.
5. Bepaal of annuleringen vanzelf worden doorgestuurd. In dezelfde groep staat Annuleringen automatisch naar Shopify pushen (Auto-push cancellations to Shopify), eveneens standaard uitgeschakeld. Als het aan staat en een aan Shopify gekoppelde order in Odoo wordt geannuleerd met de gewone annuleeractie, annuleert de module de order ook in Shopify. Mislukt dat, dan wordt het in het serverlogboek genoteerd en blijft de Odoo-order toch geannuleerd.
6. Om handmatig te annuleren, klik je op Annuleren in Shopify (Cancel in Shopify). De knop verschijnt als de order een Shopify-orderref. heeft en zolang ze niet in status Geannuleerd (Cancelled) staat. Hij vraagt om bevestiging: «De gekoppelde Shopify-order en deze Odoo-order annuleren?». De volgorde is belangrijk: eerst wordt in Shopify geannuleerd en alleen als dat zonder fout lukt, wordt de Odoo-order geannuleerd, zonder de annulering nog eens te sturen. Of de klant een bericht krijgt, er wordt terugbetaald of voorraad wordt teruggezet, bepalen de instellingen van de instantie.
7. Om het geld terug te geven, klik je op Terugbetalen in Shopify (Refund in Shopify). Dit hangt niet van de status af: de knop is alleen verborgen als de order geen Shopify-orderref. heeft. Hij vraagt om bevestiging: «Een volledige terugbetaling van deze bestelling in Shopify aanmaken?». De terugbetaling omvat de uit Shopify geïmporteerde regels, zonder verzendregels, met hun hoeveelheid en gemarkeerd als retour. Het bericht aan de klant en de terugbetaling als winkeltegoed volgen uit de instellingen van de instantie.

Wie ze mag indrukken en welke meldingen kunnen verschijnen

Bij het indrukken van een van de drie knoppen controleert de module op de server of jouw gebruiker toegang heeft als Shopify Operator (of Manager). Alleen de gewone toegang tot Verkoop is niet genoeg. Ontbreekt die, dan verschijnt You need Shopify Operator (or Manager) access to push changes to Shopify.

Andere meldingen die de actie kunnen stoppen:

• Bij alle drie de knoppen: Verkooporder … is niet gekoppeld aan een Shopify-bestelling. (Sale order … is not linked to a Shopify order.)
• Bij Pushen naar Shopify: Kon geen Shopify-orderbewerking starten voor …. (Could not begin a Shopify order edit for ….) en Deze producten hebben geen Shopify-variant en kunnen niet aan de Shopify-bestelling worden toegevoegd (bewerking niet doorgevoerd): … (These products have no Shopify variant and cannot be added to the Shopify order (edit not committed): …). De tweede somt de betrokken producten op.
• Bij Annuleren in Shopify: Annuleren Shopify-bestelling mislukt: … (Shopify order cancel failed: …), met de foutmelding die Shopify teruggeeft. In dat geval wordt de Odoo-order niet geannuleerd.

Hoe Shopify-leveringsstatus wordt berekend

De waarde komt uit de code van Odoo 20. De opties zijn Niet gevalideerd (Not Validated), Klaar voor verzending (Ready to Ship), Gedeeltelijk verzonden (Partially Shipped), Verzonden (Shipped) en Geannuleerd (Cancelled). Eerst wordt gekeken of de order geannuleerd is. Zo niet, dan wordt het geleverde vergeleken met het bestelde op de productregels met een bestelde hoeveelheid groter dan nul (zonder secties of notities en alleen van bepaalde producttypes). Zijn er geen regels om te tellen, dan kijkt de module naar de niet-geannuleerde overboekingen van de order en, als er uitgaande bij zitten, alleen naar die.

Wat de module toevoegt aan de overboekingen van Voorraad staat in dit andere artikel, en de voorraadknop in dit artikel.

Versies, abonnement en hulp

De module is gepubliceerd in Odoo Apps voor Odoo 17, 18, 19 en 20. De voorwaarden waaronder de drie knoppen verschijnen zijn in die vier versies hetzelfde; de berekening van de leveringsstatus en de rest van het beschreven gedrag komen uit de code van Odoo 20. Je kunt de pagina in Odoo Apps of de pagina van de module bekijken.

Het is een module met eenmalige betaling per Odoo-versie en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 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 die mislukt.

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat, mocht je deze flow op jouw winkel willen afstemmen.

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 (2950bdc0): models/sale_order.py
• Broncode van de module: flexigobe_shopify_seller_connector 20.0 (2950bdc0): views/sale_order_views.xml
• Broncode van de module: flexigobe_shopify_seller_connector 20.0 (2950bdc0): models/shopify_instance.py
• apps.odoo.com/apps/modules/20.0/flexigobe_shopify_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html