eFaktúra Developers
API referenciaPartnerský portál

Changelog

Datovaný prehľad zmien Agent API a partnerského portálu. Najnovšie hore.

2026-07-14Vylepšenie
  • Vystavenie a úprava faktúry (POST/PATCH /v1/invoices) — nové pole numberSeriesAction (voliteľné, "exception" | "advance") riadi počítadlo radu, keď customNumber (pri vystavení) alebo number (pri úprave) preskočí dopredu oproti radu. Neinteraktívne požiadavky bez numberSeriesAction spracuje API defaultne ako "exception": doklad si ponechá zadané číslo, ale počítadlo radu sa už automaticky neposunie (zmena správania, 2026-07). Agent API zatiaľ vlastné čísla dokladov nepodporuje. Pošlite "advance" pre obnovenie pôvodného správania (pokračovanie od zadaného čísla). Interaktívni (session) klienti namiesto defaultu dostanú 409 NUMBER_OUT_OF_SERIES s detailmi { typedNumber, expectedNext, nextIfException, nextIfAdvance, sequenceId, sequenceName, prefix }.
  • Doklady uložené so správaním "exception" nie sú naviazané na žiadny rad číslovania a nevytvárajú záznam v sequence_log — v diagnostike radov sa zobrazujú ako „čísla mimo radov" a je možné ich neskôr dodatočne prevziať do radu.
2026-06-26Nové
  • Onboarding na produkciu (FS webhook → potvrdenie e-mailom): firma si na portáli Finančnej správy zvolí eFaktúru ako poskytovateľa doručovania (PDS), FS pošle mandát webhookom a eFaktúra automaticky pošle firme potvrdzovací e-mail. Firma príjem e-faktúr potvrdí klikom na verejnej stránke (bez prihlásenia) — tým sa naviaže na vašu child org na ostrom Peppole.
  • POST /agent/organizations/:id/peppol-claim — (re)poslanie FS potvrdzovacieho e-mailu pre org, ktorú kľúč už vlastní (scope invoice:send, NIE org:provision).
  • Verejná potvrdzovacia stránka pre partner-claim — token-only, bez prihlásenia firmy (anti-misrouting: potvrdzuje schránka firmy cez jej FS company_email).
  • Nová dokumentácia: Onboarding na produkciu a API kľúče a scopes.
2026-06-20Nové
  • Hromadné odoslanie cez Peppol — POST /agent/peppol/send/batch s telom { invoiceIds: [...] } (1–200 ID v jednom volaní).
  • Prílohy k faktúram cez API — pridanie, zoznam a odstránenie príloh (scope invoice:update).
  • Prijaté doklady cez API — stiahnutie originálneho PDF aj UBL XML faktúry (scope invoice:download).
2026-06-15Nové
  • Self-billing (samofakturácia) — podpora profilu poacc:selfbilling:3.0 pre faktúry aj dobropisy.
2026-06-10Vylepšenie
  • Sandbox beží na reálnom phoss-ap-TEST na OpenPeppol TEST sieti — efk_pk_test_ odoslania idú reálnou Peppol TEST sieťou (nahradilo pôvodný in-process simulovaný Access Point). Stále bez kreditov a bez FS.
2026-05-31Nové
  • Partnerský portál: prehľad dokumentov (Dokumenty) — odoslané a prijaté faktúry cez Peppol so stavmi dokladu aj prenosu, filtre a súhrn.
  • Partnerský portál: self-service sandbox API kľúče, prehľad API volaní (logy), zoznam klientskych organizácií.
  • Partnerský portál: prihlásenie partnera (e-mail + heslo) cez pozvánku od administrátora.
  • Developer portál spustený na developers.efaktura.sk vrátane API referencie (Scalar) a dokumentácie.
2026-05-30Nové
  • Sandbox: efk_pk_test_ odoslania fungujú okamžite bez konfigurácie na Peppol TEST prostredí, žiadne kredity ani FS.
  • Sandbox routing podľa tieru kľúča (test/live) na rovnakej base URL (Stripe model).