Uživatelské API poskytovatele a AS4 mezi Access Pointy jsou rozdílná rozhraní. Otestujte příjem, odeslání, duplicitu a chyby; úspěch HTTP sám nepotvrzuje doručení.
Jak se software připojuje na Peppol přes API?
Běžná integrace propojuje váš fakturační nebo ERP systém s rozhraním poskytovatele doručování. Program připraví údaje, předá doklad a převezme výsledky či přijaté faktury. Poskytovatel zajišťuje svou úlohu v doručovací síti.
Zákaznické API a přenos mezi Access Pointy jsou odlišné vrstvy. Peppol AS4 popisuje komunikaci mezi poskytovateli. Konkrétní adresy API, způsob autentizace a formát odpovědí pro váš program určují podklady zvoleného poskytovatele.
Než se začne programovat, potvrďte rozsah: jen odeslání, jen příjem, nebo oba směry. Uveďte i více firem, opravné doklady, přílohy a požadované propojení s účetnictvím.
Které úlohy rozdělit mezi ERP a poskytovatele?
| Úloha | Co domluvit |
|---|---|
| Vznik faktury | Kde je zdroj údajů a kdo doklad schvaluje |
| Export UBL | Kdo vytvoří XML a který profil či vydání podporuje |
| Adresování | Odkud se přebírá Peppol ID a jak se ověří příjemce |
| Validace | Které vrstvy se provedou a jak se vrátí chyby |
| Doručení | Jakou identifikaci zprávy a výsledek dostane ERP |
| Příjem | Jak se získají původní XML, přílohy a čas přijetí |
| Oznamování | Jak se sleduje výsledek údajů pro Finanční správu SR (Finančná správa SR) |
Poskytovatel může přijmout hotové XML nebo nabízet tvorbu z jiných údajů. V obou případech zkontrolujte, že obchodní význam polí zůstane zachován. Mapování vysvětluje komentovaný vzor XML.
Jak navrhnout odeslání a návrat výsledku?
Doklad nejprve uložte a technicky ověřte. Při předání si zaznamenejte vlastní referenci a identifikaci zprávy poskytovatele. Odpověď API má vysvětlený význam: převzetí požadavku může předcházet konečnému výsledku přenosu.
Při asynchronním zpracování může výsledek přijít webhookem, nebo ho program zjišťuje opakovaným dotazem podle dokumentace. Tyto možnosti nepovažujte za povinnou funkci každého API. Domluvte, jak se výsledek vrátí ke správnému dokladu a co pracovník uvidí při chybě.
Ilustrační tok integrace:
ERP připraví a uloží fakturu
→ ověří XML a přiřadí vlastní referenci
→ předá doklad poskytovateli
→ uloží identifikaci zprávy
→ převezme výsledek přenosu
→ zobrazí stav nebo úkol k opravě
Schéma není definicí konkrétního API. Názvy stavů a dostupná potvrzení přebírejte z dokumentace služby. Technické doručení odlišujte od obchodního schválení odběratelem.
Co se stane při výpadku nebo opakovaném požadavku?
Pokud po odeslání nastane timeout, výsledek může být neznámý: poskytovatel mohl doklad převzít. Opakované odeslání musí mít dohodnutou ochranu před duplicitou. Ověřte, zda API podporuje idempotentní požadavek nebo dohledání zprávy podle vaší reference.
U webhooků počítejte s opakovanou událostí a podle dokumentace ověřujte její původ. Při příjmu si uložte identifikátor zprávy i identitu faktury; neopírejte kontrolu jen o název souboru. Technická duplicita přenosu a dva obchodně podobné doklady jsou odlišné situace.
Připravte i ruční vyřešení případu, který zůstal bez jednoznačného výsledku. Výsledek neoznačujte automaticky jako úspěšný jen proto, že přestal přicházet chybový kód.
Jak nastavit příjem a přístupy více firem?
Získané XML zachovejte a porovnejte údaje s importem do správné firmy. Následné schvalování, přiřazení účtů a úhrada patří do vašeho pracovního postupu. Oficiální struktura UBL pomůže určit, kam patří obchodní údaje.
Testovací a produkční účty držte odděleně. Klíče ukládejte na serveru a zpřístupněte je jen potřebným procesům. U více subjektů ověřte rozsah každého oprávnění, aby požadavek jedné firmy nemohl zpracovat doklady druhé.
Určete i obnovu přístupu a výměnu údajů při změně služby. Provozní záznam má pomoci dohledat problém bez zbytečného kopírování celého obsahu faktur do každého logu.
Co musí projít zkouškou před spuštěním?
Otestujte běžné odeslání a příjem, neplatný doklad, neznámého příjemce, opravu a opakovaný import. Přidejte timeout po předání, opakovanou událost a dočasnou nedostupnost služby. U každého scénáře určete očekávaný výsledek a postup obsluhy.
Zaznamenejte použité vydání pravidel a verzi konektoru. Při aktualizaci je porovnejte s platnými specifikacemi eDelivery. Kontrolu dokladu vysvětluje validace e-faktury.
U slovenského provozu přidejte i dohodu o oznamování údajů. Finanční správa SR popisuje automatický přenos přes Digitálního pošťáka (Digitálny poštár); integrace má uživateli umožnit dohledat jeho výsledek. Obecný tok popisuje doručování faktur.
Organizaci práce a zkoušky s dodavatelem softwaru doplňuje návod k napojení účetního programu. Převod stávajících podkladů řeší postup PDF na eFaktúru.
Ověřené zdroje
Vycházíme z oficiálních materiálů. Původní podklady najdete pod odkazy níže. Při změnách pravidel aktualizujeme i tohoto průvodce.
Obsah ověřen 1. 10. 2026. V konkrétním daňovém případě rozhoduje příslušné znění zákona a okolnosti dodání.