1. How to read the complete overview
The catalogue includes every business term (BT) and business group (BG) in the official Peppol UBL Invoice mapping. Cardinality belongs to the specific XML node; 1..1 inside an optional group only becomes mandatory when that group is used.
| Mode | BT / BG | Field |
|---|---|---|
| Core | 1..1 | Mandatory in the document or a mandatory group. |
| In group | 1..1 | Mandatory only after its optional parent group is used. |
| 0..1 / 0..n | 0..1 / 0..n | Optional or conditionally required by a validation rule. |
2. All BT and BG fields
The catalogue includes every business term (BT) and business group (BG) in the official Peppol UBL Invoice mapping. Cardinality belongs to the specific XML node; 1..1 inside an optional group only becomes mandatory when that group is used.
| Mode | BT / BG | Field | Cardinality and XML path | Rules |
|---|---|---|---|---|
| Core | BT-24 |
Specification identifier | 1..1/ubl:Invoice/cbc:CustomizationID |
PEPPOL-EN16931-R004 · BR-01 |
| Core | BT-23 |
Process identifier | 1..1/ubl:Invoice/cbc:ProfileID |
PEPPOL-EN16931-R001 · PEPPOL-EN16931-R007 |
| Core | BT-1 |
Invoice number | 1..1/ubl:Invoice/cbc:ID |
BR-02 |
| Core | BT-2 |
Issue date | 1..1/ubl:Invoice/cbc:IssueDate |
BR-03 · PEPPOL-EN16931-F001 |
| 0..1 / 0..n | BT-9 |
Due date or payment terms | 0..1/ubl:Invoice/cbc:DueDate |
PEPPOL-EN16931-F001 · BR-CO-25 |
| Core | BT-3 |
Invoice type code | 1..1/ubl:Invoice/cbc:InvoiceTypeCode |
BR-04 · BR-CL-01 · PEPPOL-EN16931-P0100 · DE-R-017 |
| 0..1 / 0..n | BT-22 |
Invoice note | 0..1/ubl:Invoice/cbc:Note |
PEPPOL-EN16931-R002 · BR-CL-08 |
| 0..1 / 0..n | BT-7 |
VAT point date | 0..1/ubl:Invoice/cbc:TaxPointDate |
BR-CO-03 |
| Core | BT-5 |
Invoice currency | 1..1/ubl:Invoice/cbc:DocumentCurrencyCode |
BR-05 · BR-CL-04 |
| 0..1 / 0..n | BT-6 |
VAT accounting currency | 0..1/ubl:Invoice/cbc:TaxCurrencyCode |
BR-CL-05 · PEPPOL-EN16931-R005 · PEPPOL-EN16931-R055 |
| 0..1 / 0..n | BT-19 |
Buyer accounting reference | 0..1/ubl:Invoice/cbc:AccountingCost |
— |
| 0..1 / 0..n | BT-10 |
Buyer reference or purchase order | 0..1/ubl:Invoice/cbc:BuyerReference |
PEPPOL-EN16931-R003 · DE-R-015 |
| 0..1 / 0..n | BG-14 |
DELIVERY OR INVOICE PERIOD | 0..1/ubl:Invoice/cac:InvoicePeriod |
BR-IC-11 |
| 0..1 / 0..n | BT-73 |
Invoicing period start date | 0..1/ubl:Invoice/cac:InvoicePeriod/cbc:StartDate |
BR-CO-19 · PEPPOL-EN16931-F001 |
| 0..1 / 0..n | BT-74 |
Invoicing period end date | 0..1/ubl:Invoice/cac:InvoicePeriod/cbc:EndDate |
PEPPOL-EN16931-F001 · BR-29 · BR-CO-19 |
| 0..1 / 0..n | BT-8 |
Value added tax point date code | 0..1/ubl:Invoice/cac:InvoicePeriod/cbc:DescriptionCode |
BR-CO-03 · BR-CL-06 · PEPPOL-EN16931-CL006 |
| In group | BT-13 |
Buyer reference or purchase order | 1..1/ubl:Invoice/cac:OrderReference/cbc:ID |
PEPPOL-EN16931-R003 |
| 0..1 / 0..n | BT-14 |
Sales order reference | 0..1/ubl:Invoice/cac:OrderReference/cbc:SalesOrderID |
— |
| 0..1 / 0..n | BG-3 |
PRECEDING INVOICE REFERENCE | 0..n/ubl:Invoice/cac:BillingReference |
DE-R-026 |
| In group | BT-25 |
Reference to the preceding invoice | 1..1/ubl:Invoice/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID |
BR-55 |
| 0..1 / 0..n | BT-26 |
Reference to the preceding invoice | 0..1/ubl:Invoice/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate |
PEPPOL-EN16931-F001 |
| In group | BT-16 |
Despatch advice reference | 1..1/ubl:Invoice/cac:DespatchDocumentReference/cbc:ID |
— |
| In group | BT-15 |
Receiving advice reference | 1..1/ubl:Invoice/cac:ReceiptDocumentReference/cbc:ID |
— |
| In group | BT-17 |
Tender or lot reference | 1..1/ubl:Invoice/cac:OriginatorDocumentReference/cbc:ID |
— |
| In group | BT-12 |
Contract reference | 1..1/ubl:Invoice/cac:ContractDocumentReference/cbc:ID |
— |
| Core | BG-24 |
ADDITIONAL SUPPORTING DOCUMENTS | 1..1/ubl:Invoice/cac:AdditionalDocumentReference |
PEPPOL-EN16931-R080 · DE-R-022 |
| Core | BT-18, BT-122 |
Invoiced object identifier, Supporting document reference | 1..1/ubl:Invoice/cac:AdditionalDocumentReference/cbc:ID |
BR-52 |
| 0..1 / 0..n | BT-18 |
Document type code | 0..1/ubl:Invoice/cac:AdditionalDocumentReference/cbc:DocumentTypeCode |
— |
| 0..1 / 0..n | BT-123 |
Supporting document description | 0..1/ubl:Invoice/cac:AdditionalDocumentReference/cbc:DocumentDescription |
— |
| 0..1 / 0..n | BT-125 |
Supporting document / attachment | 0..1/ubl:Invoice/cac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject |
— |
| In group | BT-124 |
External document location | 1..1/ubl:Invoice/cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference/cbc:URI |
— |
| In group | BT-11 |
Project reference | 1..1/ubl:Invoice/cac:ProjectReference/cbc:ID |
— |
| Core | BG-4 |
SELLER | 1..1/ubl:Invoice/cac:AccountingSupplierParty |
— |
| Core | BT-34 |
Seller electronic address | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cbc:EndpointID |
BR-62 · BR-CL-25 · PEPPOL-EN16931-R020 · PEPPOL-COMMON-R040 · PEPPOL-COMMON-R041 +11 |
| In group | BT-29, BT-90 |
Seller identifier or bank assigned creditor identifier | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID |
BR-CO-26 · DE-R-030 · PEPPOL-COMMON-R040 · PEPPOL-COMMON-R041 · PEPPOL-COMMON-R042 +9 |
| In group | BT-28 |
Seller trading name | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyName/cbc:Name |
— |
| Core | BG-5 |
SELLER POSTAL ADDRESS | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress |
BR-08 |
| 0..1 / 0..n | BT-35 |
Street and number | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:StreetName |
IT-R-002 |
| 0..1 / 0..n | BT-36 |
Seller address line 2 | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:AdditionalStreetName |
— |
| 0..1 / 0..n | BT-37 |
City | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:CityName |
IT-R-003 |
| 0..1 / 0..n | BT-38 |
Postcode | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:PostalZone |
IT-R-004 |
| 0..1 / 0..n | BT-39 |
Seller country subdivision | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:CountrySubentity |
— |
| In group | BT-162 |
Seller address line 3 | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cac:AddressLine/cbc:Line |
— |
| Core | BT-40 |
Country code | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode |
BR-09 · BR-CL-14 |
| In group | BT-31, BT-32 |
Seller VAT identifier (IČ DPH) | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID |
BR-CO-09 · BR-CO-26 · BR-S-02 · BR-S-03 · BR-S-04 +36 |
| Core | BT-27 |
Seller name | 1..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationName |
BR-06 |
| 0..1 / 0..n | BT-30 |
Seller company number (IČO) | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyID |
BR-CO-26 · BR-CL-11 · DK-R-002 · DK-R-014 · SE-R-003 +2 |
| 0..1 / 0..n | BT-33 |
Legal form and register | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyLegalForm |
— |
| 0..1 / 0..n | BG-6 |
SELLER CONTACT | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:Contact |
DE-R-002 |
| 0..1 / 0..n | BT-41 |
Seller contact point | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:Contact/cbc:Name |
— |
| 0..1 / 0..n | BT-42 |
Seller contact telephone number | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:Contact/cbc:Telephone |
DE-R-027 |
| 0..1 / 0..n | BT-43 |
Seller contact email address | 0..1/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:Contact/cbc:ElectronicMail |
DE-R-028 |
| Core | BG-7 |
BUYER | 1..1/ubl:Invoice/cac:AccountingCustomerParty |
— |
| Core | BT-49 |
Buyer electronic address | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cbc:EndpointID |
BR-63 · BR-CL-25 · PEPPOL-EN16931-R010 · PEPPOL-COMMON-R040 · PEPPOL-COMMON-R041 +11 |
| In group | BT-46 |
Buyer identifier | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID |
PEPPOL-COMMON-R040 · PEPPOL-COMMON-R041 · PEPPOL-COMMON-R042 · PEPPOL-COMMON-R043 · PEPPOL-COMMON-R044 +7 |
| In group | BT-45 |
Buyer trading name | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyName/cbc:Name |
— |
| Core | BG-8 |
BUYER POSTAL ADDRESS | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress |
BR-10 |
| 0..1 / 0..n | BT-50 |
Street and number | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:StreetName |
— |
| 0..1 / 0..n | BT-51 |
Buyer address line 2 | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:AdditionalStreetName |
— |
| 0..1 / 0..n | BT-52 |
City | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:CityName |
— |
| 0..1 / 0..n | BT-53 |
Postcode | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:PostalZone |
— |
| 0..1 / 0..n | BT-54 |
Buyer country subdivision | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:CountrySubentity |
— |
| In group | BT-163 |
Buyer address line 3 | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cac:AddressLine/cbc:Line |
— |
| Core | BT-55 |
Country code | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode |
BR-11 · BR-CL-14 |
| In group | BT-48 |
Buyer VAT identifier (IČ DPH) | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID |
BR-CO-09 · BR-AE-02 · BR-AE-03 · BR-AE-04 · BR-IC-02 +17 |
| Core | BT-44 |
Buyer name | 1..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationName |
BR-07 |
| 0..1 / 0..n | BT-47 |
Buyer company number (IČO) | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyID |
BR-AE-02 · BR-AE-03 · BR-AE-04 · BR-CL-11 · DK-R-014 |
| 0..1 / 0..n | BG-9 |
BUYER CONTACT | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:Contact |
— |
| 0..1 / 0..n | BT-56 |
Buyer contact point | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:Contact/cbc:Name |
— |
| 0..1 / 0..n | BT-57 |
Buyer contact telephone number | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:Contact/cbc:Telephone |
— |
| 0..1 / 0..n | BT-58 |
Buyer contact email address | 0..1/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:Contact/cbc:ElectronicMail |
— |
| Core | BG-10 |
PAYEE | 1..1/ubl:Invoice/cac:PayeeParty |
— |
| In group | BT-60, BT-90 |
Payee identifier or bank assigned creditor identifier | 1..1/ubl:Invoice/cac:PayeeParty/cac:PartyIdentification/cbc:ID |
DE-R-030 |
| Core | BT-59 |
Payee name | 1..1/ubl:Invoice/cac:PayeeParty/cac:PartyName/cbc:Name |
BR-17 |
| In group | BT-61 |
Payee legal registration identifier | 1..1/ubl:Invoice/cac:PayeeParty/cac:PartyLegalEntity/cbc:CompanyID |
BR-CL-11 |
| Core | BG-11 |
SELLER TAX REPRESENTATIVE PARTY | 1..1/ubl:Invoice/cac:TaxRepresentativeParty |
— |
| Core | BT-62 |
Seller tax representative | 1..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PartyName/cbc:Name |
BR-18 |
| Core | BG-12 |
SELLER TAX REPRESENTATIVE POSTAL ADDRESS | 1..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress |
BR-19 |
| 0..1 / 0..n | BT-64 |
Tax representative address line 1 | 0..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress/cbc:StreetName |
— |
| 0..1 / 0..n | BT-65 |
Tax representative address line 2 | 0..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress/cbc:AdditionalStreetName |
— |
| 0..1 / 0..n | BT-66 |
Tax representative city | 0..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress/cbc:CityName |
— |
| 0..1 / 0..n | BT-67 |
Tax representative post code | 0..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress/cbc:PostalZone |
— |
| 0..1 / 0..n | BT-68 |
Tax representative country subdivision | 0..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress/cbc:CountrySubentity |
— |
| In group | BT-164 |
Tax representative address line 3 | 1..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress/cac:AddressLine/cbc:Line |
— |
| Core | BT-69 |
Seller tax representative | 1..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress/cac:Country/cbc:IdentificationCode |
BR-20 · BR-CL-14 |
| Core | BT-63 |
Seller tax representative VAT identifier | 1..1/ubl:Invoice/cac:TaxRepresentativeParty/cac:PartyTaxScheme/cbc:CompanyID |
BR-56 · BR-CO-09 · BR-S-02 · BR-S-03 · BR-S-04 +18 |
| Core | BG-13 |
DELIVERY INFORMATION | 1..1/ubl:Invoice/cac:Delivery |
— |
| 0..1 / 0..n | BT-72 |
Delivery date or invoicing period | 0..1/ubl:Invoice/cac:Delivery/cbc:ActualDeliveryDate |
BR-IC-11 · PEPPOL-EN16931-F001 |
| 0..1 / 0..n | BT-71 |
Deliver to location identifier | 0..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cbc:ID |
— |
| 0..1 / 0..n | BG-15 |
DELIVER TO ADDRESS | 0..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address |
— |
| 0..1 / 0..n | BT-75 |
Deliver-to address | 0..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:StreetName |
— |
| 0..1 / 0..n | BT-76 |
Deliver to address line 2 | 0..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:AdditionalStreetName |
— |
| 0..1 / 0..n | BT-77 |
Deliver to city | 0..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:CityName |
— |
| 0..1 / 0..n | BT-78 |
Deliver to post code | 0..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:PostalZone |
— |
| 0..1 / 0..n | BT-79 |
Deliver to country subdivision | 0..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:CountrySubentity |
— |
| In group | BT-165 |
Deliver to address line 3 | 1..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/cac:AddressLine/cbc:Line |
— |
| In group | BT-80 |
Deliver-to address | 1..1/ubl:Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/cac:Country/cbc:IdentificationCode |
BR-57 · BR-CL-14 · BR-IC-12 |
| In group | BT-70 |
Deliver to party name | 1..1/ubl:Invoice/cac:Delivery/cac:DeliveryParty/cac:PartyName/cbc:Name |
— |
| 0..1 / 0..n | BG-16 |
PAYMENT INSTRUCTIONS | 0..n/ubl:Invoice/cac:PaymentMeans |
DE-R-001 |
| In group | BT-81 |
Payment means code | 1..1/ubl:Invoice/cac:PaymentMeans/cbc:PaymentMeansCode |
BR-49 · BR-CL-16 · DE-R-020 |
| 0..1 / 0..n | BT-82 |
Payment means text | 0..1/ubl:Invoice/cac:PaymentMeans/cbc:PaymentMeansCode/@name |
— |
| 0..1 / 0..n | BT-83 |
Payment reference | 0..1/ubl:Invoice/cac:PaymentMeans/cbc:PaymentID |
— |
| In group | BG-18 |
PAYMENT CARD INFORMATION | 1..1/ubl:Invoice/cac:PaymentMeans/cac:CardAccount |
DE-R-023-2 · DE-R-024-1 · DE-R-025-2 |
| In group | BT-87 |
Payment card primary account number | 1..1/ubl:Invoice/cac:PaymentMeans/cac:CardAccount/cbc:PrimaryAccountNumberID |
BR-51 |
| 0..1 / 0..n | BT-88 |
Payment card holder name | 0..1/ubl:Invoice/cac:PaymentMeans/cac:CardAccount/cbc:HolderName |
— |
| In group | BG-17 |
CREDIT TRANSFER | 1..1/ubl:Invoice/cac:PaymentMeans/cac:PayeeFinancialAccount |
— |
| In group | BT-84 |
IBAN / account identifier | 1..1/ubl:Invoice/cac:PaymentMeans/cac:PayeeFinancialAccount/cbc:ID |
BR-50 · BR-61 |
| 0..1 / 0..n | BT-85 |
Payment account name | 0..1/ubl:Invoice/cac:PaymentMeans/cac:PayeeFinancialAccount/cbc:Name |
— |
| In group | BT-86 |
Payment service provider identifier (for example BIC) | 1..1/ubl:Invoice/cac:PaymentMeans/cac:PayeeFinancialAccount/cac:FinancialInstitutionBranch/cbc:ID |
— |
| In group | BG-19 |
DIRECT DEBIT | 1..1/ubl:Invoice/cac:PaymentMeans/cac:PaymentMandate |
DE-R-023-2 · DE-R-024-2 · DE-R-025-1 |
| 0..1 / 0..n | BT-89 |
Mandate reference identifier | 0..1/ubl:Invoice/cac:PaymentMeans/cac:PaymentMandate/cbc:ID |
PEPPOL-EN16931-R061 · DE-R-030 |
| In group | BT-91 |
Debited account identifier | 1..1/ubl:Invoice/cac:PaymentMeans/cac:PaymentMandate/cac:PayerFinancialAccount/cbc:ID |
DE-R-031 |
| In group | BT-20 |
Due date or payment terms | 1..1/ubl:Invoice/cac:PaymentTerms/cbc:Note |
BR-CO-25 · DE-R-018 |
| Core | BG-20, BG-21 |
DOCUMENT LEVEL ALLOWANCES AND CHARGES | 1..1/ubl:Invoice/cac:AllowanceCharge |
— |
| 0..1 / 0..n | BT-98, BT-105 |
Document-level allowance | 0..1/ubl:Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReasonCode |
BR-33 · BR-38 · BR-CO-05 · BR-CO-06 · BR-CO-21 +6 |
| 0..1 / 0..n | BT-97, BT-104 |
Document level allowance or charge reason | 0..1/ubl:Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReason |
BR-33 · BR-38 · BR-CO-05 · BR-CO-06 · BR-CO-21 +2 |
| 0..1 / 0..n | BT-94,BT-101 |
Document level allowance or charge percentage | 0..1/ubl:Invoice/cac:AllowanceCharge/cbc:MultiplierFactorNumeric |
PEPPOL-EN16931-R042 |
| Core | BT-92,BT-99 |
Document-level allowance | 1..1/ubl:Invoice/cac:AllowanceCharge/cbc:Amount |
BR-31 · BR-36 · BR-CL-03 · PEPPOL-EN16931-R040 · BR-DEC-01 +2 |
| 0..1 / 0..n | BT-93,BT-100 |
Document level allowance or charge base amount | 0..1/ubl:Invoice/cac:AllowanceCharge/cbc:BaseAmount |
PEPPOL-EN16931-R041 · BR-DEC-02 · BR-DEC-06 · UBL-DT-01 · BR-CL-03 |
| Core | BT-95,BT-102 |
Document level allowance or charge VAT category code | 1..1/ubl:Invoice/cac:AllowanceCharge/cac:TaxCategory/cbc:ID |
BR-32 · BR-37 · BR-O-13 · BR-O-14 · BR-CL-17 +1 |
| 0..1 / 0..n | BT-96,BT-103 |
Document level allowance or charge VAT rate | 0..1/ubl:Invoice/cac:AllowanceCharge/cac:TaxCategory/cbc:Percent |
BR-S-06 · BR-S-07 · BR-Z-06 · BR-Z-07 · BR-E-06 +10 |
| Core | BT-110, BT-111 |
Invoice total VAT amount | 1..1/ubl:Invoice/cac:TaxTotal/cbc:TaxAmount |
BR-53 · BR-CO-14 · BR-DEC-13 · BR-DEC-15 · UBL-DT-01 +1 |
| 0..1 / 0..n | BG-23 |
VAT BREAKDOWN | 0..n/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal |
PEPPOL-EN16931-R053 · BR-CO-18 · BR-O-11 |
| In group | BT-116 |
VAT category taxable amount | 1..1/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxableAmount |
BR-45 · BR-S-08 · BR-Z-08 · BR-E-08 · BR-AE-08 +6 |
| In group | BT-117 |
VAT category tax amount | 1..1/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount |
BR-46 · BR-CO-17 · BR-S-09 · BR-Z-09 · BR-E-09 +6 |
| In group | BT-118 |
VAT category code | 1..1/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:ID |
BR-47 · BR-S-01 · BR-Z-01 · BR-E-01 · BR-AE-01 +4 |
| 0..1 / 0..n | BT-119 |
VAT category rate | 0..1/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent |
BR-48 · SE-R-006 · DE-R-014 |
| 0..1 / 0..n | BT-121 |
Exemption reason or code | 0..1/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReasonCode |
BR-CL-22 · BR-S-10 · BR-Z-10 · BR-E-10 · BR-AE-10 +11 |
| 0..1 / 0..n | BT-120 |
Exemption reason or code | 0..1/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReason |
BR-S-10 · BR-Z-10 · BR-E-10 · BR-AE-10 · BR-IC-10 +2 |
| Core | BG-22 |
DOCUMENT TOTALS | 1..1/ubl:Invoice/cac:LegalMonetaryTotal |
— |
| Core | BT-106 |
Sum of invoice line net amounts | 1..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount |
BR-12 · BR-CO-10 · BR-DEC-09 · UBL-DT-01 · BR-CL-03 |
| Core | BT-109 |
Invoice total excluding VAT | 1..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:TaxExclusiveAmount |
BR-13 · BR-CO-13 · BR-DEC-12 · UBL-DT-01 · BR-CL-03 |
| Core | BT-112 |
Invoice total including VAT | 1..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:TaxInclusiveAmount |
BR-14 · BR-CO-15 · BR-DEC-14 · UBL-DT-01 · BR-CL-03 |
| 0..1 / 0..n | BT-107 |
Sum of document-level allowances | 0..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:AllowanceTotalAmount |
BR-CO-11 · BR-DEC-10 · UBL-DT-01 · BR-CL-03 |
| 0..1 / 0..n | BT-108 |
Sum of document-level charges | 0..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:ChargeTotalAmount |
BR-CO-12 · BR-DEC-11 · UBL-DT-01 · BR-CL-03 |
| 0..1 / 0..n | BT-113 |
Paid amount | 0..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:PrepaidAmount |
UBL-DT-01 · BR-CL-03 |
| 0..1 / 0..n | BT-114 |
Rounding amount | 0..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount |
BR-DEC-17 · UBL-DT-01 · BR-CL-03 |
| Core | BT-115 |
Amount due for payment | 1..1/ubl:Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount |
BR-15 · BR-CO-16 · BR-DEC-18 · UBL-DT-01 · BR-CL-03 |
| Core | BG-25 |
INVOICE LINE | 1..n/ubl:Invoice/cac:InvoiceLine |
BR-16 |
| Core | BT-126 |
Line identifier | 1..1/ubl:Invoice/cac:InvoiceLine/cbc:ID |
BR-21 |
| 0..1 / 0..n | BT-127 |
Invoice line note | 0..1/ubl:Invoice/cac:InvoiceLine/cbc:Note |
— |
| Core | BT-129 |
Invoiced quantity | 1..1/ubl:Invoice/cac:InvoiceLine/cbc:InvoicedQuantity |
BR-22 · BR-CL-23 |
| Core | BT-130 |
Unit of measure code | 1..1/ubl:Invoice/cac:InvoiceLine/cbc:InvoicedQuantity/@unitCode |
BR-23 |
| Core | BT-131 |
Invoice line net amount | 1..1/ubl:Invoice/cac:InvoiceLine/cbc:LineExtensionAmount |
BR-24 · PEPPOL-EN16931-R120 · BR-DEC-23 · UBL-DT-01 · BR-CL-03 |
| 0..1 / 0..n | BT-133 |
Invoice line Buyer accounting reference | 0..1/ubl:Invoice/cac:InvoiceLine/cbc:AccountingCost |
— |
| Core | BG-26 |
INVOICE LINE PERIOD | 1..1/ubl:Invoice/cac:InvoiceLine/cac:InvoicePeriod |
— |
| 0..1 / 0..n | BT-134 |
Invoice line period start date | 0..1/ubl:Invoice/cac:InvoiceLine/cac:InvoicePeriod/cbc:StartDate |
BR-CO-20 · PEPPOL-EN16931-R110 · PEPPOL-EN16931-F001 |
| 0..1 / 0..n | BT-135 |
Invoice line period end date | 0..1/ubl:Invoice/cac:InvoiceLine/cac:InvoicePeriod/cbc:EndDate |
BR-30 · BR-CO-20 · PEPPOL-EN16931-R111 · PEPPOL-EN16931-F001 |
| In group | BT-132 |
Referenced purchase order line reference | 1..1/ubl:Invoice/cac:InvoiceLine/cac:OrderLineReference/cbc:LineID |
— |
| In group | BT-128 |
Invoice line object identifier | 1..1/ubl:Invoice/cac:InvoiceLine/cac:DocumentReference/cbc:ID |
— |
| In group | BT-128 |
Document type code | 1..1/ubl:Invoice/cac:InvoiceLine/cac:DocumentReference/cbc:DocumentTypeCode |
— |
| Core | BG-27, BG-28 |
INVOICE LINE ALLOWANCES OR CHARGES | 1..1/ubl:Invoice/cac:InvoiceLine/cac:AllowanceCharge |
BR-CO-23 · BR-CO-24 |
| 0..1 / 0..n | BT-140, BT-145 |
Invoice line allowance | 0..1/ubl:Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:AllowanceChargeReasonCode |
BR-42 · BR-44 · BR-CO-07 · BR-CO-08 · PEPPOL-EN16931-CL003 +4 |
| 0..1 / 0..n | BT-139, BT-144 |
Line level allowance or charge reason | 0..1/ubl:Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:AllowanceChargeReason |
BR-42 · BR-44 · BR-CO-07 · BR-CO-08 · DK-R-004 |
| 0..1 / 0..n | BT-138,BT-143 |
Line level allowance or charge percentage | 0..1/ubl:Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:MultiplierFactorNumeric |
PEPPOL-EN16931-R042 |
| Core | BT-136,BT-141 |
Invoice line allowance | 1..1/ubl:Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:Amount |
BR-41 · BR-43 · BR-CL-03 · PEPPOL-EN16931-R040 · BR-DEC-24 +2 |
| 0..1 / 0..n | BT-137,BT-142 |
Line level allowance or charge base amount | 0..1/ubl:Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:BaseAmount |
PEPPOL-EN16931-R041 · BR-DEC-25 · BR-DEC-28 · UBL-DT-01 · BR-CL-03 |
| Core | BG-31 |
ITEM INFORMATION | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item |
— |
| 0..1 / 0..n | BT-154 |
Item description | 0..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cbc:Description |
— |
| Core | BT-153 |
Item name | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cbc:Name |
BR-25 |
| In group | BT-156 |
Item Buyer's identifier | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:BuyersItemIdentification/cbc:ID |
— |
| In group | BT-155 |
Item Seller's identifier | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:SellersItemIdentification/cbc:ID |
— |
| In group | BT-157 |
Item identifier scheme | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:StandardItemIdentification/cbc:ID |
BR-64 · BR-CL-21 |
| In group | BT-159 |
Item country of origin | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:OriginCountry/cbc:IdentificationCode |
BR-CL-15 |
| In group | BT-158 |
Item identifier scheme | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:CommodityClassification/cbc:ItemClassificationCode |
BR-65 |
| Core | BG-30 |
LINE VAT INFORMATION | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory |
— |
| Core | BT-151 |
Item VAT category | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:ID |
BR-CO-04 · BR-O-12 · BR-CL-18 |
| 0..1 / 0..n | BT-152 |
Item VAT rate | 0..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:Percent |
BR-S-05 · BR-Z-05 · BR-E-05 · BR-AE-05 · BR-IC-05 +3 |
| 0..1 / 0..n | BG-32 |
ITEM ATTRIBUTES | 0..n/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:AdditionalItemProperty |
— |
| In group | BT-160 |
Item attribute | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:AdditionalItemProperty/cbc:Name |
BR-54 |
| In group | BT-161 |
Item attribute | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Item/cac:AdditionalItemProperty/cbc:Value |
BR-54 |
| Core | BG-29 |
PRICE DETAILS | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Price |
— |
| Core | BT-146 |
Item net price | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Price/cbc:PriceAmount |
BR-26 · BR-27 · BR-CL-03 · PEPPOL-EN16931-R046 |
| 0..1 / 0..n | BT-149 |
Item price base quantity | 0..1/ubl:Invoice/cac:InvoiceLine/cac:Price/cbc:BaseQuantity |
PEPPOL-EN16931-R121 · BR-CL-23 |
| In group | BT-147 |
Item price discount | 1..1/ubl:Invoice/cac:InvoiceLine/cac:Price/cac:AllowanceCharge/cbc:Amount |
— |
| 0..1 / 0..n | BT-148 |
Item gross price | 0..1/ubl:Invoice/cac:InvoiceLine/cac:Price/cac:AllowanceCharge/cbc:BaseAmount |
BR-28 · BR-CL-03 |
3. Practical mapping of common fields
3.1 Header and Peppol routing
Technical identifiers should be a fixed generator configuration.
| Mode | BT / field | Field | XML path and rule |
|---|---|---|---|
| System | BT-24 |
Specification identifier | /Invoice/cbc:CustomizationIDUse the profile required by the target SK/Peppol rule pack; the generator already uses the Peppol BIS Billing 3.0 value. |
| System | BT-23 |
Process identifier | /Invoice/cbc:ProfileIDPeppol requires a business process. Common value: urn:fdc:peppol.eu:2017:poacc:billing:01:1.0. |
| Always | BT-1 |
Invoice number | /Invoice/cbc:IDUnique sequential invoice number. |
| Always | BT-2 |
Issue date | /Invoice/cbc:IssueDateFormat YYYY-MM-DD. |
| Always | BT-3 |
Invoice type code | /Invoice/cbc:InvoiceTypeCodeUse 380 for a standard invoice; the Slovak profile also supports corrective types according to its rules. |
| Always | BT-5 |
Invoice currency | /Invoice/cbc:DocumentCurrencyCodeISO 4217, typically EUR. |
| Alternative | BT-10 / BT-13 |
Buyer reference or purchase order | /Invoice/cbc:BuyerReference or /Invoice/cac:OrderReference/cbc:IDPeppol rule R003 requires at least one of these references. |
| Condition | BT-9 / BT-20 |
Due date or payment terms | /Invoice/cbc:DueDate or /Invoice/cac:PaymentTerms/cbc:NoteIf payable amount BT-115 is greater than zero, at least one option must be present. |
| Condition | BT-7 |
VAT point date | /Invoice/cbc:TaxPointDateState it when known and different from the issue date. |
3.2 Seller
Do not mix Slovak identifiers: IČO, IČ DPH and DIČ/EndpointID belong to different XML fields.
| Mode | BT / field | Field | XML path and rule |
|---|---|---|---|
| Always | BT-27 |
Seller name | /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationNameFull legal name. |
| Always | BT-34 |
Seller electronic address | /Invoice/cac:AccountingSupplierParty/cac:Party/cbc:EndpointIDFor Slovak scheme 0245 use the ten-digit DIČ without the SK prefix. |
| System | BT-34-1 |
Electronic address scheme | .../cbc:EndpointID/@schemeIDFor a Slovak DIČ use schemeID="0245". |
| Always | BT-35 |
Street and number | .../cac:PostalAddress/cbc:StreetNameMandatory element of a Slovak invoice. |
| Always | BT-37 |
City | .../cac:PostalAddress/cbc:CityNameMandatory element of a Slovak invoice. |
| Always | BT-38 |
Postcode | .../cac:PostalAddress/cbc:PostalZoneMandatory element of a Slovak invoice. |
| Always | BT-40 |
Country code | .../cac:PostalAddress/cac:Country/cbc:IdentificationCodeISO 3166-1 alpha-2, for example SK. |
| Condition | BT-30 |
Seller company number (IČO) | .../cac:PartyLegalEntity/cbc:CompanyIDState it if assigned; use schemeID="0158" for IČO. |
| Condition | BT-31 |
Seller VAT identifier (IČ DPH) | .../cac:PartyTaxScheme/cbc:CompanyIDState it for a VAT-registered seller or when the VAT category requires it. |
| Condition | BT-33 |
Legal form and register | .../cac:PartyLegalEntity/cbc:CompanyLegalFormAccording to Section 3a of the Slovak Commercial Code where applicable. |
3.3 Buyer
The same separation of IČO, IČ DPH and Peppol EndpointID applies to a Slovak buyer.
| Mode | BT / field | Field | XML path and rule |
|---|---|---|---|
| Always | BT-44 |
Buyer name | /Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationNameFull legal name or personal name. |
| Always | BT-49 |
Buyer electronic address | /Invoice/cac:AccountingCustomerParty/cac:Party/cbc:EndpointIDPeppol routing address; for scheme 0245 use the ten-digit DIČ without SK. |
| System | BT-49-1 |
Electronic address scheme | .../cbc:EndpointID/@schemeIDFor a Slovak DIČ use schemeID="0245". |
| Always | BT-50 |
Street and number | .../cac:PostalAddress/cbc:StreetNameMandatory element of a Slovak invoice. |
| Always | BT-52 |
City | .../cac:PostalAddress/cbc:CityNameMandatory element of a Slovak invoice. |
| Always | BT-53 |
Postcode | .../cac:PostalAddress/cbc:PostalZoneMandatory element of a Slovak invoice. |
| Always | BT-55 |
Country code | .../cac:PostalAddress/cac:Country/cbc:IdentificationCodeISO 3166-1 alpha-2. |
| Condition | BT-47 |
Buyer company number (IČO) | .../cac:PartyLegalEntity/cbc:CompanyIDState it if assigned; schemeID="0158". |
| Condition | BT-48 |
Buyer VAT identifier (IČ DPH) | .../cac:PartyTaxScheme/cbc:CompanyIDState it if assigned or required by the VAT treatment. |
3.4 Payment
For a bank transfer, BT-81 and BT-84 are conditionally mandatory; BT-83 and BT-86 are optional supporting data.
| Mode | BT / field | Field | XML path and rule |
|---|---|---|---|
| Condition | BT-81 |
Payment means code | /Invoice/cac:PaymentMeans/cbc:PaymentMeansCodeRequired when payment instructions are supplied. Code 30 is typically used for a bank transfer. |
| Optional | BT-83 |
Payment reference | /Invoice/cac:PaymentMeans/cbc:PaymentIDVariable symbol or another payment reference; recommended for automatic matching. |
| Condition | BT-84 |
IBAN / account identifier | /Invoice/cac:PaymentMeans/cac:PayeeFinancialAccount/cbc:IDMandatory for a transfer when the bank account group is used. |
| Optional | BT-86 |
Payment service provider identifier (for example BIC) | /Invoice/cac:PaymentMeans/cac:PayeeFinancialAccount/cac:FinancialInstitutionBranch/cbc:IDOptional overall; if the financial institution branch group is used, its identifier is mandatory within that group. |
3.5 Every invoice line
These fields repeat for every cac:InvoiceLine element.
| Mode | BT / field | Field | XML path and rule |
|---|---|---|---|
| Line | BT-126 |
Line identifier | /Invoice/cac:InvoiceLine/cbc:IDUnique within the invoice. |
| Line | BT-129 |
Invoiced quantity | .../cbc:InvoicedQuantityNumeric value; the Slovak FA allows at most four decimal places. |
| Line | BT-130 |
Unit of measure code | .../cbc:InvoicedQuantity/@unitCodeUN/ECE Rec20/21, for example C62. |
| Line | BT-131 |
Invoice line net amount | .../cbc:LineExtensionAmountExcluding VAT, after line allowances and charges. |
| Line | BT-146 |
Item net price | .../cac:Price/cbc:PriceAmountPrice per unit excluding VAT after discount. |
| Line | BT-153 |
Item name | .../cac:Item/cbc:NameType of goods or services. |
| Line | BT-151 |
Item VAT category | .../cac:Item/cac:ClassifiedTaxCategory/cbc:IDFor example S, Z, E, AE, IC, G or O depending on the scenario. |
| Condition | BT-152 |
Item VAT rate | .../cac:Item/cac:ClassifiedTaxCategory/cbc:PercentGreater than zero for a standard rate, zero for certain 0% treatments and omitted for O. |
| System | atribút / attribute |
Currency of amount fields | .../cbc:*Amount/@currencyIDMust match BT-5, typically EUR. |
3.6 Totals and VAT breakdown
Totals must reconcile mathematically with lines, allowances, charges, paid amounts and rounding.
| Mode | BT / field | Field | XML path and rule |
|---|---|---|---|
| Always | BT-106 |
Sum of invoice line net amounts | /Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmountSum of all BT-131 values. |
| Condition | BT-107 |
Sum of document-level allowances | .../cbc:AllowanceTotalAmountState it when document-level allowances exist. |
| Condition | BT-108 |
Sum of document-level charges | .../cbc:ChargeTotalAmountState it when document-level charges exist. |
| Always | BT-109 |
Invoice total excluding VAT | .../cbc:TaxExclusiveAmountBT-106 minus BT-107 plus BT-108. |
| Always | BT-110 |
Invoice total VAT amount | /Invoice/cac:TaxTotal/cbc:TaxAmountSum of VAT amounts from all BT-117 breakdowns. |
| Always | BT-112 |
Invoice total including VAT | .../cbc:TaxInclusiveAmountBT-109 plus BT-110. |
| Condition | BT-113 |
Paid amount | .../cbc:PrepaidAmountWhen an advance or another paid amount is deducted. |
| Condition | BT-114 |
Rounding amount | .../cbc:PayableRoundingAmountWhen rounding of the payable amount is used. |
| Always | BT-115 |
Amount due for payment | .../cbc:PayableAmountBT-112 minus BT-113 plus BT-114. |
| Always | BT-116 |
VAT category taxable amount | /Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxableAmountOne breakdown for every category and rate combination. |
| Always | BT-117 |
VAT category tax amount | .../cac:TaxSubtotal/cbc:TaxAmountUsually zero for an exemption or reverse charge. |
| Always | BT-118 |
VAT category code | .../cac:TaxSubtotal/cac:TaxCategory/cbc:IDMust match the categories used on invoice lines. |
| Condition | BT-119 |
VAT category rate | .../cac:TaxSubtotal/cac:TaxCategory/cbc:PercentRequired except when the invoice is outside the scope of VAT. |
| Condition | BT-120 / BT-121 |
Exemption reason or code | .../cac:TaxCategory/cbc:TaxExemptionReason or TaxExemptionReasonCodeMandatory for exemptions, reverse charge and other 0% treatments as required by the rules. |
4. Conditional scenarios
These are the most frequent business and tax scenarios that change the minimum XML scope.
| Mode | BT / field | Field | XML path and rule |
|---|---|---|---|
| Condition | BT-6 + BT-111 |
VAT accounting currency | /Invoice/cbc:TaxCurrencyCode + second cac:TaxTotal/cbc:TaxAmountWhen the VAT accounting currency differs from the invoice currency. |
| Condition | BT-25 / BT-26 |
Reference to the preceding invoice | /Invoice/cac:BillingReference/cac:InvoiceDocumentReference/...For a corrective document, credit note or debit note. |
| Condition | BT-59 |
Payee name | /Invoice/cac:PayeeParty/cac:PartyName/cbc:NameWhen the payee differs from the seller. |
| Condition | BT-62 – BT-69 |
Seller tax representative | /Invoice/cac:TaxRepresentativeParty/...When a foreign seller is represented by a tax representative; name, VAT ID and country are mandatory, with the Slovak address required by the source. |
| Condition | BT-72 / BG-14 |
Delivery date or invoicing period | /Invoice/cac:Delivery/cbc:ActualDeliveryDate or /Invoice/cac:InvoicePeriodEspecially for intra-EU supplies, metered services or period invoicing. |
| Condition | BT-75 – BT-80 |
Deliver-to address | /Invoice/cac:Delivery/cac:DeliveryLocation/cac:Address/...When a delivery location is stated; the country code is mandatory within the group. |
| Condition | BT-92 – BT-98 |
Document-level allowance | /Invoice/cac:AllowanceCharge[cbc:ChargeIndicator='false']/...If an allowance exists: amount, VAT category and reason or reason code. |
| Condition | BT-99 – BT-105 |
Document-level charge | /Invoice/cac:AllowanceCharge[cbc:ChargeIndicator='true']/...If a charge exists: amount, VAT category and reason or reason code. |
| Condition | BT-136 – BT-140 |
Invoice line allowance | /Invoice/cac:InvoiceLine/cac:AllowanceCharge[cbc:ChargeIndicator='false']/...When the discount was not applied directly in the unit price. |
| Condition | BT-141 – BT-145 |
Invoice line charge | /Invoice/cac:InvoiceLine/cac:AllowanceCharge[cbc:ChargeIndicator='true']/...When a charge is applied to a specific invoice line. |
| Condition | BT-122 – BT-125 |
Supporting document / attachment | /Invoice/cac:AdditionalDocumentReference/...When a reference or binary attachment is added; the reference is mandatory and an embedded file needs a MIME type and filename. |
| Condition | BT-157 / BT-158 |
Item identifier scheme | .../cac:Item/.../@schemeIDMandatory only when a standard or classification identifier is provided. |
| Condition | BT-160 / BT-161 |
Item attribute | .../cac:Item/cac:AdditionalItemProperty/...If an item property is used, it must have both a name and a value. |
4.2 Most common VAT treatments
| Scenario | Key codes | Additional checks |
|---|---|---|
| Standard rate | BT-151/118 = S | Seller BT-31; BT-152 and BT-119 > 0; VAT is calculated from the taxable amount. |
| Reverse charge | AE | Seller and buyer identifiers, zero rate, zero VAT and BT-120 or BT-121 with a reverse-charge reason. |
| VAT exemption | E | Zero VAT and a mandatory exemption reason or code. |
| Intra-EU supply | IC | VAT IDs of both parties, delivery date or period, destination country and exemption reason. |
| Export | G | Zero VAT and the relevant reason or code; check delivery data. |
| Outside scope of VAT / non-taxable person | O | Exactly one O breakdown; omit VAT IDs and rates where rules prohibit them; the reason must be consistent. |
5. Slovak identifiers
Slovak identifiers have different meanings and must not be mapped into one universal field.
| Identifier | Seller | Buyer | UBL path / scheme |
|---|---|---|---|
| IČO — Slovak company number | BT-30 | BT-47 | cac:PartyLegalEntity/cbc:CompanyID, schemeID="0158" |
| IČ DPH — Slovak VAT ID | BT-31 | BT-48 | cac:PartyTaxScheme/cbc:CompanyID, value SK + 10 digits |
| DIČ as the Peppol address | BT-34 | BT-49 | cbc:EndpointID, schemeID="0245", 10 digits without the SK prefix |
6. XML skeleton
The skeleton is deliberately shortened. It shows where the principal data belongs; a production document must pass XSD, EN 16931, Peppol and SK CIUS rules.
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2">
<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>{{invoice_number}}</cbc:ID>
<cbc:IssueDate>{{YYYY-MM-DD}}</cbc:IssueDate>
<cbc:DueDate>{{YYYY-MM-DD}}</cbc:DueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>{{buyer_reference}}</cbc:BuyerReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">{{seller_DIC_without_SK}}</cbc:EndpointID>
<cac:PostalAddress>
<cbc:StreetName>{{street}}</cbc:StreetName>
<cbc:CityName>{{city}}</cbc:CityName>
<cbc:PostalZone>{{postal_code}}</cbc:PostalZone>
<cac:Country><cbc:IdentificationCode>SK</cbc:IdentificationCode></cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>{{seller_IC_DPH}}</cbc:CompanyID>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>{{seller_name}}</cbc:RegistrationName>
<cbc:CompanyID schemeID="0158">{{seller_ICO}}</cbc:CompanyID>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">{{buyer_DIC_without_SK}}</cbc:EndpointID>
<!-- address, VAT ID and PartyLegalEntity follow the same pattern as for the supplier -->
</cac:Party>
</cac:AccountingCustomerParty>
<cac:PaymentMeans>
<cbc:PaymentMeansCode>30</cbc:PaymentMeansCode>
<cbc:PaymentID>{{payment_reference}}</cbc:PaymentID>
<cac:PayeeFinancialAccount><cbc:ID>{{IBAN}}</cbc:ID></cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">{{VAT_total}}</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">{{tax_base}}</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">{{VAT_amount}}</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>23</cbc:Percent>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="EUR">{{BT-106}}</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="EUR">{{BT-109}}</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="EUR">{{BT-112}}</cbc:TaxInclusiveAmount>
<cbc:PayableAmount currencyID="EUR">{{BT-115}}</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="C62">{{quantity}}</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">{{line_net}}</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Name>{{item_name}}</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID><cbc:Percent>23</cbc:Percent>
<cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price><cbc:PriceAmount currencyID="EUR">{{unit_net_price}}</cbc:PriceAmount></cac:Price>
</cac:InvoiceLine>
</Invoice>7. Control checklist
| Check | Acceptance criterion | Owner |
|---|---|---|
| Identifiers | IČO, IČ DPH and DIČ/EndpointID are three separate fields mapped to the correct BTs. | ERP master data |
| Header | The generator supplies BT-23, BT-24, BT-1, BT-2, BT-3, BT-5 and BT-10 or BT-13. | ERP / integration |
| Parties | Supplier and customer both have an EndpointID with schemeID and a complete postal address. | Master data |
| Lines | Every line contains BT-126, 129, 130, 131, 146, 151, 153 and the correct rate for the treatment. | Invoicing |
| VAT and totals | BT-106/109/110/112/115 and every VAT breakdown reconcile mathematically with the lines. | ERP / accounting |
| Conditions | Reverse charge, exemptions, intra-EU supplies, allowances, charges and attachments activate the relevant fields. | Tax / integration |
| Validation | XML passes XSD, EN 16931, Peppol BIS and SK CIUS; production sending is fail-closed. | Integration |
8. Sources and boundaries
Verify that your XML actually meets these rules
The validator checks UBL XSD, EN 16931, Peppol BIS and Slovak SK CIUS rules and explains errors in plain language.