Zobraz e-faktúru
Vývojári

Changelog

Verejne viditeľné zmeny v službe vykresľovania faktúr.

máj 2026

  1. Nová funkcia

    @zobrazfakturu/sdk — typovaný TypeScript klient

    Zero-dep TS klient na npm — autocompletion pre všetkých 5 endpointov, typované chyby (ZobrazAuthError, ZobrazRateLimitError…), automatický opakovaný pokus pri 429/502/503 a sieťových chybách, 30 s timeout. Funguje v Node 18+, prehliadačoch, Deno, Bun a Cloudflare Workers. Zdroj a README v sdk/ subadresári repozitára.

  2. Nová funkcia

    OpenAPI 3.1 špecifikácia a verejný changelog

    Strojovo-čitateľný popis API na /api/v1/openapi.json. Importuj do Postman, Insomnia alebo openapi-typescript a vygeneruj klienta. Changelog na /changelog drží históriu zmien v jednom mieste.

  3. Nová funkcia

    Bulk endpoint /render/batch, verejný status a per-key analytics

    POST /api/v1/render/batch vykreslí až 100 faktúr v jednom volaní (10× paralelne). Verejný /status zobrazuje aktuálnu dostupnosť závislostí a 7-dňový uptime. V API kľúčoch sú za chevronom 24h štatistiky (P50/P95, chyby, cache hit).

  4. Nová funkcia

    Vývojárska stránka /developers a interaktívna API skúšobňa

    Verejná dokumentácia na /developers s úryvkami v curl/fetch/axios/Python/PHP. V nástenke je nová karta Skúšobňa, kde si vyskúšaš API priamo v prehliadači bez kľúčov. Po vytvorení kľúča sa hneď zobrazí ukážka s tvojimi credentials.

  5. Vylepšenie

    Free tier zvýšený na 100 vykreslení denne

    Predvolený denný limit pre nové účty je teraz 100 vykreslení. Existujúce účty si môže administrátor zvýšiť cez UPDATE public.user_quota SET daily_limit = 100;

  6. Nová funkcia

    Karta Aktivita a metadáta vykresleného PDF

    V nástenke je nová karta Aktivita s históriou vykreslení za posledných 30 dní (s cache hit chipom a tone-correct badge). Pri náhľade vykreslenej faktúry sa zobrazí bočný panel s typom dokladu, počtom riadkov, veľkosťou PDF, časom vykreslenia a stavom validátora.

  7. Vylepšenie

    Rate limit zvýšený zo 10/min na 100/min na kľúč

    Predtým bol limit 10 požiadaviek/min na API kľúč; nová hodnota 100/min zodpovedá kapacite upstream validátora. Veľké dávky (napr. 500 faktúr v batchi) sa už nezasekávajú o náš limit, ale o reálnu kapacitu rendereru.

  8. Nová funkcia

    QR kód pre platbu v hornej časti faktúry

    PDF teraz obsahuje PayMe 2.0 QR kód pri čísle faktúry — slovenské bankové aplikácie ho rozpoznajú a predvyplnia platobný formulár. QR sa zobrazí len pri faktúrach, ktoré sa dajú zaplatiť (EUR, platný SK IBAN, variabilný symbol, kladná suma). Dobropisy QR nemajú.

  9. Nová funkcia

    Endpointy /ping a /health?strict=true pre uptime monitory

    /api/v1/ping je minimálna kontrola dostupnosti (text/plain „ok“) ideálna pre UptimeRobot. /api/v1/health teraz s ?strict=true vracia 503 pri degraded stave — uptime monitory s kontrolou status kódu môžu alertovať bez keyword matching.

  10. Nová funkcia

    Idempotentný cache, audit endpoint a X-Request-Id

    POST /api/v1/render s X-Document-Id je teraz keyovaný podľa SHA-256(locale|xml) — opakované vykreslenie rovnakého XML je zadarmo a označené X-Cache: HIT. Nový endpoint GET /api/v1/renders vracia historickú aktivitu API kľúča. Každá odpoveď nesie X-Request-Id (zo servera alebo zo zaslanej hlavičky) — uloženie na strane volajúceho radikálne zjednoduší korelovanie pri triage.

  11. Nová funkcia

    Režim X-Document-Id: priamy upload do Vercel Blob

    S hlavičkou X-Document-Id (UUID) sa PDF nahrá do Vercel Blob a odpoveď je JSON s blobUrl namiesto bajtov. Pri vysokoobjemovom volaní šetrí to egress — pri konzumentovi epodatelna24 sme odhadli úsporu ~$765/mesačne.

apríl 2026

  1. Nová funkcia

    Spustenie služby

    Renderovanie Peppol BIS Billing 3.0 faktúr, dobropisov a samofakturácie do PDF cez nástenku alebo POST /api/v1/render. Sk/EN, validácia cez peppol-validator.eu, auth cez Google + API kľúč.