Waar de knop staat en wanneer je hem ziet
De retourformulieren open je via het menu Octopia › Fulfilment › Retouren (Octopia › Fulfillment › Returns). Het onderdeel Octopia vraagt het recht Octopia-gebruiker (Octopia User): heb je dat niet, dan zie je dit onderdeel niet. In het scherm FFM-retouren (FFM Returns) staat de knop, en hij zit in alle vier de gepubliceerde versies van de module: Odoo 17, 18, 19 en 20.

De knop heeft maar één zichtbaarheidsvoorwaarde: hij wordt verborgen wanneer het veld Retour-ID een waarde heeft. Met de standaardwaarden is dat veld leeg, dus de knop is zichtbaar. Andersom gezegd: een retour die al een Retour-ID heeft, biedt de knop niet meer aan.
Met Odoo in het Nederlands heet de knop Indienen bij Octopia. Zo staat hij in elke taal met een gepubliceerde vertaling:

| Taal van Odoo | Label van de knop |
|---|---|
| Nederlands | Indienen bij Octopia |
| Duits | An Octopia übermitteln |
| Frans | Soumettre à Octopia |
| Italiaans | Invia a Octopia |
| Portugees | Submeter à Octopia |

Een voorbeeld van begin tot eind
Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.
Hogar Norte is een verzonnen winkel die huishoudartikelen verkoopt op Cdiscount en zijn FFM-retouren vanuit Odoo beheert. Een klant stuurt een product terug uit een zending die al is verstuurd. Marta, van klantenservice, opent het retourformulier in Octopia › Fulfilment › Retouren en vult in wat dat formulier toont: het Account van Octopia, de Uitgaande zending (Outbound Shipment) waar het product vandaan komt, de Opmerking (Comment) als ze een notitie wil achterlaten en de Regels (Lines) van de retour.
Eerst klikt ze op Indienen bij Octopia met een formulier zonder regels: de actie stopt en Een retour vereist minstens één regel. verschijnt. Er is niets naar Octopia gestuurd. Marta voegt een regel toe in Regels en klikt opnieuw. Deze keer bereidt de module het verzoek voor, stuurt het met het gekozen account en bewaart de identificatie van de retour in Retour-ID, als het antwoord die bevat. Daarna zet hij de retour op de status aangemaakt en noteert een regel in het synchronisatielogboek van het account. Omdat Retour-ID nu een waarde heeft, verdwijnt de knop van het formulier.
Wat je van het voorbeeld leert: de voorafgaande controle van de module is dat er regels zijn, en het bewijs dat de aanmaak Octopia heeft bereikt is de waarde van Retour-ID.
Wat de knop doet, in volgorde
- Als de retour al een
Retour-IDheeft, slaat de methode haar over zonder iets te doen. - Hij controleert of de retour regels heeft. Heeft ze er geen, dan stopt hij met
Een retour vereist minstens één regel.en gaat niet verder. - Hij bereidt het verzoek voor met de externe identificatie van de
Uitgaande zending, de reden van de retour en, per regel, het product, de hoeveelheid en de staat van het product. - Als
Opmerkingtekst bevat, voegt hij die toe aan het verzoek. Is het veld leeg, dan gaat het verzoek zonder opmerking. - Hij maakt verbinding met het
Accountvan de retour en vraagt Octopia de retour aan te maken. - Als het antwoord de identificatie van de retour bevat, bewaart hij die in
Retour-ID. - Hij zet de retour op de status aangemaakt.
- Hij noteert een regel in het synchronisatielogboek van het account: van het type fulfilment, met een correct resultaat, met de uitgaande zending in de tekst en één geteld record.
Dat logboek is niet exclusief voor de knop. Ook twee geplande taken schrijven erin. De taak Octopia: referentiedata vernieuwen (categorieën, merken, vervoerders, typologieën) (Octopia: refresh referentials (categories, brands, carriers, typologies)) draait om de zeven dagen en is bij installatie actief, maar noteert alleen iets in het logboek wanneer een stap van de vernieuwing mislukt: dan laat ze een fout achter over onvolledige referentiedata. De taak Octopia: discussies ophalen (ToTreat-wachtrij) (Octopia: pull discussions (ToTreat queue)) draait elke 15 minuten, is bij installatie actief en laat ook haar notitie achter in dat logboek.
De melding die de knop kan stoppen
| Melding | Wanneer ze verschijnt | Wat te doen |
|---|---|---|
Een retour vereist minstens één regel. | Bij het klikken op Indienen bij Octopia met een retour zonder regels. | Voeg minstens één regel toe in Regels van het formulier en klik opnieuw. |
De controle gebeurt vóór het voorbereiden van het verzoek en vóór de verbinding met Octopia. Als de melding verschijnt, wordt die retour niet verstuurd en wordt niets bewaard van wat de knop zou schrijven: geen Retour-ID, geen statuswijziging, geen logregel.
Vragen die opkomen bij het gebruik
Wordt de opmerking verstuurd als ik hem leeg laat?
Nee. De module voegt de opmerking alleen toe aan het verzoek wanneer Opmerking tekst bevat.
Met welk account wordt hij verstuurd?
Met het account dat in Account op het formulier van de retour staat. Je ziet het ook in de lijst van FFM-retouren, naast de Uitgaande zending.
Wat gebeurt er als het antwoord geen identificatie bevat?
De module zet de retour toch op de status aangemaakt en noteert de logregel, maar Retour-ID blijft leeg. Volgens de zichtbaarheidsvoorwaarde van de knop blijft de knop met een leeg veld zichtbaar.
Kan dezelfde retour twee keer worden verstuurd?
Het hangt af van Retour-ID. Heeft de retour die al, dan niet: de knop wordt niet getoond en de methode slaat haar over. Is het veld leeg gebleven omdat het antwoord geen identificatie bevatte, dan blijft de knop zichtbaar en stuurt opnieuw klikken het verzoek opnieuw naar Octopia.
Wat je nodig hebt om het te gebruiken
De module is een eenmalige betaling per versie en staat in Odoo Apps voor Odoo 17, 18, 19 en 20; elke Odoo-versie koop je daar apart en de prijs staat op de productpagina. Daarnaast heb je het abonnement op FlexigoTech Cloud nodig, plan Connector: € 49 per maand of € 490 per jaar excl. btw, voor maximaal 3 accounts van het platform (het Pro-plan kost € 98 per maand of € 980 per jaar excl. btw, voor maximaal 10).
De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als er iets misgaat; als het platform zijn API wijzigt, worden de module en de dienst aangepast. Zonder abonnement, of met een opgeschorte dienst, stopt wat het abonnement levert; de gegevens blijven in jouw Odoo.
De module heeft andere knoppen met een eigen artikel, zoals Gesprek openen en Aangeven bij Octopia.
Hulp nodig met Octopia en Odoo?
FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Wil je nagaan hoe je FFM-retouren in jouw Odoo passen, neem dan contact met ons op.
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): views/octopia_fulfillment_views.xml
- Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_fulfillment.py
- Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_referential.py
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
