eFaktúra mostík by NextVision Analytics

Začíname

Pripojenie Doklado (SAPI+)

Registrácia v Doklado, aktivácia SAPI+, Client ID a Client Secret, Peppol adresa a webhook.

Doklado je akreditovaný digitálny poštár. eFaktúra mostík mu odovzdáva vaše vydané faktúry cez rozhranie SAPI+ a Doklado ich doručí odberateľom v sieti Peppol a oznámi finančnej správe. Postup má štyri časti: účet v Doklado, aktivácia poštára, prístup k SAPI+ a webhook.

1. Účet a firma v Doklado

  1. Na doklado.com kliknite na Vyskúšať zadarmo a vyplňte registračný formulár.
  2. Potvrďte e-mail a doplňte fakturačné údaje firmy – po uložení sa firma objaví v Zozname firiem.
  3. Ďalšiu firmu pridáte cez Zoznam firiem → Pridať firmu.

Podrobný postup s obrázkami: Ako si založiť účet v Doklado.

2. Aktivácia Doklado Poštára

  1. V Zozname firiem kliknite pri firme na Vyberte Poštára.
  2. Poštára potvrdíte na portáli finančnej správy (prihlásenie eID alebo menom a heslom, výber daňového subjektu, kontaktné údaje, Povoliť). Ak to za vás robí účtovník, zvoľte možnosť zapojiť účtovníka.
  3. Po aktivácii má firma v Doklado zelenú ikonu obálky a text, že prijímanie a odosielanie e-faktúr je aktívne.

Podrobne: Mám Doklado účet a Výber poštára na portáli finančnej správy.

3. Prístup k SAPI+ (Client ID a Client Secret)

Aby mohol eFaktúra mostík odovzdávať faktúry, potrebuje od Doklado prístupové údaje k rozhraniu SAPI+ – Client ID a Client Secret.

  1. V aplikácii otvorte Nastavenia → Doklado. Adresa webhooku je pripravená hneď, ešte pred zadaním prístupov.
  2. Požiadajte Doklado o aktiváciu SAPI+ – tlačidlo Pripraviť e-mail pre Doklado pripraví e-mail na efaktura@doklado.sk s názvom firmy, DIČ a adresou webhooku. Doplňte odkaz na firmu v Doklado a registračný e-mail. Doklado oznámilo, že nastavenie SAPI a webhookov bude dostupné aj priamo v jeho webovej aplikácii.
  3. Client ID a Client Secret od Doklado zadajte do formulára, zvoľte prostredie (Sandbox na skúšanie, neskôr Produkcia) a kliknite na Uložiť a otestovať.
  4. Aplikácia sa prihlási do Doklado a overí, či je vaša firma v sieti Peppol. Pri úspechu sa krok v prehľade označí ako hotový.
Pripojenie k Doklado – Client ID, Client Secret, Peppol adresa a webhook.
Pripojenie k Doklado – Client ID, Client Secret, Peppol adresa a webhook.

Nepomýľte si API kľúče. Kľúč z Doklado v časti Prehľad účtu → API prepojenia patrí k inému rozhraniu (Doklado Public API) a v eFaktúra mostík nefunguje. Potrebujete Client ID a Client Secret pre SAPI+.

Client Secret je ako heslo – neposielajte ho e-mailom ďalším osobám ani do chatu. V aplikácii je uložený šifrovaný a po uložení sa už nezobrazí.

Peppol adresa vašej firmy

Adresa odosielateľa v sieti Peppol je vždy 0245: a DIČ vašej spoločnosti (napr. 0245:2021234567). Aplikácia ju určí sama z DIČ v údajoch spoločnosti, nikde ju nezadávate. Pod rovnakou adresou musí byť firma aktivovaná aj v Doklado.

4. Webhook – potvrdenie odoslania do eFaktúry

Po odovzdaní faktúry vidíte v aplikácii stav Prijatá Doklado. Informáciu, že Doklado faktúru odoslalo do eFaktúry a bola doručená (alebo že doručenie zlyhalo), posiela Doklado cez webhook – automatickú správu na adresu našej aplikácie.

  1. Skopírujte Adresu webhooku pre Doklado z Nastavenia → Doklado a zadajte ju v aplikácii Doklado v nastaveniach SAPI a webhookov.
  2. Doklado vám zobrazí webhook secret (tajný kľúč na podpisovanie správ). Vložte ho do poľa Webhook secret a uložte.
  3. Odteraz sa pri faktúrach automaticky dopĺňa záznam Odoslaná do eFaktúry, prípadne chyba doručenia s dôvodom.

Kým webhook nie je nastavený, odoslané faktúry ostávajú v stave Prijatá Doklado a výsledok doručenia uvidíte len v aplikácii Doklado. Prijaté faktúry sa načítavajú aj bez webhooku, každých 15 minút.

Ak adresu webhooku vygenerujete znova (napr. pri podozrení na únik), nastavte novú adresu aj v Doklado – starú prestaneme prijímať.

Prijaté faktúry do ABRA Flexi

Prijaté e-faktúry prenáša do ABRA Flexi samotné Doklado. Prepojenie nastavíte v Doklado pri firme (účtovný program ABRA, adresa servera, organizácia a API používateľ Flexi) a faktúry prenesiete v Doklado v časti Prijaté faktúry → Exportovať. Toto prepojenie je služba Doklado a môže byť spoplatnené podľa jeho cenníka. Návod: Pridanie firmy v Doklado a Export dokladov do účtovného programu.

Pomoc s účtom v Doklado poskytuje podpora Doklado – tlačidlo Podpora v aplikácii Doklado alebo podpora@doklado.sk.

Nenašli ste odpoveď? Napíšte nám na efaktura@nva.sk.