Peppol BIS (Business Interoperability Specification) je technická dokumentácia, ktorá definuje, ako implementovať elektronickú fakturáciu v sieti Peppol. Tento článok je určený predovšetkým pre vývojárov a architektov softvérových riešení.
Čo je BIS špecifikácia?
BIS špecifikácia poskytuje:
- Technické požiadavky - presná definícia formátov a protokolov
- Obchodné pravidlá - logika spracovania dokumentov
- Validačné pravidlá - automatická kontrola správnosti
- Kódové zoznamy - štandardizované hodnoty
- Príklady - vzorové dokumenty
BIS Billing 3.0 funguje ako CIUS (Core Invoice Usage Specification), čo znamená, že je prísnejším podmnožinou európskeho štandardu EN 16931.
Architektúra BIS
BIS špecifikácia je postavená na viacerých vrstvách:
┌─────────────────────────────────────────┐
│ Peppol BIS Billing 3.0 │ ← Peppol špecifické rozšírenia
├─────────────────────────────────────────┤
│ EN 16931 CIUS │ ← Európsky sémantický model
├─────────────────────────────────────────┤
│ UBL 2.1 Syntax │ ← XML syntax
├─────────────────────────────────────────┤
│ XML / Schematron │ ← Technická vrstva
└─────────────────────────────────────────┘Kľúčové dokumenty BIS
| Dokument | Popis | Účel |
|---|---|---|
| BIS Document | Hlavná špecifikácia | Popis procesov a požiadaviek |
| Syntax Binding | UBL mapovanie | Prepojenie sémantiky a syntaxe |
| Code Lists | Kódovníky | Štandardizované hodnoty |
| Schematron | Validačné pravidlá | Automatická validácia |
| Examples | Vzorové faktúry | Referenčné implementácie |
Identifikátory procesu
Každá BIS faktúra musí obsahovať tieto identifikátory:
CustomizationID (Špecifikácia)
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>ProfileID (Obchodný proces)
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>Podporované obchodné procesy
BIS Billing 3.0 podporuje 9 hlavných scenárov:
- P1 - Fakturácia na základe objednávky
- P2 - Fakturácia na základe zmluvy
- P3 - Fakturácia na základe dodacieho listu
- P4 - Zálohová fakturácia
- P5 - Okamžitá platba
- P6 - Oprava faktúry (dobropis)
- P7 - Samoúčtovanie
- P8 - Čiastková fakturácia
- P9 - Faktúra bez objednávky
Technické komponenty
XML Namespaces
<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">Schematron súbory
Pre validáciu sú potrebné tieto súbory:
CEN-EN16931-UBL.sch- európske pravidláPEPPOL-EN16931-UBL.sch- Peppol pravidlá
Viac o validácii nájdete v článku Validácia Peppol faktúr.
Implementačné kroky
- Analýza požiadaviek
- Zistite, aké typy faktúr potrebujete
- Identifikujte obchodné procesy
- Určte DPH scenáre
- Návrh mapovania
- Mapujte interné dáta na UBL elementy
- Definujte transformačné pravidlá
- Pripravte kódovníky
- Implementácia
- Vytvorte XML generátor
- Implementujte validáciu
- Integruujte s Access Point
- Testovanie
- Unit testy pre validáciu
- Integračné testy s testovacím prostredím
- UAT s reálnymi partnermi
Kódové zoznamy
BIS špecifikácia používa štandardizované kódové zoznamy:
- UNCL1001 - typy dokumentov
- UNCL5305 - DPH kategórie
- UNCL4461 - platobné metódy
- ISO 3166-1 - kódy krajín
- ISO 4217 - kódy mien
- ICD - identifikačné schémy organizácií
- EAS - schémy elektronických adries
Verzie a aktualizácie
BIS špecifikácia je pravidelne aktualizovaná:
- Hlavné verzie - významné zmeny (napr. 2.0 → 3.0)
- Menšie verzie - opravy a doplnenia (napr. 3.0.13 → 3.0.14)
- Release notes - dokumentácia zmien
Aktuálna verzia: BIS Billing 3.0 (May 2025 release)
Stiahnuteľné zdroje
Oficiálna dokumentácia je dostupná na:
- docs.peppol.eu/poacc/billing/3.0/ - hlavná dokumentácia
- BIS špecifikácia - detailný popis