Prístup a účty
eFaktúra má tri integračné cesty a každá vydáva prístupy inde. Táto stránka vám povie, ktorá je vaša, skôr než začnete hľadať kľúče na nesprávnom mieste.
Ktorá cesta je pre vás?
| Kto ste | Čo použijete | Kde získate prístup |
|---|---|---|
| Firma s vlastným systémom (e-shop, ERP, interná appka): fakturujete za seba | REST API s kľúčom z aplikácie | fa.efaktura.sk → Nastavenia → API kľúče (self-service) |
| Softvérový vendor / účtovný SW: integrujete pre viacero firiem, príp. white-label | Partnerské Agent API | developers.efaktura.sk/register (self-service, okamžite) |
| Systém postavený na štandarde SAPI-SK Finančnej správy | SAPI-SK (OAuth2 client_id/secret) | developers.efaktura.sk/register → rozhranie SAPI-SK (self-service, okamžite) |
Cesta 1: Firma s vlastným systémom
API kľúč si vytvoríte priamo v aplikácii: fa.efaktura.sk → Nastavenia → API kľúče. Žiadne schvaľovanie: testovací aj produkčný kľúč máte hneď. API prístup je súčasťou plánov Pro a vyšších (vrátane skúšobného obdobia).
Kľúče z aplikácie majú prefix efk_test_… / efk_live_… a volajú to isté API ako partnerské kľúče, takže celá táto dokumentácia (faktúry, webhooky, validácia, chybové kódy) platí rovnako. Jediný rozdiel: kde kľúč vzniká a že sekcie o partnerskom portáli, zmluve a schvaľovaní live kľúčov sa vás netýkajú.
Cesta 2: Partner (vendor, white-label)
Ak integrujete eFaktúru pre viacero firiem (účtovný softvér, ERP, agentúra alebo white-label pod vlastnou značkou), patríte do partnerského developer portálu (developers.efaktura.sk → Dashboard). Partnerské kľúče (efk_pk_test_… / efk_pk_live_…) vedia zakladať a spravovať klientske organizácie.
Registrácia je self-service: developers.efaktura.sk/register : e-mail a OTP, firma cez eFirma (autofill IČO), zvoľte typ (API integrátor / white-label) a rozhranie (REST alebo SAPI-SK, voliteľné). Sandbox kľúč aj SAPI-SK prístupové údaje (client_id/secret) dostanete okamžite po registrácii, zadarmo. Žiadne čakanie na schválenie.
Produkčný prístup si vyžiadate priamo v portáli (3 kroky): žiadosť o produkčný prístup (pri katalógových podmienkach schválená okamžite) → zmluva (podpis kódom z e-mailu) → produkčný kľúč. Celý priebeh sledujete na Prehľade, žiadne manuálne e-maily s kľúčom. Podrobný postup: Spustenie naostro.
Radšej to prebrať s obchodným tímom najprv (objem, cenník, white-label branding)? Napíšte na podpora@efaktura.sk : pripravíme vám ponuku ručne; účet aj sandbox kľúč napokon vzniknú rovnaké, len cez obchodný tím namiesto formulára.
Cesta 3: SAPI-SK
SAPI-SK je štandardné rozhranie Finančnej správy SR (OAuth2 client_credentials). Client ID a secret sa vydávajú v tom istom registračnom formulári ako v ceste 2, stačí pri type integrácie zvoliť SAPI-SK namiesto REST a dostanete ich hneď spolu so sandbox kľúčom. Podrobnosti: sekcia „SAPI-SK (štandard FS)" v bočnom menu.
client_id/client_secret, zaregistrujte sa v partnerskom developer portáli (developers.efaktura.sk/register). Kľúč z aplikácie vám nepomôže.Neviete si vybrať?
Napíšte na podpora@efaktura.sk pár viet o tom, čo integrujete, nasmerujeme vás na správnu cestu, zvyčajne do jedného pracovného dňa.