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 documentYour eezi organisation must hold your Norwegian legal name, organisation number and VAT number. The VAT number is
NO, then the 9-digit organisation number, thenMVA, for exampleNO123456785MVA. eezi adds these details to every document as the seller, so you don't send them in the payload.
Changes to generic fields
dueDateis required.customInfo.nor.deliveryDateis required. Norwegian bookkeeping rules require the delivery date on every sales document.recipient.peppolId.endpointIdis required: your customer's Peppol ID.recipient.address.line1,city,postalCodeandcountryare required.lines[].unitis required, from Units of measure (UN/ECE Rec 20), for exampleH87(piece) orKGM(kilogram).lines[].vat.codemust be a UNTDID 5305 category, for exampleSfor all positive Norwegian rates. See Norwegian VAT codes.- To get paid by bank transfer with a KID, send
paymentMeanswith code30, the KID inrefand your bank account number inaccount.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
| Name | Type | Required | Description |
|---|---|---|---|
dueDate | string (ISO 8601 date) | Yes | Payment due date. |
customInfo.nor.deliveryDate | string (ISO 8601 date) | Yes | Date the goods were delivered or the service was performed. Shown on the invoice as the actual delivery date. |
purchaseOrderRef | string | No | Your customer's purchase order number. Many Norwegian buyers need it to approve the invoice, so send it whenever you have it. |
salesOrderRef | string | No | Your own sales order number. |
total.currency | string | No | Usually NOK. Defaults to the organisation's currency. For another currency, also send an exchange rate: see Exchange rates. |
notes | string | No | Free-text note shown on the invoice. One note only. |
Recipient (your customer)
| Name | Type | Required | Description |
|---|---|---|---|
recipient.taxId | string | Yes | Customer's Norwegian VAT number: NO + 9-digit organisation number + MVA, for example NO123456785MVA. |
recipient.peppolId.endpointId | string | Yes | Customer'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.line1 | string | Yes | Street and house number. |
recipient.address.line2 | string | No | Additional address line, for example floor or building. |
recipient.address.city | string | Yes | City or town. |
recipient.address.state | string | No | County (fylke). |
recipient.address.postalCode | string | Yes | Four-digit postal code. Send it as text so a leading zero is kept, for example "0150". |
recipient.address.country | string | Yes | NOR. |
recipient.contact.email | string | No | Customer's email address. |
recipient.taxRepresentative | object | No | Only if your customer uses a tax representative. |
recipient.taxRepresentative.name | string | Conditional | Required if you send taxRepresentative. |
recipient.taxRepresentative.taxId | string | Conditional | Required if you send taxRepresentative. VAT number of the representative. |
recipient.taxRepresentative.address.country | string | Conditional | Required 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.
| Name | Type | Required | Description |
|---|---|---|---|
shipToParty.name | string | No | Name of the party receiving the goods. |
shipToParty.address.line1 | string | No | Delivery street and house number. |
shipToParty.address.line2 | string | No | Additional delivery address line. |
shipToParty.address.city | string | No | Delivery city. |
shipToParty.address.state | string | No | Delivery county. |
shipToParty.address.postalCode | string | No | Delivery postal code. |
shipToParty.address.country | string | Conditional | Required 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.
| Name | Type | Required | Description |
|---|---|---|---|
paymentMeans | object array | No | How the customer pays. Usually one entry. |
paymentMeans[].code | string | Conditional | Required if you send paymentMeans. Payment means code: 30 bank transfer (most common in Norway), 58 SEPA credit transfer, 54 or 55 card. |
paymentMeans[].ref | string | No | The KID, digits only, for example 1001001005. Leave it out if you do not use KID. |
paymentMeans[].account.number | string | Conditional | Required for code 30 unless you send account.iban. Your 11-digit Norwegian bank account number, digits only, for example 12345678903. |
paymentMeans[].account.iban | string | Conditional | Required for code 58. Your IBAN. Used instead of account.number when both are sent. |
paymentMeans[].account.name | string | No | Name of the account holder (your company). |
paymentMeans[].account.branch | string | No | Bank identifier (BIC). Send it with an IBAN; leave it out with a Norwegian account number. |
paymentMeans[].card.pan | string | No | Last digits of the card used, for example ****8400. Never send a full card number. |
paymentMeans[].card.network | string | No | Card network, for example VISA. |
paymentMeans[].card.holderName | string | No | Name of the card holder. |
Lines
| Name | Type | Required | Description |
|---|---|---|---|
lines[].unit | string | Yes | Unit 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[].quantity | number | Yes | Decimals are allowed, for example 2.5. |
lines[].vat.code | string | Yes | VAT category. See Norwegian VAT codes. |
lines[].vat.amount | number | Yes | With vat.type percent: the Norwegian rate, 25, 15, 12 or 11.11, or 0 for categories other than S. |
lines[].vat.exemptReason | string | Conditional | For 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.exemptReasonCode | string | Conditional | VATEX code from Peppol exempt reason codes, for example VATEX-EU-AE. Alternative to exemptReason. |
Attachments
| Name | Type | Required | Description |
|---|---|---|---|
attachments | object array | No | Supporting files sent with the invoice, for example a time sheet or delivery note. |
attachments[].name | string | Conditional | Required for each attachment. File name, for example timesheet.pdf. |
attachments[].contentType | string | Conditional | Required 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[].data | string | Conditional | Required for each attachment. File content, Base64 encoded, maximum 1 MB. |
Norwegian VAT codes
vat.code | Use for | vat.amount (percent) | exemptReason |
|---|---|---|---|
S | All positive rates: general, food, transport, raw fish | 25, 15, 12, 11.11 | Do not send |
Z | Zero-rated supplies, for example books and newspapers | 0 | Do not send |
E | Exempt supplies | 0 | Required |
AE | Reverse charge | 0 | Required |
G | Export outside Norway | 0 | Required |
O | Outside the scope of VAT | 0 | Required |
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.
| Message | What to do |
|---|---|
"recipient.peppolId" is required | Add the customer's Peppol ID (iso6523-actorid-upis::0192:<organisation number>). |
[BR-61] ... the Payment account identifier (BT-84) shall be present | You 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
Sample requests (Postman)
Download the sample collection and import it into Postman (File → Import).
- Open the collection's Variables tab and set
apiTokento your organisation API key. - Send a request and check the response.
Updated about 6 hours ago