Integracja agentów AI z Optimą, wFirmą, Symfonią i Fakturownią (co realnie da się zautomatyzować, a co zostanie ręczną pracą)

Nie zaczynałbym projektu integracji agenta AI z systemem księgowym od wyboru modelu językowego czy promptów. Zaczynam od dokumentacji API systemu, z którym trzeba się zintegrować, i to zwykle jest najbardziej rozczarowujący dzień całego wdrożenia. Klient przychodzi z wizją agenta, który samodzielnie księguje faktury, sprawdza salda i odpowiada na maile z pytaniami o płatności, a po godzinie czytania dokumentacji API okazuje się, że jeden z tych czterech systemów w ogóle nie ma pełnego API dla modułu, który klienta interesuje. Tylko eksport pliku raz na dobę.

Największa bariera to nie AI, to architektura systemów księgowych

Polskie systemy księgowe powstawały w innej erze niż SaaS-owe narzędzia zagraniczne budowane od zera pod integracje. Comarch Optima to historycznie aplikacja desktopowa na bazie Firebird, do której API dopisano później, jako osobny, płatny moduł. Symfonia to w praktyce kilka różnych produktów o różnym poziomie otwartości, w zależności od tego, czy mówimy o wersji dla małych firm czy o Symfonii ERP. wFirma i Fakturownia, jako systemy stworzone później i od razu jako aplikacje webowe, mają zwykle lepiej udokumentowane REST API, ale i tu zdarzają się limity zapytań, które w praktyce blokują agenta działającego w czasie rzeczywistym na dużej liczbie dokumentów.

Efekt jest taki, że przed każdym wdrożeniem robimy coś w rodzaju audytu technicznego: co system rzeczywiście udostępnia przez API, co tylko przez plik JPK czy XML, jakie są limity zapytań na godzinę czy dobę, i czy dostęp do API jest wliczony w licencję, czy trzeba dokupić osobny pakiet. To ostatnie bywa zaskoczeniem, bo koszt integracji z systemem księgowym często nie jest kosztem pracy programisty, tylko kosztem licencji, którą trzeba dołożyć do abonamentu klienta.

Co da się zautomatyzować w praktyce, system po systemie

Poniżej opisuję to z perspektywy tego, co realnie testowaliśmy przy wdrożeniach, nie z perspektywy marketingowej dokumentacji producenta. Marketing mówi „pełne API", rzeczywistość bywa skromniejsza.

Comarch Optima

Optima ma REST API (Comarch API Management), ale to osobna licencja, którą trzeba wykupić niezależnie od standardowego abonamentu, i to jest pierwszy koszt, o którym klienci zwykle nie wiedzą, dopóki nie zapyta ich integrator. Po jej włączeniu agent AI może odczytywać i zapisywać dokumenty sprzedaży i zakupu, kontrahentów, płatności, stany magazynowe. To wystarcza do sporej części automatyzacji: agent może samodzielnie wczytać faktury kosztowe z OCR, dopasować kontrahenta, zaproponować kategorię kosztu i wpisać dokument do bufora, gdzie księgowy tylko zatwierdza. Problem zaczyna się w miejscach bardziej niszowych: część modułów kadrowo-płacowych i część operacji związanych z deklaracjami jest w API ograniczona albo w ogóle niedostępna, więc trzeba tam sięgać po inne metody. Limity zapytań w Optimie bywają dotkliwe przy dużych bazach danych, więc agent przetwarzający kilkaset dokumentów dziennie musi mieć kolejkowanie i retry, inaczej po prostu się wywali w środku dnia.

wFirma

To jeden z systemów, gdzie integracja idzie najprzyjemniej. wFirma ma dobrze udokumentowane REST API dostępne w ramach standardowego abonamentu, bez dodatkowej licencji, plus webhooki dla części zdarzeń, na przykład nowej faktury czy zmiany statusu płatności. To oznacza, że agent AI może działać reaktywnie: coś się zmienia w systemie, webhook wywołuje agenta, agent robi swoją część pracy (np. wysyła powiadomienie klientowi, generuje przypomnienie o płatności, aktualizuje CRM) bez potrzeby odpytywania systemu co pięć minut. Limity zapytań są, jak w każdym API, ale przy typowej skali małej i średniej firmy rzadko są realnym problemem. Ograniczeniem jest raczej zakres funkcjonalny: nie każdy proces księgowy da się w pełni zautomatyzować przez API, część rzeczy (np. korekty specyficznych deklaracji) wciąż wymaga wejścia w panel.

Symfonia

Tutaj trzeba być precyzyjnym, bo pod nazwą „Symfonia" kryje się kilka różnych produktów o różnym poziomie otwartości. Wersje dla mniejszych firm bywają znacznie bardziej zamknięte niż Symfonia ERP kierowana do większych organizacji. W praktyce część integracji z Symfonią, które realizowaliśmy, opierała się nie na żywym API, a na eksporcie i imporcie plików XML albo na integracji przez bazę danych po stronie klienta (gdy licencja i infrastruktura na to pozwalały). To jest integracja dużo mniej elegancka: działa wsadowo, raz czy kilka razy dziennie, nie w czasie rzeczywistym, i wymaga dodatkowego procesu, który plik odbierze i przetworzy. Dla klientów pytających „czy agent AI może mi w Symfonii automatycznie zaksięgować faktury w momencie ich otrzymania" odpowiedź bywa: nie w czasie rzeczywistym, tylko w cyklach, które ustawi harmonogram.

Fakturownia

Fakturownia z całej czwórki ma najbardziej otwarte API: REST, dostępne bez dodatkowej licencji, z dobrą dokumentacją i webhookami na większość zdarzeń. To sprawia, że jest ulubionym systemem do budowania automatyzacji od zera, szczególnie w e-commerce i małych firmach usługowych. Limity zapytań istnieją i zależą od planu abonamentowego, więc przy większej skali (setki faktur dziennie) trzeba to zaprojektować z myślą o kolejkowaniu, a nie odpytywaniu na żywo każdej pojedynczej operacji. Jeśli firma ma wybór systemu i priorytetem jest łatwość automatyzacji, Fakturownia wypada tu najlepiej z czterech.

Gdzie kończy się agent AI, a zaczyna RPA jako łatka

Kiedy API nie istnieje albo jest zbyt ograniczone, nie mówimy klientowi „to się nie da". Mówimy „da się, ale inaczej i z innymi ograniczeniami". Wtedy sięgamy po RPA: robota, który operuje na interfejsie systemu tak, jak robiłby to człowiek, klika w te same pola, czyta te same ekrany. To rozwiązanie działa, ale trzeba mieć jasność, że jest bardziej kruche niż integracja przez API. Aktualizacja interfejsu systemu księgowego, zmiana układu formularza, nowa wersja programu z inaczej ponumerowanymi polami, wszystko to może wywalić robota z sesji. Dlatego RPA traktujemy jako łatkę na konkretny problem, nie jako fundament architektury, i zawsze projektujemy ją z monitoringiem i alertami, żeby ktoś wiedział, kiedy robot się „potknął", zamiast dowiedzieć się o tym po tygodniu z braku wystawionych faktur.

Częsty scenariusz: klient korzysta z wersji Symfonii, gdzie API nie obsługuje modułu, który nas interesuje. Robot RPA loguje się do aplikacji, eksportuje potrzebny raport, agent AI po drugiej stronie odbiera ten plik, przetwarza go i na podstawie wyniku wykonuje akcję w innym systemie, na przykład aktualizuje CRM albo wysyła powiadomienie do handlowca. To działa, jest wolniejsze niż żywe API i wymaga większej ostrożności przy każdej aktualizacji systemu księgowego, ale pozwala domknąć proces, który inaczej wymagałby codziennego ręcznego eksportu i wklejania danych.

Co i tak zostaje ręczną pracą

Nawet przy najlepszym API i najlepiej zaprojektowanym agencie, są miejsca, gdzie automatyzacja się kończy, i uczciwie o tym mówimy przed każdym wdrożeniem. Klasyfikacja kosztu, który da się zaksięgować dwoma różnymi sposobami zależnie od interpretacji, korekta deklaracji po zmianie stanu faktycznego, kontakt z urzędem skarbowym w sprawie konkretnej sprawy klienta, ocena, czy dana transakcja podlega odwrotnemu obciążeniu w specyficznym przypadku, to wszystko wymaga osądu księgowego, nie reguł if-then, nawet jeśli owinie się je w duży model językowy. Agent może przygotować propozycję i podpowiedź, ale decyzję i odpowiedzialność zostawiamy człowiekowi. Dobrze zaprojektowany system automatyzacji ma jasno wyznaczoną granicę: co agent robi samodzielnie, co robi z zatwierdzeniem człowieka, a co w ogóle nie trafia do agenta i idzie prosto na biurko księgowego.

W praktyce oznacza to, że dobra automatyzacja księgowości nie polega na wyeliminowaniu księgowego z procesu, tylko na przesunięciu jego czasu z przepisywania danych na weryfikację wyjątków. Jeśli w biurze rachunkowym ktoś codziennie spędza dwie godziny na przepisywaniu pozycji z faktur PDF do systemu, tam jest oczywisty punkt startu. Jeśli księgowy spędza dwie godziny na analizie skomplikowanej transakcji międzynarodowej, tam automatyzacja nie zabierze mu roboty, tylko może dać lepsze dane wejściowe do analizy.

Jak to wygląda w praktyce, na przykładzie typowego wdrożenia

Weźmy firmę handlową, która sprzedaje przez własny sklep internetowy i korzysta z Fakturowni do wystawiania faktur, a z Optimy do księgowości pełnej. Zamówienia wpadają ze sklepu, trzeba wystawić faktury, zsynchronizować je z Optimą i pilnować, żeby stany magazynowe się zgadzały. Bez automatyzacji ktoś codziennie ręcznie sprawdza nowe zamówienia, wystawia faktury, a potem raz w tygodniu wgrywa je zbiorczo do Optimy przez import. To generuje opóźnienia i błędy, bo przy dwustu zamówieniach tygodniowo coś zawsze się pomija.

Agent AI podłączony do webhooków Fakturowni wystawia fakturę automatycznie w momencie zamówienia, na podstawie reguł ustalonych z klientem (kategoria produktu, sposób płatności, kraj dostawy). Po stronie Optimy, gdzie API wymaga osobnej licencji i ma ograniczenia dla dużych paczek zapytań, agent działa w mniejszych partiach z kolejkowaniem i retry, synchronizując dokumenty co kilkanaście minut, nie w czasie rzeczywistym. Wyjątki, na przykład zamówienie z niestandardową stawką VAT albo z krajem dostawy poza UE, trafiają do kolejki do ręcznej weryfikacji, z gotową propozycją klasyfikacji przygotowaną przez agenta. Efekt: większość faktur nie wymaga dotyku człowieka, ale te 10–15% przypadków nietypowych i tak trafiają na biurko, bo próba automatyzacji wszystkiego skończyłaby się błędami podatkowymi, które kosztują więcej niż zaoszczędzony czas.

Tego typu podejście, gdzie automatyzacja obejmuje cały łańcuch od dokumentu wejściowego do zaksięgowania i rozliczenia, jest tematem, który szerzej opisujemy na stronie automatyzacji faktur. Jeśli patrzysz na to z perspektywy biura rachunkowego obsługującego wielu klientów na różnych systemach jednocześnie, warto zobaczyć też, jak podchodzimy do tego całościowo w automatyzacji biura rachunkowego, bo tam skala problemu z różnorodnością API jest jeszcze większa.