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
- Na doklado.com kliknite na Vyskúšať zadarmo a vyplňte registračný formulár.
- Potvrďte e-mail a doplňte fakturačné údaje firmy – po uložení sa firma objaví v Zozname firiem.
- Ď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
- V Zozname firiem kliknite pri firme na Vyberte Poštára.
- 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.
- 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.
- V aplikácii otvorte Nastavenia → Doklado. Adresa webhooku je pripravená hneď, ešte pred zadaním prístupov.
- 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.
- 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ť.
- 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ý.
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.
- Skopírujte Adresu webhooku pre Doklado z Nastavenia → Doklado a zadajte ju v aplikácii Doklado v nastaveniach SAPI a webhookov.
- Doklado vám zobrazí webhook secret (tajný kľúč na podpisovanie správ). Vložte ho do poľa Webhook secret a uložte.
- 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.