Att ta fram NMI-ID via API

Här kan du ta del av hur du som använder våra NMI-klassade produkter som finns beskrivna i Handboken går tillväga för att ta fram NMI-ID via API. 

1. Inledning

Den Nationella Läkemedelslistan tillhandahåller ett flertal API:er för integration med vård- och apotekssystem. I versionspaket 21 är API:et baserat på FHIR (http://hl7.org/fhir/R4/) och det är detta API som används för att ta fram NMI-ID:t. 

FHIR bygger på HTTP-baserad kommunikation. Alla HTTP-anrop och HTTP-svar innehåller ett sidhuvud med metadata, sk. headers. Alla anrop initieras från det system som ansluter till den Nationella Läkemedelslistan och i HTTP-svaret medföljer NMI-märkningen för det API som har anropats.


2. HTTP-svar

Exempel på HTTP-svar där anrop har skett till ett NMI-klassificerat system.

HTTP-svar

NMI-ID: EHM-AT21-v6,EHM-VT21-v6
Content-Type: application/fhir+xml;charset=utf-8
X-Request-ID: eaea5c49-545a-4958-89c2-bf0baae0b15e

Fältet NMI-ID innehåller ett eller flera NMI-id:n om det är ett NMI-klassificerat system.

3. CapabilityStatement

För API:er baserade på FHIR är det även möjligt att utläsa NMI-märkningen genom att hämta det som i FHIR kallas ett CapabilityStatement. Se http://hl7.org/fhir/R4/http.html för mer information om kommunikation i FHIR.

Exempel på svar från en FHIR-server.

CapabilityStatement

{
    "resourceType": "CapabilityStatement",
    "id": "d545e2ff-593f-400d-9cb0-4bb00ee9e3d9",
    "name": "RestServer",
    "status": "active",
    "date": "2023-02-23T13:53:00.203+01:00",
    "publisher": "E-hälsomyndigheten",
    "description": "Nationella Läkemedelslistan NMI-ID: EHM-AT21-v6 och EHM-VT21-v6.",
    "kind": "instance",
    "software": {
        "name": "HAPI FHIR Server",
        "version": "5.6.2"
    },
    ...
}

Fältet description innehåller texten "NMI-ID:" följt av ett eller flera NMI-id:n om det är ett NMI-klassificerat system.

4. NMI-produkter

Mer information om de NMI-produkter som beskrivs i Handbok för vård- och apotekstjänster finns här. 



Versionshistorik

Version Datum Release Kommentar
1.0 2023-05-04 21.5 Ny sida