← Používateľská príručka

ePošťák — elektronická fakturácia Peppol

Odosiela a prijíma elektronické faktúry a obchodné odpovede Peppol cez slovenský prístupový bod ePošťák — s vlastnou zmluvou s ePošťákom alebo cez hostovanú službu Data Dance.

Na čo slúži

ePošťák je slovenský prístupový bod siete Peppol. Tieto moduly k nemu pripoja Odoo, aby elektronické faktúry pripravené modulom elektronickej fakturácie Peppol naozaj odchádzali a prichádzali:

Nainštalujte tento modul a konektor. Čo sa odosiela, kedy a čo sa stane s prijatými dokladmi, rozhoduje modul Peppol — jeho návod opisuje smerovanie, odoslanie, prijímanie a obchodné odpovede. Tento návod pokrýva to, čo je špecifické pre ePošťák: pripojenie, význam jednotlivých stavov a čo robiť, keď niečo zlyhá.

Povinnú elektronickú fakturáciu od 1. januára 2027 zhŕňa právny rámec návodu k Peppolu.

Používateľské rozhranie je preložené do slovenčiny; anglické názvy polí a tlačidiel uvedené v tomto návode (v zátvorke alebo kurzívou) zodpovedajú anglickej verzii.

Nastavenie

Všetko je v Nastavenia → EDI, časť ePošťák. Prostredie platí pre celú databázu; ID firmy, prihlasovacie údaje (v hostovanej službe kľúč sprostredkovateľa) a vyzdvihovanie patria spoločnosti, v ktorej práve pracujete. Ďalšiu spoločnosť nastavíte tak, že sa do nej prepnete a vyplníte jej vlastné údaje.

1. Prostredie (ePošťák Environment): Sandbox (testovacie, predvolené) alebo Production (produkčné). Kým je aktívny sandbox, upozorňuje na to žltý pruh; doklady zo sandboxu sa do skutočnej siete Peppol nikdy nedostanú. Každé prostredie má vlastné prihlasovacie údaje, takže prepnutie ich nezmaže.
2. Prihlasovacie údaje pre aktívne prostredie — blok Credentials (Sandbox) alebo Credentials (Production): Client ID a Client Secret z vášho účtu v ePošťáku. Polia s adresami URL sú predvyplnené a obvykle sa nemenia. V hostovanej službe vyplňte namiesto nich sprostredkovateľa (nižšie).
3. Configured key ukáže, aký druh kľúča ste zadali — z poľa s heslom sa to spätne prečítať nedá:

1. Test Connection (otestovať pripojenie). Uloží nastavenia a skúsi sa prihlásiť. S integrátorským kľúčom bez ID firmy vypíše firmy, za ktoré smie kľúč konať, aj s ich IČO a Peppol adresou; ak je práve jedna, ID firmy spoločnosti doplní sám. Vymenuje aj ostatné spoločnosti, ktoré povoľujú e-fakturáciu, ale vlastné prihlasovacie údaje k ePošťáku nemajú. Potom stlačte tlačidlo znova na potvrdenie. Výsledok sa vždy zobrazí ako oznámenie — zlyhanie nezahodí to, čo ste zadali.
2. Peppol adresa vašej spoločnosti — na kontakte spoločnosti, záložka Fakturácia: Peppol e-adresa (EAS) 0245 a ako koncový bod vaše DIČ (pozri slovenský identifikátor). Každá požiadavka na ePošťák sa vykoná v mene tohto účastníka. Koncový bod pod schémou 0245, ktorý nemá presne desať číslic, sa odmietne skôr, než sa čokoľvek odošle; osem číslic sa ohlási ako IČO, ktoré smerovateľné nie je.
3. Prepínače spoločnosti na tej istej stránke nastavení, blok Peppol BIS3 (táto firma) — povolenie e-fakturácie, rozsah, automatické odosielanie, nákupný denník: pozri nastavenie Peppolu. Ak je nainštalovaných viac poskytovateľov Peppol, nastavte tam Peppol Transport; ak zostane prázdne, cez Peppol neodíde nič.
4. Pred prvou faktúrou overte odberateľa — pozri dosiahnuteľnosť.

Nastavenia otvárajú len správcovia systému; na odosielanie a prezeranie EDI správ potrebujú aj skupiny EDI (prístup).

Cez hostovanú službu Data Dance

V databáze hostovanej spoločnosťou Data Dance je nainštalovaný modul edi_epostak_broker_client (dodáva sa samostatne) a pripojenie ide cez sprostredkovateľa (broker) hostovanej služby, nie priamo do ePošťáka. Databáza potom nemá žiadne prihlasovacie údaje k ePošťáku. V Nastavenia → EDI → ePošťák, blok Data Dance broker:

Tieto údaje dostanete spolu s hostovanou službou. Client ID, Client Secret a ID firmy sa potom nepoužívajú ani nepotrebujú — za ktoré spoločnosti smie databáza konať, rozhoduje sprostredkovateľ. Test Connection sa ho na to spýta a ohlási chybu, ak pre túto databázu neuvádza žiadnu spoločnosť.

Všetko ostatné — doklady, stavy, vyzdvihovanie, kontrola dosiahnuteľnosti — funguje rovnako. Chyby prichádzajú už roztriedené: kľúč databázy bol odmietnutý, doklad alebo adresa boli odmietnuté (opravte ich, inak zlyhajú rovnako znova), alebo je služba dočasne nedostupná.

Čo znamenajú stavy

EDI správa dokladu odoslaného cez ePošťák prechádza takto:

Zo stavu Sent sa správa dostane do Done alebo Error naplánovanou akciou ePošťák: Query Outbound Delivery Status, ktorá beží každých 30 minút a spracuje najviac 500 odoslaných správ. Potrebuje zapnuté Track Delivery Status (predvolené) a kľúč s právom čítať doklady (rozsah documents:read). Ak ePošťák dopyt na stav odmietne, sledovanie sa v tom behu preskočí a správy jednoducho zostanú v stave Sent — správa, ktorá je v stave Sent dlho, teda znamená „prevzatá, doručenie zatiaľ nepotvrdené“, nie „doručená“.

Doručenie do prístupového bodu príjemcu nie je súhlas odberateľa. Či odberateľ faktúru prijme, rozporuje alebo zaplatí, príde — ak to jeho systém posiela — ako odpoveď na faktúru.

Keď odoslanie zlyhá

Dočasné zlyhanie sa opakuje automaticky pri každom behu EDI: send queued messages (no job runner), teda každé 2 minúty, kým ePošťák doklad neprevezme alebo ho natrvalo neodmietne; počet pokusov nie je obmedzený a čakanie Retry-After, o ktoré ePošťák požiada, sa nad tento interval nedodržiava. Trvalé zlyhanie presunie správu do stavu Error, v ktorom zostane, kým ju niekto neodošle znova. Jeden neúspešný doklad nezastaví ani nezvráti ostatné odoslané v tom istom behu. Identifikátor korelácie od ePošťáka, ak ho poslal, je na konci chyby v hranatých zátvorkách — uveďte ho podpore ePošťáka.

Na opakovanie stlačte Send na EDI správe (alebo Akcie → Send (queue dispatch) pre viac správ). Odošle sa ten istý súbor a ePošťák ho spozná podľa kľúča idempotencie (Transmission UUID, odvodeného z obsahu súboru): ak predchádzajúci pokus v skutočnosti pred chybou prešiel, opakovanie sa zlúči a nedoručí sa dvakrát. Odoslať cez Peppol na faktúre vytvorí súbor nanovo; ak sa v ňom čokoľvek zmenilo, je to pre ePošťák nový doklad.

Prijímanie

Naplánovaná akcia ePošťák: Poll Inbound Documents beží každých 30 minút. Za každú spoločnosť s vlastnými prihlasovacími údajmi k ePošťáku si ako táto spoločnosť vypýta doklady čakajúce na jej Peppol adresu (spoločnosti s jedným integrátorským kľúčom sa pýtajú po jednej Peppol adrese), 20 na stránku a najviac 5 stránok na jeden beh (Documents per Poll Page, Max Pages per Poll), a ak čakajú ďalšie, spustí sa hneď znova. Každý doklad sa uloží a spracuje podľa prijímania elektronických faktúr a až potom sa ePošťáku potvrdí, čím sa odstráni z jeho frontu. Doklad, ktorého obsah sa nedá stiahnuť, sa nepotvrdí a skúsi sa znova nabudúce. Potvrdenie sa týka len Odoo a ePošťáka; odosielateľ z neho nedostane nič.

Prijímanie zlyháva potichu, ak sa nepozeráte, preto konektor hlási sám:

• Last inbound poll v nastaveniach ukazuje pre spoločnosť, v ktorej pracujete, „OK at … — N document(s) fetched“, „FAILED at … — dôvod (last success: …)“ alebo „Never polled“.
• Poll inbound now spustí vyzdvihnutie tejto spoločnosti hneď a povie, ako dopadlo.
• Po Warn after N failed polls zlyhaniach po sebe (predvolene 3; 0 to vypne) vznikne na kontakte vašej spoločnosti aktivita To-Do „Incoming ePošťák documents are not arriving“ pre prvého používateľa so skupinou EDI Manager (inak EDI User, inak pre administrátora). Keď vyzdvihovanie znova funguje, uzavrie sa sama.

Kontrola Peppol adresy odberateľa

Na kontakte s Peppol adresou sa tlačidlom Check Peppol reachability (vedľa koncového bodu, pre používateľov EDI) cez ePošťák spýtate adresára Peppol, či táto adresa môže prijímať faktúry a dobropisy Peppol BIS Billing 3.0:

Ak ePošťák uvedie vlastný dôvod, doplní sa, rovnako ako poznámka, ak účastník nie je pripravený na sieť (not network-ready).

Ladenie prenosu

Blok Transfer Tuning; predvolené hodnoty vyhovujú väčšine databáz.

Obmedzenia

• Jedno prostredie na databázu. Sandbox alebo produkcia platí pre všetky spoločnosti; prihlasovacie údaje a ID firmy má každá spoločnosť vlastné. Spoločnosť, ktorá povoľuje e-fakturáciu bez vlastných prihlasovacích údajov, neodosiela (jej doklady skončia v Error s menom spoločnosti) ani nevyzdvihuje.
• Správa si počas odosielania ponechá prostredie, v ktorom vznikla; opätovné stlačenie Odoslať cez Peppol ju vytvorí znova v prostredí aktívnom teraz (pozri odoslanie).
• Trvalo neúspešné odoslanie sa automaticky neopakuje. Dočasné zlyhanie sa zopakuje po Retry-After od ePošťáku alebo po rastúcej pauze, najviac päťkrát (pozri odosielanie).
• Configured key v režime sprostredkovateľa ukazuje „No secret configured yet“, čo je tam v poriadku.
• Či je ePošťák certifikovaným poskytovateľom doručovacej služby podľa § 76a zákona o DPH, musí potvrdiť ePošťák; tento modul to neoveruje.