0.5.0 - ci-build

FHIR_CORE_AR - Local Development build (v0.5.0). See the Directory of published versions

Consulta Documento IPS (cliente)

Obtención de Resumen IPS -Cliente

<?xml version=”1.0” encoding=”UTF-8” standalone=”no”?>Consulta Resumen de Historia IPSCHCIPSPaso 1 - Consulta de Ubicaciones de pacienteGET [url_ips]?query=patient-location-query&identifier=@dominio_local|@identificador_paciente_localresponse body: Bundle <{Organization_ar_core}>Paso 2 - Consulta de Disponibilidad de ResumenGET [url_ips]/DocumentReference?subject:Patient.identifier=@dominio_local|@identificador_local&class=https://loinc.org/|60591-5response body: Bundle <{document_reference_ar_core}>Paso 3 - Obtencion de ResumenGET [url_ips]/Binary/[id_bundle_ips]response body: {Bundle_ips_ar}

Paso 1 – Solicitud de Ubicaciones de Información de Salud

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

Parámetros

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"


          	}
   	}]
}

Paso 2 - Lista de Jurisdicciones

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)

Paso 3 - Solicitud de Resumen de Historia Clínica

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


Paso 4 - Procesamiento de la Respuesta a la Solicitud de Documentos

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

Paso 5 - Solicitud de Documento

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)

Clases de Respuesta HTTP

Operación exitosa

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)

Parámetro Inválido

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

Solicitud No Autorizada

Código de Status http: 401 Descripción: Falla en la autorización / token inválido – ver Sección Seguridad

Fuera de Alcance

Código de Status http: 403 Descripción: El solicitante no tiene permisos para acceder a la información requerida