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 credit note. For invoices, see Norway invoice.
Credit note
Every credit note must reference an invoiceNorwegian bookkeeping rules require every credit note to point to the invoice it corrects. Send the
refof that invoice ininvoiceRefs. The invoice must already exist in the same eezi organisation.
Changes to generic fields
dueDateis required.invoiceRefsis required: therefof the invoice or invoices you are crediting. You can reference more than one invoice.linesare required. Send what you are crediting as positive quantities and prices; eezi sends the document as a credit note, so you don’t use negatives.customInfo.nor.deliveryDateis required: the delivery date of the goods or services you are crediting.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, the same as on the original invoice. See Norwegian VAT codes.paymentMeansis optional. Send it when you refund the amount to the customer's bank account.- If the credit note is not in NOK, send
customInfo.exchangeRate. See Exchange rates.
type CreditNote {
// ...all generic credit note fields
dueDate: string;
invoiceRefs: 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;
};
};
shipToParty?: {
name?: string;
address?: {
line1?: string;
line2?: string;
city?: string;
state?: string;
postalCode?: string;
country: string;
};
};
lines: [
{
description: string;
quantity: number;
unit: UnitsOfMeasure;
price: {
amount: number;
};
vat: {
type: 'percent' | 'fixed';
amount: number;
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;
account?: {
number?: string; // Norwegian bank account (11 digits)
iban?: string;
name?: string;
branch?: string;
};
}
];
};Field information
Document
| Name | Type | Required | Description |
|---|---|---|---|
dueDate | string (ISO 8601 date) | Yes | Due date of the credit note, for example the date you refund the customer. Required by eezi. |
invoiceRefs | string array | Yes | ref of each invoice this credit note corrects, for example ["INV-2026-0001"]. eezi checks that each invoice exists in your organisation. |
customInfo.nor.deliveryDate | string (ISO 8601 date) | Yes | Delivery date of the goods or services being credited, usually the same as on the original invoice. |
total.amount | number | Yes | Total amount credited, including VAT, as a positive number. Must agree with the lines. |
total.currency | string | No | The same currency as the original invoice, usually NOK. For another currency, also send an exchange rate: see Exchange rates. |
notes | string | No | Free-text note shown on the credit note, for example the reason for the credit. 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. |
Delivery address
Send shipToParty only if the original invoice had a different delivery address.
| Name | Type | Required | Description |
|---|---|---|---|
shipToParty.name | string | No | Name of the party that received 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. |
Lines
| Name | Type | Required | Description |
|---|---|---|---|
lines[].description | string | Yes | What is being credited, for example Office chair (returned). |
lines[].quantity | number | Yes | Quantity credited, as a positive number. Decimals are allowed, for example 2.5. |
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[].price.amount | number | Yes | Unit price, excluding VAT, as a positive number. |
lines[].vat.type | string | Yes | percent: vat.amount is a rate, for example 25. |
lines[].vat.amount | number | Yes | The Norwegian rate, 25, 15, 12 or 11.11, or 0 for categories other than S. |
lines[].vat.code | string | Yes | VAT category, the same as on the original invoice line. See Norwegian VAT codes. |
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. |
Payment means
| Name | Type | Required | Description |
|---|---|---|---|
paymentMeans | object array | No | Only when you refund to a bank account. |
paymentMeans[].code | string | Conditional | Required if you send paymentMeans. Payment means code, usually 30 (bank transfer). |
paymentMeans[].account.number | string | Conditional | Required for code 30 unless you send account.iban. 11-digit Norwegian bank account number, digits only. |
paymentMeans[].account.iban | string | Conditional | Required for code 58. Used instead of account.number when both are sent. |
paymentMeans[].account.name | string | No | Name of the account holder. |
paymentMeans[].account.branch | string | No | Bank identifier (BIC). Send it with an IBAN. |
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 |
Exchange rates
Norwegian credit notes must show VAT in NOK. If total.currency is not NOK, send customInfo.exchangeRate with to set to NOK, normally with the same rate as on the original invoice. See Bring Your Own Rate (BYOR).
"customInfo": {
"nor": { "deliveryDate": "2026-11-13" },
"exchangeRate": { "from": "EUR", "to": "NOK", "rate": 11.7350 }
}Examples
Return of one item from invoice INV-2026-0001:
{
"ref": "CN-2026-0001",
"issued": "2026-11-20",
"dueDate": "2026-12-20",
"invoiceRefs": ["INV-2026-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"
}
},
"lines": [
{
"description": "Office chair (returned)",
"quantity": 1,
"unit": "H87",
"price": { "amount": 1500.00 },
"vat": { "type": "percent", "amount": 25, "code": "S" }
}
],
"paymentMeans": [
{
"code": "30",
"account": {
"number": "12345678903"
}
}
],
"total": {
"amount": 1875.00,
"currency": "NOK"
}
}One credit note for two invoices: list both refs, for example "invoiceRefs": ["INV-2026-0001", "INV-2026-0002"]. The rest of the credit note is built the same way.
Common errors
These come back when you create the credit note. Fix the field and send it again.
| Message | What to do |
|---|---|
400 "invoiceRefs" is required - an EHF credit note must reference the invoice it corrects | Add invoiceRefs with the ref of the original invoice. |
400 "dueDate" is required | Add dueDate to the credit note. |
400 "lines[0].vat" requires "exemptReason" or "exemptReasonCode" for code "E" | Add exemptReason (or exemptReasonCode) to every E, AE, K, G or O line. |
404 No invoice found with matching ref | An invoice in invoiceRefs does not exist in this organisation. Check the ref. |
400 "recipient.peppolId" is required | Add the customer's Peppol ID (iso6523-actorid-upis::0192:<organisation number>). |
400 [BR-61] ... the Payment account identifier (BT-84) shall be present | You sent paymentMeans code 30 without a bank account. Add account.number, or leave paymentMeans out. |
400 [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 such as H87. |
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 credit note. 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 00 first, then the credit notes, and check each response.
Updated about 6 hours ago