Hopp til hovedinnholdet

UBL Invoice Integration Guide for Partners

Haima Ambily
  • Oppdatert

Innledning

Denne artikkelen beskriver minimumskravene for å sende UBL-fakturaer til Semine DocFlow-systemet. Bruk dette som et utgangspunkt for din integrasjon. 

SEMINE støtter mottak og behandling av elektroniske fakturaer og kreditnotaer som følger PEPPOL BIS Billing 3.0 (UBL 2.1). Dette inkluderer alle gyldige EHF- fakturaer, som representerer den norske implementeringen av PEPPOL BIS Billing 3.0.

Note: I SEMINE støttes alle PEPPOL-kompatible UBL-fakturaer og kreditnotaer, inkludert, men ikke begrenset til, det norske EHF-formatet.

PEPPOL BIS Billing 3.0- og EHF-fakturaer som mottas av SEMINE inneholder en Standard Business Document (SBD)-konvolutt som omslutter UBL XML-innholdet. For flere detaljer, se Standard Business Document (SBD).

Minimalt gyldig eksempel på UBL-faktura

<h2 id="h_01K8SX2YBV0366H94B94Y83B40">Minimal valid UBL invoice example</h2>
<pre><code class="language-auto"><Invoice xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
        xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
        xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2>

    <cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>
    <cbc:ProfileID>urn:generic:billing:1.0</cbc:ProfileID>
    <cbc:ID>INV-10001</cbc:ID>
    <cbc:IssueDate>2025-10-27</cbc:IssueDate>
    <cbc:DueDate>2025-11-26</cbc:DueDate>
    <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
    <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>

    <cac:AccountingSupplierParty>
        <cac:Party>
            <cac:PartyName>
                <cbc:Name>Example Supplier Ltd.</cbc:Name>
            </cac:PartyName>
            <cac:PartyLegalEntity>
                <cbc:CompanyID>123456789</cbc:CompanyID>
            </cac:PartyLegalEntity>
            <cac:Contact>
                <cbc:ElectronicMail>info@example-supplier.eu</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingSupplierParty>

    <cac:AccountingCustomerParty>
        <cac:Party>
            <cac:PartyName>
                <cbc:Name>Example Customer Corp.</cbc:Name>
            </cac:PartyName>
            <cac:PartyLegalEntity>
                <cbc:CompanyID>987654321</cbc:CompanyID>
            </cac:PartyLegalEntity>
        </cac:Party>
    </cac:AccountingCustomerParty>

    <cac:TaxTotal>
        <cbc:TaxAmount currencyID="EUR">337.50</cbc:TaxAmount>
    </cac:TaxTotal>

    <cac:LegalMonetaryTotal>
        <cbc:PayableAmount currencyID="EUR">1688.00</cbc:PayableAmount>
    </cac:LegalMonetaryTotal>

    <cac:InvoiceLine>
        <cbc:ID>1</cbc:ID>
        <cbc:InvoicedQuantity unitCode="EA">1.00</cbc:InvoicedQuantity>
        <cac:Item>
            <cbc:Name>Generic Service Description</cbc:Name>
        </cac:Item>
        <cac:Price>
            <cbc:PriceAmount currencyID="EUR">1350.00</cbc:PriceAmount>
        </cac:Price>
    </cac:InvoiceLine>

</Invoice>
</code></pre>

Feltkrav og struktur

Dokumenthodefelt

UBL / EHF-felt SEMINE-felt Beskrivelse Eksempel
<cbc:ID> Fakturanummer Unik fakturaidentifikator brukt som hovedreferanse i SEMINE. INV-10001
<cbc:IssueDate> Fakturadato Datoen fakturaen ble utstedt. 2025-10-27
<cbc:DueDate> Forfallsdato Datoen betalingen forfaller. 2025-11-26
<cbc:InvoiceTypeCode> Fakturatype Definerer dokumenttypen (380 = Faktura, 381 = Kreditnota). 380
<cbc:DocumentCurrencyCode> Valuta Valuta som brukes på fakturatotalene. EUR

Leverandørinformasjon (avsender)

UBL / EHF-felt SEMINE-felt Beskrivelse Eksempel
<cac:AccountingSupplierParty>/<cac:Party>/<cac:PartyName>/<cbc:Name> Leverandørnavn Vises som leverandør i fakturahodet. Example Supplier Ltd.
<cac:PartyLegalEntity>/<cbc:CompanyID> Organisasjonsnummer Brukes til leverandørmatching i SEMINE sitt leverandørregister. 1234567890
<cac:Contact>/<cbc:ElectronicMail> Kontakt-e-post for leverandør Lagres som metadata; brukes ikke til matching. info@example-supplier.eu

Kundeinformasjon (mottaker)

UBL / EHF-felt SEMINE-felt Beskrivelse Eksempel
<cac:AccountingCustomerParty>/<cac:Party>/<cac:PartyName>/<cbc:Name> Kundenavn Vises som kundenavn i fakturahodet. Example Customer Corp.
<cac:PartyLegalEntity>/<cbc:CompanyID> Kundens organisasjonsnummer Brukes til å identifisere mottakende selskap i SEMINE. 0987654321

Fakturalinjer (minst én er påkrevd)

UBL / EHF-felt SEMINE-felt Beskrivelse Eksempel
<cac:InvoiceLine>/<cbc:ID> Linje-ID Unik linjeidentifikator innen fakturaen. 1
<cbc:InvoicedQuantity> Antall Antall enheter eller tjenester som faktureres. 1.00
<cac:Item>/<cbc:Name> Linjetekst Beskrivelse av varer eller tjenester. Generic Service Description
<cac:Price>/<cbc:PriceAmount> Enhetspris Pris per enhet eller tjenestelinje. 1350.00

Totalbeløp

UBL / EHF-felt SEMINE-felt Beskrivelse Eksempel
<cac:TaxTotal>/<cbc:TaxAmount> MVA totalt Viser MVA-total som brukes i validering. 337.50
<cac:LegalMonetaryTotal>/<cbc:PayableAmount> Fakturatotal Totalt beløp til betaling (inkludert MVA og avrunding). 1688.00
Tip: Sørg for at leverandørens organisasjonsnummer og valuta samsvarer med registrene i SEMINE for vellykket klassifisering.

Vanlige enhetskoder

Kode Beskrivelse
EA Stykk (enhet)
HUR Time
DAY Dag

Vanlige valutakoder

Kode Valuta
NOK Norske kroner
SEK Svenske kroner
EUR Euro

Vanlige valideringsfeil

Feilmelding Hva er galt Hvordan rette
Mangler fakturanummer Ingen ID-element Legg til <ID> med et unikt fakturanummer
Mangler fakturadato Ingen IssueDate-element Legg til <IssueDate> i formatet YYYY-MM-DD
Ugyldig valutakode Valutaen gjenkjennes ikke Bruk gyldig ISO 4217-kode (NOK, EUR, USD)
Leverandørens organisasjonsnummer er påkrevd Mangler eller ugyldig CompanyID Legg til kun numerisk organisasjonsnummer (8–11 sifre)
Kundens organisasjonsnummer er påkrevd Mangler eller ugyldig CompanyID Legg til kun numerisk organisasjonsnummer (8–11 sifre)
Ugyldig format på organisasjonsnummer Inneholder bokstaver eller feil lengde Fjern landskoder; bruk kun sifre
Ingen fakturalinjer funnet Ingen InvoiceLine-elementer Legg til minst én fakturalinje
Mangler linjebeløp Ingen LineExtensionAmount Legg til totalt linjebeløp
Mangler totalbeløp Ingen PayableAmount Legg til totalt beløp til betaling

Format for organisasjonsnummer per land

Land Lengde Format Gyldig eksempel Ugyldig eksempel
Norge 🇳🇴 9 sifre Kun numerisk 123456789 NO123456789MVA
Sverige 🇸🇪 10 sifre Kun numerisk 1234567890 SE123456789001
Danmark 🇩🇰 8 sifre Kun numerisk 12345678 DK12345678
Finland 🇫🇮 8 sifre Format: 1234567-8 1234567-8 FI12345678

Se også: Peppol Code Lists - Participant identifier schemes

Valgfrie, men anbefalte felt

Betalingsinformasjon

<PaymentMeans>
  <PaymentMeansCode>31</PaymentMeansCode>
  <PayeeFinancialAccount>
    <ID schemeID="BBAN">12345678901</ID>
  </PayeeFinancialAccount>
</PaymentMeans>

Forfallsdato

<PaymentTerms>
  <PaymentDueDate>2024-04-15</PaymentDueDate>
</PaymentTerms>

Skattedetaljer

<TaxTotal>
  <TaxAmount currencyID="NOK">250.00</TaxAmount>
  <TaxSubtotal>
    <TaxableAmount currencyID="NOK">1000.00</TaxableAmount>
    <TaxAmount currencyID="NOK">250.00</TaxAmount>
    <TaxCategory>
      <ID>S</ID>
      <Percent>25.0</Percent>
      <TaxScheme>
        <ID>VAT</ID>
      </TaxScheme>
    </TaxCategory>
  </TaxSubtotal>
</TaxTotal>

Referanse til innkjøpsordre

<OrderReference>
  <ID>PO-2024-001</ID>
</OrderReference>

Trenger du mer informasjon?

For detaljert teknisk dokumentasjon, se relaterte artikler nedenfor:

Relaterte artikler

Kommentarer

0 kommentarer

Logg på hvis du vil legge inn en kommentar.