Odczyt dokumentów: PDF i zdjęcia do JSON

Wysyłasz fakturę, paragon, umowę albo pismo (PDF albo zdjęcie z telefonu). Dostajesz dane w JSON: co to za dokument, kto wystawił, numer, daty, kwoty, rachunek, pozycje, tagi i jednozdaniowe streszczenie, a na życzenie pełny tekst. Kod sprawdza NIP-y i numery rachunków sumą kontrolną, daty w kalendarzu i to, czy netto + VAT daje brutto.

Obieg dokumentów, biura rachunkowe, archiwa i aplikacje

Start

49 złnetto miesięcznie

do 20 dokumentów dziennie

Mała firma albo jedno stanowisko w biurze.

Więcej

149 złnetto miesięcznie

do 100 dokumentów dziennie

Biuro rachunkowe albo aplikacja z obiegiem dokumentów.

Koszt modelu AI jest w cenie. Faktury ustrukturyzowane z KSeF masz już w XML: do nich nie potrzebujesz odczytu (zobacz API KSeF).

Zapytanie i odpowiedź

POST /api/v1/dokumenty
curl https://odswiezona.pl/api/v1/dokumenty \  -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \  -H "Content-Type: application/json" \  -d "{\"typ\": \"application/pdf\", \"plik_base64\": \"$(base64 -w0 faktura.pdf)\"}"

200 OK

{  "ok": true,  "dokument": {    "rodzaj": "faktura", "tytul": "Faktura za paliwo 09/2026",    "wystawca": { "nazwa": "Stacja Paliw Sp. z o.o.", "nip": "1133067162" }, "odbiorca": { "nazwa": "Twoja Firma", "nip": null },    "numer": "FV/123/09/2026", "data_wystawienia": "2026-09-28", "data_sprzedazy": "2026-09-28", "termin_platnosci": "2026-10-12",    "waluta": "PLN", "kwota_netto": 254.07, "kwota_vat": 58.43, "kwota_brutto": 312.5, "zgodnosc_kwot": true,    "rachunek": "61109010140000071219812874",    "pozycje": [{ "nazwa": "Olej napędowy ON", "ilosc": 50.2, "cena_netto": 5.06, "wartosc_brutto": 312.5 }],    "tagi": ["paliwo", "transport"], "streszczenie": "Faktura za 50 litrów oleju napędowego."  },  "limit": { "dzienny": 20, "wykorzystano": 1 }}
CoJak
ZapytaniePOST /api/v1/dokumenty, JSON: plik_base64 (do 10 MB), typ (application/pdf, image/jpeg, image/png, image/webp), opcjonalnie nazwa i tekst: true (pełny tekst w odpowiedzi)
Rodzajefaktura, faktura korygująca, paragon, rachunek, umowa, pismo, wezwanie, potwierdzenie przelewu, oferta, inne
KontrolaNIP i rachunek z niepoprawną sumą kontrolną → null; data spoza kalendarza → null; zgodnosc_kwot: czy netto + VAT = brutto (z groszem tolerancji)
Klucz i limitynagłówek Authorization: Bearer odsw_…; dzienny limit według planu i 20 zapytań na minutę
Błędy400 złe dane albo plik niezgodny z typem (nie liczą się do limitu), 401 zły klucz, 413 za duży plik, 429 limit, 502 chwilowy błąd

Odczyt to pomoc przy wprowadzaniu, nie zastępuje sprawdzenia przez księgową. Plik przekazuję do modelu OpenAI (umowa z OpenAI Ireland; dane z API nie służą do trenowania modeli) i nie zapisuję ani pliku, ani wyniku; liczę tylko liczbę dokumentów na klucz. Dokumenty mogą zawierać dane osób: przetwarzam je na Twoje zlecenie na podstawie umowy powierzenia, którą podpisuję razem z umową na API.

Klucz testowy na tydzień

Napisz, jakie dokumenty chcesz odczytywać. Dostaniesz klucz z małym limitem, żeby sprawdzić trafność na własnych plikach.