Meldingsstatus API
Denne siden beskriver meldingsstatus API og bruksmønstre for dette.
eFormidling benytter meldingsstatuser for å understøtte feilsøking, varsling av feil og statistikk. Dette har tidligere blitt levert sammen med logg, men for å sikre pålitelig overlevering av meldingsstatuser etableres det nå et API for å ta imot disse.
Integrasjonspunktet bruker meldingsstatustjenesten under panseret. Det er vanligvis ikke nødvendig å integrere direkte mot meldingsstatustjenesten, men i noen sjeldne tilfeller ønsker en virksomhet å kommunisere med virksomheter på eFormidling uten selv å kjøre et integrasjonspunkt.
Eksempel på statusmelding:
{
"conversation_id": "3233d263-30d0-4cd4-9e38-ff62a978d58e",
"receiver_org_number": "991825827",
"@timestamp": "2022-08-10T00:11:27.246Z",
"service_identifier": "DPE",
"sender": "0192:971203420",
"status": "LEVERT",
"orgnr": "971203420",
"receiver": "0192:991825827",
"message_id": "65f237bc-7d64-45cb-8f4d-3d81345b4668",
"process_identifier": "urn:no:difi:profile:einnsyn:journalpost:ver1.0",
"sender_org_number": "971203420",
"document_identifier": "urn:no:difi:einnsyn:xsd::publisering"
}
Statusmeldinger leveres over HTTP eller RSocket med OAuth JWT fra Maskinporten.
- HTTP:
POST https://qa-meldingsutveksling.difi.no/logging/api/status
- RSocket:
qa-meldingsutveksling.difi.no:7070
Meldingsstatus API bruker OAuth2 for autorisasjon og forventer selvforsynte JWT fra Maskinporten. JWT-forespørsler til Maskinporten er forventet å inneholde x5c for det norske virksomhetssertifikatet (SEIDv1 or SEIDv2) JWT-forespørselen ble signert med.
- Maskinporten (ekstern lenke)
eFormidling oppretter OAuth-klienter i Maskinporten som del av onboarding-prosessen:
- Klient-IDen er
MOVE_IP_<orgnummer>
- En eller flere av følgende scope blir tildelt klienten:
- move/dpo.read (eFormidlings meldingstjeneste)
- move/dpe.read</code> (eInnsyns meldingstjeneste)
- move/dpi.read</code> (Digital Post til Innbyggere)
- move/dpf.read</code> (KS SvarUt og SvarInn)
- move/dpv.read</code> (Altinn Digital Post)