Valueset

Introducción

El servicio FHIR MINSAL convierte conjuntos de valores en recursos ValueSet de FHIR y provee la posibilidad de interactuar con ellos en formato FHIR.

Los ValueSet pueden ser recuperados usando sus url canónicas.

Links:

• Especificación FHIR ValueSet
• Especificación FHIR ValueSet $validate-code
• Especificación FHIR ValueSet $expand

Obtener un único ValueSet

La solicitud sin versión de un ValueSet devuelve la versión más reciente liberada.

URL de Solicitud

GET /fhir/ValueSet/?url=:url

Parámetros de la Solicitud

Parámetro	Descripción
url	URL canónica del Valueset

Solicitud de ejemplo

GET /fhir/ValueSet/?url=http://minsal.com/fhir/vs/sexo_biologico

Respuesta de ejemplo

{
    "resourceType": "Bundle",
    "id": "d9ad7aa5-42b8-496a-937a-17bfa19d7df7",
    "meta": {
        "lastUpdated": "2023-07-04T14:19:23.688+00:00"
    },
    "type": "searchset",
    "total": 1,
    "link": [
        {
            "relation": "self",
            "url": "{{baseUrl}}/ValueSet/?url=http%3A%2F%2Fminsal.com%2Ffhir%2Fvs%2Fsexo_biologico"
        }
    ],
    "entry": [
        {
            "fullUrl": "{{baseUrl}}/ValueSet/7b6217e8-42e8-461a-ae29-53b2b0352805",
            "resource": {
                "resourceType": "ValueSet",
                "id": "7b6217e8-42e8-461a-ae29-53b2b0352805",
                "url": "http://minsal.com/fhir/vs/sexo_biologico",
                "version": "0.1",
                "name": "Sexo biologico",
                "status": "draft",
                "experimental": true,
                "description": "Lista de los posibles sexos para captura de detalle de pacicentes.",
                "copyright": "This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (SNOMED International), and distributed by agreement between SNOMED International and HL7. Implementer use of SNOMED CT is not covered by this agreement."
            }
        }
    ]
}

Obtener versión de un ValueSet

URL de Solicitud

GET /fhir/ValueSet/?url=:url&version=:version

Parámetros de Solicitud

Parámetro	Descripción
url	URL canónica del ValueSet
version	La versión del ValueSet

Solicitud de ejemplo

GET /fhir/ValueSet/?url=http://minsal.com/fhir/vs/sexo_biologico&version=0.1

Respuesta de ejemplo

{
    "resourceType": "Bundle",
    "id": "87cb3db8-bea0-4ba0-b2d1-fb9e4e9c9ccd",
    "meta": {
        "lastUpdated": "2023-07-04T14:22:56.674+00:00"
    },
    "type": "searchset",
    "total": 1,
    "link": [
        {
            "relation": "self",
            "url": "{{baseUrl}}/ValueSet/?url=http%3A%2F%2Fminsal.com%2Ffhir%2Fvs%2Fsexo_biologico&version=0.1"
        }
    ],
    "entry": [
        {
            "fullUrl": "{{baseUrl}}/ValueSet/7b6217e8-42e8-461a-ae29-53b2b0352805",
            "resource": {
                "resourceType": "ValueSet",
                "id": "7b6217e8-42e8-461a-ae29-53b2b0352805",
                "url": "http://minsal.com/fhir/vs/sexo_biologico",
                "version": "0.1",
                "name": "Sexo biologico",
                "status": "draft",
                "experimental": true,
                "description": "Lista de los posibles sexos para captura de detalle de pacicentes.",
                "copyright": "This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (SNOMED International), and distributed by agreement between SNOMED International and HL7. Implementer use of SNOMED CT is not covered by this agreement."
            }
        }
    ]
}

Obtener una lista de ValueSets

Esta solicitud devuelve las versiones más recientes de todos los ValueSets.

URL de Solicitud

GET /fhir/ValueSet/

Parámetros de Solicitud

Parámetro	Descripción
_count	Conteo de respuestas

Solicitud de ejemplo

GET /fhir/ValueSet/

Respuesta de ejemplo

{
    "resourceType": "Bundle",
    "id": "c25c2819-0607-4f8f-917c-20239e0ce6c5",
    "meta": {
        "lastUpdated": "2023-07-04T15:15:26.493+00:00"
    },
    "type": "searchset",
    "total": 3,
    "link": [
        {
            "relation": "self",
            "url": "{{baseUrl}}/ValueSet/"
        }
    ],
    "entry": [
        {
            "fullUrl": "{{baseUrl}}/ValueSet/122f0f73-812f-455d-91ca-8f842251ed0a",
            "resource": {
                "resourceType": "ValueSet",
                "id": "122f0f73-812f-455d-91ca-8f842251ed0a",
                "url": "http://example.com/fhir/vs/sex_es",
                "version": "0.1",
                "name": "Sexo",
                "status": "draft",
                "experimental": true,
                "description": "Lista de los posibles sexos para captura de detalle de pacicentes.",
                "copyright": "This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (SNOMED International), and distributed by agreement between SNOMED International and HL7. Implementer use of SNOMED CT is not covered by this agreement."
            }
        },
        {
            "fullUrl": "{{baseUrl}}/ValueSet/7b6217e8-42e8-461a-ae29-53b2b0352805",
            "resource": {
                "resourceType": "ValueSet",
                "id": "7b6217e8-42e8-461a-ae29-53b2b0352805",
                "url": "http://minsal.com/fhir/vs/sexo_biologico",
                "version": "0.1",
                "name": "Sexo biologico",
                "status": "draft",
                "experimental": true,
                "description": "Lista de los posibles sexos para captura de detalle de pacicentes.",
                "copyright": "This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (SNOMED International), and distributed by agreement between SNOMED International and HL7. Implementer use of SNOMED CT is not covered by this agreement."
            }
        },
        {
            "fullUrl": "{{baseUrl}}/ValueSet/bc4b4694-2021-4179-997b-c31556679a18",
            "resource": {
                "resourceType": "ValueSet",
                "id": "bc4b4694-2021-4179-997b-c31556679a18",
                "url": "http://minsal.com/fhir/vs/servicios_de_referencia",
                "version": "0.1",
                "name": "Servicios de Referencia",
                "status": "draft",
                "experimental": true,
                "description": "Lista de los posibles Servicios de Destino de una Interconsulta.",
                "copyright": "This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (SNOMED International), and distributed by agreement between SNOMED International and HL7. Implementer use of SNOMED CT is not covered by this agreement."
            }
        }
    ]
}

$expand

La definición de un conjunto de valores se utiliza para crear una colección simple de códigos adecuados para su uso en la entrada o validación de datos.

Si la operación no se llama a nivel de instancia, debe proporcionarse en uno de los parámetros url, context o oalueSet. Se devolverá un conjunto de valores expandido, o un OperationOutcome con un mensaje de error.

La expansión del conjunto de valores devuelta por esta consulta debe tratarse como un resultado transitorio que cambiará con el tiempo (que lo haga o no depende de cómo se especifique el conjunto de valores), por lo que las aplicaciones deben repetir la operación cada vez que se utilice el conjunto de valores.

URL de solicitud

GET /fhir/ValueSet/$expand/?url=:url

POST /fhir/ValueSet/$expand

Parámetros de Solicitud (GET)

Parámetro	Descripción
url	(M) URL canonica del ValueSet
displayLanguage	(O) El idioma que será usado para los ValueSet.expansion.contains.display
valueSetVersion	(O) La versión del valueset
offset	(O) Punto de inicio para el subconjunto deseado (defecto 0)
count	(O) Número deseado de códigos a ser devueltos (defecto 100)
filter	(O) La cadena de caracteres que actúa de filtro puede ser usado para controlar los códigos incluidos en la expansión del ValueSet. Para usar múltiples filtros, cada cadena debe ser separada por espacios y el servicio lo reconocerá como filtros combinados de intersección.

Solicitud de ejemplo

GET /fhir/ValueSet/$expand?url=http://snomed.info/sct/449081005/version/20230430?fhir_vs=ecl/<<74400008&count=10&displayLanguage=es

GET /fhir/ValueSet/$expand?url=http://snomed.info/sct/449081005/version/20230430?fhir_vs=ecl/<<74400008&filter=perforada&count=10&displayLanguage=es

Respuesta de ejemplo

{
    "resourceType": "ValueSet",
    "id": "abbc2197-9e84-42ec-95a9-55015390f1ae",
    "url": "http://snomed.info/sct/449081005/version/20230430?fhir_vs=ecl/<<74400008",
    "status": "active",
    "copyright": "This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (SNOMED International), and distributed by agreement between SNOMED International and HL7. Implementer use of SNOMED CT is not covered by this agreement.",
    "expansion": {
        "id": "2a6a472e-dfd8-44d7-8b33-6381ff9e859a",
        "timestamp": "2023-07-04T16:22:24+00:00",
        "total": 3,
        "offset": 0,
        "parameter": [
            {
                "name": "version",
                "valueUri": "http://snomed.info/sct|http://snomed.info/sct/449081005/version/20230430"
            },
            {
                "name": "displayLanguage",
                "valueString": "es"
            }
        ],
        "contains": [
            {
                "system": "http://snomed.info/sct",
                "code": "286967008",
                "display": "apendicitis aguda perforada"
            },
            {
                "system": "http://snomed.info/sct",
                "code": "1255222000",
                "display": "apendicitis crónica perforada"
            },
            {
                "system": "http://snomed.info/sct",
                "code": "95547004",
                "display": "apendicitis supurativa perforada"
            }
        ]
    }
}