Journalføringstjenesten - Write API

Dette API-et er inngangsporten for innsending av journaldata. Tjenesten tar imot strukturerte FHIR-ressurser og sørger for sikker lagring og prosessering.

Innsending av data

Tjenesten støtter mottak av følgende FHIR-ressurser:

• Composition: For journalnotater og dokumenter.
• MedicationDispense: For vellykket utlevering av legemidler.
• Bundle: For samling av flere ressurser i én transaksjon (se eksempel).

Endepunkter

• POST /v1/Composition
• POST /v1/MedicationDispense
• POST /v1/Bundle

Validering og Regler

For å sikre datakvalitet og hindre sammenblanding av test- og produksjonsdata, utføres følgende kontroller ved hver innsending:

1. Teknisk formatkontroll

API-et utfører en deserialisering av mottatt JSON for å sikre at innholdet følger FHIR-standarden. Forespørsler med ugyldig JSON-struktur eller manglende obligatoriske FHIR-elementer vil bli avvist med 400 Bad Request.

2. Håndtering av fødselsnummer (FNR)

Det er streng kontroll på hvilke typer fødselsnummer som tillates i de ulike miljøene for å sikre dataseparasjon:

• Produksjonsmiljø:
  • Kun reelle fødselsnummer er tillatt.
  • Syntetiske fødselsnummer avvises.
• Testmiljø:
  • Kun syntetiske fødselsnummer skal benyttes.
  • Reelle fødselsnummer avvises for å hindre utilsiktet bruk av ekte personopplysninger.

Vi anbefaler å bruke SyntPop for å generere gyldige syntetiske testdata for bruk i våre testmiljøer. Mer informasjon finnes på NHN Utviklerportal - SyntPop.

Slik sender du inn

Innsending skjer ved å poste en FHIR-ressurs som JSON.

Eksempel på innsending av Bundle (Transaction):

Se eksempel på Bundle-ressurs for detaljer om format og struktur.