Was die Schaltfläche «An Octopia übermitteln» bei FFM-Retouren tut

Wo die Schaltfläche steht und wann sie sichtbar ist

Die Retouren öffnen Sie über das Menü Octopia › Fulfillment › Retouren (Octopia › Fulfillment › Returns). Der Bereich Octopia setzt die Berechtigung Octopia-Benutzer (Octopia User) voraus: Ohne sie sehen Sie diesen Bereich nicht. Auf dem Bildschirm FFM-Retouren (FFM Returns) befindet sich die Schaltfläche, und zwar in allen vier veröffentlichten Versionen des Moduls: Odoo 17, 18, 19 und 20.

Die Schaltfläche hat nur eine Sichtbarkeitsbedingung: Sie wird ausgeblendet, sobald das Feld Retouren-ID einen Wert hat. Mit den Standardwerten ist dieses Feld leer, die Schaltfläche ist also sichtbar. Umgekehrt gilt: Eine Retoure, die bereits eine Retouren-ID hat, bietet die Schaltfläche nicht mehr an.

Wenn Odoo auf Deutsch läuft, heißt die Schaltfläche An Octopia übermitteln. So lautet sie in jeder Sprache mit veröffentlichter Übersetzung:

Ein Fall zum Nachvollziehen von Anfang bis Ende

Beispiel Fiktiver Fall: Firma und Zahlen sind erfunden, um den Ablauf zu zeigen.

Hogar Norte ist ein erfundener Shop, der Haushaltswaren bei Cdiscount verkauft und seine FFM-Retouren aus Odoo verwaltet. Ein Kunde schickt ein Produkt aus einer bereits versendeten Lieferung zurück. Marta aus dem Kundenservice öffnet die Retoure unter Octopia › Fulfillment › Retouren und füllt aus, was diese Ansicht zeigt: das Octopia-Konto (Account), die Ausgehende Sendung (Outbound Shipment), aus der das Produkt stammt, den Kommentar (Comment), falls sie eine Notiz hinterlassen möchte, und die Positionen (Lines) der Retoure.

Zuerst klickt sie auf An Octopia übermitteln, obwohl die Retoure keine Positionen hat: Die Aktion bricht ab und es erscheint Eine Retoure benötigt mindestens eine Position. An Octopia wurde nichts gesendet. Marta fügt unter Positionen eine Zeile hinzu und klickt erneut. Diesmal bereitet das Modul die Anfrage vor, sendet sie mit dem gewählten Konto und speichert die Retouren-Kennung, sofern die Antwort sie enthält, in Retouren-ID. Danach setzt es die Retoure auf den Status „erstellt“ und trägt eine Zeile in das Synchronisierungsprotokoll des Kontos ein. Da Retouren-ID nun einen Wert hat, verschwindet die Schaltfläche aus der Ansicht.

Was der Fall zeigt: Die Vorabprüfung des Moduls ist, dass Positionen vorhanden sind, und der Beleg dafür, dass die Anlage bei Octopia angekommen ist, ist der Wert in Retouren-ID.

Was die Schaltfläche der Reihe nach tut

1. Hat die Retoure bereits eine Retouren-ID, überspringt die Methode sie, ohne etwas zu tun.
2. Sie prüft, ob die Retoure Positionen hat. Ist keine vorhanden, bricht sie mit Eine Retoure benötigt mindestens eine Position. ab und macht nicht weiter.
3. Sie bereitet die Anfrage mit der externen Kennung der Ausgehende Sendung, dem Retourengrund und je Position mit Produkt, Menge und Produktzustand vor.
4. Enthält Kommentar Text, fügt sie ihn der Anfrage hinzu. Ist das Feld leer, geht die Anfrage ohne Kommentar raus.
5. Sie verbindet sich mit dem Konto der Retoure und bittet Octopia, die Retoure anzulegen.
6. Enthält die Antwort die Kennung der Retoure, speichert sie diese in Retouren-ID.
7. Sie setzt die Retoure auf den Status „erstellt“.
8. Sie trägt eine Zeile in das Synchronisierungsprotokoll des Kontos ein: vom Typ Fulfillment, mit erfolgreichem Ergebnis, mit der ausgehenden Sendung im Text und einem gezählten Datensatz.

Dieses Protokoll gehört nicht nur der Schaltfläche. Auch zwei geplante Aufgaben schreiben hinein. Die Aufgabe Octopia: Referenzdaten aktualisieren (Kategorien, Marken, Transporteure, Typologien) (Octopia: refresh referentials (categories, brands, carriers, typologies)) läuft alle sieben Tage und ist bei der Installation aktiv, trägt aber nur dann etwas ins Protokoll ein, wenn ein Schritt der Aktualisierung fehlschlägt: Dann hinterlässt sie einen Fehler wegen unvollständiger Referenzdaten. Die Aufgabe Octopia: Diskussionen abrufen (ToTreat-Warteschlange) (Octopia: pull discussions (ToTreat queue)) läuft alle 15 Minuten, ist bei der Installation aktiv und hinterlässt ebenfalls ihren Eintrag in diesem Protokoll.

Die Meldung, die die Schaltfläche stoppen kann

Die Prüfung erfolgt vor der Vorbereitung der Anfrage und vor der Verbindung mit Octopia. Wenn die Meldung erscheint, wird diese Retoure nicht gesendet und nichts von dem gespeichert, was die Schaltfläche schreiben wollte: weder Retouren-ID noch die Statusänderung noch die Protokollzeile.

Fragen, die bei der Nutzung aufkommen

Wird der Kommentar gesendet, wenn ich ihn leer lasse?

Nein. Das Modul fügt den Kommentar der Anfrage nur hinzu, wenn Kommentar Text enthält.

Mit welchem Konto wird gesendet?

Mit dem Konto, das in der Retoure unter Konto steht. Sie sehen es auch in der Liste der FFM-Retouren, neben der Ausgehende Sendung.

Was passiert, wenn die Antwort keine Kennung enthält?

Das Modul setzt die Retoure trotzdem auf den Status „erstellt“ und trägt die Protokollzeile ein, aber Retouren-ID bleibt leer. Nach der Sichtbarkeitsbedingung der Schaltfläche bleibt sie bei leerem Feld sichtbar.

Kann dieselbe Retoure zweimal gesendet werden?

Das hängt von Retouren-ID ab. Hat die Retoure sie bereits, nein: Die Schaltfläche wird nicht angezeigt und die Methode überspringt die Retoure. Blieb das Feld leer, weil die Antwort keine Kennung enthielt, bleibt die Schaltfläche sichtbar, und ein erneuter Klick sendet die Anfrage erneut an Octopia.

Was Sie zur Nutzung brauchen

Das Modul ist eine Einmalzahlung pro Version und im Odoo Apps Store für Odoo 17, 18, 19 und 20 veröffentlicht; jede Odoo-Version wird dort einzeln gekauft, der Preis steht auf der jeweiligen Produktseite. Zusätzlich benötigen Sie das Abonnement von FlexigoTech Cloud, Tarif Connector: 49 €/Monat oder 490 €/Jahr zzgl. MwSt., für bis zu 3 Konten der Plattform (der Tarif Pro kostet 98 €/Monat oder 980 €/Jahr zzgl. MwSt., für bis zu 10).

Die Verbindung läuft über FlexigoTech Cloud, das die Zugangsdaten verschlüsselt speichert, die Synchronisierung überwacht und per E-Mail warnt, wenn sie fehlschlägt; ändert die Plattform ihre API, werden Modul und Dienst angepasst. Ohne Abonnement oder bei ausgesetztem Dienst stoppt, was das Abonnement liefert; die Daten bleiben in Ihrem Odoo.

Das Modul hat weitere Schaltflächen mit eigenem Artikel, etwa Konversation öffnen und Bei Octopia melden.

Wenn Sie Hilfe mit Octopia und Odoo brauchen

FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und individuelle Integrationen. Wenn Sie prüfen möchten, wie Ihre FFM-Retouren in Ihr Odoo passen, schreiben Sie uns.

Weiterlesen

Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen

• Quellcode des Moduls: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_fulfillment_views.xml
• Quellcode des Moduls: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_fulfillment.py
• Quellcode des Moduls: 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