Wanneer het kan
Het gebaar gaat over een order die al onderweg is: Odoo verstuurt het alleen als de Octopia-order op Shipped of Delivered staat. Bovendien moet het verkoopkanaal gebaren toestaan. Dat zie je onder Octopia › Configuration › Sales Channels, in de groep "Commercial Gestures" van elk kanaal: "Commercial Gestures Enabled", "Gesture Max Amount", "Gesture Max Rate (%)" en "Gesture Currency". Dat zijn alleen-lezengegevens die van Octopia komen wanneer de configuratie wordt gesynchroniseerd. Zolang een kanaal niet gesynchroniseerd is, houdt Odoo het gebaar om die reden niet tegen en heeft Octopia het laatste woord.
De knoppen van het gebaar zijn alleen zichtbaar voor wie managerrechten heeft in de connector.

Stap voor stap
- Ga naar Octopia › Orders › Commercial Gestures en maak een nieuw gebaar aan.
- Kies de order en de reden, en vul zo nodig de toelichting in.
- Klik op "Check Remaining Budget". Odoo leest bij Octopia hoeveel er voor die order nog kan worden toegekend en zet dat in het veld voor het beschikbare budget.
- Vul het bedrag van het gebaar in, zonder boven dat budget uit te komen.
- Klik op "Submit to Octopia" en bevestig: de melding herinnert je eraan dat het gebaar dat bedrag aan de klant terugbetaalt.
- Het gebaar gaat naar In Progress, met de referentie van Octopia en de verzenddatum.

De redenen
Octopia vraagt om een reden uit zijn eigen lijst, en Odoo biedt je dezelfde aan: Late Delivery, Missing Product, Product Return Fees, Quantity Compensation, Reference Mistake, Shipping Fees, Fees Unduly Charged, Warranty Period Exceeded en Other. Kies de reden die beschrijft wat er gebeurd is; de toelichting, als je die invult, gaat met het gebaar mee.
Wat er bij het verzenden wordt gecontroleerd
| Controle | Melding als het misgaat |
|---|---|
| Het kanaal heeft gebaren niet uitgeschakeld | Sales channel %s has commercial gestures disabled. |
| De order staat op Shipped of Delivered | Commercial gestures apply to shipped or delivered orders only (order %s is %s). |
| Het bedrag is niet hoger dan het resterende budget, als dat groter is dan 0 | Gesture amount %(amount).2f exceeds the remaining budget %(available).2f for this order. |
Odoo leest het budget vlak voor het verzenden opnieuw, dus de derde controle gebruikt het bedrag van dat moment, niet het bedrag dat je zag toen je op de knop klikte. Die controle houdt alleen iets tegen als er een budget groter dan 0 is: staat het budget op 0, is het op of ontbreekt het, dan verstuurt Odoo het gebaar toch en beslist Octopia.

Na het verzenden
De taak "Octopia: poll async jobs (packages, cancellations, gestures)" vraagt Octopia elke 5 minuten naar de gebaren die op In Progress staan. Wil je niet wachten, dan doet "Poll Status" meteen dezelfde controle. Het gebaar eindigt in Done als Octopia het accepteert, of in Rejected als dat niet zo is; de lijst kleurt ze groen en rood.
Bij Done kan Odoo de creditfactuur voor je klaarzetten. Daarvoor moet "Auto-create Credit Notes" in het Octopia-account aangevinkt zijn en moet de order een klant hebben. De creditfactuur wordt in concept aangemaakt, met één regel voor het bedrag van het gebaar en zonder btw, en de referentie begint met "Octopia commercial gesture". Er staat geen btw op omdat dat bedrag het brutobedrag is dat het kanaal heeft terugbetaald, met de btw er al in. Controleer hem voordat je hem boekt: moet je die btw in je boekhouding apart tonen, doe dat dan zonder het totaal te wijzigen.
Annuleert het gebaar de order?
Nee. De order blijft zoals hij is en de klant krijgt alleen het bedrag van het gebaar terug. Om de hele order of enkele regels te annuleren, is er de annulering van Cdiscount-orders.
Zit het in alle versies?
Ja, commerciële gebaren zitten in de connector die is gepubliceerd voor Odoo 17, 18, 19 en 20.
Lees verder
Gecontroleerd in de broncode van de connector (versie 17.0, 18.0, 19.0 en 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: views/octopia_order_actions_views.xml, models/octopia_order_actions.py
- Broncode van de module: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_api_client.py (GESTURE_REASON_SELECTION, GESTURE_STATUS_SELECTION), models/octopia_order_actions.py
- Broncode van de module: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_order_actions.py (action_submit, action_check_available)
- Broncode van de module: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_sales_channel.py, views/octopia_sales_channel_views.xml, views/menu.xml
- Broncode van de module: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_order_actions.py (action_poll, _on_done), models/octopia_account.py, data/octopia_cron_data.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
