Publikacja · enfino.pl
Od zgody do uzgodnienia: bezpieczny obieg płatności z KSeF
Poznaj praktyczny sposób łączenia danych KSeF i bankowych API: od zgód i kontroli faktur po obsługę wyjątków oraz uzgadnianie płatności.
Sprawdzanie dostępności głosu lokalnego…
Zacznij od procesu, nie od integracji
Połączenie danych z KSeF z informacjami bankowymi ma sens dopiero wtedy, gdy firma wie, który problem chce rozwiązać. Czy chodzi o skrócenie czasu od otrzymania faktury do przygotowania przelewu, ograniczenie ręcznego przepisywania danych, czy szybsze wykrywanie niezgodności? Każdy cel wymaga innych reguł i uprawnień. Przed wyborem dostawcy opisz obecny obieg: kto odbiera fakturę, kto sprawdza kontrahenta, kto zatwierdza zobowiązanie, kto zleca płatność i kto księguje wyciąg.
Następnie wskaż punkty kontrolne. Przykładowo faktura może być pobrana automatycznie, ale płatność pozostaje wstrzymana do czasu potwierdzenia zamówienia przez pracownika. To rozdziela automatyzację danych od decyzji finansowej. Unikaj założenia, że samo pojawienie się faktury w systemie oznacza, iż należy ją opłacić. Dane dokumentu są wejściem do procesu, a nie samodzielną autoryzacją zobowiązania.
Ustal źródło prawdy dla każdej informacji
W integracji łatwo pomylić dane faktury z danymi płatniczymi. Dokument ustrukturyzowany może dostarczać m.in. identyfikator, kwoty, terminy i dane stron, natomiast bankowe API może udostępniać informacje o rachunku, saldzie lub statusie operacji zależnie od usługi, banku i zakresu zgody. Zanim zbudujesz mapowanie, zdecyduj, które źródło jest nadrzędne dla konkretnego pola i co zrobić przy rozbieżności.
Praktyczna tabela mapowania powinna zawierać nazwę pola, źródło, format, regułę walidacji, właściciela i sposób obsługi braku danych. Dla przykładu system może porównać rachunek zapisany w danych dostawcy z rachunkiem przechowywanym w kartotece firmy, lecz nie powinien po cichu zastępować jednego drugim. Zmiana rachunku, niezgodna kwota albo nieczytelny termin powinny kierować dokument do kolejki wyjątków. Format i aktualność wymagań KSeF, specyfikacji API oraz procedur bankowych trzeba zweryfikować przed wdrożeniem i ponownie po zmianach tych usług.
Zgody PSD2 zaprojektuj jako element operacyjny
Dostęp przez otwarte API bankowe nie jest bezterminowym, nieograniczonym upoważnieniem do dowolnych operacji. Dostępny zakres, czas obowiązywania zgody i sposób ponownego uwierzytelnienia zależą od usługi, banku oraz obowiązujących zasad. Dlatego zapisz, kto może zainicjować połączenie, do jakiego rachunku i celu, jak użytkownik rozpoznaje zakres zgody oraz kto reaguje, gdy dostęp wygasa lub zostaje odwołany.
Wybierając rozwiązanie, sprawdź widoczność statusu zgody, powiadomienia o problemach, procedurę odnowienia oraz możliwość odebrania dostępu. Przetestuj scenariusz, w którym token traci ważność w trakcie uzgadniania płatności: proces powinien zatrzymać się czytelnie, bez tworzenia pozornie potwierdzonego wyniku. Nie wpisuj haseł bankowych do własnej aplikacji i nie traktuj pozytywnej odpowiedzi technicznej jako dowodu, że transakcja została rozliczona. Zakres zgodności danego dostawcy i model prawny należy sprawdzić w dokumentacji oraz u właściwych specjalistów; sam opis marketingowy nie stanowi potwierdzenia.
Automatyzuj przygotowanie, zachowaj kontrolę nad zleceniem
Bezpieczny wariant często zaczyna się od automatycznego przygotowania płatności, a nie od bezwarunkowego wysyłania przelewów. System może pobrać dane faktury, sprawdzić kompletność pól, zestawić je z zamówieniem i przygotować propozycję płatności. Osoba uprawniona zatwierdza ją w banku lub w uzgodnionym procesie. Dopiero po potwierdzeniu statusu transakcji rozwiązanie oznacza fakturę jako opłaconą albo rozpoczyna dalsze uzgodnienie.
Ustal progi i wyjątki: druga akceptacja dla wysokich kwot, blokada przy nieznanym rachunku, wstrzymanie duplikatu oraz osobna ścieżka dla faktur korygujących. Przykład z praktyki: dwie faktury o podobnej kwocie i tym samym dostawcy mogą dotyczyć różnych zamówień; automatyczne dopasowanie wyłącznie po kwocie grozi błędem. Użyj kilku kryteriów, takich jak identyfikator dokumentu, kontrahent, waluta, termin i referencja zamówienia. Reguły testuj na kopii procesu, obejmując odrzucenie i ponowienie płatności, a nie tylko przypadek idealny.
Zaprojektuj uzgadnianie i obsługę wyjątków
Status faktury i status płatności to różne informacje. Dokument może być przyjęty, lecz niezatwierdzony; przelew może być zlecony, ale jeszcze niezaksięgowany; płatność może też wrócić lub zostać odrzucona. Model danych powinien rozróżniać te etapy, zapisywać czas aktualizacji i wskazywać źródło statusu. Nie nadpisuj poprzedniego stanu bez śladu audytowego, bo utrudnia to wyjaśnienie, dlaczego dokument uznano za rozliczony.
Przygotuj kolejkę wyjątków z konkretnymi powodami, np. „rachunek różni się od kartoteki”, „brak referencji” albo „status banku niepotwierdzony”. Każdy wyjątek powinien mieć właściciela, termin reakcji i możliwą decyzję: popraw dane, poproś o wyjaśnienie, odrzuć dopasowanie lub ponów pobranie statusu. Uzgadnianie powinno uwzględniać częściowe płatności, zbiorcze przelewy, zwroty i korekty, jeśli występują w firmie. Najpierw przeanalizuj rzeczywiste próbki i ustal reguły księgowe z zespołem finansowym; nie zakładaj, że każdy bank przekazuje identyczny zestaw pól.
Wybierz dostawcę i wdrażaj etapami
Porównuj rozwiązania według kryteriów możliwych do sprawdzenia: obsługiwane banki i rachunki, zakres odczytu oraz inicjowania operacji, sposób zarządzania zgodami, dzienniki zdarzeń, eksport danych, obsługa błędów, procedura zmiany dostawcy i czas reakcji wsparcia. Poproś o demonstrację scenariuszy nieudanych: wygasłej zgody, braku odpowiedzi banku, faktury z niezgodnym rachunkiem i odrzuconego przelewu. Ustal także, jak przechowywane są dane, kto ma do nich dostęp i jak długo są zachowywane; weryfikację prawną i bezpieczeństwa powierz odpowiednim osobom.
Uruchom pilotaż na ograniczonej grupie rachunków i dokumentów, początkowo bez automatycznego zatwierdzania płatności. Mierz liczbę ręcznych korekt, czas obsługi wyjątków, błędne dopasowania oraz zgodność statusów systemu z potwierdzeniami bankowymi. Po każdym cyklu popraw reguły i udokumentuj decyzje. Dopiero gdy wyniki pilotażu są stabilne, rozszerz zakres i rozważ kolejne kroki automatyzacji. Przed startem sprawdź aktualną dokumentację KSeF, API banku, warunki dostawcy oraz wewnętrzne procedury — dostępność funkcji i wymagania mogą się zmieniać.