Pre vývojárov
Štruktúra UBL 2.1 XML e-faktúry
Prehľad povinných a voliteľných elementov UBL 2.1 Invoice pre PEPPOL BIS Billing 3.0 s mapovaním na BT polia EN 16931 a XML príkladmi.
Koreňový element a menné priestory
UBL 2.1 faktúra musí mať koreňový element <Invoice> s týmito menných priestormi:
<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">
<!-- povinné polia -->
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>FA-2025-001</cbc:ID>
<cbc:IssueDate>2025-06-01</cbc:IssueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
</Invoice>
Povinné elementy hlavičky
| Element | BT pole | Povinnosť | Príklad / popis |
|---|---|---|---|
| cbc:CustomizationID | BT-24 | Povinné | Fixná hodnota pre PEPPOL BIS 3.0 |
| cbc:ProfileID | BT-23 | Povinné | Fixná hodnota profilu |
| cbc:ID | BT-1 | Povinné | Číslo faktúry: FA-2025-001 |
| cbc:IssueDate | BT-2 | Povinné | Dátum vystavenia: 2025-06-01 |
| cbc:DueDate | BT-9 | Voliteľné | Dátum splatnosti: 2025-06-15 |
| cbc:InvoiceTypeCode | BT-3 | Povinné | 380 = faktúra, 381 = dobropis |
| cbc:DocumentCurrencyCode | BT-5 | Povinné | EUR |
| cbc:BuyerReference | BT-10 | Podmienečne | Referencia objednávky odberateľa |
| cbc:TaxPointDate | BT-7 | Podmienečne | Dátum zdaniteľného plnenia (SK-CIUS) |
Dodávateľ a odberateľ
<!-- Dodávateľ -->
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="0196">SK12345678</cbc:EndpointID>
<cac:PartyName><cbc:Name>ABC 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:PartyTaxScheme>
<cbc:CompanyID>SK2020123456</cbc:CompanyID>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>ABC s.r.o.</cbc:RegistrationName>
<cbc:CompanyID>12345678</cbc:CompanyID>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
DPH (TaxTotal)
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">20.00</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">100.00</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">20.00</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID> <!-- S=štandard, Z=nulová, E=oslobodená, AE=prenos, O=mimo DPH -->
<cbc:Percent>20</cbc:Percent>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
Riadok faktúry (InvoiceLine)
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="C62">10</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">100.00</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Description>Konzultačné služby</cbc:Description>
<cbc:Name>IT konzultácia</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>20</cbc:Percent>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">10.00</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
Časté kódy mernej jednotky: C62 = kusy · HUR = hodiny · DAY = dni · MTK = m² · KGM = kg · LTR = litre · MTR = metre. Slovenské skratky ako "ks" alebo "hod" sú neplatné.
Validujte váš UBL XML výstup
Validátor skontroluje štruktúru, menné priestory, povinné elementy aj business pravidlá. Zobrazí presné chyby s XPath umiestnením.
Spustiť validáciu →