Guía IPS Argentina basada en Core Ar - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Consulta de de resumen de pacientes

Consulta de documento IPS (cliente)

Esta operación permite localizar y recuperar documentos IPS disponibles para un paciente a través del Bus de Interoperabilidad.

Flujo de consulta

1. Consultar los dominios que poseen información del paciente.
2. Presentar al usuario las jurisdicciones disponibles.
3. Buscar referencias a documentos IPS.
4. Procesar el Bundle de resultados.
5. Recuperar el documento seleccionado.

Paso 1: consultar ubicaciones con información de salud

El cliente solicita al Bus la lista de dominios donde el paciente fue identificado y para los cuales existe autorización según el consentimiento registrado.

La operación especial se realiza sobre Patient y recibe:

• El dominio local.
• El identificador local del paciente.

GET [base]/Patient?query=patient-location-query&identifier=@dominio_local|@identificador_paciente_local

Ejemplo:

GET https://bus.msal.gov.ar/Patient?query=patient-location-query&identifier=http://dummy.org.ar|2029129

Respuesta

El servidor devuelve un Bundle de tipo searchset. Cada entrada contiene una Organization que representa un dominio donde podrían existir documentos del paciente.

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 2,
  "entry": [
    {
      "resource": {
        "resourceType": "Organization",
        "id": "10291",
        "identifier": [
          {
            "system": "https://bus.msal.gov.ar/dominios",
            "value": "20001"
          }
        ],
        "name": "PROVINCIA DE NEUQUEN"
      }
    },
    {
      "resource": {
        "resourceType": "Organization",
        "id": "102421",
        "identifier": [
          {
            "system": "https://bus.msal.gov.ar/dominios",
            "value": "20111"
          }
        ],
        "name": "HOSPITAL ITALIANO DE BUENOS AIRES"
      }
    }
  ]
}

Paso 2: presentar las jurisdicciones

Con la respuesta anterior, el cliente puede:

• Habilitar la consulta cuando exista información en otro dominio.
• Mostrar una lista de dominios disponibles.
• Permitir la consulta en todos los dominios o en uno determinado.
• Ofrecer filtros por dominio, tipo de documento y rango de fechas.

El tipo de documento predeterminado es el Resumen de Historia Clínica IPS.

Paso 3: solicitar referencias de documentos IPS

La consulta más simple utiliza el identificador local del paciente, su dominio y el tipo de documento.

Consultar todos los dominios disponibles

GET https://bus.msal.gov.ar/v1/DocumentReference?subject:Patient.identifier=@dominio_local|@identificador_local&class=http://loinc.org|60591-5

Consultar un dominio específico

Agregar el parámetro custodian con el identificador del dominio:

GET https://bus.msal.gov.ar/v1/DocumentReference?subject:Patient.identifier=@dominio_local|@identificador_local&class=http://loinc.org|60591-5&custodian=https://bus.msal.gov.ar/dominios|@identificador_dominio

Paso 4: procesar las referencias encontradas

Una respuesta exitosa contiene un Bundle de tipo searchset con recursos DocumentReference.

Cada referencia puede informar, entre otros datos:

• Identificadores del documento y su versión.
• Estado del documento.
• Tipo documental LOINC 60591-5.
• Paciente asociado.
• Autor y organización responsable.
• Etiqueta de seguridad.
• Contexto clínico.
• URL del recurso Binary que contiene el documento.

Ejemplo resumido:

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "fullUrl": "https://hceneuquen.gob.ar/DocumentReference/10311",
      "resource": {
        "resourceType": "DocumentReference",
        "id": "10311",
        "status": "current",
        "type": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "60591-5"
            }
          ]
        },
        "subject": {
          "reference": "https://saludddigital.gob.ar/fhir/Patient/20192812"
        },
        "content": [
          {
            "attachment": {
              "id": "PRINCIPAL",
              "url": "https://saludddigital.gob.ar/fhir/Binary/7a391905-6109-4ae3-96b6-758e5b96d381"
            }
          }
        ]
      }
    }
  ]
}

El cliente presenta la lista de documentos y permite seleccionar uno para ver su contenido.

Paso 5: recuperar el documento

El cliente realiza una petición al Bus utilizando la URL incluida en:

Bundle.entry.resource.content.attachment.url

Ejemplo:

GET https://saludddigital.gob.ar/fhir/Binary/7a391905-6109-4ae3-96b6-758e5b96d381

El servidor devuelve el documento en el formato correspondiente, por ejemplo FHIR JSON o XML.

Respuestas HTTP

Perfiles relacionados

• documentreference_ar_ips_core: referencia al documento IPS.
• Bundle_ar_ips_core: documento IPS completo.