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 partners@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 (gaty)

Produkčný kľúč efk_pk_live_… vám vieme vydať až po splnení troch komerčných podmienok. Do ich splnenia žiadosť o live kľúč čaká v príslušnom stave.

Gate	Podmienka	Čakací stav pri nesplnení
Plán	Zvolený tarifný plán partnera.	Surfacuje sa pri aktivácii (nevytvára samostatný čakací stav).
Zmluva	Schválená partnerská (reseller) zmluva.	`waiting_for_contract`
Licencia	Uhradená ročná licencia.	`waiting_for_payment`

Gaty sa vyhodnocujú v poradí plán → zmluva → licencia. Skôrší blokujúci gate má prednosť: kým nie je schválená zmluva, žiadosť čaká v waiting_for_contract aj keby bola licencia už uhradená.

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.
Od 1. 12. 2026	Štandardné účtovanie za transakciu (per‑tx) podľa plánu.

Partnerské promo (koniec 30. 11. 2026) je odlišné od FA web promo (koniec 1. 1. 2027, per‑org kreditový model) — nezamieňajte ich. 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 partners@efaktura.sk.