Połączenia bankowe

Niniejszy przewodnik opisuje aktywne połączenie z bankiem w standardzie PSD2 open banking: sposób podłączenia, wiązanie kont bankowych z księgą główną, konfigurowanie szablonu importu w celu automatycznego tworzenia partnerów, dopasowywania faktur i księgowania opłat przy każdej synchronizacji, a także strukturę zwracanych danych. Szczegóły techniczne API znajdują się w sekcji Importy z banków i płatności. W przypadku plików wyciągów zamiast aktywnego połączenia zobacz Importowanie wyciągów bankowych (camt.053).

1. Podłączenie banku

W sekcji Bank → Połączenia wybierz kraj i kliknij Pokaż banki. Wybierz swój bank oraz typ właściciela konta (firma lub osoba prywatna), a następnie kliknij Połącz. Zostaniesz przekierowany na stronę autoryzacji banku, gdzie należy się zalogować i zatwierdzić dostęp; bank następnie przekieruje Cię z powrotem do Nordlet. Połączenie pojawi się na liście wraz z datą wygaśnięcia zgody. Zgody są ograniczone czasowo przez bank (najczęściej na 90 lub 180 dni) i po ich wygaśnięciu należy ponownie nawiązać połączenie.

Lista banków pochodzi od dostawcy usługi open banking skonfigurowanego dla danej instancji Nordlet. Jeśli dla danego kraju nie ma widocznych banków, oznacza to, że dostawca jeszcze go nie obsługuje.

2. Powiązanie kont bankowych

W ramach połączenia każde udostępniane przez bank konto jest wymienione wraz z numerem IBAN i walutą. Dla każdego z nich wybierz istniejące konto bankowe z planu kont lub kliknij Utwórz nowe konto bankowe, opcjonalnie ustaw datę początkową synchronizacji i kliknij Powiąż. Synchronizowane są wyłącznie powiązane konta. Bez podania daty początkowej pierwsza synchronizacja pobierze dane z ostatnich 90 dni.

3. Utworzenie szablonu importu

W sekcji Bank → Szablony importu kliknij Nowy szablon importu, wybierz typ Połączenie bankowe i nadaj mu nazwę. Wiersze reprezentują atrybuty zwracane przez strumień bankowy dla każdej transakcji. Pole Wymagane w pliku jest zachowane dla kompletności struktury, jednak aktywny strumień danych nie jest z nim weryfikowany.

Konto w księdze głównej. Zwykły wiersz kwoty transaction_amount.amount oraz wiersze reguł można przypisać do konta w księdze głównej. Każda zsynchronizowana transakcja utworzona z przypisanego wiersza jest od razu księgowana i oznaczana jako sparowana z zapisem w dzienniku. Wiersze reguł wybierają transakcje na podstawie kodu transakcji bankowej lub strony operacji:

Wiersz	Kryterium wyboru	Typowe konto
Opłaty bankowe (kod CHRG)	transakcje, których rodzina kodów to CHRG	koszt prowizji bankowych (konto 6800 w planie standardowym)
Odsetki (kod INTR)	rodzina kodów INTR	przychody lub koszty finansowe
Podatki (kod TAXE)	rodzina kodów TAXE	płatności podatkowe
Inne wydatki	dowolne inne obciążenie	pozostaw opcję „Nieaksięgowane”, aby płatności zostały sparowane z fakturami zakupowymi
Inne wpływy	dowolne inne uznanie	pozostaw opcję „Nieaksięgowane”, aby wpływy zostały sparowane z fakturami sprzedaży
transaction_amount.amount	każda transakcja nieobjęta regułami	zazwyczaj „Nieaksięgowane”

Transakcja jest księgowana na konto przypisane do pierwszego pasującego wiersza: najpierw według rodziny kodów, następnie według strony operacji, a na końcu według zwykłego wiersza kwoty. Kod pochodzi z pola bank_transaction_code przekazywanego przez bank; w przypadku banków, które go nie przesyłają, wiersze oparte na kodach pozostają niesparowane.

Tworzenie brakujących klientów / dostawców. Zaznacz opcję Utwórz brakujących klientów przy wierszu debtor.name, aby dla każdego nierozpoznanego płatnika wpływu utworzyć kartotekę klienta, oraz Utwórz brakujących dostawców przy wierszu creditor.name dla każdego nierozpoznanego odbiorcy wypływu. Partnerzy są rozpoznawani na podstawie numeru IBAN (debtor_account.iban / creditor_account.iban, zapisanego na kontach bankowych partnera), a następnie na podstawie dokładnej nazwy; partner znaleziony po nazwie ma uzupełniany numer IBAN. Nowy partner jest traktowany jako firma, jeśli jego nazwa zawiera formę prawną (UAB, MB, SIA, GmbH, Ltd itd.), lub jako osoba fizyczna w pozostałych przypadkach.

Tworzenie partnera dla banku. Zaznacz tę opcję w wierszu reguły opłat bankowych. Synchronizacja utworzy dostawcę o nazwie powiązanego banku i będzie rejestrować każdą opłatę w dzienniku z przypisaniem do tego partnera.

Powiąż faktury za pomocą tego pola. Zaznacz tę opcję przy wierszu remittance_information lub reference_number. Każda nowa transakcja, której opis lub numer referencyjny zawiera numer otwartej wystawionej faktury sprzedaży (wpływ) lub zarejestrowanej faktury zakupowej (wypływ), zostaje z nią sparowana, a płatność zostaje zaksięgowana. Jeśli płatnik jest znanym partnerem (rozpoznanym po zapisanym numerze IBAN, dokładnej nazwie lub kodzie), faktura musi należeć do tego partnera. Płatność od nieznanego płatnika jest parowana tylko wtedy, gdy odpowiada pozostałemu saldu, a numer faktury zawiera jej prefiks serii. Płatność przekraczająca pozostałe saldo nigdy nie jest parowana. Transakcje niespełniające tych warunków pozostają niesparowane do ręcznego dopasowania. Opcja Twórz faktury zaliczkowe dla niesparowanych wpłat przychodzących przekształca niesparowaną wpłatę od znanego partnera w wystawioną fakturę zaliczkową na tę kwotę, datowaną na dzień płatności, z zastosowaniem wskazanej stawki VAT lub wybranego pozycji cennikowej; opcja ta wymaga włączenia funkcji Utwórz brakujących klientów, aby partner był znany.

Zapisz szablon.

4. Zastosowanie szablonu i wybór harmonogramu

Wróć do sekcji Bank → Połączenia. Dla każdego powiązanego konta dostępne jest pole wyboru szablonu oraz harmonogramu. Wybierz szablon, ustaw harmonogram (Synchronizuj ręcznie, Synchronizuj codziennie, Synchronizuj co tydzień lub Synchronizuj co miesiąc) i kliknij Zastosuj. Powiązane konto bez przypisanego szablonu nadal pobiera dane, ale wyłącznie je rejestruje; żadne księgowania, parowania ani tworzenia obiektów nie są wykonywane.

W przypadku harmonogramu dziennego, tygodniowego lub miesięcznego API wykonuje synchronizację automatycznie: co godzinę system wyszukuje konta, których czas od ostatniej synchronizacji przekracza dany okres (24 godziny, 7 dni lub 30 dni) i synchronizuje je dokładnie tak samo, jak w przypadku opcji Synchronizuj teraz, uruchamiając następnie przypisany szablon. Synchronizacja zaplanowana wlicza się do limitu użycia w taki sam sposób jak synchronizacja ręczna (każde 10 pobranych transakcji = jedno żądanie). Jeśli bank odrzuci synchronizację, na przykład z powodu wygaśnięcia zgody, połączenie zostanie oznaczone błędem i pomijane do momentu ponownego podłączenia.

5. Synchronizacja

Kliknij Synchronizuj teraz przy połączeniu. Nordlet pobiera nowe zaksięgowane transakcje dla każdego powiązanego konta; transakcje w toku są pomijane do momentu ich zaksiegowania przez bank. System pobiera dane od czasu ostatniej synchronizacji (z uwzględnieniem jednotygodniowego okresu nakładania się, aby nie ominąć późnych zaksięgowań), rejestruje je jednokrotnie (transakcje są rozpoznawane po referencji wpisu bankowego), a następnie uruchamia szablon konta. Podsumowanie operacji informuje, ile transakcji zaimportowano, a ile już istniało; poprzez API synchronizacja zwraca również liczbę utworzonych zapisów księgowych, utworzonych partnerów, powiązanych i utworzonych faktur, sparowanych płatności oraz ostrzeżenia dotyczące płatności, których nie udało się sparować.

Synchronizacje można wywoływać za pomocą API (bank/feeds/sync) według harmonogramu; każde 10 pobranych transakcji liczy się jako jedno żądanie API.

6. Gdzie szukać wyników

• Bank → Transakcje - wszystkie zsynchronizowane transakcje z podziałem na zakłady dla poszczególnych kont; sparowane pozycje zawierają linki do faktur lub zapisów w dzienniku.
• Faktury - faktury zaliczkowe utworzone dla niesparowanych wpłat.
• Partnerzy - utworzeni klienci i dostawcy, każdy z numerem IBAN w sekcji kont bankowych.
• Księga główna → Dziennik - księgowania opłat (z bankiem jako partnerem), odsetek, podatków i płatności.

W przypadku awarii połączenia

Nieudana synchronizacja oznaczy połączenie komunikatem o błędzie zwróconym przez bank. Wygaśnięcie zgody to najczęstsza przyczyna: kliknij ponownie Połącz dla tego samego banku i zatwierdź dostęp; powiązane konta i ich szablony zostaną zachowane. Opcja Rozłącz usuwa połączenie i powiązania kont, ale nie wpływa na wcześniej zarejestrowane transakcje.