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ź
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 }}
| Co | Jak |
|---|---|
| Zapytanie | POST /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) |
| Rodzaje | faktura, faktura korygująca, paragon, rachunek, umowa, pismo, wezwanie, potwierdzenie przelewu, oferta, inne |
| Kontrola | NIP i rachunek z niepoprawną sumą kontrolną → null; data spoza kalendarza → null; zgodnosc_kwot: czy netto + VAT = brutto (z groszem tolerancji) |
| Klucz i limity | nagłówek Authorization: Bearer odsw_…; dzienny limit według planu i 20 zapytań na minutę |
| Błędy | 400 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.