Skip to main content

Introduction

The norwegian invoicing API is designed to facilitate the exchange of electronic documents in compliance with the Norwegian e-invoicing regulations.

The platform runs on top of the Peppol Network, allowing seamless interoperability between different systems and ensuring that your documents are delivered securely and efficiently. Learn more about Peppol here and here.

This product is a specific implementation of the Peppol standard, tailored to meet the requirements of the Norwegian market: documents are exchanged in the EHF Billing 3.0 format, as well as in the European Peppol BIS Billing 3.0 one, and companies are identified by their organisasjonsnummer. It runs on the domain no.api.acubeapi.com.

To get started:

  1. Get a valid token, see here
  2. Onboard the company (LegalEntity) into the Peppol Network using its organisasjonsnummer, see here
  3. Prepare and send a new EHF or Peppol BIS Billing 3.0 document, you can choose between standard UBL 2.1 XML or the JSON format, see here
  4. Receive the uuid identifier for the newly created document as response and store it
  5. Receive information about the delivery to your configured webhook, match against the previously stored identifier.

Environments​

  • sandbox is the environment where you can test the entire platform without paying at any time. Documents are by the way exchanged through the Peppol test Network, and you can create test companies that do not exist in the Enhetsregisteret, see here The base URL is https://no-sandbox.api.acubeapi.com
  • production is the environment where documents exchange happens in the official Peppol Network The base URL is https://no.api.acubeapi.com

Authentication​

You can find all the information about the authentication here.

API orchestration and webhooks​

You can configure via API your webhooks where to receive information in real-time, as soon as an event happens.

A-Cube Peppol API supports two types of events:

  • outgoing-document it is dispatched to inform your webhook about an outgoing deliver
  • incoming-document it is dispatched when an incoming document has been delivered to your account

You can find more information about webhooks here.