Automatyzacja faktur i maili z n8n i Claude

Przepisywanie faktur z maila do systemu księgowego to praca, której nie znosi nikt, kto musi ją wykonywać. Otwierasz załącznik, przepisujesz sprzedawcę, numer, kwotę i termin, przeklikujesz się przez formularz, wracasz do skrzynki po następny plik. Dziesięć faktur to godzina, a pod koniec miesiąca uzbiera się ich znacznie więcej. To zadanie idealne do oddania maszynie, bo jest powtarzalne, nudne i łatwe o pomyłkę przy dziesiątej pozycji z rzędu.

Czym są n8n i Claude

Do zbudowania takiego przepływu wystarczą dwa elementy. n8n to narzędzie do automatyzacji, w którym łączysz gotowe klocki, zwane węzłami, w jeden ciąg działań, bez pisania całej aplikacji od zera. Całość układasz w wizualnym edytorze, przeciągając węzły i łącząc je strzałkami, więc widać cały proces jak na schemacie. Claude, model od Anthropic, dokłada to, czego n8n samo nie umie: czyta treść faktury jak człowiek i zwraca uporządkowane dane. Razem prowadzą dokument od skrzynki do zaksięgowanej pozycji.

Zanim zaczniesz

Potrzebujesz działającego n8n, uruchomionego przez Dockera na własnym serwerze albo w wersji chmurowej n8n Cloud. Do tego klucz API do Claude z konta Anthropic, dostęp do skrzynki, na którą przychodzą faktury, oraz miejsce docelowe: arkusz Google albo system księgowy z interfejsem programistycznym, na przykład Fakturownia czy wFirma. Zbierz te dane przed startem, żeby nie przerywać budowy w połowie i nie szukać hasła w trakcie.

Przepływ krok po kroku

Zacznij od wyzwalacza. Węzeł Gmail Trigger albo IMAP Email nasłuchuje skrzynki i uruchamia przepływ, gdy przyjdzie nowa wiadomość. Od razu dołóż filtr, żeby reagować tylko na maile z załącznikiem PDF, a najlepiej z konkretnej etykiety albo folderu, do którego trafiają faktury. Dzięki temu automat nie budzi się przy każdym newsletterze i nie próbuje księgować oferty z hurtowni.

Kolejny węzeł wyciąga załącznik jako plik binarny i przekazuje go dalej. Jeśli w jednym mailu bywa kilka faktur, ustaw krok, który rozbija je na osobne pozycje i przepuszcza każdą z osobna. Na tym etapie warto od razu odłożyć kopię oryginału na Dysk albo do osobnego folderu, żeby zawsze mieć źródło do wglądu, gdyby księgowa albo urząd o nie poprosili.

Claude czyta fakturę

Teraz sedno, czyli odczyt. Węzłem HTTP Request albo gotowym węzłem Anthropic wysyłasz plik do Claude z jasnym poleceniem: odczytaj z tej faktury nazwę sprzedawcy, NIP, numer dokumentu, kwotę netto i brutto oraz termin płatności i zwróć je w ustalonym formacie. Poproś o czysty wynik w formacie JSON z zawsze tymi samymi polami, bo na uporządkowanych danych łatwo pracować w następnych krokach. Claude radzi sobie z odczytem PDF, także skanów, więc nie musisz osobno uruchamiać rozpoznawania tekstu.

Mając dane w stałym formacie, zapisujesz je tam, gdzie mają trafić. Węzeł Google Sheets dopisuje nowy wiersz do arkusza, a węzeł HTTP Request wysyła pozycję do systemu księgowego przez jego interfejs. Kluczowe jest mapowanie: pole kwota z odpowiedzi Claude ląduje w polu kwoty w księgowości, termin w terminie i tak dalej. Raz dobrze ułożone mapowanie działa potem przy każdej fakturze bez dotykania.

Wyjątki do ręcznego sprawdzenia

Dołóż warunek na przypadki nietypowe. Węzeł IF sprawdza, czy wszystkie wymagane pola się wypełniły i czy kwoty się zgadzają, na przykład czy brutto nie jest niższe od netto. Jeśli czegoś brakuje albo coś nie trzyma się kupy, przepływ odkłada taką fakturę do osobnej kolejki do ręcznego sprawdzenia, zamiast księgować ją na ślepo. Automat obsługuje typowy ruch, a człowiek dogląda tylko wyjątków, których i tak jest garstka.

Typowe błędy

Najgroźniejszy błąd to brak obsługi błędów. Bez osobnej ścieżki na nieudane kroki przepływ potrafi po cichu zgubić fakturę i nikt się nie zorientuje. Drugi to ślepe zaufanie do odczytu bez żadnej kontroli sum. Trzeci to potknięcia na formatach: przecinek zamiast kropki w kwocie, data w innym układzie, obca waluta. Czwarty to duplikaty, gdy ten sam mail przyjdzie dwa razy, dlatego warto sprawdzać numer faktury przed zapisem.

Zanim wpuścisz przepływ na produkcję, przepuść przez niego kilkanaście prawdziwych faktur różnych dostawców i policz błędy. Włącz zapis każdego kroku, żeby dało się odtworzyć, co dokładnie stało się z konkretnym dokumentem, gdy coś pójdzie nie tak. Dopiero gdy na realnych danych wynik jest powtarzalny, przełącz automat w tryb bez ręcznego zatwierdzania.

Dobrze ułożony przepływ oszczędza kilka godzin miesięcznie i, co ważniejsze, zdejmuje z głowy nudną, łatwą o pomyłkę robotę. Policz też, ile realnie kosztuje jedno wywołanie modelu, bo przy setkach faktur miesięcznie nawet grosze się sumują, choć zwykle i tak wychodzi ułamek wartości zaoszczędzonego czasu. Automatyzacja oszczędza godziny tylko wtedy, gdy jej ufasz, a ufasz dlatego, że ją sprawdziłeś, a nie dlatego, że raz zadziałała. To nie magia do włączenia i zapomnienia, tylko narzędzie, które raz porządnie zbudowane pracuje po cichu w tle.