Obieg dokumentów, biura rachunkowe, archiwa i aplikacje

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.

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)\"}"

{
  "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 przekazujemy do modelu OpenAI (umowa z OpenAI Ireland; dane z API nie służą do trenowania modeli) i nie zapisujemy ani pliku, ani wyniku; liczymy tylko liczbę dokumentów na klucz. Dokumenty mogą zawierać dane osób: przetwarzamy je na Twoje zlecenie na podstawie umowy powierzenia, którą podpisujemy 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.

Poproś o klucz testowy