Skip to main content
Download OpenAPI

Onboard legal entity

A LegalEntity must be registered within our business registry to be a participant into the Peppol Network.

In Norway, companies are identified by their organisasjonsnummer, the 9-digit organisation number assigned by the Brønnøysund Register Centre (Enhetsregisteret, the Central Coordinating Register for Legal Entities).

Create the LegalEntity​

You can create a LegalEntity via API with POST /legal-entities by specifying only its organisasjonsnummer:

{
  "organisasjonnummer": "509100675"
}

The platform validates the number, looks it up in the Enhetsregisteret and fills in the company data (name and address) for you. You will receive back an HTTP 201 with the LegalEntity you created, including the uuid that identifies it:

{
  "uuid": "e69c700b-d034-4c38-872f-42c03fb95fda",
  "registeredName": "Sesam stasjon",
  "country": "NO",
  "address": "Oslo",
  "city": "Oslo",
  "stateOrProvince": "Oslo",
  "zipCode": "0010",
  "identifierScheme": "iso6523-actorid-upis",
  "identifierValue": "0192:509100675",
  "smpEnabled": false,
  "createdAt": "2026-10-02T10:00:00+00:00",
  "updatedAt": null
}

The Peppol participant identifier is always built as 0192:{organisasjonsnummer}, where 0192 is the ICD code of the Enhetsregisteret.

Errors​

StatusWhen it happens
HTTP 404the organisasjonsnummer does not exist in the Enhetsregisteret
HTTP 409a LegalEntity with the same identifier already exists in your account
HTTP 422the organisasjonsnummer is not made of 9 digits or its check digit is not valid or the organisasjonsnummer has been struck off (slettet)

Create a test LegalEntity (sandbox only)​

In the sandbox environment you can create a LegalEntity without looking it up in the Enhetsregisteret, so you can test the platform with companies that do not exist. Send the same POST /legal-entities request with the HTTP header X-Skip-CCR-Check: true, and provide in the body the company data that would otherwise be read from the Enhetsregisteret:

{
  "organisasjonnummer": "923609016",
  "registeredName": "Test stasjon",
  "country": "NO",
  "address": "Storgata 1",
  "city": "Oslo",
  "stateOrProvince": "Oslo",
  "zipCode": "0155"
}
FieldRequiredDescription
organisasjonnummeryesthe 9-digit organisation number
registeredNameyesthe company name
countryyesthe country code, as ISO 3166-1 alpha-2 (i.e., NO)
addressnothe street address
citynothe city
stateOrProvincenothe municipality (kommune)
zipCodenothe postal code

The LegalEntity is created with the data you provided, exactly as if it came from the Enhetsregisteret, and you will receive back an HTTP 201 with the same response described above. You can then claim it and exchange documents with it, through the Peppol test Network only.

The organisasjonsnummer is still validated, so it must be made of 9 digits with a valid check digit, but it does not need to exist in the Enhetsregisteret. Without the header, the Enhetsregisteret is always queried and the additional fields of the body are ignored.

The header is not available in production: a request that contains it is refused with an HTTP 400 and the message The X-Skip-CCR-Check header is not available in production.

Errors​

StatusWhen it happens
HTTP 400the header has been sent to the production environment
HTTP 409a LegalEntity with the same identifier already exists in your account
HTTP 422the organisasjonsnummer is not valid, registeredName or country are missing, or country is not a valid country code

Claim the LegalEntity into the SMP​

Once created, the LegalEntity is not yet reachable in the Peppol Network. You can enable the record into the SMP and register it into the Peppol Network with PUT /legal-entities/{uuid}/claim.

The endpoint does not need a request body, and any body sent is ignored.

The company will be enabled to receive both Invoice and CreditNote documents, in the following formats:

FormatProcess
EHF Billing 3.0urn:fdc:anskaffelser.no:2019:ehf:postaward:g3:08:1.0
Peppol BIS Billing 3.0urn:fdc:peppol.eu:2017:poacc:billing:01:1.0

See Formats for more details on the two formats.

If the same participant identifier is already registered in the SMP by another account, you will receive an HTTP 409 error.

You can read the current SMP records of a LegalEntity at any time with GET /legal-entities/{uuid}/smp.

Unclaim the LegalEntity​

To stop receiving documents through the Peppol Network, you can remove the records from the SMP with PUT /legal-entities/{uuid}/unclaim.

The LegalEntity record is kept in your account, so you can claim it again later. The response will be:

{
  "enabled": false,
  "capabilities": []
}

Delete the LegalEntity​

You can delete a LegalEntity with DELETE /legal-entities/{uuid}. If the LegalEntity is claimed, its records are removed from the SMP as well.

The documents already exchanged by the LegalEntity are kept. If you create again a LegalEntity with the same organisasjonsnummer, the previous record is restored with the data currently present in the Enhetsregisteret.

Last updated on