Registrere et integreringspunkt i webportalen for ID-porten

Firmaer som er registrert for merverdiavgift i Norge, har sine kontoer i webportalen ID-porten. Hvis du vil aktivere direkte innsending av mva-returer til Altinn, må du opprette et integreringspunkt på firmaets konto i ID-porten. Hvis du vil ha mer informasjon, kan du se ID-Porten og godkjenning.

Vi anbefaler at du definerer følgende parametere for integreringspunktet for direkte innsending av mva-returer til Altinn fra Microsoft Dynamics 365 Finance.

Parameternavn (norsk)	Parameternavn (engelsk)	Beskrivelse av parameteren	Parameterverdi
Difi-tjeneste	Difi-tjeneste	Velg tjenesten som skal tilordnes riktige områder.	Velg API-klient.
Områder	Områder	APIer/ressurser som integreringen har tilgang til.	Velg følgende områder: openid skatteetaten:mvameldinginnsending skatteetaten:mvameldingvalidering
Kundens org.nr.	Kundens organisasjonsnummer	Organisasjonsnummeret til tjenesteeieren.	Du behøver ikke å angi noen verdi i dette feltet. Den obligatoriske verdien angis automatisk når oppsettet av integreringspunktet lagres.
Integrasjonens identifikator	Integrasjonens identifikator	Den unike identifikatoren for tjenesten. Identifikatoren genereres automatisk.	Du behøver ikke å angi noen verdi i dette feltet. Den obligatoriske verdien angis automatisk når oppsettet av integreringspunktet lagres.
Navn på integrasjonen	Navn på integrasjonen	Navnet på integrasjonen slik det vises i påloggingsvinduet.	Angi Microsoft Dynamics 365 Finance.
Beskrivelse	Beskrivelse	En kort beskrivelse av tjenesten (for eksempel "Møteportal for NN-kommune").	Angi Integrering med Microsoft Dynamics 365 Finance.
Tillatte tilskuddstyper	Tillatte tilskuddstyper	Et tilskudd representerer brukerens tillatelse til å hente et tilgangstoken. Ved å velge bestemte tilskudd godtar du de tilsvarende metodene for å hente et tilgangstoken.	Velg følgende tilskuddstyper: authorization_code refresh_token
Klientautentiseringsmetode	Godkjenningsmetode for klient	Godkjenningsmetode for klienten.	Angi client_secret_post.
Applikasjonstype	Programtype	Programtypen (eller klienten) er typen kjøretidsmiljø som klienten kjører under. OAuth2-kapitlet 2.1 viser de tilgjengelige alternativene. Valget av klienttype er en sikkerhetsvurdering som kunden vil utføre.	Velg web.
Gyldig(e) omdirigerings-uri-er	Gyldige omdirigerings-URIer	Denne parameteren gjelder bare for personlige påloggingsintegreringer. Den angir URIene som klienten har tillatelse til å gå til etter pålogging.	I Finance kan du gå til Avgift>Oppsett>Elektroniske meldinger>Webprogrammer, kopiere URL-adressen (HTTPS-internettadressen) fra nettleserens adresselinje og lime den inn i dette feltet.
Gyldig(e) post logout redirect uri-er	Gyldig(e) post logout redirect URI-er	Denne parameteren gjelder bare for personlige påloggingsintegreringer. Den angir URIene som klienten har tillatelse til å gå til etter avlogging.	Angi basisnettadressen for Finance-miljøet.
Frontchannel logout uri	URI for Frontchannel-avlogging	URI-en som leverandøren sender en forespørsel til ved avlogging som utløses av en annen klient i den samme økten. Hvis du ikke angir denne parameteren, er det fare for at brukeren fremdeles kan være logget på tjenesten når de logger seg av ID-porten.	Angi basisnettadressen for Finance-miljøet.
Frontchannel logout krever sesjons-id	Frontchannel-avlogging krever økt-ID	Denne parameteren gjelder bare for personlige påloggingsintegreringer. Det er et flagg som bestemmer om utsteder- og økt-ID-parameterne sendes sammen med frontchannel_logout_uri.	La denne boksen stå tom.
Tilbake-uri	Tilbake-URI	Denne parameteren gjelder bare for personlige påloggingsintegreringer. Den angir URI-en som en bruker blir sendt tilbake til når de avbryter påloggingen.	Angi basisnettadressen for Finance-miljøet.
Authorization levetid (sekunder)	Autorisasjonslevetid (sekunder)	Levetiden for den registrerte autorisasjonen. I en OpenID Connect-kontekst vil denne autorisasjonen få tilgang til sluttpunktet userinfo. Verdien må angis i sekunder.	Angi 31536000 (= ett år).
Tilgangstoken levetid (sekunder)	Tilgangstokenlevetid (sekunder)	Levetiden for utstedte access_token i sekunder.	Angi 7200 (= to timer).
Refresh token levetid (sekunder)	Oppdateringstokenlevetid (sekunder)	Levetiden for det utstedte refresh_token i sekunder.	Angi 0 (null).
Oppdater tokentype	Oppdater tokentype	Én gang – Du får en ny refresh_token hver gang du oppdaterer access_token. Kan brukes på nytt – En oppdatering av access_token endrer ikke refresh_token.	Angi Engangs.

Viktig

Pass på at du trygt lagrer klient-IDen og klienthemmeligheten for integreringspunktet som du oppretter for samhandling med ID-porten. Du trenger disse legitimasjonene i trinnet Definere klient-IDen og klienthemmelighet for integreringspunktet for ID-porten i Finance i forberedelsene til direkte innsending av mva-returer til Altinn i Finance.