UBL XML faktúra: praktický príklad slovenskej e-faktúry
Rýchla odpoveď
UBL XML faktúra je dátový dokument, nie vizuálny PDF súbor. Obsahuje presné elementy pre číslo faktúry, dátum, menu, dodávateľa, odberateľa, položky, DPH a sumy. Peppol BIS Billing 3.0 používa UBL syntax a dopĺňa ju o obchodné pravidlá.
Nižšie je zjednodušený príklad, ktorý má slúžiť na orientáciu. Pri produkčnom použití vždy validujte dokument voči aktuálnym Peppol pravidlám a slovenským požiadavkám.
Zjednodušený príklad
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:peppol.eu:poacc:billing:3.0</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>2027-001</cbc:ID>
<cbc:IssueDate>2027-01-10</cbc:IssueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>OBJ-1001</cbc:BuyerReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">1234567890</cbc:EndpointID>
<cac:PartyName><cbc:Name>Dodávateľ s.r.o.</cbc:Name></cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Hlavná 1</cbc:StreetName>
<cbc:CityName>Bratislava</cbc:CityName>
<cbc:PostalZone>81101</cbc:PostalZone>
<cac:Country><cbc:IdentificationCode>SK</cbc:IdentificationCode></cac:Country>
</cac:PostalAddress>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">0987654321</cbc:EndpointID>
<cac:PartyName><cbc:Name>Odberateľ s.r.o.</cbc:Name></cac:PartyName>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">27.90</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">146.85</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">27.90</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>19</cbc:Percent>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="EUR">146.85</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="EUR">146.85</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="EUR">174.75</cbc:TaxInclusiveAmount>
<cbc:PayableAmount currencyID="EUR">174.75</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="C62">25</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">146.85</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Name>Isolation plate 60x100</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>19</cbc:Percent>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">5.8739495798</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
</Invoice>
Čo tento príklad ukazuje
Príklad ukazuje základnú štruktúru. Nie je to kompletná šablóna pre všetky slovenské faktúry. Produkčná faktúra musí zohľadniť konkrétny obchodný scenár, identifikátory, daňovú kategóriu, prípadné zľavy, poplatky, platobné údaje a slovenské pravidlá.
Najdôležitejšie bloky
| Blok | Úloha |
|---|---|
CustomizationID | určuje profil a kompatibilitu s EN 16931 / Peppol BIS |
ProfileID | určuje obchodný proces |
AccountingSupplierParty | predávajúci |
AccountingCustomerParty | kupujúci |
TaxTotal | celková DPH a rozpis dane |
LegalMonetaryTotal | súhrn peňažných súm |
InvoiceLine | položky faktúry |
Prečo je XML lepšie ako PDF pre automatizáciu
PDF faktúra vyzerá dobre človeku. XML faktúra je čitateľná pre systém. Účtovný softvér vie z XML priamo načítať dodávateľa, odberateľa, sumu, DPH, položky a dátumy. To umožňuje automatické zaúčtovanie, schvaľovanie a kontrolu.
Čo treba testovať
Pri implementácii netestujte iba jednu jednoduchú faktúru. Otestujte aj:
- dobropis,
- zľavu na položke,
- zľavu na dokumente,
- viac sadzieb DPH,
- oslobodené plnenie,
- prenesenie daňovej povinnosti,
- prílohy,
- zaokrúhlenie,
- faktúru bez objednávky, ale s buyer reference.
Zhrnutie
UBL XML faktúra je jadro elektronickej fakturácie. Ak je správne vytvorená a validovaná, CPDS ju vie doručiť a odberateľský systém spracovať. Najväčšou chybou je brať XML ako prílohu k PDF. V novom modeli je XML hlavný dokument a PDF je len voliteľný náhľad.
Zdroje a verifikácia
Tento článok je písaný ako edukačný sprievodca. Pri právnych a technických tvrdeniach odporúčame overiť aktuálny stav aj v oficiálnych dokumentoch.
- Peppol BIS Billing 3.0 — UBL Invoice syntax tree — OpenPeppol · overené 16. mája 2026
- Peppol BIS Billing 3.0 — Rules — OpenPeppol · overené 16. mája 2026
Ako citovať túto stránku
UBL XML faktúra: praktický príklad. CPDS.sk, technický stav k 16.5.2026.