Statusverdier for ordre og varsler

Referanse for ordrestatus og varslingsresultater i Altinn Notifications

Denne siden beskriver statusverdiene som brukes når Altinn Notifications rapporterer fremdrift for varslingsordrer og leveringsresultat for e‑post og SMS.

Disse verdiene vises i svarene fra status‑API‑ene (for eksempel /future/shipment/{id} og statusfeed). De hjelper deg å

overvåke utsendingene dine
finne årsaken når noe går galt
gi god brukerstøtte

Eksempel på respons fra status‑API‑et:

{
  "shipmentId": "c1d034c5-6af7-4813-aff7-920ab02e27b2",
  "sendersReference": "b6030a4e-93a3-489f-8478-85618d198745",
  "type": "Notification",
  "status": "Order_Processed",
  "lastUpdate": "2026-02-04T11:32:01.268148Z",
  "recipients": [
    {
      "type": "Email",
      "destination": "nullstilt@altinn.xyz",
      "status": "Email_Succeeded",
      "lastUpdate": "2026-02-04T11:33:09.64992Z"
    },
    {
      "type": "SMS",
      "destination": "+4798765432",
      "status": "SMS_Accepted",
      "lastUpdate": "2026-02-04T11:33:01.433868Z"
    }
  ]
}

Slik leser du statusfeltene

Ordrenivå: status på toppnivå viser fremdrift for hele ordren (Order_*‑verdier).
Mottakernivå: hvert element i recipients har et status‑felt som viser resultatet for én kanal til én mottaker (Email_* eller SMS_*‑verdier).

Navnene i API‑responsen følger mønsteret:

Order_{OrderProcessingState}
Email_{EmailNotificationResultType}
SMS_{SmsNotificationResultType}

I tabellene under viser vi både enum‑verdien og strengverdien som faktisk opptrer i API‑et.

OrderProcessingState (ordrestatus)

Ordrestatus beskriver hvor langt en varslingsordre har kommet i behandlingen.

Enum-verdi	API-statusstreng	Beskrivelse	Type
`Registered`	`Order_Registered`	Ordren er opprettet og lagret, men behandlingen har ikke startet ennå.	Midlertidig
`Processing`	`Order_Processing`	Ordren behandles nå (mottakeroppslag, evaluering av sendebetingelser osv.).	Midlertidig
`Processed`	`Order_Processed`	Ordren er ferdig behandlet og er overlevert til e‑post- og SMS‑kanalene.	Midlertidig
`Completed`	`Order_Completed`	Ordren er ferdig behandlet, og alle varsler har fått endelig leveringsstatus.	Endelig
`SendConditionNotMet`	`Order_SendConditionNotMet`	Sendebetingelsen var ikke oppfylt, derfor ble ingen varsler sendt.	Endelig
`Cancelled`	`Order_Cancelled`	Ordren ble kansellert før utsending.	Endelig

Forskjellen mellom Completed og Processed

Processed betyr at systemet har behandlet ordren og opprettet alle varsler, men at sluttstatus for leveringen fortsatt er under oppfølging.
Completed betyr at både ordren og alle tilhørende varsler har fått endelig leveringsstatus (for eksempel levert eller feilet i e‑post- og SMS‑kanalene).

EmailNotificationResultType (e-postresultat)

Status for ett enkelt e‑postvarsel til én mottaker.

Enum-verdi	API-statusstreng	Beskrivelse	Type
`New`	`Email_New`	E‑posten er opprettet, men ikke sendt videre ennå.	Midlertidig
`Sending`	`Email_Sending`	E‑posten er i ferd med å bli sendt.	Midlertidig
`Succeeded`	`Email_Succeeded`	E‑posten er akseptert av e‑postleverandøren og ingen leveringsbekreftelse er mottatt.	Midlertidig
`Delivered`	`Email_Delivered`	Leverandøren har bekreftet at e‑posten er levert.	Endelig
`Failed`	`Email_Failed`	Feil uten mer spesifikk årsak.	Endelig
`Failed_RecipientNotIdentified`	`Email_Failed_RecipientNotIdentified`	Mottakeren kunne ikke identifiseres.	Endelig
`Failed_InvalidFormat`	`Email_Failed_InvalidFormat`	Ugyldig e‑postadresseformat.	Endelig
`Failed_RecipientReserved`	`Email_Failed_RecipientReserved`	Mottakeren er reservert eller blokkert.	Endelig
`Failed_SuppressedRecipient`	`Email_Failed_SuppressedRecipient`	Mottakeren er undertrykt hos leverandøren.	Endelig
`Failed_TransientError`	`Email_Failed_TransientError`	Midlertidig feil hos leverandøren. Dette varselet blir ikke forsøkt på nytt automatisk, men en ny varslingsordre kan lykkes.	Endelig
`Failed_Bounced`	`Email_Failed_Bounced`	E‑posten kom i retur (bounce).	Endelig
`Failed_FilteredSpam`	`Email_Failed_FilteredSpam`	Filtrert som spam av leverandøren.	Endelig
`Failed_Quarantined`	`Email_Failed_Quarantined`	Satt i karantene hos leverandøren.	Endelig
`Failed_TTL`	`Email_Failed_TTL`	E‑posten utløp før den kunne leveres.	Endelig

SmsNotificationResultType (SMS-resultat)

Status for én SMS til én mottaker.

Enum-verdi	API-statusstreng	Beskrivelse	Type
`New`	`SMS_New`	SMS-en er opprettet, men ikke sendt videre ennå.	Midlertidig
`Sending`	`SMS_Sending`	SMS-en er i ferd med å bli sendt.	Midlertidig
`Accepted`	`SMS_Accepted`	Akseptert av SMS‑gatewayen.	Midlertidig
`Delivered`	`SMS_Delivered`	Bekreftet levert til mottakerens mobiltelefon.	Endelig
`Failed`	`SMS_Failed`	Feil uten mer spesifikk årsak.	Endelig
`Failed_InvalidRecipient`	`SMS_Failed_InvalidRecipient`	Ugyldig telefonnummer eller mottaker.	Endelig
`Failed_RecipientReserved`	`SMS_Failed_RecipientReserved`	Mottakeren er blokkert eller reservert.	Endelig
`Failed_BarredReceiver`	`SMS_Failed_BarredReceiver`	Operatøren har sperret mottakerens abonnement.	Endelig
`Failed_Deleted`	`SMS_Failed_Deleted`	Meldingen ble slettet før levering.	Endelig
`Failed_Expired`	`SMS_Failed_Expired`	Meldingen utløp hos operatør eller gateway.	Endelig
`Failed_Undelivered`	`SMS_Failed_Undelivered`	Meldingen kunne ikke leveres.	Endelig
`Failed_RecipientNotIdentified`	`SMS_Failed_RecipientNotIdentified`	Mottakeren kunne ikke identifiseres.	Endelig
`Failed_Rejected`	`SMS_Failed_Rejected`	Avvist av leverandør eller operatør.	Endelig
`Failed_TTL`	`SMS_Failed_TTL`	Meldingen utløp før levering (time‑to‑live overskredet).	Endelig

Time-to-live (TTL) og utløp

For både e‑post og SMS kan meldinger utløpe før de leveres:

For SMS kan du eksplisitt angi en time‑to‑live (TTL) når du bestiller enkelte typer varsler (for eksempel umiddelbare varsler).
E‑post og SMS vil også ha en øvre grense hos leverandør/gateway for hvor lenge de forsøker levering.

Når TTL eller maks levetid er nådd:

resultatet vil typisk bli rapportert som Failed_TTL, Failed_Expired eller en annen terminal feilstatus
det er ikke hensiktsmessig å prøve samme varsel på nytt uten at du først vurderer om innholdet fortsatt er relevant for mottakeren