TechBridge Solutions

Strona główna / Realizacje

Faktury z KSeF i PDF bez przepisywania

Firma usługowa rozliczała projekty i przychody we własnym systemie, a faktury trafiały do niego ręcznie: numer, daty, pozycje, kwoty, waluta. Zbudowałem import, który czyta plik PDF faktury, także wydruk z KSeF, i zakłada gotowy szkic do sprawdzenia.

3układy faktur rozpoznawane automatycznie
15prawdziwych faktur z archiwum wczytanych w testach
117testów automatycznych dla obszaru faktur
0odrzuconych plików: nieznany układ daje szkic do sprawdzenia

Punkt wyjścia

  • Faktury powstawały w trzech układach: z programu Fakturownia, ze starszego własnego szablonu firmy oraz jako wydruk z aplikacji KSeF.
  • Część faktur była w dolarach, część to faktury korygujące, a każda pomyłka przy przepisywaniu psuła rozliczenie projektu.
  • Od 2026 roku coraz więcej faktur przechodzi przez KSeF, więc wydruk z KSeF musiał być czytany tak samo pewnie jak zwykły PDF.

Co zrobiłem

  • Rozpoznawanie układu. Każdy rodzaj faktury ma osobny czytnik, a system sam wybiera właściwy. Plik w nieznanym układzie nie jest odrzucany, tylko trafia jako szkic z oznaczeniami do uzupełnienia.
  • Wydruk z KSeF. Etykiety i wartości w osobnych komórkach, daty z kropkami, polski zapis kwot. Pozycje faktury czytane są po kodzie PKWiU na końcu wiersza, bo tabela podatkowa pod spodem wygląda jak drugi zestaw pozycji.
  • Waluty bez zgadywania. Gdy na fakturze w dolarach nie ma kursu, system nie przyjmuje kursu 1,0, tylko oznacza brak kursu do uzupełnienia.
  • Faktury korygujące. Korekta wczytuje się jako osobny dokument z odnośnikiem do faktury korygowanej. Wcześniej wyglądała jak duplikat i znikała.
  • Testy na prawdziwych plikach. Archiwum faktur wyłapało błędy, których nie widać na przykładach: numer KSeF łamany na dwie linie i pozycję zaczynającą się od cyfry, która wypadała z faktury, przez co suma się nie zgadzała.

Efekt

  • Zamiast przepisywania: wgranie pliku PDF i sprawdzenie tylko tych pól, które system oznaczył.
  • Nagłówek, pozycje, kwoty netto, VAT i brutto, termin płatności, waluta oraz numer KSeF trafiają do systemu w jednym kroku.
  • Nowy układ faktury to nowy czytnik, bez przebudowy całego importu.

Technologie

Ruby on Rails (API) i Next.js w istniejącym systemie firmy, odczyt tekstu z PDF, testy automatyczne RSpec.

Potrzebujesz tego u siebie?

Ten sam mechanizm przygotuję dla Twojej firmy: faktury PDF albo z KSeF do Excela, programu księgowego, CRM lub własnego systemu. Automatyzacje wyceniam od 1 000 zł netto, dokładną cenę podam po obejrzeniu kilku przykładowych faktur.

Zapytaj o wycenę