Skvělé API
včetně webhooků

Jednoduchá integrace. Nabízíme přehledné rozhraní, které vám umožní začít posílat a přijímat dokumenty během několika hodin.

Prohlédnout API dokumentaci

Vaše aplikace získá přístup k:

Ověření, zda příjemce používá Peppol
Odeslání dokumentů v různých formátech
Příjem dokumentů
Sledování stavu dokumentů
Konverze mezi formáty
Notifikace o nových dokumentech

Dvě prostředí připravená
pro váš hladký vývoj

Aby byla integrace do vašeho SaaS co nejbezpečnější a nejrychlejší, oddělili jsme testování od ostrého provozu. K dispozici máte dvě nezávislá prostředí, která přesně odpovídají potřebám vašeho vývojového cyklu.

Sandbox (Testovací prostředí)

Ideální pro vývoj, experimentování a bezstarostné testování. Sandbox slouží k tomu, aby si vaši vývojáři osahali API, nastavili webhooky a otestovali aplikaci bez jakéhokoli rizika nebo zbytečné byrokracie.

Okamžitý start: Nemusíte čekat na schválení účtu ani procházet procesem ověřování. Registrujete se a hned testujete.
Propojeno s testovací sítí Peppol: Sandbox není jen izolovaná simulace. Je reálně připojen k oficiální testovací síti Peppol. To znamená, že můžete posílat testovací e-faktury do jiných testovacích přístupových bodů (Access Points) a ověřit si doručení end-to-end.
Sandbox je zcela zdarma: Za zprávy odeslané v sandboxu nic neplatíte. Můžete poslat tolik testovacích požadavků, kolik váš vývojový tým potřebuje.

Produkce (Ostrý provoz)

Skutečné firemní transakce a maximální bezpečnost. Jakmile máte integraci hotovou a otestovanou, přepnete svou aplikaci na produkční endpoint. V tomto prostředí běží byznys vašich zákazníků naplno.

Pouze pro ostrá data: Produkční prostředí slouží výhradně pro reálnou e-fakturaci s právní váhou.
Důkladné ověření zákazníka: Kvůli přísným bezpečnostním standardům sítě Peppol a legislativním požadavkům je v produkci vyžadováno skutečné ověření identity subjektu. Tím garantujeme stoprocentní důvěryhodnost všech odesílatelů.
Garantovaná dostupnost a podpora: Produkční API běží na vysoce dostupné infrastruktuře s garantovaným SLA, abychom zajistili, že faktury vašich klientů dorazí vždy včas.

Integrační scénáře pro napojení

API podporuje několik integračních modelů. Vyberte si podle typu vašeho produktu a provozních potřeb.

Jsem developer na míru

Pokud vytváříte aplikaci pro sebe nebo pro jednoho klienta a chcete přijímat nebo odesílat doklady, použijte API klíč s přístupem k jednomu participantovi (firmě).

Použijte autorizační endpoint pro převod client_id/client_secret na Bearer token /api/auth/token (více informací).

Použijte zjednodušené endpointy pro odesílání:
/api/documents/send?wait-for-result nebo /api/documents/send/isdoc?wait-for-result

Související odkazy: Dokumentace | Příklad

Jsem účetní kancelář

Použijte API klíč s přístupem ke všem participantům (firmám) a odesílejte doklady přes participant-scoped routy.

Použijte autorizační endpoint pro převod client_id/client_secret na Bearer token /api/auth/token (více informací).

Endpointy pro odesílání:
/api/participants/{PARTICIPANT_ID}/documents/send?wait-for-result nebo /api/participants/{PARTICIPANT_ID}/documents/send/as/isdoc?wait-for-result

PARTICIPANT_ID může být:

ext:VÁŠ_IDENTIFIKÁTOR
Peppol ID (například 9929:12345678)
UUID přidělené naší platformou

Související odkazy: Dokumentace | Příklad

Jsem developer a autor SaaS

Typický flow je nabídnout v aplikaci „Odesílejte faktury do Peppol“, přesměrovat uživatele na OAuth souhlas a potom používat vydaný refresh token pro odesílání nebo příjem dokladů jménem uživatele.

Pokračujte tím, že v sekci Developers přidáte aplikaci a nastavíte požadovaná oprávnění.

Pak stačí používat zjednodušené endpointy pro odesílání:
/api/documents/send?wait-for-result nebo /api/documents/send/isdoc?wait-for-result

Související odkazy: Dokumentace | Příklad

Jsem developer a autor SaaS se specializací na faktury

Pro účetní, fakturační nebo vytěžovací systémy je onboarding často jednodušší, když klient nemusí nejprve ručně vytvořit účet a pak se vracet zpět pro udělení přístupu. Účty klientů můžete zakládat automaticky a verifikaci spouštět přímo z aplikace. Běžné varianty jsou:

Každého klienta už znáte a verifikaci (KYC) zajišťujete vlastním smluvním procesem.
Účet založíte vy a verifikaci dokončí Dativery (například přes Bank iD a další metody).

Na Slovensku je potřeba během verifikačního flow potvrdit příjem na portálu finanční správy. V tomto modelu si vytvoříte API klíč, založíte jednotlivé klienty a následně odesíláte doklady pod jejich participanty.

Související odkazy: Dokumentace | Příklad

Pracuji s jednoduchou aplikací bez backendu

Využijte komponentu tlačítka „Odeslat přes Peppol“. Umožní vám zajistit odeslání i bez vlastního backendu; uživatel bude během flow vyzván k přihlášení.

Související odkazy: Dokumentace | Příklad

Proberme integraci společně

Rezervujte si nezávazný hovor s naším technickým konzultantem. Podíváme se na architekturu vaší aplikace a ukážeme vám, jak engine nejlépe integrovat.

Naplánovat schůzku