Jak AI uzgadnia utarg z terminali Polcard i eService z kasą fiskalną i kontem bankowym?

Tak, AI potrafi codziennie uzgadniać sprzedaż z terminali płatniczych Polcard i eService z raportami kasy fiskalnej i wyciągiem bankowym, zamiast robić to ręcznie w Excelu. W praktyce oznacza to, że każdego rana właściciel sieci lokali dostaje gotowe zestawienie: które terminale się zbilansowały, gdzie brakuje przelewu zbiorczego i gdzie kwota nie pasuje do kasy. Zanim jednak to zadziała, trzeba zrozumieć, skąd AI ma wziąć dane i co tak naprawdę można z tych systemów wyciągnąć.

Co tak naprawdę spływa z terminala, a co musisz sam pobrać

Terminal płatniczy rejestruje każdą transakcję: numer terminala (TID), datę i godzinę, kwotę brutto, typ karty, numer RRN (Retrieval Reference Number) i status autoryzacji. Te dane trafiają do centrum rozliczeniowego, czyli do Polcarda, eService albo PayTela. Ale do Twojego konta bankowego nie trafia przelew za każdą transakcję z osobna. Spływa jeden przelew zbiorczy, zwykle dzień lub dwa po dacie sprzedaży, z kwotą pomniejszoną o prowizję.

To pierwsze źródło nieporozumień w większości firm. Kasjerka zamknęła terminal w piątek o 23:00, raport Z z kasy pokazuje jedną kwotę, a przelew na konto przyjedzie w poniedziałek i będzie o prowizję mniejszy. Jeśli prowadzicie pięć lokali, macie pięć terminali, pięć zestawów raportów z kasy i jeden wyciąg bankowy, w którym przelewy opisane są numerem partii lub samym numerem terminala. Bez czegoś, co to połączy, łatwo zgubić dzień albo cały weekend.

Z portalu akceptanta można wyciągnąć cztery rodzaje danych:

• Raport dzienny transakcji: lista każdej płatności z TID, datą, kwotą brutto i statusem. Dostępny w zakładce "Historia transakcji" albo "Raporty dzienne".
• Zestawienie prowizji: ile potrącono za dany okres, z podziałem na typy kart i stawki prowizji interchange.
• Historia przelewów zbiorczych: data i kwota każdego przelewu na konto, z numerem partii (batch ID), który łączy przelew z transakcjami z konkretnego dnia i terminala.
• Chargebacki i reklamacje: lista transakcji zaskarżonych przez klientów, z datą otwarcia sprawy, kwotą i terminem odpowiedzi akceptanta.

Raport Z z kasy fiskalnej to osobna historia. Kasa rejestruje całą sprzedaż: gotówkę, karty, bony, płatności podzielone. Żeby uzgodnić terminal z kasą, potrzebujecie z kasy wartości samej sprzedaży bezgotówkowej za ten dzień. W zależności od modelu kasy to albo pole "karty" w raporcie dobowym, albo raport płatności z podziałem na typy. Novitus, Posnet i Elzab drukują to inaczej, ale struktura pliku eksportu jest zazwyczaj stała.

Polcard, eService i PayTel: co udostępniają, a czego nie ma

Wiele firm zaczyna od pytania: "czy jest API do Polcarda?" Odpowiedź jest prosta: dla standardowego konta akceptanta w Polsce nie ma publicznie udokumentowanego REST API, z którego można by automatycznie pobierać dane transakcyjne.

Polcard (Fiserv Polska) udostępnia portal akceptanta z możliwością ręcznego eksportu raportów w formacie CSV lub XLS. Globalna platforma Fiserv ma własne API (Fiserv Developer Studio, REST), ale to narzędzie dla banków i dużych integratorów płatniczych, nie dla akceptanta z restauracją czy siecią sklepów. Dla większych sieci Fiserv oferuje automatyczne dostarczanie raportów na serwer SFTP lub email w ustalonym cyklu. To wymaga podpisania osobnego porozumienia, ale daje automatyczny przepływ plików bez klikania w portal każdego rana.

eService (od 2023 roku część Worldline) działa podobnie: portal rozliczeń z eksportem CSV i XLS, brak publicznego API dla akceptantów, możliwość automatycznej wysyłki raportów dla klientów z umowami enterprise. W standardowym koncie eksportujecie ręcznie z zakładki "Raporty" albo "Historia rozliczeń".

PayTel: mniejszy operator, ten sam model. Portal z eksportami, brak API dla akceptantów.

Terminale z Programu Polska Bezgotówkowa: sprzęt dostarczony przez jednego z operatorów (najczęściej Polcard, eService lub BNP Paribas Polska), więc raportowanie idzie przez portal tego operatora. Sam udział w programie nic tu nie zmienia.

Legalne drogi do automatyzacji bez API:

• Eksport ręczny do CSV lub XLS, a następnie automatyczne przetwarzanie przez AI po wrzuceniu pliku do wspólnego folderu lub wysłaniu na skrzynkę.
• Negocjacja dostarczania raportów przez SFTP lub email: możliwa przy odpowiedniej wielkości klienta albo za dodatkową opłatą w umowie z operatorem.
• Niektóre systemy POS, na przykład z integracją PC-Market, StrongPoint albo Gastro POS, zbierają dane z terminali i udostępniają je przez własne API albo bazę danych. To szybsza droga niż portal akceptanta.
• Jeśli korzystacie z systemu kasowego z wbudowaną integracją płatniczą, sprawdźcie, czy ma moduł eksportu rozliczeń z podziałem na terminale i daty.

Pięć lokali i poranek księgowej: jak wygląda ten problem bez AI

Wyobraźcie sobie sieć pięciu lokali gastronomicznych w różnych miastach. Każdy lokal ma terminal Polcard i kasę fiskalną Novitus lub Posnet. W poniedziałek rano księgowa Marta siada do biurka i musi uzgodnić sprzedaż bezgotówkową z piątku, soboty i niedzieli.

Marta loguje się do portalu akceptanta Polcard i pobiera raport dzienny transakcji dla każdego z pięciu terminali z trzech dni. Piętnaście eksportów. Potem otwiera wyciąg bankowy i identyfikuje przelewy zbiorcze z opisami "POLCARD SETTLEMENT", próbując przypisać każdy do konkretnego terminala i dnia. Następnie dzwoni do menedżerów lokali albo czeka na mailem przesłane raporty Z z kas fiskalnych.

Gdzie zwykle pojawia się problem? Przelew zbiorczy z niedzieli przyjdzie we wtorek albo środę, bo terminal zamknął partię po 22:00 i przelewy z weekendu idą wolniej. Jeden z lokali miał dwie transakcje zwrotu w sobotę, które zmniejszają kwotę przelewu, ale w raporcie kasy figurują jako odrębna pozycja. W Gdańsku terminal padł na kilkanaście minut, transakcje z tego czasu przeszły offline i rozliczą się osobną partią z inną datą. Marta spędza na tym od dwóch do trzech godzin, a i tak zdarzają się błędy wychodzące przy zamknięciu miesiąca.

Co AI robi z tymi danymi każdego ranka

Gdy pliki z portalu akceptanta i wyciąg bankowy trafiają do systemu automatycznie przez SFTP albo są wrzucane ręcznie do wspólnego folderu, AI przejmuje robotę, którą dotąd robiła Marta.

Po pierwsze, AI łączy każdy przelew zbiorczy z transakcjami z portalu akceptanta po numerze partii i dacie. Sprawdza: czy suma transakcji brutto minus prowizja zgadza się z kwotą przelewu. Jeśli nie, wskazuje konkretną pozycję, która się nie domyka: transakcję zwrotu, chargeback odrzucony przez bank albo transakcję offline z inną datą rozliczenia niż data sprzedaży.

Po drugie, AI porównuje sumę płatności bezgotówkowych z raportu Z kasy fiskalnej z sumą transakcji z terminala za ten sam terminal i dzień. Typowa rozbieżność: kasa pokazuje całą płatność kartą, a terminal widzi tę samą płatność z innym znacznikiem czasu, bo kasjer autoryzował kartę przed wystawieniem paragonu. AI zaznacza rozbieżności powyżej ustalonego progu i pokazuje je do weryfikacji.

Po trzecie, raport dla właściciela sieci. Zamiast przeglądania piętnastu plików, właściciel dostaje rano jedną tabelę:

• Kraków: OK, przelew zbiorczy z piątku wpłynął w sobotę, kwota zgodna z raportem.
• Gdańsk: brak przelewu zbiorczego z niedzieli, termin oczekiwany wtorek do 12:00.
• Warszawa-Centrum: rozbieżność 143 zł między kasą a terminalem z soboty, do wyjaśnienia z menedżerem.
• Wrocław: chargeback otwarty na transakcję z 24.10, termin odpowiedzi do 10.11, dokumenty do przygotowania.
• Warszawa-Wola: wszystko zgodne.

Cztery lokale zielone, jeden do sprawdzenia, jeden chargeback do pilnowania. Marta zamiast trzech godzin spędza kwadrans na wyjaśnieniu tej jednej rozbieżności.

Chargebacki i brakujące przelewy: tu AI naprawdę pomaga

Chargeback to dla wielu właścicieli lokali gastronomicznych temat, który odkrywają za późno. Klient składa reklamację w swoim banku, bank obciąża akceptanta, Polcard albo eService wysyła powiadomienie do portalu i od tego momentu biegnie termin odpowiedzi: zazwyczaj kilkanaście dni roboczych. Jeśli nie odpiszecie z dowodem sprzedaży, przegrywacie automatycznie. Dowód to paragon, wydruk z terminala albo log transakcji z numerem RRN.

AI podpięte do portalu akceptanta sprawdza sekcję "Reklamacje" albo "Chargebacki" przy każdym pobraniu danych i od razu oznacza nowe sprawy z datą otwarcia i datą terminu. Przy sieci pięciu lokali zdarzają się miesiące z kilkoma chargebackami naraz i bez pilnowania któryś przepada.

Brakujące przelewy to drugi scenariusz. Przelew zbiorczy powinien przyjść w konkretnym oknie: standardowo T+1 albo T+2 po zamknięciu terminala, zależnie od umowy i godziny zamknięcia partii. AI wie, kiedy terminal zamknął partię, i wie, kiedy przelew powinien przyjść. Jeśli do rana kolejnego dnia nie ma przelewu na wyciągu, wysyła alert. Bez tego łatwo stwierdzić po tygodniu, że za środę nie przyszły pieniądze, bo terminal był odłączony od internetu i partia nigdy nie została wysłana.

Realny koszt prowizji per lokal to jeszcze jedno zestawienie, które AI robi automatycznie co miesiąc. Suma potrąconych prowizji podzielona przez sumę sprzedaży bezgotówkowej daje efektywną stawkę prowizji dla każdego lokalu. Jeśli jeden lokal odbiega od reszty, może to oznaczać inną strukturę kart (więcej kart premium, firmowych, zagranicznych, które mają wyższe stawki interchange) albo błąd w konfiguracji terminala lub umowy.

Jak AI przygotowuje dane do księgowania

Dla biura rachunkowego albo działu księgowości praca z pięcioma terminalami i jednym wyciągiem bankowym to układanka: który przelew zbiorczy dotyczy którego lokalu, jak rozdzielić prowizję na centra kosztów, jak zaksięgować chargeback, który może cofnąć się i wrócić jako wpływ.

AI może przygotować plik importu do programu finansowo-księgowego, na przykład Comarch ERP Optima, Subiekt GT czy Symfonia, z gotową strukturą dekretów. Każda transakcja sprzedażowa idzie na właściwe konto przychodów, prowizja na konto kosztów, przelew zbiorczy na rozliczenie. Format zależy od programu, ale strukturę można ustawić raz i potem AI generuje go codziennie albo raz w tygodniu.

Typowy plik wynikowy: CSV albo XML z polami: data transakcji, data rozliczenia, numer terminala, numer lokalu, kwota brutto sprzedaży, kwota prowizji, kwota przelewu zbiorczego, numer partii, status uzgodnienia. Biuro rachunkowe dostaje plik gotowy do importu, a nie tabele do ręcznego przepisywania.

Od czego zacząć integrację terminali z AI

Zanim cokolwiek zautomatyzujecie, sprawdźcie trzy rzeczy.

Pierwsza: czy macie dostęp do portalu akceptanta ze spójnym widokiem wszystkich terminali. Jeśli każdy lokal ma osobne konto w portalu Polcard albo eService, zacznijcie od poproszenia operatora o konto agregujące dla właściciela sieci. Polcard ma w portalu akceptanta funkcję dostępu wielolokalizacyjnego, eService podobnie na koncie głównym. Bez tego każdy eksport to osobne logowanie i osobny plik.

Druga: format eksportów. Sprawdźcie, czy raporty z portalu akceptanta wychodzą w formacie CSV ze stałą strukturą kolumn. Zdarza się, że po aktualizacji portalu układ kolumn się zmienia i wtedy mapowanie AI musi być zaktualizowane. Lepiej trzymać eksporty w oryginale i dopiero AI je interpretuje, niż budować kruche sztuczne mapowania.

Trzecia: raporty Z z kas fiskalnych. Skąd płyną? Przez email, przez chmurę kasy (Novitus Cloud, Posnet Online), przez system POS, przez ręczne skanowanie? To drugie źródło danych i musi trafiać do tego samego miejsca co raporty z terminala.

Gdy macie odpowiedzi na te trzy pytania, integracja wygląda konkretnie: albo eksporty lądują automatycznie na SFTP i AI je pobiera, albo ustalony pracownik wrzuca pliki raz dziennie do folderu na serwerze, a AI robi resztę. Jedno spotkanie wstępne i konfiguracja na kilka godzin.

Chcecie zobaczyć, jak to działa na Waszych danych z Polcarda albo eService? 15 minut rozmowy wystarczy, żeby ocenić, czy Wasz format eksportów nadaje się do automatyzacji od razu, czy trzeba coś ustandaryzować. Możecie też zajrzeć na realne wdrożenia, żeby zobaczyć, jak podobne firmy przeprowadziły ten proces.