Odosielanie PDF faktúr cez Peppol

Odosielanie PDF faktúr cez Peppol pomocou PSB eConnect: e-mail alebo API, rozpoznávanie IDR a validácia.

PDF faktúra technicky nie je elektronická faktúra: údaje nie sú v štruktúrovanom formáte a presnosť nemôže byť zaručená len rozpoznávaním skenu. Napriek tomu eConnect ponúka riešenie na odosielanie PDF faktúr cez Peppol. PSB rozpozná PDF pomocou IDR (Intelligent Document Recognizer), validuje podstatné polia na základe Vami dodaných metadát a vytvorí z neho platnú elektronickú faktúru.

Ako to funguje: odošlete PDF spolu so sadou kontrolných metadát (číslo faktúry, sumy, príjemca). IDR rozpozná faktúru a porovná rozpoznanie s Vašimi metadátami. Všetko súhlasí? Faktúra sa odošle. Nesúhlasí? Dostanete upozornenie.

Poznámka: táto stránka popisuje odoslanie samostatného PDF bez UBL (rozpoznávanie pomocou IDR na základe dodaných metadát). Chcete namiesto toho priložiť PDF ako prílohu k elektronickej faktúre, ktorú už dodávate vo formáte UBL? Pozrite Prikladanie príloh v článku Odoslanie faktúry cez API.

Dva spôsoby odoslania

Existujú dva spôsoby odoslania PDF faktúry do PSB. Oba spôsoby vyžadujú rovnaké metadáta.

Spôsob 1: cez e-mail

Odošlite PDF ako prílohu na zabezpečenú e-mailovú adresu Vášho PSB tenanta. V tele e-mailu uveďte kontrolné metadáta vo formáte Markdown:

[factuurnummer](INV-2026-0042)
[totaalfactuur](1.250,00)
[totaalbtw](262,50)
[ontvangerSchemeId](0106)
[ontvangerIdentifier](12345678)
[ontvangerNaam](Voorbeeldbedrijf B.V.)
[ontvangerEmail](finance@voorbeeld.nl)

Tagy v hranatých zátvorkách sa dohodnú počas úvodnej konfigurácie. Je dôležité, aby sa po spustení spojenia nemenili.

Poznámka: Presnú e-mailovú adresu a dostupné tagy konfiguruje eConnect individuálne pre každého zákazníka. Kontaktujte TechSupport pre úvodnú konfiguráciu.

Spôsob 2: cez API GenericSend

Odošlite PDF do API GenericSend a dodajte metadáta ako metaAttributen (páry kľúč-hodnota):

{
  "factuurnummer": "INV-2026-0042",
  "totaalfactuur": "1250,00",
  "totaalbtw": "262,50",
  "ontvangerSchemeId": "0106",
  "ontvangerIdentifier": "12345678"
}

Pri odoslaní cez API dostanete späť documentId. Tento identifikátor môžete prepojiť s faktúrou vo Vašom vlastnom softvéri, aby ste mohli sledovať stav odoslania. Môžete tiež zadať vlastné documentId.

Povinné metadáta

Nasledujúce polia sú minimálne povinné:

PolePopisfactuurnummerJedinečné číslo faktúrytotaalfactuurCelková suma faktúry vrátane DPHtotaalbtwCelková suma DPHontvangerSchemeIdIdentifikátor schémy Peppol príjemcu (napr. 0106 pre KvK)ontvangerIdentifierIdentifikačné číslo príjemcu (napr. číslo KvK)ontvangerNaamNázov príjemcuontvangerEmailE-mailová adresa príjemcu

Ďalšie tagy môžu byť pridané po dohode.

Proces spracovania

Po prijatí PDF prechádza nasledujúcimi krokmi:

  1. Rozpoznávanie: IDR rozpozná PDF faktúru a prevedie ju na XML faktúru (UBL)
  2. Smerovacie polia: údaje o príjemcovi z metadát sa prenesú do XML
  3. Validácia: kontrolné metadáta sa porovnajú s hodnotami rozpoznanými IDR. Číslo faktúry, názov príjemcu a identifikátory z Vašich metadát môžu prepísať rozpoznané hodnoty. Ak sa suma faktúry alebo DPH líši od rozpoznania, toto pole je tiež prepísané a faktúra je odmietnutá
  4. Odoslanie alebo upozornenie: ak je validácia úspešná, faktúra sa odošle cez Peppol (alebo inú nakonfigurovanú metódu doručenia). Ak validácia zlyhá, dostanete upozornenie
Chybové hlásenia

Ak validácia nie je úspešná (napríklad preto, že rozpoznaná suma sa líši od dodanej sumy), existujú tri spôsoby prijatia upozornenia:

MetódaPopisE-mailTechnická chybová správa e-mailom. Adresa príjemcu môže byť pevne nastavená, extrahovaná z XML alebo metadát, alebo to môže byť adresa odosielateľaWebhookPri použití API môžete nakonfigurovať adresu webhooku. PSB odošle aktualizáciu stavu, aby ste mohli aktualizovať stav vo Vašom vlastnom softvériPlatformaChybová správa je viditeľná aj v platforme eConnect pri príslušnom dokumente
Riadky faktúry

Pri rozpoznávaní riadkov IDR prenesie riadky faktúry len vtedy, ak súčet súm riadkov zodpovedá celkovej sume bez DPH. Ak riadky nezodpovedajú, IDR vloží celkovú sumu pre každú kategóriu DPH ako riadok faktúry do XML. Chcete, aby faktúra bola v takom prípade odmietnutá namiesto odoslanej? To je konfigurovateľné. Ak nie je rozpoznaný žiadny riadok faktúry, možno toto voliteľne tiež nastaviť tak, aby faktúra bola odmietnutá namiesto odoslanej bez riadkov; dostanete rovnaké upozornenie ako pri inej chybe validácie.

Dôležité: Faktúra, ktorá bola odmietnutá, nemôže byť následne opravená a automaticky odoslaná. Jedinou možnosťou je manuálne nahrať XML cez platformu.

Kedy použiť PDF via Peppol?

Toto riešenie je určené pre situácie, keď zdroj faktúr nemôže vygenerovať štruktúrovaný formát, ale napriek tomu chcete odosielať cez Peppol. Typické scenáre:

  • Softvérové balíky, ktoré podporujú len export do PDF
  • Hybridné prostredia, kde časť fakturačného toku je už digitálna a časť stále beží na PDF
  • Postupná migrácia na úplnú elektronickú fakturáciu

Pre najlepšiu kvalitu a spoľahlivosť sa vždy odporúča dodávať priamo vo formáte UBL cez API.


Chcete nastaviť PDF via Peppol? Kontaktujte náš tím pre úvodnú konfiguráciu.

Požiadať o konfiguráciu