PDF faktura technicky není elektronická faktura: data nejsou ve strukturovaném formátu a přesnost nemůže být zaručena pouze rozpoznáváním skenu. Přesto eConnect nabízí řešení pro odesílání PDF faktur přes Peppol. PSB rozpozná PDF pomocí IDR (Intelligent Document Recognizer), validuje podstatná pole na základě Vámi dodaných metadat a vytvoří z něj platnou elektronickou fakturu.

Poznámka: tato stránka popisuje odeslání samostatného PDF bez UBL (rozpoznávání pomocí IDR na základě dodaných metadat). Chcete místo toho přiložit PDF jako přílohu k elektronické faktuře, kterou již dodáváte ve formátu UBL? Viz Přikládání příloh v článku Odeslání faktury přes API.

Existují dva způsoby odeslání PDF faktury do PSB. Oba způsoby vyžadují stejná metadata.

Odešlete PDF jako přílohu na zabezpečenou e-mailovou adresu Vašeho PSB tenanta. V těle e-mailu uveďte kontrolní metadata ve formátu 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ávorkách se dohodnou během úvodní konfigurace. Je důležité, aby se po spuštění spojení neměnily.

Poznámka: Přesnou e-mailovou adresu a dostupné tagy konfiguruje eConnect individuálně pro každého zákazníka. Kontaktujte TechSupport pro úvodní konfiguraci.

Odešlete PDF do API GenericSend a dodejte metadata jako metaAttributen (páry klíč-hodnota):

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

Při odeslání přes API obdržíte zpět documentId. Tento identifikátor můžete propojit s fakturou ve Vašem vlastním softwaru, abyste mohli sledovat stav odeslání. Můžete také zadat vlastní documentId.

Následující pole jsou minimálně povinná:

Další tagy mohou být přidány po dohodě.

Po přijetí PDF prochází následujícími kroky:

1. Rozpoznávání: IDR rozpozná PDF fakturu a převede ji na XML fakturu (UBL)
2. Směrovací pole: údaje o příjemci z metadat se přenesou do XML
3. Validace: kontrolní metadata se porovnají s hodnotami rozpoznanými IDR. Číslo faktury, název příjemce a identifikátory z Vašich metadat mohou přepsat rozpoznané hodnoty. Pokud se částka faktury nebo DPH liší od rozpoznání, toto pole je rovněž přepsáno a faktura je odmítnuta
4. Odeslání nebo upozornění: pokud je validace úspěšná, faktura se odešle přes Peppol (nebo jinou nakonfigurovanou metodu doručení). Pokud validace selže, obdržíte upozornění

Pokud validace není úspěšná (například proto, že rozpoznaná částka se liší od dodané částky), existují tři způsoby přijetí upozornění:

Při rozpoznávání řádků IDR přenese řádky faktury pouze tehdy, pokud součet částek řádků odpovídá celkové částce bez DPH. Pokud řádky neodpovídají, IDR vloží celkovou částku pro každou kategorii DPH jako řádek faktury do XML. Chcete, aby faktura byla v takovém případě odmítnuta místo odeslána? To je konfigurovatelné. Pokud není rozpoznán žádný řádek faktury, lze toto volitelně také nastavit tak, aby faktura byla odmítnuta místo odeslána bez řádků; obdržíte stejné upozornění jako u jiné chyby validace.

Důležité: Faktura, která byla odmítnuta, nemůže být následně opravena a automaticky odeslána. Jedinou možností je manuálně nahrát XML přes platformu.

Toto řešení je určeno pro situace, kdy zdroj faktur nemůže vygenerovat strukturovaný formát, ale přesto chcete odesílat přes Peppol. Typické scénáře:

• Softwarové balíky, které podporují pouze export do PDF
• Hybridní prostředí, kde část fakturačního toku je již digitální a část stále běží na PDF
• Postupná migrace na úplnou elektronickou fakturaci

Pro nejlepší kvalitu a spolehlivost se vždy doporučuje dodávat přímo ve formátu UBL přes API.

Chcete nastavit PDF via Peppol? Kontaktujte náš tým pro úvodní konfiguraci.