Przejdź do głównej treści
Amazon

Co robi przycisk «Sync FBA Ledger Detail» w Odoo

Przycisk Sync FBA Ledger Detail uruchamia ręcznie, dla jednego konta, synchronizację, którą codziennie wykonuje zaplanowane zadanie na aktywnych kontach z włączonym szczegółem: prosi Amazon o raport ze szczegółami księgi FBA, czeka, aż będzie gotowy, importuje jego wiersze i zostawia podsumowanie. Najpierw sprawdza twoje uprawnienia; jeśli nie masz uprawnienia Manager ani uprawnienia Ustawienia, zatrzyma cię komunikatem.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 5 listopada 2026

Najważniejsze

Moduł
Amazon
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
5 min

Co Odoo robi samo, bez klikania

Zaplanowane zadanie Amazon SP-API - Sync FBA ledger detail report (opt-in) uruchamia się raz dziennie i jest aktywne od instalacji modułu. Obsługuje tylko aktywne konta, które mają włączoną synchronizację szczegółu, i dla każdego z nich uruchamia tę samą synchronizację co przycisk.

Są różnice względem uruchomienia ręcznego: w podsumowaniu jako źródło widnieje zaplanowane zadanie zamiast ręcznego uruchomienia, podsumowanie nie jest publikowane w chatterze konta, a jeśli jedno konto zawiedzie, zadanie zostawia ostrzeżenie w logu serwera i przechodzi do następnego. Przycisk nie dokonuje takiego wyboru kont: działa na koncie, w którym go klikasz.

Przycisk jest w gałęziach Odoo 17, 18, 19 i 20 i zawsze widać go na ekranie Accounts, bez żadnych warunków.

Your Odoo doesn't talk to Amazon, Temu or Shopify?
Wideo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (wideo po angielsku)

Przypadek Casa Olivar: od menu do podsumowania

Przykład Przypadek poglądowy: firma i jej dane są zmyślone, żeby pokazać przebieg.

Casa Olivar to wymyślony sklep, który sprzedaje oliwę i konserwy przez FBA i ma konektor w Odoo 20. Marta z administracji ma uprawnienie Manager i chce przejrzeć historię zdarzeń jednego konta, nie czekając na dzienne zadanie.

  1. Wchodzi w Amazon › Configuration › Accounts i otwiera konto.
  2. W zakładce FBA Reports (opt-in), w grupie Reimbursement Claim Audit (find money Amazon owes you), znajduje się pole wyboru FBA reimbursement audit, domyślnie wyłączone. Marta chce, żeby synchronizacja przechodziła także przez audyt roszczeń konta, więc je włącza.
  3. Klika Sync FBA Ledger Detail. Akcja odpytuje Amazon, z przerwą między kolejnymi zapytaniami, aż raport się zakończy, zakończy się błędem albo wyczerpią się próby.
  4. Gdy akcja kończy się podsumowaniem, konto zapisuje datę i tekst uruchomienia i publikuje to podsumowanie w swoim chatterze.
  5. Jeśli stan raportu widoczny w podsumowaniu nie jest DONE, z tego uruchomienia nic nie jest importowane i Marta może uruchomić je ponownie później. Jeśli jest DONE, ale Amazon nie przekazuje dokumentu raportu, podsumowanie to zaznacza i również nic nie jest importowane. Jeśli dokument jest, podsumowanie dodaje, ile wierszy zawierał raport i ile z nich zostało przechwyconych, zaktualizowanych lub pominiętych.

Jej kolega Íñigo ma tylko uprawnienie Viewer: nie widzi w menu pozycji Configuration i Accounts, więc nie dociera do tego ekranu.

Następnego dnia zaplanowane zadanie robi to samo bez klikania, ale tylko na aktywnych kontach z włączoną synchronizacją szczegółu.

Schemat wykonany kodem z nazwą przycisku po hiszpańsku, niemiecku, francusku, włosku i portugalsku
Schemat wykonany kodem na podstawie opublikowanych tłumaczeń modułu, nie jest ekranem Odoo: nazwa przycisku zależnie od języka Odoo.

Co sprawdza, zanim zapyta Amazon

Ścieżka Amazon › Configuration › Accounts ma uprawnienia na każdym poziomie: Amazon wymaga Viewer, a zarówno Configuration, jak i Accounts wymagają Manager. Bez tego uprawnienia nie widzisz tych pozycji.

Po kliknięciu przycisku pierwsza jest kontrola na serwerze: jeśli nie jesteś superużytkownikiem, musisz mieć uprawnienie Manager konektora albo uprawnienie Ustawienia. Potem sprawdza, czy możesz zapisywać w tym koncie. Superużytkownik przechodzi bez kontroli grup, a zaplanowane zadanie również jej nie przechodzi, bo wywołuje synchronizację bezpośrednio.

Schemat wykonany kodem: ścieżka menu Amazon, Configuration, Accounts, przycisk Sync FBA Ledger Detail i z boku komunikat o uprawnieniach, który może go zatrzymać
Schemat wykonany kodem na podstawie kodu modułu, nie jest ekranem Odoo: menu, przycisk i komunikat, który może zatrzymać akcję.

Co robi w środku, po kolei

  1. Sprawdza uprawnienia, jak widziałeś wyżej.
  2. Pracuje z jednym kontem.
  3. Prosi Amazon o utworzenie raportu ze szczegółami księgi FBA. Jeśli Amazon nie zwróci identyfikatora raportu, akcja się zatrzymuje.
  4. Odpytuje o stan raportu, aż będzie DONE, CANCELLED lub FATAL, albo aż wyczerpią się próby. Liczbę prób i sekundy między nimi bierze z konta; jeśli nie ma wartości, kod używa dwunastu prób z dziesięciosekundową przerwą.
  5. Jeśli raport nie kończy w DONE, zapisuje datę i podsumowanie ze stanem, w którym raport został, publikuje je w chatterze i kończy bez importowania czegokolwiek.
  6. Jeśli jest w DONE, ale Amazon nie daje dokumentu raportu, robi to samo: zapisane podsumowanie, brak importu i brak liczników wierszy.
  7. Jeśli dokument jest, pobiera go i przekazuje do importu historii zdarzeń księgi konta.
  8. Jeśli FBA reimbursement audit jest włączone, synchronizacja przechodzi także przez audyt roszczeń konta.
  9. Zapisuje datę i podsumowanie oraz publikuje podsumowanie w chatterze.

Podsumowanie zawiera konto, źródło (ręczne, jeśli uruchamiasz je ty), identyfikator i stan raportu oraz, jeśli dojdzie do importu, liczbę wierszy, przechwyconych, zaktualizowanych i pominiętych.

Co zmienia się w twoim Odoo, a co nie

  • Gromadzi się historia zdarzeń księgi konta.
  • Konto zapisuje datę i podsumowanie ostatniego uruchomienia, a chatter dostaje notatkę z podsumowaniem.
  • Przy włączonym FBA reimbursement audit synchronizacja przechodzi także przez audyt roszczeń. Jego pomoc mówi, że po włączeniu synchronizacja gromadzi też zdarzenia zgubienia, uszkodzenia i odnalezienia, a audyt zestawia je ze zwrotami z rozliczeń, żeby wskazać jednostki, które Amazon jeszcze jest winien, z szacunkową wartością i terminem zgłoszenia roszczenia. To analiza tylko do odczytu.
  • Według samego kodu jest to niezależna synchronizacja, która nie rusza zapasów FBA: gromadzi tylko historię zdarzeń na potrzeby audytu zwrotów.

Komunikat, który może zatrzymać akcję

Po kliknięciu Sync FBA Ledger Detail może pojawić się ten komunikat: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Pojawia się, gdy nie jesteś superużytkownikiem i nie masz uprawnienia Manager konektora ani uprawnienia Ustawienia. Naprawia się to tak, jak mówi sam tekst: poproś osobę odpowiedzialną o nadanie ci dostępu kierownika.

Czego uczy ten przypadek

  • Dzienne zadanie synchronizuje aktywne konta z włączoną synchronizacją szczegółu; przycisk służy do ręcznego uruchomienia jej na koncie, które masz otwarte.
  • Uprawnienie jest sprawdzane przy kliknięciu, oprócz ograniczenia menu.
  • Stan raportu w podsumowaniu mówi ci, czy doszło do importu.
  • Pole wyboru FBA reimbursement audit decyduje, czy synchronizacja przechodzi także przez audyt roszczeń.

Jak pomaga FlexigoTech

FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie. Strona modułu i jego karta w Odoo Apps zawierają szczegóły zakupu. Moduł to jednorazowa opłata za wersję i wymaga subskrypcji FlexigoTech Cloud, plan Konektor (49 €/mies. lub 490 €/rok, netto (bez VAT)). Połączenie przechodzi przez FlexigoTech Cloud, który przechowuje poświadczenia w postaci zaszyfrowanej, pilnuje synchronizacji i wysyła e-mail, jeśli coś zawiedzie.

Czytaj dalej

Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła