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">SK1234567890</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://api.epostak.sk/v1/invoices/send
Content-Type: application/json
X-API-Key: your-api-key-here

{
  "recipientPeppolId": "9950:SK9876543210",
  "invoiceFormat": "PEPPOL_BIS_3",
  "invoiceXml": "<base64-encoded XML faktúry>",
  "metadata": {
    "invoiceNumber": "INV-2026-001",
    "issueDate": "2026-02-17",
    "totalAmount": 120.00,
    "currency": "EUR"
  }
}

// Odpoveď (HTTP 202 Accepted):
{
  "invoiceId": "epostak-uuid-12345",
  "status": "QUEUED",
  "estimatedDelivery": "2026-02-17T14:30:00Z"
}