Skip to main content

Utleggsbegjæring API

English summary for Utleggsbegjaering API.

The target audience includes current debt collection systems, municipalities, and other system providers. If you wish to integrate the Utleggsbegjæring and prøving service into your system, or if you have any related questions, please contact: fremtidensinnkreving@skatteetaten.no.

The diagram below illustrates the overall services the Norwegian Tax Administration will offer for the receipt and assessment of Utleggsbegjæring. Please note that the diagram represents a target state, and not all services shown have been implemented yet. Additional services not included in the diagram may also be introduced in the future

Informasjonsmodell

For information about the services see:

Altinn Dialogue gateway

Suppliers are not required to integrate with Dialogporten, either during the pilot phase or in full production. It will be sufficient to use only the API endpoints. However, through Dialogporten, we will offer an event notification service that alerts users when new messages from the Norwegian Tax Administration are available—such as requests to correct a previously submitted enforcement request. If you choose not to use the notification service, you must regularly check for new messages by polling the agency’s API.

Follow up and support

During the testing phase, we will provide support to system providers throughout development and testing. More information will be made available here.

In the meantime, please contact: fremtidensinnkreving@skatteetaten.no.

Scope

The following scope is to be used when authenticating in Maskinporten: skatteetaten:utleggsbegjaering

Delegation

Tilgang til dette API-et kan delegeres i Altinn, f.eks. dersom leverandør benyttes for den tekniske oppkoblingen. Søk opp følgende tjeneste i Altinn for å delegere tilgangen: Utleggstrekkbegjæring API - På vegne av

Technical specification

URL-er til API-et, beskrivelsen av parameterne, endepunkter og respons ligger i Open API spesifikasjonen på SwaggerHub.

Data catalogue

This API is currently not available in the data catalogue

Access to the service

Connection to the Tax Administration's test environment is done via Maskinporten. To obtain a token from Maskinporten, the debt collection system must use its enterprise certificate to specify which Organisasjonsnummer it represents. This organisasjonsnummer must be approved by the Tax Administration.

To use the services for submitting Utleggsbegjæring, the following scope must be specified during authentication with Maskinporten: skatteetaten:utleggsbegjaering The API supports two authentication methods via Maskinporten, as described below

Option 1 – System Provider as Submitter

If the system provider only submits utleggsbegjæring on behalf of their own organization, classic authentication via Maskinporten can be used. More information is available here.

Option 2 – Systembruker

If the system provider wants to offer functionality where another organization (a customer of the system provider) uses the system to submit utleggsbegjæringer, Altinn's new functionality for Systembruker must be used. More information can be found in Altinn System User for SBS and the System User Roadmap. In order to use Systembruker functionality, the system provider must register in Maskinporten and the Altinn test environment.

Read about Systembruker here

Test setup

Use any fictional organizations from Tenor as the submitter of the utleggsbegjæring.

Option 1 - Testing with System Provider as Submitter

When the system provider is the submitter, any fictional organizations in Tenor can be used.

Option 2 - Testing with System User

The selected organization in Tenor (representing a test debt collection company) must approve that its business system is allowed to use the resource/service "Submission and follow-up of enforcement requests" on behalf of the company. A Systembruker is then created, linking the user, system, provider, and API.