Podręcznik użytkownika

Zamień faktury, paragony, umowy, CV i inne dokumenty biznesowe w czyste, możliwe do sprawdzenia dane gotowe do eksportu. Z tekstem źródłowym widocznym za każdą wartością.

Ten przewodnik dotyczy korzystania z DocAI w przeglądarce. Chcesz wywoływać DocAI z poziomu kodu? Zobacz dokumentację API.

Co robi DocAI

Przesyłasz dokument, przetwarzasz go przez API albo kierujesz załącznik e-mail do DocAI. DocAI odczytuje go, rozpoznaje typ i wyodrębnia istotne pola. Numer faktury, sumy, pozycje, nazwy, daty i inne. Każda wartość jest:

Oceniana pod względem pewności, dzięki czemu od razu widzisz, czemu można ufać
Możliwa do prześledzenia. Dokładny tekst źródłowy jest podświetlony na stronie
Edytowalna. Popraw lub dodaj cokolwiek przed zapisaniem lub eksportem
Eksportowalna do JSON, CSV, Excel lub PDF oraz możliwa do udostępnienia bezpiecznym linkiem

Obsługiwane formaty: PDF, PNG, JPG/JPEG, HEIC/HEIF, AVIF, TIFF, BMP, WEBP. Obsługiwane są wielostronicowe pliki PDF; AI odczytuje do 3 pierwszych stron w celu ekstrakcji pól.

Jak przetwarzany jest dokument

1
Odbierz lub prześlij

Przeciągnij plik, użyj API lub wyślij załącznik przez skonfigurowanego dostawcę poczty e-mail.
2
Odczyt (OCR)

Strona jest skanowana do postaci tekstu wraz z pozycją każdego słowa, dzięki czemu wartości można powiązać z miejscem na stronie.
3
Klasyfikacja

DocAI wykrywa typ dokumentu (i region) wraz z poziomem pewności. Możesz to zmienić ręcznie, jeśli wiesz lepiej.
4
Ekstrakcja

AI wypełnia pola odpowiednie dla danego typu. Jeśli AI jest niedostępna, DocAI korzysta z dopasowywania wzorców, dzięki czemu i tak otrzymujesz wynik.
5
Przegląd, zatwierdzanie i eksport

Sprawdź podświetlone wartości, popraw błędy, zakończ przegląd i zatwierdź kontrolowane przekazanie do księgowości.

Zaufanie: pewność i dowody

DocAI nigdy nie każe Ci ufać wartości bezkrytycznie.

Dowód. Kliknij dowolne pole, aby zobaczyć podświetlony na stronie fragment, z którego pochodzi. Pobrany adnotowany PDF zawiera te same ramki.

Kolory pewności. Wartości pól i ich ramki są oznaczone kolorami, dzięki czemu wzrok od razu trafia na to, co wymaga sprawdzenia:

Wysoka (≥ 80%) Bardzo prawdopodobnie poprawna
Średnia (≥ 50%) Warto rzucić okiem
Niska (< 50%) Sprawdź to, zanim zaufasz tej wartości
Nieznana Brak dostępnej oceny. Zweryfikuj ręcznie.

Delikatne szare ramki w podglądzie oznaczają cały tekst rozpoznany przez DocAI, dzięki czemu możesz potwierdzić, że nic nie zostało pominięte. nie tylko dopasowane pola.

Wymaga przeglądu. Gdy brakuje kluczowych pól lub ich pewność jest niska, wynik jest oznaczany jako Wymaga przeglądu, zamiast zostać po cichu zaakceptowany. Sprawdzanie kompletności działa automatycznie dla faktur i CV.

Obsługiwane typy dokumentów

DocAI automatycznie wykrywa typ lub możesz wybrać go samodzielnie przed analizą. Dokumenty typizowane mają stały, znany zestaw pól. Kluczowe pola zawsze są obecne w wyniku (puste, jeśli nie zostały znalezione). Dokumenty ogólne nie mają stałej struktury, więc DocAI zwraca wszystkie znalezione oznaczone pola.

Typ dokumentu	Rodzaj	Najlepsze do
Faktura	Typizowany	Faktury sprzedaży/zakupu, rachunki, faktury VAT/GST
Zamówienie zakupu	Typizowany	Zamówienia zakupu, potwierdzenia zamówień
Dowód dostawy / lista przewozowa	Typizowany	Potwierdzenia odbioru towaru, dokumenty wysyłkowe
Paragon	Typizowany	Paragony kasowe, paragony za paliwo i z restauracji
CV / życiorys	Typizowany	CV kandydatów
Formularz strukturalny	Ogólny	Formularze wniosków, kwestionariusze
Umowa	Ogólny	Umowy, warunki
Dokument tożsamości	Ogólny	Dowody osobiste, paszporty, prawa jazdy
Wyciąg bankowy	Ogólny	Wyciągi z konta
Inne / nieznany	Ogólny	Wszystko inne

Legenda: Pole kluczowe (zawsze wyodrębniane) i Dodatkowo przechwytywane (jeśli obecne).

Limit stron. DocAI renderuje pierwsze 5 stron pliku PDF i wysyła pierwsze 3 do modelu AI. To w pełni obejmuje powyższe dokumenty transakcyjne. W przypadku długiej umowy lub pełnego wyciągu bankowego odczytywane są tylko te pierwsze strony. Podziel plik albo ponownie przeanalizuj zapisany dokument, co odczytuje do 20 stron.

Faktura. Szczegóły pól

Pełna ekstrakcja finansowa z tabelą pozycji i automatyczną weryfikacją sum.

Pola kluczowe: numer faktury, data wystawienia, nazwa sprzedawcy, nazwa nabywcy, kwota całkowita, kwota VAT/podatku, pozycje

Dodatkowo przechwytywane: termin płatności, suma częściowa, waluta, metoda płatności, numery podatkowe sprzedawcy i nabywcy, adresy sprzedawcy i nabywcy, stawka VAT dla każdej pozycji

Tabela pozycji: opis, ilość, jednostka, cena jednostkowa, kwota netto, stawka VAT, kwota VAT, kwota brutto

Warianty regionalne dodają szczegóły VAT/GST/podatku od sprzedaży. Zobacz Warianty regionalne.

Zamówienie zakupu. Szczegóły pól

Pola kluczowe: numer zamówienia, data zamówienia, nazwa sprzedawcy, nazwa nabywcy, kwota całkowita, pozycje

Dodatkowo przechwytywane: data dostawy, adres dostawy, waluta, metoda płatności

Dowód dostawy / lista przewozowa. Szczegóły pól

Skoncentrowany na ilościach. Bez sum czy VAT (ceny zwykle nie występują w dokumentach dostawy). Lista przewozowa jest obsługiwana tak samo jak dowód dostawy.

Pola kluczowe: numer dowodu dostawy, data dostawy, nazwa sprzedawcy, nazwa nabywcy, pozycje

Dodatkowo przechwytywane: powiązany numer zamówienia, adres dostawy

Paragon. Szczegóły pól

Zoptymalizowany pod paragony kasowe, z automatyczną podklasyfikacją:

Rodzaj paragonu: fiskalny, niefiskalny, faktura uproszczona, zwrot/korekta

Typ sprzedawcy: sklep spożywczy, stacja paliw, restauracja, handel detaliczny, apteka. Pola są odpowiednio dostosowywane.

Pole kluczowe: kwota całkowita

Dodatkowo przechwytywane: kwota VAT, numer podatkowy sprzedawcy/nabywcy, waluta, metoda płatności, pozycje

Paragony za paliwo: rodzaj paliwa, litry, cena za litr, numer dystrybutora

Paragony z restauracji: numer stolika, kelner, opłata za obsługę, napiwek

CV / życiorys. Szczegóły pól

CV i życiorys to ten sam typ.

Pola kluczowe: imię i nazwisko, e-mail, telefon, umiejętności, doświadczenie zawodowe

Dodatkowo przechwytywane: lokalizacja, podsumowanie zawodowe, wykształcenie, certyfikaty, języki, LinkedIn, GitHub, łączna liczba lat doświadczenia

Tabela doświadczenia zawodowego: stanowisko, firma, data rozpoczęcia, data zakończenia, najważniejsze osiągnięcia

Tabela wykształcenia: instytucja, stopień, kierunek studiów, początek, koniec

Inne dokumenty. Formularze, umowy, dokumenty tożsamości, wyciągi

W przypadku formularzy strukturalnych, umów, dokumentów tożsamości, wyciągów bankowych i innych, DocAI zwraca znalezione na stronie oznaczone pola jako pary etykieta → wartość. Nie ma stałego schematu, więc zakres zależy od dokumentu. Ale dowody, pewność, edycja i eksport działają tak samo.

Potrzebujesz stałej struktury dla jednego z tych przypadków? Utwórz własny typ z dokładnie takimi polami, jakich potrzebujesz.

Warianty regionalne

Ten sam typ dokumentu może zawierać różne szczegóły w zależności od kraju/regionu. DocAI automatycznie wykrywa region (na podstawie numerów podatkowych, waluty i sformułowań) i dodaje odpowiednie pola. Lub możesz samodzielnie wybrać region przed analizą.

Typ bazowy	Region	Dodatkowe dodane pola
Faktura	UE (VAT)	Numer rejestracyjny firmy, adnotacja o odwrotnym obciążeniu/zwolnieniu, IBAN, rozbicie VAT wg stawki
Faktura	USA (podatek od sprzedaży)	Adres dostawy, adres płatności, podatek od sprzedaży, zaświadczenie o zwolnieniu podatkowym
Faktura	Indie (GST)	Miejsce dostawy, IRN, rozbicie GST (CGST/SGST/IGST/Cess), HSN/SAC dla każdej pozycji
Zamówienie zakupu	USA	Adres dostawy, Incoterms, numer dostawcy
Dowód dostawy	UE	Przewoźnik, numer śledzenia/listu przewozowego, liczba paczek, waga brutto, ilość zamówiona a dostarczona dla każdej pozycji

Automatyczne wykrywanie rozpoznaje UE, USA i Indie dla powyższych typów i stosuje odpowiedni schemat regionalny. Wybór regionu bez wariantu po prostu używa typu bazowego. To nigdy nie jest błąd.

Utwórz własny typ (niestandardowe szablony)

Masz dokument, którego DocAI nie obsługuje standardowo, na przykład raport laboratoryjny, formularz wewnętrzny lub konkretną umowę? W przestrzeni roboczej utwórz własny typ z dokładnie takimi polami, jakich potrzebujesz, a następnie wybierz go podczas analizy.

Typy pól: tekst, liczba, data, lista, tabela (z własnymi kolumnami)
Poziomy: oznacz każde pole jako krytyczne, zalecane lub opcjonalne, aby sprawdzanie kompletności wiedziało, co jest ważne
Opcjonalnie rozszerz wbudowany typ, aby zachować wszystkie pola faktury/zamówienia itp. i dodać własne
Dla obszaru roboczego i wielokrotnego użytku: szablony należą do obszaru roboczego; każdy członek może go utworzyć, a twórca (lub administrator obszaru roboczego) może go edytować

Najważniejszym czynnikiem wpływającym na dokładność niestandardowego pola jest jasny opis. To podpowiedź, której AI używa, aby znaleźć właściwą wartość. Limity: do 60 pól na szablon i 30 kolumn na tabelę.

Języki

Interfejs i ekstrakcja DocAI działają w językach angielskim, niemieckim, francuskim, hiszpańskim, polskim i włoskim. Dokumenty w tych językach są odczytywane i przetwarzane natywnie (rozpoznawane są etykiety pól, takie jak Rechnung, Faktura, Facture). Zmień język interfejsu w menu języka; Twój wybór jest zapamiętywany.

Przeglądanie i poprawianie wyników

Edytuj dowolną wartość bezpośrednio na miejscu. Kliknij, wpisz, gotowe
Potwierdź pole, aby oznaczyć je jako sprawdzone
Dodaj brakujące pole, którego AI nie znalazła
Edytor pozycji dla faktur, zamówień i dowodów dostawy. Dodawaj, usuwaj i edytuj wiersze w tabeli
Kliknij pole, aby przejść do jego tekstu źródłowego na stronie i go podświetlić
To Twoje poprawki są zapisywane, eksportowane i udostępniane. Nie surowy wynik AI

Eksportowanie

Z każdego wyniku możesz pobrać:

Format	Zawartość
JSON	Pełny strukturalny wynik, wraz z pewnością i dowodami
CSV (pola)	Jeden wiersz na pole
CSV (pozycje)	Tabela pozycji
Excel (XLSX)	Pola i tabele w arkuszu kalkulacyjnym
Adnotowany PDF	Oryginał z ramkami w kolorach pewności nad każdą wartością

Eksporty do arkuszy kalkulacyjnych są chronione przed wstrzykiwaniem formuł: komórki zaczynające się od =, +, - lub @ są odpowiednio maskowane, aby były traktowane jako tekst, a nie formuła.

Musisz wysłać wynik do współpracownika, klienta lub audytora?

Bezpieczny link. Utwórz tymczasowy publiczny link do zapisanego wyniku
Wybierz dokładnie, co jest udostępniane dla każdego pola: pokazane w pełni, zamaskowane lub ukryte
Skanowanie danych wrażliwych wykrywa e-maile, numery telefonów, IBAN, numery podatkowe, numery dokumentów tożsamości i daty urodzenia przed udostępnieniem, dzięki czemu nic nie wycieknie przez przypadek
Wygasanie. Linki wygasają (domyślnie 7 dni, maksymalnie 365) i można je natychmiast unieważnić. Wygasłe linki przestają działać
Linki tylko dla zespołu. Udostępniaj wyłącznie członkom obszaru roboczego, bez publicznego tokenu
Podgląd zredagowanego PDF. Po włączeniu krok przeglądu pokazuje podgląd strona po stronie dokładnego wyglądu udostępnianego PDF, z automatycznie zredagowanymi polami już zaczernionymi. Możesz przeciągnąć na dowolnej stronie, aby zaczernić dodatkowe obszary; narysowane ramki są na stałe zapisywane w udostępnianym pliku podczas tworzenia linku

Filtrowanie pól odbywa się na serwerze, więc publiczny link nigdy nie zwróci danych, których nie zdecydowałeś się udostępnić.

Przetwarzanie wielu plików naraz

Skorzystaj z przesyłania wsadowego, aby dodać wiele dokumentów naraz. Są one przetwarzane w tle, a Ty możesz śledzić postęp i zbierać wyniki dla każdego pliku po zakończeniu. Każdy plik jest weryfikowany podczas przesyłania; wszystko, co nieobsługiwane lub przekracza limit rozmiaru, jest zgłaszane indywidualnie, aby reszta mogła przejść dalej.

Przyjmowanie dokumentów e-mailem i automatyzacja zatwierdzania

DocAI może przyjmować załączniki przekazywane przez Postmark, Mailgun, SendGrid, Amazon SES, Make, n8n lub inny adapter. DocAI nie udostępnia skrzynki pocztowej ani nie analizuje samodzielnie ładunków e-mail właściwych dla dostawców: dostawca odbiera wiadomość, filtruje spam, wyodrębnia załączniki i wysyła je do API przyjmowania wiadomości e-mail DocAI.

Utwórz klucz API z zakresami extract i history w sekcji Ustawienia deweloperskie.
Skonfiguruj dostawcę poczty e-mail lub przepływ automatyzacji ze stabilnym identyfikatorem wiadomości oraz stabilną przestrzenią nazw dostawcy/konta.
Opcjonalnie wskaż przestrzeń roboczą, aby załączniki trafiały do kolejki przeglądu i zatwierdzania tej przestrzeni.
Sprawdź niepewne pola, zakończ przegląd i pozwól uprawnionej osobie zatwierdzającej zatwierdzić dokument.
Użyj podpisanego webhooka document.approved (a nie document.completed), aby rozpocząć zapis księgowy lub eksport.

Ponowienia po stronie dostawcy są bezpieczne. DocAI zwraca istniejące zadanie dla załącznika, który został już zaakceptowany. Nieudane przyjęcie może ponownie użyć tego samego identyfikatora zadania z nowymi bajtami maksymalnie przez trzy próby łącznie; aktywne lub zakończone zadania nigdy nie są przetwarzane dwukrotnie.

Dostarczenie webhooka jest trwałe i ponawiane automatycznie. Jeśli po wielokrotnych próbach nie można umieścić trwałego zdarzenia w kolejce, pojawia się ono w sekcji Ustawienia deweloperskie → Zdarzenia wymagające uwagi, gdzie po usunięciu przyczyny możesz je odtworzyć.

Informacje o polach multipart, przykładach odpowiedzi, weryfikacji podpisu oraz konfiguracji Make/n8n znajdziesz w dokumentacji API.

Wskazówki dla najlepszych wyników

Prześlij oryginalny plik PDF, jeśli go masz. Pliki PDF zawierające tekst są odczytywane dokładniej niż zdjęcia.
W przypadku zdjęć/skanów: dobre oświetlenie, cała strona w kadrze, minimalne przekrzywienie
Wybierz typ/region, jeśli już go znasz. Eliminuje to zgadywanie.
Ufaj kolorom. Zielony można szybko przejrzeć, czerwony/pomarańczowy zasługuje na uwagę
Użyj własnego typu dla powtarzających się dokumentów wewnętrznych, aby za każdym razem otrzymywać spójne, nazwane pola

Strony i limit

DocAI mierzy użycie w stronach: analiza jednej strony dokumentu zużywa jedną stronę z limitu. Każde nowe konto startuje ze 100 bezpłatnymi stronami. Jednorazowy limit startowy bez daty wygaśnięcia. Płatne plany dodają miesięczny limit stron resetowany 1. każdego miesiąca.

Każda przetworzona strona liczy się raz. Przesyłanie przez stronę, partie, pobieranie z e-maili i API korzystają z tej samej stawki. Ponowienia dostawcy nie naliczają opłaty drugi raz za ukończony załącznik.
Skan wrażliwości AI podczas udostępniania kosztuje jedną stronę za dokument (wyświetlany przed jego uruchomieniem).
Przeglądanie, eksporty (JSON, CSV, XLSX), pulpity i udostępnianie bez skanu AI są bezpłatne.
Gdy saldo osiągnie zero, analizy są odrzucane i pojawia się monit o zmianę planu. Nic nie jest usuwane. Zapisane wyniki pozostają dostępne do czasu ich usunięcia.

Limity w skrócie

Element	Limit
Typy plików	PDF, PNG, JPG/JPEG, HEIC/HEIF, AVIF, TIFF, BMP, WEBP
Strony rasteryzowane na dokument	Do 5 stron
Strony odczytywane przez AI	Pierwsze 3 strony na dokument (strony rasteryzowane powyżej tego limitu są dostępne do pracy z ramkami, ale nie są wysyłane do AI)
Języki interfejsu i ekstrakcji	EN, DE, FR, ES, PL, IT
Pola niestandardowego szablonu	≤ 60 pól, ≤ 30 kolumn na tabelę
Wygasanie linku udostępniania	1–365 dni (domyślnie 7)

Limity rozmiaru przesyłania, limity wsadowe i miesięczne limity zależą od Twojego planu i konfiguracji instancji.

FAQ

Czy działa bez AI?

Tak. Jeśli dostawca AI jest niedostępny, DocAI korzysta z dopasowywania wzorców i odpowiednio oznacza wynik. Nadal otrzymasz pola do przeglądu.

Czy mogę wymusić typ dokumentu lub region?

Tak. Wybierz je przed analizą; w przeciwnym razie DocAI automatycznie wykryje oba.

Dlaczego niektóre pola są puste?

W dokumentach typizowanych każde pole kluczowe jest zawsze wymienione. Puste pole oznacza, że nie znaleziono go na stronie, choć może rzeczywiście nie występować w dokumencie. W dokumentach ogólnych pojawiają się tylko znalezione pola.

Co dzieje się z moimi dokumentami?

Zapisane wyniki są przechowywane dla każdego użytkownika i pozostają dostępne do czasu ich usunięcia. Nie ma automatycznego usuwania zależnego od czasu. W każdej chwili możesz usunąć dowolny wynik lub wszystkie wyniki. Linki do udostępniania można unieważnić.

Limity dokumentów i przestrzeni dyskowej w Twoim planie stanowią praktyczny pułap: po osiągnięciu jednego z nich zapisywanie jest blokowane do czasu zmiany planu lub usunięcia danych. Wyeksportuj do własnego systemu ewidencji wszystko, co musisz zachować zgodnie z ustawowym obowiązkiem przechowywania. DocAI nie jest archiwum.

Czy DocAI może odbierać dokumenty przez e-mail?

Tak, za pośrednictwem skonfigurowanego dostawcy poczty przychodzącej lub narzędzia automatyzacji. Dostawca wyodrębnia zaakceptowane załączniki i wysyła je do DocAI; DocAI obsługuje walidację, bezpieczne względem duplikatów tworzenie zadań, ekstrakcję, kierowanie do przeglądu oraz webhooki.

Gdzie znajdę dokumentację dla programistów/API?

Zobacz dokumentację API.