Spustenie naostro

Checklist prechodu zo sandboxu do produkcie. V sandboxe overte celý tok, potom prepnite na produkčný kľúč, base URL ostáva rovnaká.

Pred spustením

Otestované v sandboxe

Vystavenie faktúry, odoslanie cez Peppol a (ak relevantné) prijatie dokladu prebehlo v sandboxe s kľúčom efk_pk_test_….

Ošetrené chyby a 429

Aplikácia korektne spracúva chybové kódy a rešpektuje Retry-After pri rate limite.

Bezpečné uloženie kľúčov

Kľúče sú v server-side prostredí / secret store, nie v klientskom kóde ani v repozitári.

Idempotencia

Pri opakovaní požiadaviek si ukladáte id vytvorených dokladov, aby ste predišli duplicitám.

Mapovanie organizácií

Pre každú klientsku organizáciu posielate správne X-Organization-Id.

Prepnutie na produkciu

Produkčný kľúč

Administrátor po aktivácii partnera vydá produkčný kľúč efk_pk_live_…. Nahraďte ním sandbox kľúč v produkčnej konfigurácii.

Reálne odoslanie

Live odoslania idú reálne cez Peppol: overte si fakturáciu/kredity a stav doručenia v sekcii Dokumenty.

Sandbox a produkcia sú oddelené iba prefixom kľúča. Skontrolujte, že v produkcii naozaj používate efk_pk_live_… a nie testovací kľúč.

FS verifikačný token

Produkčný (live) Peppol enroll vyžaduje FS verifikačný token, hex kód z verifikácie DIČ na Finančnej správe. V sandboxe je tento token nepovinný (TEST SMP registruje 9915 účastníka aj bez neho), ale pri efk_pk_live_… kľúči je povinný a bez neho POST /v1/agent/peppol/enroll vráti VALIDATION_ERROR.

Token sa posiela v tele enrollu ako verificationTokenHex (lowercase / uppercase hex). Ako token získať pre danú organizáciu rieši onboarding na FS: kontaktujte podporu na podpora@efaktura.sk. Stav onboardingu organizácie viete priebežne posielať aj cez POST /v1/agent/organizations/{id}/activation-token s telom { "token": "…" }, ktorý posunie organizáciu v životnom cykle (caka_na_token → caka_na_fs).

Aktivácia partnera: 3 kroky

Produkčný prístup (a s ním kľúč efk_pk_live_…) prechádza tromi krokmi priamo v partnerskom portáli: celý priebeh sledujete na Prehľade (sekcia Onboarding), žiadne manuálne e‑maily s kľúčom alebo prílohami. Pri štandardnom objeme/cenníku (katalógové podmienky) systém žiadosť aj schvaľuje automaticky: bez čakania na admina.

Žiadosť o produkčný prístup

Tlačidlo „Požiadať o produkčný prístup" na Prehľade. Pri katalógových podmienkach sa žiadosť schváli okamžite a zmluva sa začne generovať; mimo katalógu (upravené podmienky) ide na posúdenie eFaktúre.

Zmluva: podpis kódom z e-mailu

Systém vygeneruje zmluvu s dohodnutými podmienkami. Podpíšete ju cez odkaz priamo v portáli: skontrolujete PDF, vyplníte meno a funkciu podpisujúceho, vyžiadate si 6-miestny kód e-mailom na kontaktnú adresu partnera a zadaním kódu zmluvu podpíšete: žiadne kreslenie, tlačenie ani skenovanie. Finálne podpísané PDF (s auditným záznamom overenia kódu) je na stiahnutie v portáli aj v potvrdzujúcom e‑maile.

Produkčný kľúč

Po podpísaní zmluvy sa aktivuje produkčný prístup a v portáli si jednorazovo vygenerujete kľúč efk_pk_live_…. Uložte si ho hneď. Neskôr sa už nezobrazí celý. Fakturácia beží mesačne pozadu podľa cenníka, bez platby vopred.

SAPI-SK je voliteľné: ak rozhranie nepoužívate, krok sa vás netýka a nič vám neblokuje postup cez zvyšné kroky.

Zmena dohodnutých podmienok po podpise (objem, balík, cenník) nemení existujúcu zmluvu: pri renegociácii sa vygeneruje a znova podpíše nová zmluva s aktuálnymi podmienkami; pôvodná zostáva ako archívny záznam.

Kredity a fakturácia

Sandbox je vždy zadarmo: test sendy (efk_pk_test_…) idú cez TEST sieť, neúčtujú sa a nestrhávajú kredity. Produkčné odoslanie cez Peppol spotrebúva kredit / účtuje sa za transakciu.

Obdobie	Účtovanie produkčných sendov
Do 30. 11. 2026 (promo)	Základný poplatok 0 € do promo limitu transakcií za mesiac (API 1000 / white‑label 5000 tx/mesiac, neprorátuje sa). Spotreba nad limit sa fakturuje mesačne pozadu sadzbou celkového objemu; na účtovanú sumu sa vzťahuje minimálna mesačná platba 10 € bez DPH.
Od 1. 12. 2026	Objemový cenník: mesačný objem transakcií určí jednu sadzbu (0,055 – 0,0194 € / tx) na celý objem; odoslaný doklad a dobropis = 1 tx, prijatý doklad = 0,5 tx. Tabuľkové sadzby platia pre ročný záväzok s platbou vopred; ročný záväzok s mesačnou platbou = ×1,10, flex mesačne bez záväzku = ×1,20. Bez vstupného poplatku; minimálna mesačná platba 10 € bez DPH (pri nulovej spotrebe sa nefakturuje nič). Cenník a kalkulačka: efaktura.sk/api-rest.

Obdobie

Účtovanie produkčných sendov

Do 30. 11. 2026 (promo)

Základný poplatok 0 € do promo limitu transakcií za mesiac (API 1000 / white‑label 5000 tx/mesiac, neprorátuje sa). Spotreba nad limit sa fakturuje mesačne pozadu sadzbou celkového objemu; na účtovanú sumu sa vzťahuje minimálna mesačná platba 10 € bez DPH.

Od 1. 12. 2026

Objemový cenník: mesačný objem transakcií určí jednu sadzbu (0,055 – 0,0194 € / tx) na celý objem; odoslaný doklad a dobropis = 1 tx, prijatý doklad = 0,5 tx. Tabuľkové sadzby platia pre ročný záväzok s platbou vopred; ročný záväzok s mesačnou platbou = ×1,10, flex mesačne bez záväzku = ×1,20. Bez vstupného poplatku; minimálna mesačná platba 10 € bez DPH (pri nulovej spotrebe sa nefakturuje nič). Cenník a kalkulačka: efaktura.sk/api-rest.

Partnerské promo (koniec 30. 11. 2026) je odlišné od FA web promo (koniec 1. 1. 2027, per‑org kreditový model), preto ich nezamieňajte. Ak pri live sende nie je dostatok kreditu, POST /v1/agent/peppol/send vráti 402 s kódom INSUFFICIENT_CREDIT.

Potrebujete pomoc s nasadením? Kontaktujte nás cez partnerský portál alebo na podpora@efaktura.sk.