CodeSystem
Introducción
El servicio terminológico FHIR MINSAL convierte las fuentes terminológicas en recursos CodeSystem y provee la posibilidad de interactuar con estos en el formato FHIR.
Los Codesystem pueden ser recuperados usando su Namespace Global (url canónica).
Vínculos:
- Especificación FHIR CodeSystem
- Especificación FHIR de $lookup CodeSystem
- Especificación FHIR de $validate-code CodeSystem
Obtener un único CodeSystem
La solicitud de un CodeSystem sin versiones devuelve la versión liberada más reciente. Si no existe una versión liberada, entonces se devolverá una respuesta vacía.
URL de Solicitud
GET /fhir/CodeSystem?url=:url&version=:version
Parámetros de Solicitud
| Parámetro | Descripción |
|---|---|
| url | La URL canónica del codesystem |
Solicitud de ejemplo
GET /fhir/CodeSystem?url=http://snomed.info/sct
Respuesta de Ejemplo
{
"resourceType": "Bundle",
"id": "e9a91ae0-5adb-4611-9c58-07370ab28439",
"meta": {
"lastUpdated": "2023-07-04T02:38:19.125+00:00"
},
"type": "searchset",
"total": 7,
"link": [
{
"relation": "self",
"url": "{{baseUrl}}/CodeSystem?url=http%3A%2F%2Fsnomed.info%2Fsct"
}
],
"entry": [
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20220131",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20220131",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20220131",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-01-31",
"status": "active",
"date": "2022-01-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20220731",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20220731",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20220731",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-07-31",
"status": "active",
"date": "2022-07-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_449081005_20221031",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_449081005_20221031",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/449081005/version/20221031",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-10-31",
"status": "active",
"date": "2022-10-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20221031",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20221031",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20221031",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-10-31",
"status": "active",
"date": "2022-10-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20230331",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20230331",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20230331",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2023-03-31",
"status": "active",
"date": "2023-03-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_449081005_20230430",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_449081005_20230430",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/449081005/version/20230430",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2023-04-30",
"status": "active",
"date": "2023-04-30T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20230430",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20230430",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20230430",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2023-04-30",
"status": "active",
"date": "2023-04-30T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
}
]
}
Obtener versión de un CodeSystem
URL de Solicitud
GET /fhir/CodeSystem/?url=:url&version=:version
Parámetros de Solicitud
| Parámetro | Descripción |
|---|---|
| url | La URL canónica del codesystem |
| version | La versión del codesystem |
Solicitud de ejemplo
GET /fhir/CodeSystem?url=http://snomed.info/sct&version=http://snomed.info/sct/449081005/version/20230430
Respuesta de Ejemplo
{
"resourceType": "Bundle",
"id": "d5b1c5f1-a8eb-492e-a41d-b30b4996538c",
"meta": {
"lastUpdated": "2023-07-04T02:29:34.237+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{{baseUrl}}/CodeSystem?url=http%3A%2F%2Fsnomed.info%2Fsct&version=http%3A%2F%2Fsnomed.info%2Fsct%2F449081005%2Fversion%2F20230430"
}
],
"entry": [
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_449081005_20230430",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_449081005_20230430",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/449081005/version/20230430",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2023-04-30",
"status": "active",
"date": "2023-04-30T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
}
]
}
Obtener una lista de los CodeSystem
Esta solicitud devuelve las versiones más recientes de todos los Code System.
URL de Solicitud
GET /fhir/CodeSystem/
Parámetros de Solicitud
| Parámetro | Descripción |
|---|---|
| _count | Conteo de las respuestas |
Solicitud de ejemplo
GET /fhir/CodeSystem/
GET /fhir/CodeSystem?_count=10
Respuesta de Ejemplo
{
"resourceType": "Bundle",
"id": "6577a2f5-dcea-4fc0-9159-761c3929b4ed",
"meta": {
"lastUpdated": "2023-07-04T02:42:30.095+00:00"
},
"type": "searchset",
"total": 7,
"link": [
{
"relation": "self",
"url": "{{baseUrl}}/CodeSystem?_count=10"
}
],
"entry": [
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20220131",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20220131",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20220131",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-01-31",
"status": "active",
"date": "2022-01-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20220731",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20220731",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20220731",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-07-31",
"status": "active",
"date": "2022-07-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20221031",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20221031",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20221031",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-10-31",
"status": "active",
"date": "2022-10-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_449081005_20221031",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_449081005_20221031",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/449081005/version/20221031",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2022-10-31",
"status": "active",
"date": "2022-10-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20230331",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20230331",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20230331",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2023-03-31",
"status": "active",
"date": "2023-03-31T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_900000000000207008_20230430",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_900000000000207008_20230430",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/900000000000207008/version/20230430",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2023-04-30",
"status": "active",
"date": "2023-04-30T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
},
{
"fullUrl": "{{baseUrl}}/CodeSystem/sct_449081005_20230430",
"resource": {
"resourceType": "CodeSystem",
"id": "sct_449081005_20230430",
"url": "http://snomed.info/sct",
"version": "http://snomed.info/sct/449081005/version/20230430",
"name": "SNOMED_CT",
"title": "SNOMED CT release 2023-04-30",
"status": "active",
"date": "2023-04-30T00:00:00+00:00",
"publisher": "SNOMED International",
"hierarchyMeaning": "is-a",
"compositional": true,
"content": "complete"
}
}
]
}
Operaciones FHIR
Según el perfil mSVCM, las siguientes operaciones FHIR deben ser soportadas para un CodeSystem:
- $lookup
- $validate-code
$lookup
URL de Solicitud
GET /fhir/CodeSystem/$lookup/?system=:system&code=:code
POST /fhir/CodeSystem/$lookup
Parámetros de Solicitud (GET)
| Parameter | Description |
|---|---|
| system | (M) La URL canónica del codesystem |
| code | (M) El código del concepto |
| version | (O) La version del codesystem |
| displayLanguage | (O) El idioma solicitado para mostrar |
Request body (POST)
{
"resourceType": "Parameters",
"parameter": [
{
"name": "coding",
"valueCoding": {
"system": "http://snomed.info/sct",
"version": "http://snomed.info/sct/449081005/version/20230430",
"displayLanguage": "es",
"code": "425615007"
}
},
{
"name": "property",
"valueString": "inactive"
}
]
}
Solicitud de ejemplo
GET /fhir/CodeSystem/$lookup?system=http://snomed.info/sct&code=74400008&displayLanguage=es
GET /fhir/CodeSystem/$lookup?system=http://snomed.info/sct&code=74400008&version=http://snomed.info/sct/449081005/version/20230430&displayLanguage=es
Respuesta de Ejemplo
{
"resourceType": "Parameters",
"parameter": [
{
"name": "code",
"valueString": "74400008"
},
{
"name": "display",
"valueString": "apendicitis"
},
{
"name": "name",
"valueString": "SNOMED CT release 2023-04-30"
},
{
"name": "system",
"valueString": "http://snomed.info/sct"
},
{
"name": "version",
"valueString": "http://snomed.info/sct/449081005/version/20230430"
},
{
"name": "active",
"valueBoolean": true
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "effectiveTime"
},
{
"name": "valueString",
"valueString": "20020131"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "moduleId"
},
{
"name": "value",
"valueCode": "900000000000207008"
}
]
},
{
"extension": [
{
"url": "http://snomed.info/fhir/StructureDefinition/designation-use-context",
"extension": [
{
"url": "context",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "450828004"
}
},
{
"url": "role",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000548007",
"display": "PREFERRED"
}
},
{
"url": "type",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000013009",
"display": "Synonym"
}
}
]
}
],
"name": "designation",
"part": [
{
"name": "language",
"valueCode": "es"
},
{
"name": "use",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000013009",
"display": "Synonym"
}
},
{
"name": "value",
"valueString": "apendicitis"
}
]
},
{
"extension": [
{
"url": "http://snomed.info/fhir/StructureDefinition/designation-use-context",
"extension": [
{
"url": "context",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "450828004"
}
},
{
"url": "role",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000549004",
"display": "ACCEPTABLE"
}
},
{
"url": "type",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000013009",
"display": "Synonym"
}
}
]
}
],
"name": "designation",
"part": [
{
"name": "language",
"valueCode": "es"
},
{
"name": "use",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000013009",
"display": "Synonym"
}
},
{
"name": "value",
"valueString": "inflamación aguda del apéndice"
}
]
},
{
"extension": [
{
"url": "http://snomed.info/fhir/StructureDefinition/designation-use-context",
"extension": [
{
"url": "context",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000509007"
}
},
{
"url": "role",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000548007",
"display": "PREFERRED"
}
},
{
"url": "type",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000013009",
"display": "Synonym"
}
}
]
},
{
"url": "http://snomed.info/fhir/StructureDefinition/designation-use-context",
"extension": [
{
"url": "context",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000508004"
}
},
{
"url": "role",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000548007",
"display": "PREFERRED"
}
},
{
"url": "type",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000013009",
"display": "Synonym"
}
}
]
}
],
"name": "designation",
"part": [
{
"name": "language",
"valueCode": "en"
},
{
"name": "use",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000013009",
"display": "Synonym"
}
},
{
"name": "value",
"valueString": "Appendicitis"
}
]
},
{
"extension": [
{
"url": "http://snomed.info/fhir/StructureDefinition/designation-use-context",
"extension": [
{
"url": "context",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000509007"
}
},
{
"url": "role",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000548007",
"display": "PREFERRED"
}
},
{
"url": "type",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000003001",
"display": "Fully specified name"
}
}
]
},
{
"url": "http://snomed.info/fhir/StructureDefinition/designation-use-context",
"extension": [
{
"url": "context",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000508004"
}
},
{
"url": "role",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000548007",
"display": "PREFERRED"
}
},
{
"url": "type",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000003001",
"display": "Fully specified name"
}
}
]
}
],
"name": "designation",
"part": [
{
"name": "language",
"valueCode": "en"
},
{
"name": "use",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000003001",
"display": "Fully specified name"
}
},
{
"name": "value",
"valueString": "Appendicitis (disorder)"
}
]
},
{
"extension": [
{
"url": "http://snomed.info/fhir/StructureDefinition/designation-use-context",
"extension": [
{
"url": "context",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "450828004"
}
},
{
"url": "role",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000548007",
"display": "PREFERRED"
}
},
{
"url": "type",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000003001",
"display": "Fully specified name"
}
}
]
}
],
"name": "designation",
"part": [
{
"name": "language",
"valueCode": "es"
},
{
"name": "use",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "900000000000003001",
"display": "Fully specified name"
}
},
{
"name": "value",
"valueString": "apendicitis (trastorno)"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "parent"
},
{
"name": "value",
"valueCode": "302168000"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "parent"
},
{
"name": "value",
"valueCode": "18526009"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "67365005"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "85189001"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "9124008"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "418171008"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "25598004"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "26826005"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "42640003"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "91313006"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "58997001"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "32084004"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "8744003"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "123601005"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "1145117000"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "733157003"
}
]
},
{
"name": "property",
"part": [
{
"name": "code",
"valueString": "child"
},
{
"name": "value",
"valueCode": "5596004"
}
]
}
]
}
$validate-code
URL de Solicitud
GET /fhir/CodeSystem/$validate-code/?url=:url&code=:code
Parámetros de Solicitud (GET)
| Parámetros | Descripción |
|---|---|
| url | (M) La URL canónica del codesystem |
| code | (M) El código del concepto |
| version | (O) La version del codesystem |
| display | (O) El texto asociado al código |
NOTA:
- displayLanguage actualmente no es soportado para la operación $validate-code
Solicitud de ejemplo
GET /fhir/CodeSystem/$validate-code?url=http://snomed.info/sct&version=http://snomed.info/sct/449081005/version/20230430&code=181216001
Respuesta de Ejemplo
{
"resourceType": "Parameters",
"parameter": [
{
"name": "result",
"valueBoolean": true
},
{
"name": "display",
"valueString": "Entire lung"
},
{
"name": "system",
"valueString": "http://snomed.info/sct"
},
{
"name": "version",
"valueString": "http://snomed.info/sct/449081005/version/20230430"
}
]
}