Important information

This page is not available in English.

Alle

Registrer åpning når dere viser forsendelser fra Dialogporten

  • Published:
  • Updated: 19 November 2026

Bruker dere Dialogporten til å hente og vise forsendelser fra Skatteetaten i systemet deres, eller planlegger dere å gjøre det?

Når en bruker åpner en forsendelse i systemet deres, må åpningen også registreres hos Skatteetaten og Altinn. Ellers kan brukeren få et nytt varsel (revarsel) om en forsendelse som allerede er åpnet.

Åpningen registreres gjennom et kall til endepunktet som følger med forsendelsen. Kallet har to funksjoner:

  • Det henter ekstra innhold når Skatteetaten har lagt til mer informasjon om forsendelsen.
  • Det registrerer forsendelsen som åpnet. Dialogtokenet som sendes inn, avgjør hvilken part åpningen registreres på.

Derfor bør dere registrere at forsendelsen er åpnet

Når en bruker åpner en forsendelse i innboksen hos Skatteetaten eller Altinn, blir den automatisk registrert som åpnet.

Når brukeren åpner forsendelsen i systemet deres, skjer ikke denne registreringen automatisk. Dere må derfor gjøre et kall til endepunktet som følger med forsendelsen.

Vi anbefaler derfor at dere tar i bruk disse endepunktene når dere bruker Dialogporten til å vise aktuelle forsendelser fra Skatteetaten.

Slik fungerer

API-et skal bare brukes for forsendelser der Skatteetaten har lagt inn en URL til tjenesten i content.contentReference.value, og der mediaType har denne verdien:

application/vnd.dialogporten.frontchannelembed-url;type=text/html

URL-en til endepunktet følger med forsendelsen dere henter fra Dialogporten.

For å bruke API-et trenger dere et dialogtoken fra Dialogporten. Dialogtokenet gjelder for den aktuelle dialogen og brukes til å knytte åpningen til riktig part.

Les mer

Les den tekniske dokumentasjonen for Forsendelse Åpnet API for informasjon om endepunkter, autentisering, testing og hvordan dere tar API-et i bruk.