How PEPPOL routing works for Norway

When you send an invoice, Sovos reads the buyer's 9-digit organisasjonsnummer from the document, queries ELMA, and routes the invoice to the correct Access Point automatically. Sovos creates or updates a trading partner endpoint record the first time it routes to a buyer.

You don't need to create trading partner records before sending invoices. Manual trading partner management is for edge cases. For example, when you need to pre-configure delivery for a specific buyer or update an existing endpoint.

Create a trading partner endpoint through the API

Request

CODECopy

POST /v2/configurations/networks/{networkId}/trading-partners/endpoints

POST /v2/configurations/networks/{networkId}/trading-partners/endpoints

JSONCopy

{ "productId": "no_invoice_outbound_1.0", "codeComponents": [ { "field": "IDENTIFIER", "value": "123456789" } ] }

{
  "productId": "no_invoice_outbound_1.0",
  "codeComponents": [
    {
      "field": "IDENTIFIER",
      "value": "123456789"
    }
  ]
}

Field	Format	Required	Notes
productId	string	Required	no_invoice_outbound_1.0 for outbound invoice routing.
codeComponents[].field	string	Required	Always IDENTIFIER for Norway.
codeComponents[].value	string	Required	The buyer's 9-digit organisasjonsnummer. Must pass MOD-11 checksum validation. Format: ^\d{9}$.

The PEPPOL scheme (0192) is set during onboarding.

Successful response

JSONCopy

{ "status": 201, "success": true, "data": { "id": "[trading-partner-endpoint-uuid]", "code": { "value": "123456789", "scheme": "0192" } } }

{
  "status": 201,
  "success": true,
  "data": {
    "id": "[trading-partner-endpoint-uuid]",
    "code": {
      "value": "123456789",
      "scheme": "0192"
    }
  }
}

Get a trading partner endpoint

Send the following request:

GET /v2/configurations/networks/{networkId}/trading-partners/endpoints/{endpointId}

Update a trading partner endpoint

Send the following request:

PUT /v2/configurations/networks/{networkId}/trading-partners/endpoints/{endpointId}

After creation, you can update the supportedDocuments field but not the codeComponents (the organisasjonsnummer) or the network identifier after creation. If a buyer's organisasjonsnummer changes, remove the existing trading partner record and create a new one.

Delete a trading partner endpoint

Send the following request:

DELETE /v2/configurations/networks/{networkId}/trading-partners/endpoints/{endpointId}

A successful deletion returns 200 OK or 204 No Content.