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.
Existujú dva spôsoby odoslania PDF faktúry do PSB. Oba spôsoby vyžadujú rovnaké metadáta.
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.
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.
Nasledujúce polia sú minimálne povinné:
factuurnummertotaalfactuurtotaalbtwontvangerSchemeId0106 pre KvK)ontvangerIdentifierontvangerNaamontvangerEmailĎalšie tagy môžu byť pridané po dohode.
Po prijatí PDF prechádza nasledujúcimi krokmi:
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:
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.
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:
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