Gdzie jest przycisk i kiedy go widać
Karty zwrotów otwierasz z menu Octopia › Fulfillment › Zwroty. Sekcja Octopia wymaga uprawnienia Użytkownik Octopia (Octopia User): jeśli go nie masz, tej sekcji nie widzisz. Przycisk jest na ekranie Zwroty FFM (FFM Returns) i występuje we wszystkich czterech opublikowanych wersjach modułu: Odoo 17, 18, 19 i 20.

Przycisk ma jeden warunek widoczności: znika, gdy pole ID zwrotu ma wartość. Przy wartościach domyślnych to pole jest puste, więc przycisk jest widoczny. Mówiąc odwrotnie: zwrot, który ma już ID zwrotu, przestaje oferować ten przycisk.
Przy Odoo w języku polskim przycisk nazywa się Zgłoś do Octopia. Tak brzmi w każdym języku z opublikowanym tłumaczeniem:

| Język Odoo | Etykieta przycisku |
|---|---|
| Polski | Zgłoś do Octopia |
| Niemiecki | An Octopia übermitteln |
| Francuski | Soumettre à Octopia |
| Włoski | Invia a Octopia |
| Portugalski | Submeter à Octopia |

Przykład od początku do końca
Przykład Przypadek poglądowy: firma i jej dane są zmyślone, żeby pokazać przebieg.
Hogar Norte to wymyślony sklep, który sprzedaje artykuły gospodarstwa domowego w Cdiscount i obsługuje zwroty FFM z Odoo. Klient zwraca produkt z już zrealizowanej wysyłki. Marta z obsługi klienta otwiera kartę zwrotu w Octopia › Fulfillment › Zwroty i wypełnia to, co pokazuje ta karta: Konto (Account) Octopia, Wysyłka wychodząca (Outbound Shipment), z której pochodzi produkt, Komentarz (Comment), jeśli chce zostawić notatkę, oraz Pozycje (Lines) zwrotu.
Najpierw klika Zgłoś do Octopia przy karcie bez pozycji: akcja się zatrzymuje i pojawia się Zwrot wymaga co najmniej jednej pozycji. Nic nie zostało wysłane do Octopia. Marta dodaje pozycję w Pozycje i klika ponownie. Tym razem moduł przygotowuje żądanie, wysyła je z wybranym kontem i, jeśli odpowiedź zawiera identyfikator zwrotu, zapisuje go w ID zwrotu. Następnie ustawia zwrot w stan utworzony i dodaje wpis w dzienniku synchronizacji konta. Ponieważ ID zwrotu ma już wartość, przycisk znika z karty.
Wniosek z przykładu: moduł wykonuje wcześniej jedno sprawdzenie, czy są pozycje, a śladem tego, że utworzenie dotarło do Octopia, jest wartość w ID zwrotu.
Co robi przycisk, po kolei
- Jeśli zwrot ma już
ID zwrotu, metoda pomija go i nic nie robi. - Sprawdza, czy zwrot ma pozycje. Jeśli nie ma żadnej, zatrzymuje się z komunikatem
Zwrot wymaga co najmniej jednej pozycji.i nie idzie dalej. - Przygotowuje żądanie z zewnętrznym identyfikatorem
Wysyłka wychodząca, powodem zwrotu oraz, dla każdej pozycji, produktem, ilością i stanem produktu. - Jeśli
Komentarzzawiera tekst, dodaje go do żądania. Jeśli jest pusty, żądanie idzie bez komentarza. - Łączy się z
Kontozwrotu i prosi Octopia o utworzenie zwrotu. - Jeśli odpowiedź zawiera identyfikator zwrotu, zapisuje go w
ID zwrotu. - Ustawia zwrot w stan utworzony.
- Dodaje wpis w dzienniku synchronizacji konta: typu fulfillment, z wynikiem poprawnym, z wysyłką wychodzącą w tekście i jednym policzonym rekordem.
Ten dziennik nie jest wyłączny dla przycisku. Zapisują do niego także dwa zaplanowane zadania. Zadanie Octopia: odświeżanie danych referencyjnych (kategorie, marki, przewoźnicy, typologie) (Octopia: refresh referentials (categories, brands, carriers, typologies)) uruchamia się co siedem dni i jest aktywne po instalacji, ale dodaje wpis do dziennika tylko wtedy, gdy jakiś krok odświeżania się nie powiedzie: wtedy zostawia błąd niekompletnych danych referencyjnych. Zadanie Octopia: pobieranie dyskusji (kolejka ToTreat) (Octopia: pull discussions (ToTreat queue)) uruchamia się co 15 minut, jest aktywne po instalacji i również zostawia swój wpis w tym dzienniku.
Komunikat, który może zatrzymać przycisk
| Komunikat | Kiedy się pojawia | Co zrobić |
|---|---|---|
Zwrot wymaga co najmniej jednej pozycji. | Po kliknięciu Zgłoś do Octopia przy zwrocie bez pozycji. | Dodaj co najmniej jedną pozycję w Pozycje na karcie i kliknij ponownie. |
Sprawdzenie odbywa się przed przygotowaniem żądania i przed połączeniem z Octopia. Gdy komunikat się pojawia, ten zwrot nie jest wysyłany i nie zapisuje się nic z tego, co przycisk miał zapisać: ani ID zwrotu, ani zmiana stanu, ani wpis w dzienniku.
Wątpliwości przy użyciu
Czy komentarz jest wysyłany, jeśli zostawię go pusty?
Nie. Moduł dodaje komentarz do żądania tylko wtedy, gdy Komentarz zawiera tekst.
Z jakim kontem jest wysyłany?
Z tym, które widnieje w Konto na karcie zwrotu. Widzisz je też na liście Zwroty FFM, obok Wysyłka wychodząca.
Co się dzieje, jeśli odpowiedź nie zawiera identyfikatora?
Moduł mimo to ustawia zwrot w stan utworzony i dodaje wpis w dzienniku, ale ID zwrotu pozostaje puste. Zgodnie z warunkiem widoczności przycisku, przy pustym polu przycisk nadal jest widoczny.
Czy można wysłać ten sam zwrot dwa razy?
Zależy od ID zwrotu. Jeśli zwrot już je ma, nie: przycisk się nie wyświetla, a metoda go pomija. Jeśli pole zostało puste, bo odpowiedź nie zawierała identyfikatora, przycisk nadal jest widoczny i kliknięcie go ponownie wysyła żądanie do Octopia jeszcze raz.
Czego potrzebujesz, żeby z niego korzystać
Moduł jest płatny jednorazowo za wersję i opublikowany w Odoo Apps dla Odoo 17, 18, 19 i 20; każdą wersję Odoo kupuje się tam osobno, a jej cena jest w karcie. Dodatkowo wymaga subskrypcji FlexigoTech Cloud, plan Conector: 49 €/mies. lub 490 €/rok netto (bez VAT), dla maksymalnie 3 kont platformy (plan Pro to 98 €/mies. lub 980 €/rok netto (bez VAT), dla maksymalnie 10).
Połączenie przechodzi przez FlexigoTech Cloud, które przechowuje zaszyfrowane dane dostępowe, pilnuje synchronizacji i wysyła e-mail, jeśli coś zawiedzie; jeśli platforma zmieni swoje API, moduł i usługa są dostosowywane. Bez subskrypcji lub przy zawieszonej usłudze zatrzymuje się to, co daje subskrypcja; dane zostają w Twoim Odoo.
Moduł ma inne przyciski z własnym artykułem, jak Otwórz rozmowę i Zgłoś do Octopia.
Jeśli potrzebujesz pomocy z Octopia i Odoo
FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie. Jeśli chcesz sprawdzić, jak zwroty FFM pasują do Twojego Odoo, napisz do nas.
Czytaj dalej
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach
Źródła
- Kod modułu: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_fulfillment_views.xml
- Kod modułu: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_fulfillment.py
- Kod modułu: 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
