0.5.0 - ci-build
FHIR_CORE_AR - Local Development build (v0.5.0). See the Directory of published versions
<?xml version=”1.0” encoding=”UTF-8” standalone=”no”?>
El cliente hace una petición al bus para obtener el listado de dominios que cuentan con información de salud sobre el paciente.
Esta es una operación especial que implementa el Bus de Interoperabilidad para el recurso Patient: $Patient_Location_Query
Los parámetros son el dominio local y el identificador del paciente para el dominio local.
Devuelve una lista con todos los dominios (identificación y descripción) en los cuales el paciente puede tener documentos publicados porque fue identificado y el consentimiento que está registrado en el Bus de Interoperabilidad lo habilita.
Esta operación está basada en el perfil XCPD de IHE, sólo que el perfil original está basado en HL7 V3 y devuelve también los identificadores del paciente para cada dominio, que para nosotros está fuera de scope porque los dominios no se comunican entre sí.
(http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_XCPD_HDL_Revoke_Option.pdf))
| GET [base]?query=patient-location-query&identifier=@dominio_local | @identificador_paciente_local` |
Para obtener la lista de dominios que tienen información disponible sobre un paciente;
GET https://bus.msal.gov.ar/Patient?query=patient-location-query&identifier=http:/dummy.org.ar|2029129
Salida: Un recurso FHIR Bundle de tipo ‘searchset’ con una entry de tipo **Organization **por cada dominio que haya identificado al paciente
{
"resourceType": "Bundle",
"id": "26419249-18b3-45de-b10e-dca0b2e72b",
"meta": {
"lastUpdated": "2019-03-18T03:28:49Z"
},
"type": "searchset",
"total": 2,
"entry": [{
"fullUrl": "http://server/path/Endpoint/10291",
"resource": {
"resourceType": "Organization",
"id": "10291",
"identifier": [{
"system": "https://bus.msal.gov.ar/dominios",
"value": "20001"
}],
"name": "PROVINCIA DE NEUQUEN"
}
}, {
"fullUrl": "http://server/path/Endpoint/102421",
"resource": {
"resourceType": "Organization",
"id": "102421",
"identifier": [{
"system": "https://bus.msal.gov.ar/dominios",
"value": "20111"
}],
"name": "HOSPITAL ITALIANO DE BUENOS AIRES"
}
}]
}
Esta información le permitirá al cliente determinar el estado del botón **‘Mi Historia’ **(por el momento lo llamamos Mi Historia a la espera del nombre definitivo y del diseño del botón)
Si hay algún dominio que no sea el propio que tiene información, lo puede habilitar.
Si hay más de un dominio, puede habilitar una lista para el usuario para que el usuario disponga si quiere buscar + información en todos los dominios o en alguno en especial.
El cliente puede de esta manera (si hay uno o más dominios habilitados) mostrar al usuario el botón para obtener los documentos disponibles de todos los dominios o una búsqueda avanzada incluyendo dominio, tipo de documento y rango de fechas. El tipo de documento cuyo consentimiento se define por omisión es RESUMEN DE HISTORIA CLÍNICA (IPS)
Los parámetros para la solicitud más simple son idPaciente (de esa institucion), idDominio y tipoDocumento.
Para obtener la lista de resúmenes de historia de paciente de todos los dominios donde esté disponible:
https://bus.msal.gov.ar/ /v1/DocumentReference?subject:Patient.identifier=@dominio_local|@identificador_local&class=https://loinc.org/|60591-5
Si se desea solo el resumen de un dominio específico, se debe incluir también el identificador del dominio del cual se desea el resumen en el parámetro Custodian
https://bus.msal.gov.ar/ /v1/DocumentReference?subject:Patient.identifier=@dominio_local|@identificador_local&class=https://loinc.org/|60591-5&custodian=https://bus.msal.gov.ar/dominios|@identificador_dominio
La respuesta exitosa será un Bundle con el detalle de los documentos disponibles para el paciente. El perfil de cada DocumentReference del Bundle está descripto aquí
En este ejemplo se trata de 2 documentos tipo 60591-5 (Resumen de Historia Clínica IPS), generados respectivamente por la Historia Clínica de Neuquen y el Hospital Italiano de Buenos Aires
{
"resourceType": "Bundle",
"id": "cba1be29-b82c-4624-95e7-756b884332b8",
"meta": {
"lastUpdated": "2019-04-10T18:12:18.313+00:00"
},
"type": "searchset",
"total": 2,
"link": [{
"relation": "self",
"url": "https://saludddigital.gob.ar/baseR4/DocumentReference"
}],
"entry": [{
"fullUrl": "https://hceneuquen.gob.ar/DocumentReference/10311",
"resource": {
"resourceType": "DocumentReference",
"id": "10311",
"meta": {
"versionId": "1",
"lastUpdated": "2019-04-10T18:45:07.421+00:00"
},
"contained": [{
"resourceType": "Practitioner",
"id": "AutorContenido",
"identifier": [{
"system": "https://saludddigital.gob.ar/profesionales",
"value": "32818"
}]
},
{
"resourceType": "Organization",
"id": "OrganizacionResponsable",
"identifier": [{
"system": "https://saludddigital.gob.ar/Organization",
"value": "BOUROL"
}]
}
],
"masterIdentifier": {
"system": "https://hceneuquen.gob.ar/documentos_versiones",
"value": "291828-2v1"
},
"identifier": [{
"system": "https://hceneuquen.gob.ar/documentos",
"value": "291828-2"
}],
"status": "current",
"type": {
"coding": [{
"system": "http://loinc.org",
"code": "60591-5"
}]
},
"subject": {
"reference": "https://saludddigital.gob.ar/fhir/Patient/20192812"
},
"author": [{
"reference": "#AutorContenido"
},
{
"reference": "#OrganizacionResponsable"
}
],
"securityLabel": [{
"coding": [{
"system": "https://saludddigital.gob.ar/nivelesconfidencialidad",
"code": "N"
}]
}],
"content": [{
"attachment": {
"id": "PRINCIPAL",
"url": "https://saludddigital.gob.ar/fhir/Binary/7a391905-6109-4ae3-96b6-758e5b96d381"
}
}],
"context": {
"event": [{
"coding": [{
"system": "https://saludddigital.gob.ar/tiposevento",
"code": "CIR"
}]
}],
"period": {
"start": "2019-04-03T10:30:00+03:00",
"end": "2019-04-05T10:30:00+03:00"
},
"facilityType": {
"coding": [{
"system": "https://saludddigital.gob.ar/tipoprestador",
"code": "INI"
}]
},
"practiceSetting": {
"coding": [{
"system": "https://saludddigital.gob.ar/especialidades",
"code": "CLM"
}]
}
}
}
},
{
"fullUrl": "https://hiba.com.ar/DocumentReference/141311",
"resource": {
"resourceType": "DocumentReference",
"id": "141311",
"meta": {
"versionId": "1",
"lastUpdated": "2019-02-10T18:45:07.421+00:00"
},
"contained": [{
"resourceType": "Practitioner",
"id": "AutorContenido",
"identifier": [{
"system": "https://saludddigital.gob.ar/profesionales",
"value": "132818"
}]
},
{
"resourceType": "Organization",
"id": "OrganizacionResponsable",
"identifier": [{
"system": "https://saludddigital.gob.ar/Organization",
"value": "HIBABSAS"
}]
}
],
"masterIdentifier": {
"system": "https://hiba.com.ar/documentos_versiones",
"value": "291528-2v1"
},
"identifier": [{
"system": "https://hiba.com.ar/documentos",
"value": "291528-2"
}],
"status": "current",
"type": {
"coding": [{
"system": "http://loinc.org",
"code": "60591-5"
}]
},
"subject": {
"reference": "https://saludddigital.gob.ar/fhir/Patient/20192812"
},
"author": [{
"reference": "#AutorContenido"
},
{
"reference": "#OrganizacionResponsable"
}
],
"securityLabel": [{
"coding": [{
"system": "https://saludddigital.gob.ar/nivelesconfidencialidad",
"code": "N"
}]
}],
"content": [{
"attachment": {
"id": "PRINCIPAL",
"url": "https://saludddigital.gob.ar/fhir/Binary/7b591205-6109-4ae3-96b6-758e5b96d381"
}
}],
"context": {
"event": [{
"coding": [{
"system": "https://saludddigital.gob.ar/tiposevento",
"code": "CIR"
}]
}],
"period": {
"start": "2019-04-03T10:30:00+03:00",
"end": "2019-04-05T10:30:00+03:00"
},
"facilityType": {
"coding": [{
"system": "https://saludddigital.gob.ar/tipoprestador",
"code": "INI"
}]
},
"practiceSetting": {
"coding": [{
"system": "https://saludddigital.gob.ar/especialidades",
"code": "CLM"
}]
}
}
}
}
]
}
El cliente de HC muestra a su usuario la lista de resultados según corresponda, con una opción para ‘Ver el documento’. Ejemplo ‘Ver Detalles’
El usuario hace click en “ver detalles” (o similar) de un documento especifico
El cliente hace una petición al BUS usando la referencia obtenida en el paso anterior (en el atributo @value de cada elemento entry[].resource.DocumentReference.content[1]/attachment[1]/url[1])
La referencia tendrá la forma de recurso Binary en el Bus.
https://saludddigital.gob.ar/fhir/Binary/7b591205-6109-4ae3-96b6-758e5b96d381
En el caso de Binary, el servidor devolverá el recurso en el formato correspondiente al tipo de recurso (FHIR XML o JSON) El perfil para este Bundle está descripto en Bundle_ar_ips_core
Ver ejemplo de Respuesta - [Documento Completo IPS] (Bundle-Bundle-ar-IPS-FernandezPerezPablo)
Código de Status http: 200 Descripción: No se han producido errores. Inclusive si la operación no devuelve ningún registro (no se han encontrado documentos)
Código de Status http: 400 Descripción: Parámetro o sintáxis inválida.
Puede deberse a - código inválido de tipo de documento (class.system) - sistema de identificación de paciente inválido (patient.identifier.system) - URL con un formato inválido
Código de Status http: 401 Descripción: Falla en la autorización / token inválido – ver Sección Seguridad
Código de Status http: 403 Descripción: El solicitante no tiene permisos para acceder a la información requerida