Pre partnerov · onboardingPilot v sandboxe

Hromadná príprava, individuálne potvrdenie na FS

Predregistrujte DIČ klientov a po ich voľbe vo VPDS ich eFakturuj automaticky priradí k vášmu partner účtu. Finančná správa dnes dokumentuje potvrdenie samostatne za každý daňový subjekt.

Otvoriť VPDS Pozrieť API požiadavku

Partner API: až 5 000 DIČ naraz
Finančná správa: 1 potvrdenie na subjekt
Priradenie: automaticky podľa DIČ

Proces

Hromadné zapojenie v 4 krokoch

01
Partner predregistruje DIČ
JSON API a potvrdenie mandátu.
Backend pripravený
02
Oprávnená osoba potvrdí VPDS
Samostatne za každý subjekt.
Manuálny krok
03
Webhook spojí rovnaké DIČ
Bez kódu na partner priradenie.
Automaticky
04
Firma sa sprístupní partnerovi
Publikovanie siete dobieha asynchrónne.
Automaticky

Vy ako sprostredkovateľ pre svojich zákazníkov

Voliteľný krok, robíme ho my

Pri výbere poskytovateľa vo VPDS môže byť pri každom klientovi uvedený aj sprostredkovateľ — Vaša firma. Je to Vaša voľba: klienti môžu byť zapojení aj bez tohto zápisu, no so zápisom figuruje Vaša firma priamo v označení každého klienta na Finančnej správe.

Toto je samostatný krok a nerobíte ho Vy na portáli, robíme ho my. Zapíšeme Vás do zoznamu Finančného riaditeľstva ako nášho sprostredkovateľa podľa § 76a ods. 5. Žiadosť podávame do 5 pracovných dní od podpisu zmluvy a potrebujeme k tomu iba názov firmy, IČO a DIČ.

Aby ste vedeli dopredu: tento zápis je súčasťou programu Pro, teda od 289 € mesačne. Hovoríme to hneď na začiatku, aby to pre Vás nebolo prekvapenie neskôr.

Cenník — program Pro

VPDS: vybraný poskytovateľ Efakturuj a vybraný sprostredkovateľ — partnerská firma — VPDS zobrazuje pri klientovi poskytovateľa (Efakturuj) aj zvoleného sprostredkovateľa — Vašu firmu.

Predregistrujte klientov

Backend pripravený

Partner API prijíma DIČ a voliteľne celý profil klienta — IČO, IČ DPH, adresu, IBAN aj fakturačný e-mail. Profil sa pri prepojení nasadí na organizáciu, takže je fakturačne použiteľná okamžite (bez IČ DPH prvá odoslaná faktúra neprejde validáciou BT-31 — doplniť sa dá aj neskôr). Požiadavka je idempotentná pre kombináciu partner + DIČ, preto je bezpečné zoznam odoslať znova. DIČ zapisujte ako presne 10 číslic bez medzier a oddeľovačov. API kľúč potrebuje scope invoices:write.

POST /api/v1/partner/enrollment-intentsmax. 5 000 položiek

curl -X POST https://api.sandbox.efakturuj.sk/api/v1/partner/enrollment-intents \
  -H 'X-API-Key: efk_…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mandate_attested": true,
    "items": [
      {
        "dic": "2020123456",
        "legal_name": "Klient A, s. r. o.",
        "ico": "12345678",
        "vat_id": "SK2020123456",
        "street": "Hlavná 1",
        "city": "Bratislava",
        "postal_code": "81101",
        "iban": "SK31…",
        "billing_email": "fakturacia@klient-a.sk"
      },
      { "dic": "2120000001", "legal_name": "Klient B, s. r. o." }
    ]
  }'

Mandát v eFakturuj

mandate_attested: true je vyhlásenie partnera, že má oprávnenie za uvedených klientov. Nenahrádza registráciu zastupovania ani rozsah oprávnení evidovaný vo Finančnej správe. Rovnaké DIČ nepredregistrujte cez viac partner účtov; prvý čakajúci záznam má prednosť.

CSV a úplný profil

Úplný profil klienta (adresa, IČ DPH, IBAN, fakturačný e-mail) je už súčasťou API požiadavky a pri prepojení sa nasadí na organizáciu. Plánovaný zostáva priamy CSV import v partnerskej konzole — dnes partner prevedie CSV na vyššie uvedenú JSON požiadavku.

Potvrďte jedného klienta vo VPDS

Jediný manuálny krok

Klient alebo jeho zástupca evidovaný vo Finančnej správe sa prihlási podporovaným spôsobom, vyberie daňový subjekt, doplní e-mail a telefón, udelí súhlas a žiadosť odošle. Zástupca môže vidieť viac klientov podľa svojich oprávnení, ale výber vykonáva po jednom.

1Otvorte priamy odkaz na Efakturuj vo VPDS.
2Prihláste sa a zvoľte jeden daňový subjekt.
3Skontrolujte údaje z FS a doplňte e-mail a telefón.
4Povoľte poskytnutie údajov a odošlite žiadosť.

Obrazovka VPDS s nadpisom Výber daňového subjektu a rozbaľovacím poľom Vyberte subjekt. — Vo VPDS vyberte subjekt, za ktorý vykonávate označenie.Kliknutím zväčšíte

Aktivačný kód pri samostatnej aktivácii

Vaši klienti v hromadnom zapojení žiadny kód nepotrebujú — prepojenie prebehne automaticky. Kód sa týka len samostatnej aktivácie firmy: vygenerovaný → e-mailom → 7 dní · 5 pokusov → jednorazový. Expirovaný kód sa obnoví samoobslužne cez „Poslať znova“ (nový kód, nová platnosť, pokusy sa vynulujú) alebo zopakovaním označenia vo VPDS. Detail v postupe Aktivácia firmy.

Webhook priradí firmu podľa DIČ

Automaticky

Po potvrdení VPDS odošle Finančná správa webhook. eFakturuj nájde najstarší čakajúci partner záznam s rovnakým DIČ a priradí k nemu organizáciu. Na partner priradenie klient nepotrebuje aktivačný kód.

pendingPOST /api/v1/webhooks/fs/pds-onboardinglinked

Firma sa sprístupní v partner API

Automaticky

eFakturuj vytvorí pracovný priestor, uloží partner väzbu a odvodí Peppol ID. Stav môžete sledovať cez GET /api/v1/partner/enrollment-intents — alebo push formou cez lifecycle webhooky nižšie.

Lifecycle webhooky: `client.linked` a `client.activated`

Automaticky

client.linked — vystrelí v momente spracovania FS webhooku: DIČ sa zhodlo s Vašou predregistráciou, organizácia je priradená k partnerovi a profil klienta je nasadený.
client.activated — vystrelí, keď je účastník overený v sieti Peppol (SMP/SML publikovanie dokončené). Od tohto momentu je firma plne prevádzkyschopná: smerovateľná, schopná prijímať aj odosielať. Prihlásenie klienta nemá na túto udalosť žiadny vplyv.

Kde sa konfiguruje

V konzole na vlastnej firme partnera: Connect → Webhooks → Add Endpoint. Do poľa Events zadajte client.linked,client.activated (možno kombinovať s invoice eventami). Doručovanie ide štandardným webhook kanálom — HMAC-SHA256 podpis, automatické opakovanie pri 5xx a delivery log priamo v konzole.

Payload

{
  "id": "3f6c…",
  "event": "client.activated",
  "created_at": "2026-08-29T10:15:00+00:00",
  "data": {
    "organisation_id": "48ecb56f-…",
    "dic": "2020555666",
    "name": "Klient A, s. r. o.",
    "peppol_id": "0245:2020555666"
  }
}

Realita vs. cieľ

Stav funkcií

Stav funkcií hromadného zapojenia klientov
Funkcia	Stav	Poznámka
JSON predregistrácia DIČ	Backend pripravený	Až 5 000 položiek, idempotentné opakovanie.
Úplný profil klienta v API	Backend pripravený	Adresa, IČ DPH, IBAN, e-mail — nasadia sa pri prepojení.
CSV import v konzole	Pripravujeme	Dnes: CSV → JSON požiadavka.
Individuálny výber vo VPDS	Manuálne	Oficiálne zdokumentovaný proces FS.
DIČ auto-link + client.linked	Backend pripravený	Partner väzba sa vytvorí po webhooku.
SMP/SML publikovanie	Backend pripravený	Spustené po webhooku, dokončenie je asynchrónne.
Partner webhooky client.linked / client.activated	Backend pripravený	linked = priradenie po webhooku; activated = účastník overený v sieti. Nastavíte v Connect → Webhooks na vlastnej firme partnera (pridajte tieto eventy k endpointu).

Hromadné zapojenie v 4 krokoch

Partner predregistruje DIČ

Oprávnená osoba potvrdí VPDS

Webhook spojí rovnaké DIČ

Firma sa sprístupní partnerovi

Vy ako sprostredkovateľ pre svojich zákazníkov

Predregistrujte klientov

Mandát v eFakturuj

CSV a úplný profil

Potvrďte jedného klienta vo VPDS

Aktivačný kód pri samostatnej aktivácii

Webhook priradí firmu podľa DIČ

Firma sa sprístupní v partner API

Lifecycle webhooky: client.linked a client.activated

Kde sa konfiguruje

Payload

Stav funkcií

Oficiálne zdroje FS

Lifecycle webhooky: `client.linked` a `client.activated`