Vytvorenie SAPI+ pripojenia
Vygenerujte Client ID a Client Secret, vyberte firmy a bezpečne uložte prístupy aj Webhook Secret.
Na prepojenie vášho účtovného alebo ERP systému s Doklado potrebujete Client ID a Client Secret. Vygenerujete ich vo webovej aplikácii v časti Prehľad účtu → SAPI+ prepojenia.
Ak pri vytváraní zadáte aj URL webhooku, vygeneruje sa vám navyše Webhook Secret na overovanie notifikácií.
Pred začiatkom
Prihláste sa do prostredia, pre ktoré vytvárate prístupy:
| Prostredie | Webová aplikácia |
|---|---|
| Sandbox na testovanie | efaktura-sandbox.doklado.sk |
| Produkcia | app.doklado.sk |
Pre sandbox najskôr dokončite aktiváciu SAPI+. Pripravte si názov prepojenia a rozhodnite sa, ku ktorým firmám má mať váš systém prístup. Ak chcete webhooky, pripravte si ich URL adresu od správcu alebo dodávateľa svojho systému.
1. Otvorte SAPI+ prepojenia
V Prehľade účtu vyberte SAPI+ prepojenia. Potom kliknite vpravo hore na + Nové prepojenie.
2. Pomenujte prepojenie
Do povinného poľa Názov prepojenia napíšte názov, podľa ktorého ho neskôr ľahko rozpoznáte. Napríklad Účtovný systém – firma ABC alebo ERP – skupina firiem.
Názov slúži na váš prehľad. Nie je to Client ID ani heslo.
3. Rozhodnite sa, či chcete webhooky
Pole URL pre príjem notifikácií (webhook) je voliteľné.
- Chcete dostávať notifikácie do svojho systému? Vložte URL, ktorú vám poskytol jeho správca alebo dodávateľ, napríklad
https://vas-system.sk/webhooks/doklado. - Webhooky zatiaľ nepoužívate? Pole nechajte prázdne. Prijaté dokumenty môžete načítavať cez API.
Do tohto poľa patrí adresa vo vašom systéme, na ktorú má Doklado posielať notifikácie. Adresu webovej aplikácie Doklado sem nevkladajte.
Ak URL vyplníte, spolu s klientskými prístupmi sa vygeneruje aj Webhook Secret.
4. Vyberte firmy
V zozname sa zobrazujú iba firmy, ktoré majú aktivovanú eFaktúru. Jedna firma môže mať iba jedno SAPI+ pripojenie. Pred vytvorením nového prepojenia skontrolujte, či už firma nie je priradená k existujúcemu pripojeniu. Toto pravidlo platí aj pri výbere skupiny alebo všetkých firiem.
Ak svoju firmu nevidíte, skontrolujte aktiváciu eFaktúry.
Určite, ku ktorým z týchto firiem bude mať prepojenie prístup. Aj možnosť Prístup k všetkým Firmám sa vzťahuje na firmy s aktivovanou eFaktúrou:
| Potrebujete prístup… | Čo vybrať |
|---|---|
| K jednej firme | Vyhľadajte firmu a zaškrtnite ju v zozname. |
| K skupine vybraných firiem | Zaškrtnite všetky firmy, ktoré má prepojenie používať. |
| Ku všetkým firmám | Zaškrtnite Prístup k všetkým Firmám. |
Napríklad pri prepojení iba pre firmu ABC vyberte len firmu ABC. Ak jeden systém spracúva firmy ABC aj XYZ, vyberte obe.
Pred pokračovaním skontrolujte názov, prípadnú URL webhooku aj výber firiem.
5. Vygenerujte prístupy
Kliknite na Vygenerovať nové prepojenie. V nasledujúcom kroku sa zobrazia vygenerované údaje:
| Údaj | Na čo slúži |
|---|---|
| Client ID | Identifikuje vaše prepojenie. Pri získaní tokenu ho zadávate ako client_id. |
| Client Secret | Tajný kľúč prepojenia. Pri získaní tokenu ho zadávate ako client_secret. |
| Webhook Secret | Zobrazí sa, ak ste zadali URL webhooku. Váš systém ním overuje, že notifikácia prišla z Doklado. |
Client Secret a Webhook Secret majú odlišný účel. Pri nastavovaní integrácie ich nezameňte.
6. Uložte údaje pred zatvorením okna
Secrety sa zobrazia iba raz. Pred kliknutím na Zavrieť ich bezpečne uložte. Po zatvorení dialógu ich už nebude možné znovu zobraziť. Bude ich možné iba resetovať.
- Client ID skopírujte kliknutím na ikonu kopírovania na pravej strane jeho riadku.
- Rovnakou ikonou na pravej strane riadku Client Secret skopírujte aj tajný kľúč. Oba údaje uložte do bezpečného úložiska, napríklad firemného správcu hesiel alebo úložiska tajných údajov vašej integrácie. Ikona oka slúži na zobrazenie tajnej hodnoty.
- Ak používate webhooky, rovnako uložte aj Webhook Secret.
- K údajom si poznačte názov prepojenia, prostredie a vybrané firmy.
- Až keď máte všetko uložené, kliknite na Zavrieť.
Tajné hodnoty neposielajte do bežného chatu ani e-mailu a neprikladajte ich na screenshoty. Ak pripojenie nastavuje dodávateľ vášho systému, odovzdajte mu údaje bezpečným spôsobom určeným vašou organizáciou.
Ak secret stratíte, bude potrebný reset. Novú hodnotu potom nastavte aj v pripojenom systéme.
Čo ďalej
S uloženými client_id a client_secret pokračujte na Prvé volanie SAPI+, kde získate access token a vyskúšate načítanie dokumentov.
Ak ste nastavili webhook, odovzdajte jeho secret správcovi integrácie na nastavenie overovania webhookov. Podrobnosti o tokenoch nájdete na stránke Autentifikácia a tokeny.