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 invoice

Norwegian bookkeeping rules require every credit note to point to the invoice it corrects. Send the ref of that invoice in invoiceRefs. The invoice must already exist in the same eezi organisation.

Changes to generic fields

  • dueDate is required.
  • invoiceRefs is required: the ref of the invoice or invoices you are crediting. You can reference more than one invoice.
  • lines are 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.deliveryDate is required: the delivery date of the goods or services you are crediting.
  • 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, the same as on the original invoice. See Norwegian VAT codes.
  • paymentMeans is 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

NameTypeRequiredDescription
dueDatestring (ISO 8601 date)YesDue date of the credit note, for example the date you refund the customer. Required by eezi.
invoiceRefsstring arrayYesref of each invoice this credit note corrects, for example ["INV-2026-0001"]. eezi checks that each invoice exists in your organisation.
customInfo.nor.deliveryDatestring (ISO 8601 date)YesDelivery date of the goods or services being credited, usually the same as on the original invoice.
total.amountnumberYesTotal amount credited, including VAT, as a positive number. Must agree with the lines.
total.currencystringNoThe same currency as the original invoice, usually NOK. For another currency, also send an exchange rate: see Exchange rates.
notesstringNoFree-text note shown on the credit note, for example the reason for the credit. 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.

Delivery address

Send shipToParty only if the original invoice had a different delivery address.

NameTypeRequiredDescription
shipToParty.namestringNoName of the party that received 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.

Lines

NameTypeRequiredDescription
lines[].descriptionstringYesWhat is being credited, for example Office chair (returned).
lines[].quantitynumberYesQuantity credited, as a positive number. Decimals are allowed, for example 2.5.
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[].price.amountnumberYesUnit price, excluding VAT, as a positive number.
lines[].vat.typestringYespercent: vat.amount is a rate, for example 25.
lines[].vat.amountnumberYesThe Norwegian rate, 25, 15, 12 or 11.11, or 0 for categories other than S.
lines[].vat.codestringYesVAT category, the same as on the original invoice line. See Norwegian VAT codes.
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.

Payment means

NameTypeRequiredDescription
paymentMeansobject arrayNoOnly when you refund to a bank account.
paymentMeans[].codestringConditionalRequired if you send paymentMeans. Payment means code, usually 30 (bank transfer).
paymentMeans[].account.numberstringConditionalRequired for code 30 unless you send account.iban. 11-digit Norwegian bank account number, digits only.
paymentMeans[].account.ibanstringConditionalRequired for code 58. Used instead of account.number when both are sent.
paymentMeans[].account.namestringNoName of the account holder.
paymentMeans[].account.branchstringNoBank identifier (BIC). Send it with an IBAN.

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

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.

MessageWhat to do
400 "invoiceRefs" is required - an EHF credit note must reference the invoice it correctsAdd invoiceRefs with the ref of the original invoice.
400 "dueDate" is requiredAdd 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 refAn invoice in invoiceRefs does not exist in this organisation. Check the ref.
400 "recipient.peppolId" is requiredAdd the customer's Peppol ID (iso6523-actorid-upis::0192:<organisation number>).
400 [BR-61] ... the Payment account identifier (BT-84) shall be presentYou 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

Credit note - 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 00 first, then the credit notes, and check each response.

Norway – sample credit note requests (Postman collection)


Did this page help you?