Norway

Norway uses EHF Billing 3.0: the Peppol BIS Billing 3.0 format with a few Norwegian rules on top. This guide only lists what is different from the generic invoice. For credit notes, see Norway credit note.

Invoice

📘

Before you send your first document

Your eezi organisation must hold your Norwegian legal name, organisation number and VAT number. The VAT number is NO, then the 9-digit organisation number, then MVA, for example NO123456785MVA. eezi adds these details to every document as the seller, so you don't send them in the payload.

Changes to generic fields

  • dueDate is required.
  • customInfo.nor.deliveryDate is required. Norwegian bookkeeping rules require the delivery date on every sales document.
  • recipient.peppolId.endpointId is required: your customer's Peppol ID.
  • recipient.address.line1, city, postalCode and country are required.
  • lines[].unit is required, from Units of measure (UN/ECE Rec 20), for example H87 (piece) or KGM (kilogram).
  • lines[].vat.code must be a UNTDID 5305 category, for example S for all positive Norwegian rates. See Norwegian VAT codes.
  • To get paid by bank transfer with a KID, send paymentMeans with code 30, the KID in ref and your bank account number in account.number. See Payment and KID.
  • If the invoice is not in NOK, send customInfo.exchangeRate. See Exchange rates.
type Invoice {
  // ...all generic invoice fields
  dueDate: string;
  purchaseOrderRef?: string;
  salesOrderRef?: string;
  notes?: string;
  customInfo: {
    nor: {
      deliveryDate: string;
    };
    exchangeRate?: { // required if total.currency is not NOK
      from: string;
      to: 'NOK';
      rate: number;
    };
  };
  recipient: {
    // ...all other generic recipient fields
    address: {
      line1: string;
      line2?: string;
      city: string;
      state?: string;
      postalCode: string;
      country: string;
    };
    peppolId: {
      endpointId: string;
    };
    taxRepresentative?: {
      name: string;
      taxId: string;
      address: {
        country: string;
      };
    };
  };
  shipToParty?: {
    name?: string;
    address?: {
      line1?: string;
      line2?: string;
      city?: string;
      state?: string;
      postalCode?: string;
      country: string;
    };
  };
  lines: [
    {
      // ...all other generic line item fields
      unit: UnitsOfMeasure;
      vat: {
        // ...all other generic line item vat fields
        code: VatCodeUNTDID;
        exemptReason?: string; // E, AE, K, G and O need exemptReason or exemptReasonCode
        exemptReasonCode?: string; // VATEX code, e.g. VATEX-EU-AE
      };
    }
  ];
  paymentMeans?: [
    {
      code: string;
      ref?: string; // KID
      account?: {
        number?: string; // Norwegian bank account (11 digits)
        iban?: string;
        name?: string;
        branch?: string;
      };
      card?: {
        pan: string; // never the full card number, e.g. ****8400
        network?: string;
        holderName?: string;
      };
    }
  ];
  attachments?: Attachment[];
};

Field information

Document

NameTypeRequiredDescription
dueDatestring (ISO 8601 date)YesPayment due date.
customInfo.nor.deliveryDatestring (ISO 8601 date)YesDate the goods were delivered or the service was performed. Shown on the invoice as the actual delivery date.
purchaseOrderRefstringNoYour customer's purchase order number. Many Norwegian buyers need it to approve the invoice, so send it whenever you have it.
salesOrderRefstringNoYour own sales order number.
total.currencystringNoUsually NOK. Defaults to the organisation's currency. For another currency, also send an exchange rate: see Exchange rates.
notesstringNoFree-text note shown on the invoice. One note only.

Recipient (your customer)

NameTypeRequiredDescription
recipient.taxIdstringYesCustomer's Norwegian VAT number: NO + 9-digit organisation number + MVA, for example NO123456785MVA.
recipient.peppolId.endpointIdstringYesCustomer's Peppol ID in the form iso6523-actorid-upis::0192:<organisation number>, for example iso6523-actorid-upis::0192:123456785. 0192 is the scheme for Norwegian organisation numbers.
recipient.address.line1stringYesStreet and house number.
recipient.address.line2stringNoAdditional address line, for example floor or building.
recipient.address.citystringYesCity or town.
recipient.address.statestringNoCounty (fylke).
recipient.address.postalCodestringYesFour-digit postal code. Send it as text so a leading zero is kept, for example "0150".
recipient.address.countrystringYesNOR.
recipient.contact.emailstringNoCustomer's email address.
recipient.taxRepresentativeobjectNoOnly if your customer uses a tax representative.
recipient.taxRepresentative.namestringConditionalRequired if you send taxRepresentative.
recipient.taxRepresentative.taxIdstringConditionalRequired if you send taxRepresentative. VAT number of the representative.
recipient.taxRepresentative.address.countrystringConditionalRequired if you send taxRepresentative. Country code.

Delivery address

Send shipToParty only when the goods go to a different address than the customer's address. Leave it out otherwise: the customer's address is then the place of delivery.

NameTypeRequiredDescription
shipToParty.namestringNoName of the party receiving the goods.
shipToParty.address.line1stringNoDelivery street and house number.
shipToParty.address.line2stringNoAdditional delivery address line.
shipToParty.address.citystringNoDelivery city.
shipToParty.address.statestringNoDelivery county.
shipToParty.address.postalCodestringNoDelivery postal code.
shipToParty.address.countrystringConditionalRequired if you send a delivery address. Country code, for example NOR.

Payment and KID

Most Norwegian invoices are paid by bank transfer with a KID (customer identification number). The KID lets your bank match the payment to the invoice automatically.

NameTypeRequiredDescription
paymentMeansobject arrayNoHow the customer pays. Usually one entry.
paymentMeans[].codestringConditionalRequired if you send paymentMeans. Payment means code: 30 bank transfer (most common in Norway), 58 SEPA credit transfer, 54 or 55 card.
paymentMeans[].refstringNoThe KID, digits only, for example 1001001005. Leave it out if you do not use KID.
paymentMeans[].account.numberstringConditionalRequired for code 30 unless you send account.iban. Your 11-digit Norwegian bank account number, digits only, for example 12345678903.
paymentMeans[].account.ibanstringConditionalRequired for code 58. Your IBAN. Used instead of account.number when both are sent.
paymentMeans[].account.namestringNoName of the account holder (your company).
paymentMeans[].account.branchstringNoBank identifier (BIC). Send it with an IBAN; leave it out with a Norwegian account number.
paymentMeans[].card.panstringNoLast digits of the card used, for example ****8400. Never send a full card number.
paymentMeans[].card.networkstringNoCard network, for example VISA.
paymentMeans[].card.holderNamestringNoName of the card holder.

Lines

NameTypeRequiredDescription
lines[].unitstringYesUnit of measure from Units of measure, for example H87 (piece), C62 (one), KGM (kilogram), HUR (hour). ERP codes such as ST or PC are rejected.
lines[].quantitynumberYesDecimals are allowed, for example 2.5.
lines[].vat.codestringYesVAT category. See Norwegian VAT codes.
lines[].vat.amountnumberYesWith vat.type percent: the Norwegian rate, 25, 15, 12 or 11.11, or 0 for categories other than S.
lines[].vat.exemptReasonstringConditionalFor E, AE, K, G and O: why no VAT is charged. Send this, exemptReasonCode, or both. Not used for S or Z (eezi leaves it out).
lines[].vat.exemptReasonCodestringConditionalVATEX code from Peppol exempt reason codes, for example VATEX-EU-AE. Alternative to exemptReason.

Attachments

NameTypeRequiredDescription
attachmentsobject arrayNoSupporting files sent with the invoice, for example a time sheet or delivery note.
attachments[].namestringConditionalRequired for each attachment. File name, for example timesheet.pdf.
attachments[].contentTypestringConditionalRequired for each attachment. One of application/pdf, image/png, image/jpeg, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.oasis.opendocument.spreadsheet.
attachments[].datastringConditionalRequired for each attachment. File content, Base64 encoded, maximum 1 MB.

Norwegian VAT codes

vat.codeUse forvat.amount (percent)exemptReason
SAll positive rates: general, food, transport, raw fish25, 15, 12, 11.11Do not send
ZZero-rated supplies, for example books and newspapers0Do not send
EExempt supplies0Required
AEReverse charge0Required
GExport outside Norway0Required
OOutside the scope of VAT0Required

You can mix rates in one invoice. eezi adds a VAT breakdown per rate.

Exchange rates

Norwegian invoices must show VAT in NOK. If total.currency is not NOK, send your rate in customInfo.exchangeRate with to set to NOK. See Bring Your Own Rate (BYOR) for how it works.

"customInfo": {
  "nor": { "deliveryDate": "2026-11-13" },
  "exchangeRate": { "from": "EUR", "to": "NOK", "rate": 11.7350 }
}

Example

{
  "ref": "INV-2026-0001",
  "issued": "2026-11-17",
  "dueDate": "2026-12-17",
  "purchaseOrderRef": "PO-0001",
  "customInfo": {
    "nor": {
      "deliveryDate": "2026-11-13"
    }
  },
  "recipient": {
    "name": "Example Buyer AS",
    "taxId": "NO123456785MVA",
    "address": {
      "line1": "Example Street 1",
      "line2": "Floor 2",
      "city": "Oslo",
      "postalCode": "0150",
      "country": "NOR"
    },
    "peppolId": {
      "endpointId": "iso6523-actorid-upis::0192:123456785"
    },
    "contact": {
      "email": "[email protected]"
    }
  },
  "paymentMeans": [
    {
      "code": "30",
      "ref": "1001001005",
      "account": {
        "number": "12345678903"
      }
    }
  ],
  "lines": [
    {
      "description": "Office chair",
      "quantity": 2,
      "unit": "H87",
      "price": { "amount": 1500.00 },
      "vat": { "type": "percent", "amount": 25, "code": "S" }
    },
    {
      "description": "Coffee",
      "quantity": 10,
      "unit": "KGM",
      "price": { "amount": 120.00 },
      "vat": { "type": "percent", "amount": 15, "code": "S" }
    }
  ],
  "total": {
    "amount": 5130.00,
    "currency": "NOK"
  }
}

Common errors

These come back as 400 Bad Request (or 403 where shown) when you create the document. Fix the field and send the document again.

MessageWhat to do
"recipient.peppolId" is requiredAdd the customer's Peppol ID (iso6523-actorid-upis::0192:<organisation number>).
[BR-61] ... the Payment account identifier (BT-84) shall be presentYou sent paymentMeans code 30 without a bank account. Add account.number (or account.iban).
[BR-CL-23] Unit code MUST be coded according to the UN/ECE Recommendation 20 ...lines[].unit is not a valid code, for example ST. Use a code from Units of measure such as H87.
"lines[0].vat" requires "exemptReason" or "exemptReasonCode" for code "E"Add exemptReason (or exemptReasonCode) to every E, AE, K, G or O line.
403 A document with the same ref already exists.Every ref must be unique. Use a new number.

A 201 or 202 response means eezi accepted the invoice. Check the final status (success or error) as described in Asynchronous responses.

Example CSV file

Invoice - NOR.csv

Sample requests (Postman)

Download the sample collection and import it into Postman (File → Import).

  1. Open the collection's Variables tab and set apiToken to your organisation API key.
  2. Send a request and check the response.

Norway – sample invoice requests (Postman collection)


Did this page help you?