Een casus: een commercieel gebaar dat je niet kunt indienen
Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.
Distribuciones Norte, een voor dit voorbeeld verzonnen bedrijf, verkoopt op Cdiscount en beheert de orders in Odoo met Octopia Connector. Marta van klantenservice wil een klant compenseren met een commercieel gebaar. Ze opent Octopia › Orders › Commerciële gebaren (Octopia › Orders › Commercial Gestures). Dat deel Octopia van het menu zie je alleen met het recht Octopia-gebruiker (Octopia User); heb je dat niet, dan zie je dat deel niet.
Ze maakt het formulier van het gebaar aan en klikt op Indienen bij Octopia (Submit to Octopia). Odoo vraagt om bevestiging met deze tekst: Een commercieel gebaar betaalt dit bedrag terug aan de klant. Doorgaan? (A commercial gesture refunds the customer this amount. Continue?). Marta bevestigt en de actie stopt met deze melding: Commerciële gebaren gelden alleen voor verzonden of geleverde orders (order … is …). (Commercial gestures apply to shipped or delivered orders only (order … is …).). Op de plek van de puntjes zet Odoo de Octopia-identificatie van de order en de status waarin hij zich bevindt.

Het probleem zit niet in het formulier van het gebaar, maar in de status van de order waar het naar verwijst.

Wanneer verschijnt de melding precies
De melding verschijnt wanneer je op Indienen bij Octopia klikt in het formulier van het gebaar en de order voldoet aan de voorwaarde die je hieronder ziet. De knop is zichtbaar zolang het veld Status (State) van het gebaar zijn beginwaarde heeft en wordt verborgen bij elke andere waarde, in Odoo 17, 18, 19 en 20.
Volgens de code van Odoo 20.0 doorloopt de module de gebaren en slaat ze de gebaren over die niet in die beginstatus staan. Voor elk van de andere voert ze deze controles uit, in deze volgorde:
- Ze controleert of het bedrag groter is dan nul. Zo niet, dan stopt ze met een andere melding.
- Ze kijkt naar het verkoopkanaal van de order: als de configuratie is gesynchroniseerd en de commerciële gebaren zijn uitgeschakeld, stopt ze ook met een andere melding.
- Ze kijkt naar de status van de order: als die niet verzonden en niet geleverd is, stopt ze met de melding waar het hier om gaat.
Met andere woorden: de melding verschijnt wanneer de status van de order niet verzonden en niet geleverd is, op voorwaarde dat het gebaar eerst de controle van het bedrag en die van het kanaal heeft doorstaan. En de melding zelf geeft de huidige status van de order aan.
Bij het stoppen wordt niets opgeslagen van wat de actie zou wijzigen:
- het gebaar gaat niet naar een andere status;
- de referentie van de aanvraag en de verzenddatum worden niet genoteerd;
- er wordt niets naar Octopia gestuurd.
Daarom blijft de knop zichtbaar in het formulier en kun je er later opnieuw op klikken.
De melding staat in de gepubliceerde code van de takken 17.0, 18.0, 19.0 en 20.0. De volgorde van controles die je net las is die van de code van Odoo 20.0.

Commerciële gebaren gelden alleen voor verzonden of geleverde orders (order … is …).Hoe los je het op
- Lees de melding: ze bevat de Octopia-identificatie van de order en de huidige status.
- Als die status niet verzonden en niet geleverd is, kan het gebaar nog niet worden ingediend. Laat het formulier zoals het is: door deze melding hoef je daar niets te corrigeren.
- Zodra de order verzonden of geleverd is, open je het gebaar opnieuw in
Octopia › Orders › Commerciële gebaren, klik je opIndienen bij Octopiaen bevestig je. - Controleer het resultaat: als het indienen gelukt is, staat het gebaar in behandeling en verdwijnt de knop uit het formulier, omdat het gebaar niet meer de beginstatus heeft.
Als je in plaats van deze melding een andere ziet, kan die afkomstig zijn van een van de eerdere controles: het bedrag van het gebaar of de uitgeschakelde gebaren in het verkoopkanaal.
Voor de rest van wat die knop doet, heb je de stap-voor-stap van de knop Indienen bij Octopia.
Wat er gebeurt als de order wel voldoet
Als de order verzonden of geleverd is, gaat de module verder. Ze vraagt bij Octopia het resterende budget van de order op. Als Octopia een budget teruggeeft en het bedrag van het gebaar dat overschrijdt, stopt ze met een melding dat het bedrag hoger is dan het resterende budget. Overschrijdt het dat niet, of zegt Octopia niets, dan stuurt ze het gebaar door met de reden, het detail en het bedrag.
Als Octopia een referentie van de aanvraag teruggeeft, slaat ze die op in het formulier. Daarna noteert ze de verzenddatum, zet ze het gebaar in behandeling en maakt ze een synchronisatieregistratie van het type gebaren aan met een geslaagd resultaat.
Wat je van deze casus leert
- De melding gaat over de order, niet over het gebaar: de voorwaarde die haar veroorzaakt is de status van de order.
- De open plekken in het bericht zijn de aanwijzing: de Octopia-identificatie van de order en zijn huidige status.
- Een melding van dit type laat het indienen niet half gedaan achter: de status van het gebaar verandert niet en er komt niets aan bij Octopia.
- De knop blijft zichtbaar, dus opnieuw proberen betekent er nog eens op klikken wanneer de order verzonden of geleverd is.
Kosten en hulp van FlexigoTech
Octopia Connector (Cdiscount & Octopia Marketplaces) is een module met eenmalige betaling per Odoo-versie (17, 18, 19 en 20; de prijs van elke versie staat op de Odoo Apps-pagina) en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts van het platform.
Als je Odoo aan het implementeren bent en wilt nagaan hoe het circuit van orders en commerciële gebaren van Cdiscount in je bedrijf past, implementeren wij bij FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelen we connectoren en integraties op maat.
Is een andere knop van de module interessant voor je, lees dan het artikel over de knop Importeren.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_order_actions.py
- Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_order_actions_views.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
