Przejdź do głównej treści
GoCardless

GoCardless i automatyzacja płatności: co centralizuje Odoo dzięki konektorowi

Dzięki konektorowi GoCardless Odoo uruchamia każde pobranie płatności na podstawie mandatu klienta, a Odoo 20 importuje rozliczenia samo: zaplanowane zadanie pobiera je codziennie, razem z prowizjami i podziałem, a drugie zadanie działa co godzinę.

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

Najważniejsze

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
4 min

Jeśli korzystasz z GoCardless i nie masz jeszcze Odoo, musisz wiedzieć, gdzie trafia każde rozliczenie wypłacane przez GoCardless. Dzięki konektorowi (karta w Odoo Apps) Odoo 20 zapisuje kartę dla każdego rozliczenia: kwotę, potrącone prowizje, datę wpływu, odnośnik, status i typ, a także jego podział.

Karta rozliczenia GoCardless w Odoo, z datą wpływu, statusem paid, kwotą netto, potrąconymi prowizjami, łączną liczbą pozycji, różnicą równą zero, podziałem na płatności i przyciskiem Post to accounting
Karta rozliczenia w trybie testowym, z danymi demonstracyjnymi wymyślonej siłowni i interfejsem w języku angielskim: data wpływu, kwota netto, prowizje, różnica równa zero, podział na płatności z prowizją każdej z nich i przycisk Post to accounting.

Co zawiera każde rozliczenie

Gdy moduł importuje nowe rozliczenie, tworzy jego kartę z kwotą, potrąconymi prowizjami, datą wpływu, odnośnikiem, statusem i typem podanymi przez GoCardless, w walucie rozliczenia. Następnie pobiera jego podział. Każda karta jest powiązana z kontem GoCardless, z którego pochodzi.

Import zwraca tylko te rozliczenia, które faktycznie utworzył. Jeśli import zostanie uruchomiony ponownie, to, co już istniało, nie jest liczone jako nowe: licznik nie zalicza dwa razy tych samych pieniędzy.

How to stop copy-pasting between apps (Odoo)
Wideo: How to stop copy-pasting between apps (Odoo) (wideo po angielsku)

Dwa zaplanowane zadania, aktywne po instalacji

Po instalacji modułu aktywne są dwa zaplanowane zadania:

  • GoCardless: import payouts działa raz dziennie.
  • GoCardless: recover missed events działa co godzinę.

Pierwsze z nich pobiera rozliczenia. Przechodzi przez konta GoCardless, z których może korzystać, a na końcu liczy, ile rozliczeń zaimportowało, i zapisuje błędy wraz z ich typem i stałym kodem.

Jak automatyzuje się pobieranie płatności

Pobranie płatności także uruchamia Odoo, na podstawie mandatu podpisanego przez klienta. Gdy klient płaci przez GoCardless i autoryzuje mandat, moduł zapisuje go jako metodę płatności i pobiera z niego płatność. Potem za każdym razem, gdy Odoo obciąża tę zapisaną metodę, na przykład przy rejestrowaniu płatności faktury albo przy odnowieniu subskrypcji w Odoo, moduł wysyła pobranie do GoCardless ze stałym kluczem. Jeśli GoCardless nie odpowie na to żądanie, zaplanowane zadanie uruchamiane co godzinę wysyła je ponownie z tym samym kluczem, więc płatność zostaje pobrana tylko raz. To, co przychodzi potem, czyli rozliczenia, sprowadza codzienne zaplanowane zadanie.

Ścieżki konektora w porównaniu

SytuacjaCo robi konektorSzczegóły
CodziennieZadanie GoCardless: import payouts przechodzi przez konta, z których można korzystać, i pobiera ich rozliczeniaAktywne po instalacji
Co godzinęDziała zadanie GoCardless: recover missed eventsAktywne po instalacji
Konto niepołączone, ze środowiskiem innym niż środowisko jego tokenu albo wykryte jako kopiaZadanie go nie wywołujePowtarzałoby tylko ten sam wyjątek przy każdym uruchomieniu
Nowe rozliczenieTworzy kartę z kwotą, potrąconymi prowizjami, datą wpływu, odnośnikiem, statusem i typem oraz pobiera jej podziałLiczy się jako zaimportowane
Rozliczenie już zaimportowaneAktualizuje status i datę wpływuNie liczy się jako nowe; jeśli nie ma podziału, pobiera go ponownie
Rozliczenie w zarchiwizowanej walucieReaktywuje walutęOdoo nie zatwierdza zapisu w zarchiwizowanej walucie
Rozliczenie w walucie nieznanej OdooPomija jeZostaje to odnotowane w dzienniku technicznym
Wiele rozliczeńPodąża za kursorem GoCardless, strona po stronieImport początkowy nie gubi najstarszych
Jedno konto zawodziZapisuje błąd i przechodzi do pozostałychZapisuje typ błędu i stały kod
GoCardless ogranicza tempo zapytańCzeka i ponawia próbę ograniczoną liczbę razyJeśli ponowienia się wyczerpią, liczy się to jako błąd tego konta

Szczegóły poszczególnych przypadków

Rozliczenie oczekujące może się później zmienić

Rozliczenie zaimportowane, gdy było jeszcze oczekujące, może zostać odrzucone lub wypłacone później. Dlatego gdy rozliczenie już istnieje, moduł nie tworzy kolejnego: aktualizuje jego status i datę wpływu. Pozostanie przy pierwszym statusie pozwoliłoby zaksięgować w banku jako otrzymaną płatność, która została odrzucona.

Jeśli wcześniejszy import utworzył nagłówek, ale nie udało się pobrać podziału, kolejny pobierze go ponownie. Bez tego kroku rozliczenie byłoby niezgodne i niemożliwe do zaksięgowania.

Błąd na jednym koncie nie wstrzymuje pozostałych

Zadanie wywołuje tylko te konta GoCardless, które są połączone, działają w środowisku swojego tokenu i nie są kopią. Jeśli konto zwróci błąd, zadanie go zapisuje i przechodzi do następnego. Błąd jest zapisywany z typem i stałym kodem, nigdy z identyfikatorem GoCardless ani jego tekstem.

Pełny import początkowy

GoCardless dostarcza rozliczenia stronami. Moduł podąża za kursorem, aż się skończą, ponieważ zatrzymanie się na pierwszej stronie spowodowałoby po cichu utratę wszystkich starszych rozliczeń w imporcie początkowym.

Zarchiwizowane waluty

Odoo zawiera wszystkie waluty, ale nieużywane pozostawia zarchiwizowane. Jeśli GoCardless wypłaca w jednej z nich, moduł ją reaktywuje, ponieważ pieniądze wpłynęły w tej walucie i muszą być dostępne w księgowości. Jeśli waluta nie istnieje w Odoo, rozliczenie jest pomijane.

Limit zapytań

Jeśli GoCardless ogranicza tempo zapytań, moduł czeka i próbuje ponownie, ale tylko ograniczoną liczbę razy. Jeśli nadal się nie uda, zadanie zapisuje błąd tego konta, z jego typem i stałym kodem, i przechodzi do pozostałych.

Jak pomaga FlexigoTech

Jeśli nie korzystasz jeszcze z Odoo, FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie: możemy uruchomić Odoo i skonfigurować działanie konektora GoCardless. Moduł znajdziesz na karcie w Odoo Apps i na stronie konektora. Konektor działa w ramach subskrypcji FlexigoTech Cloud.

Czytaj dalej

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

Źródła

  • Kod modułu: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
  • Kod modułu: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
  • flexigotech.com/en/services.html
  • Kod modułu: flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py