Vytváření ZUGFeRD faktur: Průvodce krok za krokem

ZUGFeRD je jedním z nejpopulárnějších formátů e-fakturace v Německu, protože kombinuje to nejlepší ze dvou světů: vizuálně čitelnou PDF fakturu a strojově čitelný XML soubor v jednom dokumentu. Tento průvodce vysvětluje, jak vytvořit vyhovující ZUGFeRD fakturu.

Co přesně je ZUGFeRD faktura?

ZUGFeRD faktura je dokument PDF/A-3 s vloženým CII XML souborem (Cross-Industry Invoice). PDF obsahuje vizuální reprezentaci faktury, stejně jako tradiční PDF faktura. Navíc je v PDF vložen jako příloha XML soubor obsahující všechna fakturační data ve strukturovaném, strojově čitelném formátu. Počínaje ZUGFeRD 2.1 se tento soubor jmenuje factur-x.xml (v ZUGFeRD 2.0 se ještě jmenoval zugferd-invoice.xml).

Výhoda: příjemci bez specializovaného softwaru vidí normální PDF fakturu. Příjemci s e-fakturačními systémy mohou automaticky extrahovat a zpracovat data.

Profily ZUGFeRD

ZUGFeRD 2.x (aktuálně verze 2.4, odpovídající Factur-X 1.08) nabízí několik profilů, které se liší rozsahem obsažených dat:

Minimum

Obsahuje pouze základní hlavičková data (číslo faktury, datum, celková částka). Vhodný pouze pro účely archivace, ne pro automatizované zpracování.

Basic WL (Without Lines)

Rozšiřuje profil Minimum o informace o prodávajícím a kupujícím a také rozpis DPH, ale neobsahuje jednotlivé řádkové položky.

Basic

Jako Basic WL, ale s řádkovými položkami. Toto je první úroveň, která umožňuje smysluplné automatizované zpracování.

EN 16931 (Comfort)

Mapuje kompletní evropský datový model EN 16931. Tento profil je základem pro povinné požadavky e-fakturace a pokrývá všechna povinná pole definovaná evropskou normou.

Extended

Umožňuje další pole nad rámec EN 16931, například pro požadavky specifické pro odvětví.

XRechnung

Speciální profil, který plně mapuje CIUS XRechnung, čímž je vhodný pro faktury zadavatelům z veřejného sektoru.

Pro většinu případů použití doporučujeme minimálně profil EN 16931 (Comfort), protože splňuje zákonné požadavky.

Povinná pole v ZUGFeRD faktuře

Počínaje profilem EN 16931 (Comfort) jsou vyžadovány následující základní údaje:

Číslo faktury (BT-1)
Datum faktury (BT-2)
Kód měny (BT-5), např. EUR
Prodávající: název, adresa, DIČ
Kupující: název, adresa
Řádkové položky: popis, množství, jednotková cena, sazba DPH
Součty: čistá částka, DPH, hrubá částka
Platební informace: datum splatnosti, platební metoda, IBAN

Krok za krokem: Vytvoření ZUGFeRD faktury

Krok 1: Strukturujte fakturační data

Zachyťte všechna fakturační data ve strukturovaném formátu. S invapi používáte JSON objekt obsahující všechna relevantní pole — prodávající, kupující, řádkové položky, částky a platební informace.

Krok 2: Připravte PDF

Vytvořte vizuální PDF fakturu s vaším obvyklým rozvržením a firemní identitou. PDF slouží jako základ a stane se kontejnerem PDF/A-3. Ujistěte se, že informace v PDF odpovídají XML datům.

Krok 3: Vygenerujte CII XML

Strojově čitelný XML soubor musí být ve formátu UN/CEFACT Cross-Industry Invoice. Ruční vytváření je náchylné k chybám — doporučuje se automatizovaný nástroj nebo API.

Krok 4: Vložte XML do PDF

CII XML soubor se vloží jako příloha do PDF. PDF musí odpovídat standardu PDF/A-3 a odkazovat na XML soubor jako připojenou přílohu se správným MIME typem.

Krok 5: Validujte

Před odesláním byste měli vytvořenou ZUGFeRD fakturu validovat. Validace kontroluje jak strukturu XML, tak soulad s obchodními pravidly EN 16931.

Snadná cesta s invapi

Kroky 3 až 5 lze automatizovat pomocí invapi API. Jednoduše odešlete svá fakturační data jako JSON spolu s PDF souborem a invapi vygeneruje kompletní, validovanou ZUGFeRD fakturu.

Pracovní postup prostřednictvím API:

Sestavte fakturační data jako JSON
Nahrajte PDF a odešlete je společně s JSON na ZUGFeRD endpoint
Obdržíte validované ZUGFeRD PDF jako výsledek

API zajišťuje konverzi, vložení a validaci. Můžete začít ihned s bezplatným plánem.

Závěr

ZUGFeRD faktury kombinují to nejlepší z obou světů: čitelnost pro člověka a strojovou zpracovatelnost. Přestože proces vytváření vyžaduje více než pouhé vygenerování PDF, lze jej plně automatizovat se správnými nástroji. Seznámit se se ZUGFeRD nyní znamená být dobře připraven na povinné požadavky e-fakturace.