OIOUBL og NemHandel — hvad er det og hvornår skal du bruge det?

OIOUBL er det danske standardformat for elektroniske fakturaer til det offentlige. For ejendomsadministratorer er det relevant ved salg til almene boligselskaber, kommuner og institutioner.

---

Hvad er OIOUBL?

OIOUBL = Offentlig Information Online Universal Business Language

Det er en dansk implementering af UBL 2.1 (Universal Business Language) — et XML-baseret fakturaformat standardiseret af OASIS.

<!-- OIOUBL Invoice — minieksempel -->
<?xml version="1.0" encoding="UTF-8"?>
<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">

  <!-- Fakturanummer og dato -->
  <cbc:ID>SET-2025-001</cbc:ID>
  <cbc:IssueDate>2025-09-01</cbc:IssueDate>
  <cbc:InvoiceTypeCode listID="urn:oioubl:codelist:invoicetypecode-1.2">380</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>DKK</cbc:DocumentCurrencyCode>
  <cbc:Note>Varmeafregning 2024/2025 — Eksempelvej 1-7</cbc:Note>

  <!-- Sælger (din virksomhed) -->
  <cac:AccountingSupplierParty>
    <cac:Party>
      <cbc:EndpointID schemeID="GLN">5790000123456</cbc:EndpointID>
      <cac:PartyName><cbc:Name>M-Bus Gateway ApS</cbc:Name></cac:PartyName>
      <cac:PostalAddress>
        <cbc:StreetName>Servervejen 1</cbc:StreetName>
        <cbc:CityName>København</cbc:CityName>
        <cbc:PostalZone>2100</cbc:PostalZone>
        <cac:Country><cbc:IdentificationCode>DK</cbc:IdentificationCode></cac:Country>
      </cac:PostalAddress>
    </cac:Party>
  </cac:AccountingSupplierParty>

  <!-- Køber (almen boligorganisation med EAN) -->
  <cac:AccountingCustomerParty>
    <cac:Party>
      <cbc:EndpointID schemeID="GLN">5790001234567</cbc:EndpointID><!-- EAN-nummer -->
      <cac:PartyName><cbc:Name>Boligselskab Vest, Afd. 12</cbc:Name></cac:PartyName>
    </cac:Party>
  </cac:AccountingCustomerParty>

  <!-- Betalingsbetingelse -->
  <cac:PaymentTerms>
    <cbc:Note>Netto 30 dage</cbc:Note>
    <cbc:PaymentDueDate>2025-10-01</cbc:PaymentDueDate>
  </cac:PaymentTerms>

  <!-- Fakturalinje — varmeafregning -->
  <cac:InvoiceLine>
    <cbc:ID>1</cbc:ID>
    <cbc:InvoicedQuantity unitCode="EA">1</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="DKK">284750.00</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Description>Varmeafregning 2024-06-01 – 2025-05-31, 45 lejligheder</cbc:Description>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>Z</cbc:ID><!-- Ingen moms (varme til boliger) -->
        <cbc:Percent>0</cbc:Percent>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="DKK">284750.00</cbc:PriceAmount>
    </cac:Price>
  </cac:InvoiceLine>

  <!-- Totaler -->
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="DKK">284750.00</cbc:LineExtensionAmount>
    <cbc:TaxExclusiveAmount currencyID="DKK">284750.00</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="DKK">284750.00</cbc:TaxInclusiveAmount><!-- Ingen moms -->
    <cbc:PayableAmount currencyID="DKK">284750.00</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
</Invoice>

---

Hvornår er OIOUBL obligatorisk?

Lov: Bekendtgørelse om elektronisk afregning med offentlige myndigheder (BEK 354/2020).

---

EAN-nummeret

EAN (European Article Number) er et 13-cifret GLN-nummer der identificerer modtagerens elektroniske faktura-postkasse:

EAN:      5790001234567
Format:   13 cifre, starter med 579... (dansk offentlig sektor)
Bruges til: Afsendelse via NemHandel-netværket
Find EAN: Via modtagerens indkøbsafdeling, eller ean.offentligdigital.dk

I portalen: Sæt EAN-nummer på ejendom under Ejendom → Fakturering → EAN. Platformen inkluderer det automatisk i OIOUBL-output.

---

NemHandel-netværket

NemHandel er den danske infrastruktur til udveksling af OIOUBL-fakturaer:

[Din platform] → genererer OIOUBL XML
      ↓
[NemHandel-afsender (PEPPOL-accesspoint)]
      ↓  (krypteret, signeret)
[NemHandel-modtager]
      ↓
[Modtagerens ERP-system (e-conomic, SAP, etc.)]

Afsendelse: Platformen genererer XML-filen. Afsendelse via NemHandel kræver et accesspoint (tilbydes af leverandører som Digst, MHI, e-conomic). Alternativt: email vedhæftning til ean@modtager.dk.

---

Hvad platformen genererer

# Download OIOUBL for én settlement:
GET /api/v1/settlements/{settlement_id}/oioubl
Accept: application/xml

# Response: UBL 2.1 Invoice XML med:
# - InvoiceTypeCode: 380 (standard faktura)
# - Sælger: Din virksomhed (fra tenant-profil)
# - Køber: EAN + boligorganisationens navn
# - InvoiceLine pr. afregning (én samlet linje eller pr. lejlighed)
# - TaxCategory: Z (nulmoms — varme til boliger)
# - PaymentTerms: 30 dage (konfigurerbar)

---

Moms på varmeafregning

Varme til beboelseslejligheder er momsfritaget i Danmark (ML § 13, stk. 1, nr. 5):

Privat udlejer → lejer (bolig): INGEN moms
Almen boligorg. → lejer (bolig): INGEN moms
Platform → almen boligorg. (serviceydelse): 25% MOMS

OBS: Moms på platformsgebyrerne (49 kr./enhed) er 25%.
     Moms på selve varmeafregningerne til lejerne er 0%.

---

Alternativ: PDF-faktura med EAN-reference

Mange mindre almen boligorganisationer accepterer PDF-faktura med EAN-nummer i PDF:

Faktura nr. SET-2025-001
Modtager EAN: 5790001234567

Vedrørende: Varmeafregning 2024/2025 — Eksempelvej 1-7
Beløb: 284.750,00 kr. (ekskl. moms, jf. ML § 13)

Dette er teknisk set ikke OIOUBL — men accepteres i praksis af mange offentlige modtagere.

---

Konklusion

OIOUBL er obligatorisk ved fakturering til almene boligorganisationer og offentlige institutioner over tærskelværdien. Platformen genererer OIOUBL 2.1 XML automatisk pr. settlement — kræver blot EAN-nummeret på ejendomsprofilen. Varmeafregning til boliger er momsfritaget.

Se almen bolig-guide eller opsæt OIOUBL i portalen.