eFaktúra Developers

Changelog

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

2026-08-20Nové
  • Modul Zmluvy v Agent API (/v1/agent/contracts): zoznam, detail, vytvorenie, úprava, zmazanie, harmonogram platieb (vrátane označenia platby ako uhradenej), naviazané faktúry a opakované faktúry, štatistiky, AI extrakcia z PDF a prílohy. Scopes contract:read/create/update/delete; nové partnerské kľúče dostávajú read/create/update automaticky, staršie kľúče treba pregenerovať.
  • PATCH /v1/agent/invoices/:id: úprava obsahu faktúry (položky, dátumy, poznámky, bankový účet, linkovanie zmluvy…). Rovnaké pravidlá ako v aplikácii: stornované/archivované/zamknuté doklady sa upraviť nedajú, Peppol-odoslané len účtovné metadáta. Payload je camelCase (session tvar), voliteľný optimistický zámok cez pole version. Vyžaduje scope invoice:update.
  • Sprísnenie: USER-scoped API kľúče (efk_live_/efk_test_) sa teraz autorizujú prienikom scopes kľúča a oprávnení používateľa. Kľúč s obmedzenými scopes (napr. len invoice:read) už nedokáže vykonať zápisové operácie cez oprávnenia svojho vlastníka; least-privilege kľúče platia naozaj.
  • Zákazky (projekty) v Agent API: /v1/agent/projects (zoznam, vytvorenie s farbou, detail, úprava) a nové polia case_id na výdavkoch (vytvorenie, upload, úprava, filter zoznamu) + caseId na zmluvách. Doklady aj zmluvy tak viete tagovať zákazkou už pri vzniku. Pribudol aj branch_id na výdavkoch (predtým len branch_code pri uploade).
2026-08-01Nové
  • Idempotencia pri vytváraní dokladov: POST /v1/agent/invoices a POST /v1/agent/expenses prijímajú voliteľnú hlavičku Idempotency-Key. Opakovanie s rovnakým kľúčom aj telom vráti uloženú odpoveď (doklad sa nevytvorí druhýkrát, číslo radu sa neminie); rovnaký kľúč s iným telom vráti 409. Dôrazne odporúčané pre všetky retry mechanizmy.
  • POST /v1/agent/invoices/:id/send-reminder: opakované volanie do 10 minút už pripomienku neodošle znova, vráti 200 so sent:false namiesto duplicitného e-mailu zákazníkovi.
  • Opravy e-invoice validácie: opravný doklad (§25, UNTDID 384) si zachováva skutočné znamienko súm (predtým sa absolútnou hodnotou správal ako dobropis); dobropis bez DPH kategórie na riadku teraz správne padá na SK-BT-148; dedup prijatých dokladov zahŕňa typ dokladu (dobropis s rovnakým číslom ako faktúra sa už nezahodí ako duplikát).
2026-07-27Oprava
  • POST /v1/agent/expenses/scan-qr: parsovanie eKasa bločkov sa vzťahuje len na organizácie s fiskalizáciou SK (eKasa). Organizácie z iných krajín (napr. CZ) dostanú aj pre eKasa QR generický výsledok { type: "text", raw }.
2026-07-23Oprava
  • GET /v1/agent/expenses/:id/qr: generovaný Pay by Square QR kód už neobsahuje dátum splatnosti (bankové aplikácie ho predvypĺňali alebo platbu odmietali).
2026-07-22Vylepšenie
  • Telefónne číslo v inline customer objekte (POST /v1/agent/invoices) sa validuje ako E.164: oddeľovače a prefix 00 sa normalizujú, neplatné číslo vráti zrozumiteľnú 400 VALIDATION_ERROR (predtým neprehľadná 500 z DB constraintu).
2026-07-21Nové
  • Nová hodnota payment_method: "offset" (vzájomný zápočet) pri vytváraní faktúry, označení výdavku ako uhradeného aj zázname platby. Dobropisy sa dajú vysporiadať so zápornou sumou k úhrade (predtým sa orezávala na nulu).
  • POST /v1/agent/invoices/:id/send-reminder: podporovaný jazyk pripomienky "cs" (čeština), popri sk/en/de/hu.
2026-07-18Vylepšenie
  • Faktúry v stave pending_approval (čakajú na schválenie) sú blokované rovnako ako drafty: nemožno na ne poslať pripomienku ani ich označiť ako paid/cancelled; API vráti 400 s pokynom faktúru najprv vydať.
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).