Skvelé API
vrátane webhookov

Jednoduchá integrácia. Ponúkame prehľadné rozhranie, ktoré vám umožní začať posielať a prijímať dokumenty počas niekoľkých hodín.

Pozrieť API dokumentáciu

Vaša aplikácia získa prístup k:

Overenie, či príjemca používa PEPPOL
Odosielanie dokumentov v rôznych formátoch
Prijímanie dokumentov
Sledovanie stavu dokumentov
Konverzia medzi formátmi
Notifikácie o nových dokumentoch

Dve prostredia pripravené
na váš plynulý vývoj

Aby bola integrácia do vášho SaaS čo najbezpečnejšia a najrýchlejšia, oddelili sme testovanie od ostrej prevádzky. K dispozícii máte dve nezávislé prostredia, ktoré presne zodpovedajú potrebám vášho vývojového cyklu.

Sandbox (Testovacie prostredie)

Ideálne na vývoj, experimentovanie a bezstarostné testovanie. V sandboxe si vaši vývojári môžu vyskúšať API, nastaviť webhooky a otestovať aplikáciu bez rizika a zbytočnej administratívy.

Okamžitý štart: Nemusíte čakať na schválenie účtu ani absolvovať proces overovania. Zaregistrujete sa a môžete hneď testovať.
Prepojenie s testovacou sieťou Peppol: Sandbox nie je iba izolovaná simulácia. Je skutočne pripojený k oficiálnej testovacej sieti Peppol. Môžete tak posielať testovacie e-faktúry do iných testovacích prístupových bodov (Access Points) a overiť si doručenie od začiatku až do konca.
Sandbox je úplne zadarmo: Za správy odoslané v sandboxe nič neplatíte. Môžete odoslať toľko testovacích požiadaviek, koľko váš vývojový tím potrebuje.

Produkcia (Ostrá prevádzka)

Skutočné firemné transakcie a maximálna bezpečnosť. Keď máte integráciu hotovú a otestovanú, prepnete aplikáciu na produkčný endpoint. V tomto prostredí naplno funguje podnikanie vašich zákazníkov.

Len pre ostré údaje: Produkčné prostredie slúži výhradne na reálnu e-fakturáciu s právnymi účinkami.
Dôkladné overenie zákazníka: Vzhľadom na prísne bezpečnostné štandardy siete Peppol a legislatívne požiadavky sa v produkcii vyžaduje skutočné overenie identity subjektu. Tým zaručujeme úplnú dôveryhodnosť všetkých odosielateľov.
Garantovaná dostupnosť a podpora: Produkčné API beží na vysoko dostupnej infraštruktúre s garantovaným SLA, aby faktúry vašich klientov vždy dorazili načas.

Integračné scenáre pre prepojenie

API podporuje niekoľko integračných modelov. Vyberte si podľa typu produktu a prevádzkových potrieb.

Som vývojár riešenia na mieru

Ak vytvárate aplikáciu pre seba alebo jedného klienta a chcete prijímať či odosielať doklady, použite API kľúč s prístupom k jednému participantovi (firme).

Na výmenu client_id/client_secret za Bearer token použite autorizačný endpoint /api/auth/token (viac informácií).

Na odosielanie použite zjednodušené endpointy:
/api/documents/send?wait-for-result alebo /api/documents/send/isdoc?wait-for-result

Súvisiace odkazy: Dokumentácia | Príklad

Som účtovná kancelária

Použite API kľúč s prístupom ku všetkým participantom (firmám) a odosielajte doklady cez routy viazané na participanta.

Na výmenu client_id/client_secret za Bearer token použite autorizačný endpoint /api/auth/token (viac informácií).

Endpointy na odosielanie:
/api/participants/{PARTICIPANT_ID}/documents/send?wait-for-result alebo /api/participants/{PARTICIPANT_ID}/documents/send/as/isdoc?wait-for-result

PARTICIPANT_ID môže byť:

ext:VÁŠ_IDENTIFIKÁTOR
Peppol ID (napríklad 9929:12345678)
UUID pridelené našou platformou

Súvisiace odkazy: Dokumentácia | Príklad

Som vývojár a autor SaaS

Typický postup je ponúknuť v aplikácii možnosť „Odosielajte faktúry do Peppolu“, presmerovať používateľa na súhlas OAuth a potom používať vydaný refresh token na odosielanie alebo príjem dokladov v jeho mene.

Pokračujte pridaním aplikácie v sekcii Developers a nastavením požadovaných oprávnení.

Potom stačí používať zjednodušené endpointy na odosielanie:
/api/documents/send?wait-for-result alebo /api/documents/send/isdoc?wait-for-result

Súvisiace odkazy: Dokumentácia | Príklad

Som vývojár fakturačnej SaaS aplikácie

Pri účtovných, fakturačných alebo vyťažovacích systémoch je onboarding často jednoduchší, keď klient nemusí najprv ručne vytvoriť účet a potom sa vracať udeliť prístup. Účty klientov môžete zakladať automaticky a overenie spúšťať priamo z aplikácie. Bežné možnosti sú:

Každého klienta už poznáte a overenie (KYC) zabezpečujete vlastným zmluvným procesom.
Účet založíte vy a overenie dokončí Dativery (napríklad cez Bank iD a ďalšie metódy).

Na Slovensku je počas overovania potrebné potvrdiť príjem na portáli finančnej správy. V tomto modeli si vytvoríte API kľúč, založíte jednotlivých klientov a potom odosielate doklady pod ich participantmi.

Súvisiace odkazy: Dokumentácia | Príklad

Pracujem s jednoduchou aplikáciou bez backendu

Použite komponent tlačidla „Odoslať cez Peppol“. Umožní vám odosielanie aj bez vlastného backendu; používateľ bude počas procesu vyzvaný na prihlásenie.

Súvisiace odkazy: Dokumentácia | Príklad

Prejdime si integráciu spoločne

Rezervujte si nezáväzný rozhovor s naším technickým konzultantom. Pozrieme sa na architektúru vašej aplikácie a ukážeme vám najlepší spôsob integrácie enginu.

Naplánovať stretnutie