Peppol BIS Billing 3.0: technický formát slovenských e-faktúr

Tento článok je určený vývojárom a IT tímom, ktoré implementujú e-fakturáciu pre svoju firmu alebo klientov. Vysvetlíme, čo presne je formát Peppol BIS Billing 3.0, ako vyzerá XML štruktúra faktúry, aké polia sú povinné podľa slovenských pravidiel a ako faktúry validovať a testovať. Ak hľadáte riešenie bez nutnosti implementovať Peppol priamo, pozrite si sekciu o ePošťák API.

Peppol BIS Billing 3.0 (Business Interoperability Specification) je štandardizovaný formát elektronických faktúr používaný v rámci siete Peppol. Je postavený na štandarde UBL 2.1 (Universal Business Language) — XML formáte spravovanom konzorciom OASIS.

Peppol BIS Billing 3.0 faktúra je XML dokument s koreňovým elementom Invoice v namespace UBL. Tu je zjednodušená kostra dokumentu:

<?xml version="1.0" encoding="UTF-8"?>
<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á hlavička -->
  <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>

  <!-- Identifikácia faktúry -->
  <cbc:ID>INV-2026-001</cbc:ID>
  <cbc:IssueDate>2026-02-17</cbc:IssueDate>
  <cbc:DueDate>2026-03-03</cbc:DueDate>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>

  <!-- Predávajúci a kupujúci -->
  <cac:AccountingSupplierParty> ... </cac:AccountingSupplierParty>
  <cac:AccountingCustomerParty> ... </cac:AccountingCustomerParty>

  <!-- Platobné podmienky -->
  <cac:PaymentMeans> ... </cac:PaymentMeans>

  <!-- Daňové súhrny -->
  <cac:TaxTotal> ... </cac:TaxTotal>

  <!-- Celkové sumy -->
  <cac:LegalMonetaryTotal> ... </cac:LegalMonetaryTotal>

  <!-- Položky faktúry -->
  <cac:InvoiceLine> ... </cac:InvoiceLine>

</Invoice>

Príklad identifikácie predávajúceho:

<cac:AccountingSupplierParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0245">2020298610</cbc:EndpointID>
    <cac:PartyName>
      <cbc:Name>Moja Firma 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>SK1234567890</cbc:CompanyID>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:PartyTaxScheme>
    <cac:PartyLegalEntity>
      <cbc:RegistrationName>Moja Firma s.r.o.</cbc:RegistrationName>
      <cbc:CompanyID>12345678</cbc:CompanyID>
    </cac:PartyLegalEntity>
  </cac:Party>
</cac:AccountingSupplierParty>

Pred odoslaním faktúry do produkčného prostredia Peppol je nevyhnutné overiť jej správnosť. Validácia prebieha na viacerých úrovniach:

Príklad odoslania faktúry cez ePošťák REST API:

POST https://epostak.sk/api/v1/documents/send
Authorization: Bearer <token>
X-Firm-Id: <uuid-firmy>
Content-Type: application/json

{
  "receiverPeppolId": "0245:2020202020",
  "invoiceNumber": "FV-2026-0001",
  "issueDate": "2026-08-22",
  "currency": "EUR",
  "items": [{ "description": "Služba", "quantity": 1, "unitPrice": 100, "vatRate": 23 }]
}

// HTTP 202 potvrdzuje prijatie na spracovanie, nie doručenie.
// Výsledný stav sledujte cez dokumentovaný Enterprise endpoint:
GET /api/v1/documents/{id}/status