Import wyciągów bankowych do Odoo to dopiero pierwszy krok. Prawdziwa korzyść pojawia się dopiero wtedy, gdy operację bankową można niezawodnie przypisać do właściwej faktury sprzedaży, faktury zakupu, noty kredytowej lub płatności.
Właśnie tu w Odoo 19 Community brakuje wygodnej możliwości w interfejsie użytkownika. Zaimportowane wiersze bankowe pozostają przez to najpierw na pośrednim koncie bankowym i muszą zostać przypisane do otwartej pozycji księgowej, aby można je było dalej przetwarzać.
Dlatego dla własnej instalacji Odoo 19 Community opracowaliśmy Bank Statement Matcher. Ponieważ ten problem dotyczy nie tylko nas, udostępniamy moduł bezpłatnie na GitHubie na wolnej licencji AGPL-3.
Przejdź do projektu na GitHubie:
Odoo 19 Bank Statement Matcher
Od importu wyciągu bankowego do właściwej faktury
Za pomocą naszego opublikowanego już projektu Odoo 19 Bank Statement Import można wczytywać do Odoo 19 Community różne formaty wyciągów bankowych. Należą do nich m.in. CAMT.053, CAMT.054, OFX i SWIFT MT940.
Nowy Bank Statement Matcher uzupełnia ten import o kolejny decydujący etap pracy:
Która zaimportowana operacja bankowa należy do której otwartej pozycji?
Moduł przeszukuje otwarte należności i zobowiązania, ocenia możliwe trafienia i pokazuje użytkownikom, dlaczego proponowane jest dane przypisanie. Propozycję można sprawdzić, potwierdzić, poprawić lub zastąpić ręcznym wyborem.
W ten sposób powstaje dla Odoo 19 Community spójny przebieg pracy:
zaimportować wyciąg bankowy
ustalić możliwe przypisania
sprawdzić propozycje zbiorczo
zatwierdzić jednoznaczne trafienia
niejasne przypadki opracować ręcznie
Co potrafi Odoo 19 Bank Statement Matcher
Moduł został opracowany z myślą o praktycznym zastosowaniu w księgowości. Obsługuje m.in. następujące funkcje:
wyszukiwanie pasujących faktur, faktur zakupu, not kredytowych i płatności
automatyczne ustalanie propozycji przypisania przy tworzeniu wiersza bankowego
zrozumiałe wyświetlanie zastosowanej reguły przypisania i jej pewności
ponowne wyszukiwanie w późniejszym czasie
pojedyncze przypisanie lub wspólne opracowanie kilku wierszy bankowych
ręczny wybór otwartej pozycji, gdy żadna propozycja nie pasuje
cofnięcie już dokonanego przypisania
rozpoznawanie kilku równorzędnych trafień bez arbitralnej decyzji
wskazówki o ofertach lub zamówieniach, dla których nie istnieje jeszcze otwarta pozycja księgowa
opcjonalne bezpośrednie przekazanie z importu wyciągów bankowych OCA do widoku przypisywania
polskie tłumaczenie przy angielskim kodzie źródłowym
Centralny przegląd jest w Odoo dostępny w menu Księgowość → Księgowość → Przypisywanie wierszy bankowych. Tam można wspólnie przeszukiwać i opracowywać nadal otwarte wiersze bankowe.
Przypisanie możliwe do prześledzenia zamiast czarnej skrzynki
W przypadku danych finansowych nie wystarczy zaproponować jakiekolwiek trafienie. Użytkownicy muszą móc zobaczyć, dlaczego dana operacja bankowa ma pasować do określonego dokumentu.
Bank Statement Matcher działa dlatego według jasno zdefiniowanych reguł i różnych poziomów zaufania:
| Zaufanie | Reguła | Znaczenie |
|---|---|---|
| 100 | Referencja | W opisie księgowania znaleziono numer dokumentu, referencję płatności lub referencję źródłową. |
| 80 | Partner i kwota | Partner biznesowy i otwarta kwota są zgodne. |
| 60 | Jednoznaczna kwota | Kwota dokładnie pasuje tylko do jednej otwartej pozycji. |
| 30 | Partner | Partner się zgadza, ale kwota nie; jest to tylko wskazówka. |
Dla każdego dziennika można ustalić, od jakiego poziomu zaufania jednoznaczna propozycja może zostać zatwierdzona akcją zbiorczą. Słabsze trafienia pozostają widoczne, ale trzeba je sprawdzić i potwierdzić pojedynczo.
Ważne jest przy tym: moduł nie księguje bez nadzoru w tle. Tworzy propozycje. Przypisanie następuje dopiero w wyniku świadomego działania użytkownika – pojedynczo lub w ramach kontrolowanego przetwarzania zbiorczego.
Uwzględniane są także trudne referencje bankowe
Banki nie zawsze przesyłają referencje płatności w jednolitej formie. Numer faktury może być połączony z nazwami, cyframi lub innymi danymi. Separatory mogą brakować lub być przedstawione inaczej niż w oryginalnym dokumencie.
Matcher normalizuje więc porównywane wartości i uwzględnia także przejścia między literami a cyframi. Dzięki temu referencje mogą zostać rozpoznane na przykład także wtedy, gdy w opisie bankowym zostały dołączone bezpośrednio do innych treści.
Wyszukiwanie odbywa się celowo od dokumentu Odoo do opisu bankowego. Dzięki temu unika się sytuacji, w której krótkie, ogólne ciągi cyfr z opisu księgowania prowadzą do dużej liczby niepasujących trafień.
Reguły nie są ograniczone ani do konkretnego banku, ani do konkretnego kraju, ani do sztywno ustalonego schematu numeracji. To czyni moduł interesującym także dla innych instalacji Odoo 19 Community.
Dlaczego ponowne wyszukiwanie jest ważne
Nie każdą płatność bankową można przypisać już podczas importu. W praktyce płatność może wpłynąć, zanim odpowiednia faktura zostanie utworzona lub zaksięgowana w Odoo. Także faktura zakupu lub nota kredytowa mogą zostać wprowadzone dopiero później.
Dlatego wiersze bankowe można sprawdzić ponownie w późniejszym czasie za pomocą „Szukaj ponownie”. Gdy tylko pojawi się pasująca otwarta pozycja, z wcześniej nieprzypisywalnej operacji bankowej może powstać jednoznaczne trafienie.
Jeśli opis bankowy wymienia na przykład ofertę lub zamówienie, dla którego nie istnieje jeszcze faktura, a tym samym otwarta pozycja, moduł podaje pomocną wskazówkę. Zamiast jedynie wyświetlić „brak trafienia”, zwraca uwagę, że być może najpierw trzeba utworzyć fakturę.
Bezpieczeństwo ma pierwszeństwo
Błędne automatyczne przypisanie może w księgowości spowodować więcej pracy niż otwarty wiersz bankowy. Bank Statement Matcher został więc celowo zaprojektowany ostrożnie:
Trafienia o jednakowej ocenie nie są rozstrzygane arbitralnie.
Słabe propozycje są wyświetlane, ale nie są zatwierdzane akcją zbiorczą.
Przed przypisaniem ponownie sprawdza się, czy otwarta pozycja jest nadal dostępna.
Pozycja, która została w międzyczasie rozliczona przez innego użytkownika, nie jest przetwarzana ponownie.
Każdy wiersz bankowy jest przetwarzany w ramach własnego punktu zapisu bazy danych (savepoint).
Błąd w jednym wierszu bankowym nie uniemożliwia przetwarzania wszystkich pozostałych wierszy.
Niekompletne stare dane bez prawidłowej daty księgowania są dla bezpieczeństwa wykluczane.
W ten sposób moduł wspiera automatyzację tam, gdzie oszczędza czas, i wymaga ręcznej decyzji tam, gdzie stan danych nie jest wystarczająco jednoznaczny.
Współdziałanie z naszym Bank Statement Import
Repozytorium składa się z dwóch modułów:
| Moduł | Zadanie |
|---|---|
| account_statement_matcher | Udostępnia właściwe wyszukiwanie, ocenę, sprawdzanie i przypisywanie. Wymaga tylko modułu Odoo account. |
| account_statement_matcher_import_oca | Opcjonalny pomost do importu wyciągów bankowych OCA. Po imporcie od razu otwiera się widok przypisywania z nowo zaimportowanymi wierszami. |
Opcjonalny pomost instaluje się automatycznie, gdy obecny jest zarówno Matcher, jak i moduł OCA account_statement_import_file. Import wyciągu bankowego i następujące po nim przypisywanie ściśle ze sobą współpracują.
Więcej o imporcie obsługiwanych formatów bankowych znajdą Państwo w naszym wpisie:
Odoo 19 Bank Statement Import – nasze rozszerzenia dla Odoo Community
Instalacja w Odoo 19 Community
Instalacja przebiega jak w przypadku zwykłego dodatkowego modułu Odoo:
Skopiować foldery modułów do skonfigurowanej ścieżki dodatków Odoo (addons).
Zaktualizować listę aplikacji w Odoo.
Zainstalować moduł Bank Statement Matcher.
Dla każdego dziennika bankowego ustalić, czy podczas importu mają być wyszukiwane propozycje.
Wybrać żądaną wartość minimalną dla kontrolowanego przypisywania zbiorczego.
Moduł został opracowany i przetestowany dla Odoo 19.0 Community. Przed zastosowaniem z innymi wersjami Odoo należy sprawdzić zwłaszcza zmiany w wewnętrznych funkcjach księgowości i uzgadniania.
Jak przy każdym rozszerzeniu w obszarze księgowości zalecamy, aby instalację najpierw sprawdzić w środowisku testowym na kopii własnej bazy danych i typowych wyciągów bankowych.
Bezpłatnie i open source dla społeczności Odoo
My w Biricon IT Services GmbH opracowujemy rozwiązania najpierw z myślą o konkretnych wymaganiach z naszej własnej działalności. Gdy powstaje z tego moduł nadający się do ogólnego użytku, nie chcemy ukrywać go w pojedynczej instalacji.
Odoo 19 Bank Statement Matcher jest więc dostępny bezpłatnie jako projekt open source. Kod źródłowy można przeglądać, sprawdzać, dostosowywać i rozwijać w ramach licencji AGPL-3.
Naszym celem nie jest ślepa automatyzacja jak największej liczby decyzji księgowych. Chcemy ograniczyć powtarzalną pracę i jednocześnie zadbać o to, aby przypisania finansowe pozostały możliwe do prześledzenia i kontroli.
Tak rozumiemy sensowny rozwój open source: rozwiązać rzeczywisty problem, przejrzyście udokumentować rozwiązanie i następnie udostępnić je społeczności.
Projekt, kod źródłowy i współpraca
Pełny kod źródłowy, wskazówki dotyczące instalacji i dokumentacja techniczna są dostępne na GitHubie:
Otwórz Odoo 19 Bank Statement Matcher na GitHubie
Cieszymy się z doświadczeń praktycznych, zgłoszeń błędów, propozycji ulepszeń i wkładu społeczności Odoo.
Bezpłatnie. Możliwe do prześledzenia. Open source. Dla Odoo 19 Community.