Sandbox a aktivácia
Pripravte testovaciu firmu a požiadajte o aktiváciu SAPI+.
Pre vývoj a overenie integrácie použite Doklado Sandbox. Registrácia je otvorená.
1. Vytvorte účet a testovaciu firmu
Zaregistrujte sa platnou a pravidelne sledovanou e-mailovou adresou. Po prihlásení vytvorte testovaciu firmu; možnosť založenia firmy je v pravom hornom rohu aplikácie.
2. Požiadajte o aktiváciu
Pošlite žiadosť na efaktura@doklado.sk a uveďte:
- DIČ a názov vytvorenej testovacej firmy,
- URL odkaz na firmu v Doklado Sandbox,
- e-mailovú adresu použitú pri registrácii,
- URL vášho webhooku, ak chcete používať webhooky.
Pri ďalšej komunikácii uvádzajte registračnú e-mailovú adresu. Pri aktivácii si potvrďte Peppol Participant ID firmy a dostupnosť požadovaných funkcií.
3. Vygenerujte klientské prístupy
Po aktivácii otvorte Prehľad účtu → SAPI+ prepojenia a vytvorte nové prepojenie. Môže byť určené pre jednu firmu, vybrané firmy alebo všetky firmy. Systém ponúka iba firmy s aktivovanou eFaktúrou. Jedna firma môže mať iba jedno SAPI+ pripojenie, aj keď vytvárate prepojenie pre skupinu alebo všetky firmy. Ak firma vo výbere chýba, skontrolujte jej aktiváciu eFaktúry aj existujúce SAPI+ pripojenie. Ak zadáte URL webhooku, vygeneruje sa aj Webhook Secret.
Podrobný postup so screenshotmi nájdete v návode Vytvorenie SAPI+ pripojenia. Secrety si bezpečne uložte ešte pred zatvorením dialógu — zobrazia sa iba raz.
4. Overte integráciu
- Získajte token podľa návodu Autentifikácia.
- Načítajte prijaté dokumenty cez prvé volanie API.
- Overte vyhľadanie príjemcu a odoslanie testovacej eFaktúry.
- Pri príjme otestujte uloženie XML aj následné potvrdenie
acknowledge. - Ak používate webhooky, overte podpis, opakované doručenie a polling pri výpadku webhooku.
V sekcii REST API referencia nájdete vstupy a odpovede jednotlivých operácií.