Sist endret: 29. okt. 2026
Preview: Dette er dokumentasjonen for Altinn Studio v9, som er en forhåndsversjon. Gjeldende versjon er v8. For å se dokumentasjonen for gjeldende versjon, velg v8 i versjonsvelgeren i menyen til venstre.

Slik sender du kvittering ifm signering

Følg stegene i denne guiden for å sette opp meldingstjenesten til å sende signeringskvittering

Før du starter

Sett opp en app med signering

Denne guiden tar utgangspunkt i en eksisterende app med signeringsoppgave.

Maskinporten-klient

Du trenger en maskinporten-klient med tilgang til følgende scopes:

  • altinn:serviceowner
  • altinn:correspondence.write

Er du usikker kan du følge veiledningen for oppsett av meldingstjeneste under, der beskrives også oppsett av maskinporten-klient med nødvendige scopes.

1. Sett opp en meldingstjeneste

Hvis du allerede har en meldingstjeneste tilgjengelig, kan du bruke den, og kan hoppe over dette steget.

Du trenger en meldingstjeneste i Altinn Melding for å kunne sende signeringskvittering.

Følg steg 4-6 i hurtigstartsguiden for Altinn Melding for å sette opp en meldingstjeneste som kan brukes til å sende kvittering ifm signering. Stegene 1-3 er kun nødvendig om du ikke allerede har gjort dette i andre sammenhenger. Du trenger ikke å utføre stegene som omhandler å integrere mot meldingstjenesten, dette gjør appen automatisk i forbindelse med signeringssteget.

2. Registrer maskinporten-klienten i appen

Hvis du allerede bruker maskinporten i appen trenger du ikke å utføre dette steget. Påse likevel at maskinporten-klienten har fått tilgang til nødvendige scopes før du går videre.

Følg denne guiden for å ta i bruk maskinporten-klienten din i appen.

3. Legg til en meldingsressurs

    1. Naviger til appen din, og gå til Prosess i toppmenyen.
    2. Klikk på signeringsoppgaven i prosess-visningen og se at du får opp konfigurasjonsmuligheter i panelet på høyre side.
    3. Klikk på “Oppgi en ressurs for å sende ut meldinger”
    4. Legg inn navnet på meldingstjenesten i feltet
    5. Klikk på “Del dine endringer” og knappen “Del endringer”.
    6. Publiser tjenesten til testmiljø og verifiser at kvitteringen sendes.
    1. Legg inn altinn:correspondenceResource under altinn:signatureConfig på signeringsoppgaven (i filen App/config/process/process.bpmn) Se eksempel under:

      App/config/process/process.bpmn
      <bpmn:task id="SigningTask" name="Signering">
      <bpmn:extensionElements>
          <altinn:taskExtension>
          <altinn:taskType>signing</altinn:taskType>
          <altinn:actions>
          <altinn:action>sign</altinn:action>
          <altinn:action>reject</altinn:action>
          </altinn:actions>
          <altinn:signatureConfig>
              <!-- De faktiske dataene som skal signeres. Kan være vedlegg, skjemadata i xml, eller PDF fra tidligere steg. -->
              <altinn:dataTypesToSign>
              <altinn:dataType>ref-data-as-pdf</altinn:dataType>
              </altinn:dataTypesToSign>
      
              <!-- Signature-datatypen brukes for å lagre signaturene. -->
              <altinn:signatureDataType>signatures</altinn:signatureDataType>
      
              <!-- ... ev. annen konfigurasjon knyttet til signering her -->
      
              <!-- Her oppgis en meldingsressurs, som brukes for å si fra til de som skal signere -->
              <!-- om at de må inn og signere, samt signeringskvittering. Påkrevd. -->
              <altinn:correspondenceResource>app-correspondence-resource</altinn:correspondenceResource>
      
          </altinn:signatureConfig>
          </altinn:taskExtension>
      </bpmn:extensionElements>
      <bpmn:incoming>SequenceFlow_1oot28q</bpmn:incoming>
      <bpmn:outgoing>SequenceFlow_1if1sh9</bpmn:outgoing>
      </bpmn:task>
      
    2. Konfigurer miljøspesifikke meldingsressurser (valgfritt)

    Hvis du ønsker å bruke forskjellige meldingsressurser i forskjellige miljøer, kan du legge til en env-attributt på oppsettet. Se eksempel under:

    App/config/process/process.bpmn
    <altinn:signatureConfig>
        ...
      <altinn:correspondenceResource env="Development">app-correspondence-resource-1</altinn:correspondenceResource>
      <altinn:correspondenceResource env="Staging">app-correspondence-resource-2</altinn:correspondenceResource>
      <altinn:correspondenceResource env="Production">app-correspondence-resource</altinn:correspondenceResource>
        ...
    </altinn:signatureConfig>
    

    Env-attributten godtar en rekke verdier, men kategoriserer disse til slutt i tre kategorier som vist i tabellen under. Det skilles ikke mellom store og små bokstaver i verdiene.

    MiljøAliaser
    Lokal testdevelopment, dev, local, localtest
    Teststaging, test, at22, at23, at24, tt02, yt01
    Produksjonproduction, prod, produksjon