Guía implementación interoperabilidad FHIR sectorial e intersectorial - Local Development build (v0.10.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Interacciones

Interacciones con el Servidor FHIR

Este documento describe detalladamente las cuatro interacciones principales del servidor FHIR necesarias para la guía de implementación junto con ejemplos prácticos y diagramas de secuencia. Cada interacción está nombrada y documentada según las especificaciones del estándar FHIR, incluyendo estructuras de request y parámetros de búsqueda, sin embargo están enfocadas en las operaciones definidas en el marco de interoperabilidad con documentos CDA existentes.

1. Registro de Evento Clínico

Descripción:
Permite registrar información completa sobre un evento clínico específico. El bundle enviado en el cuerpo debe contener una Composition como recurso inicial, que encapsula los demás recursos involucrados en el evento.

Secuencia:

Request Body:

{
  "resourceType": "Bundle",
  "type": "document",
  "entry": [
    {"resource": {"resourceType": "Composition", "id": "COMP-APH-001"}},
    {"resource": {"resourceType": "Observation", "id": "OBS-001"}}
  ]
}

Ejemplo de respuesta exitosa:

{
  "resourceType": "OperationOutcome",
  "id": "op-success",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "details": {
        "text": "El Bundle de documento clínico se ha procesado correctamente."
      }
    }
  ]
}

Ejemplo de respuesta fallida:

{
  "resourceType": "OperationOutcome",
  "id": "op-error",
  "issue": [
    {
      "severity": "error",
      "code": "invalid",
      "details": {
        "text": "El Bundle carece de la sección obligatoria 'ClinicalDocument'."
      },
      "diagnostics": "El recurso Bundle no incluye el recurso Composition requerido."
    }
  ]
}

2. Consulta de Sistemas de Codificación (Search CodeSystem)

Descripción:
Esta interacción permite consultar sistemas de codificación (CodeSystem) para sincronización o actualización local de catálogos de términos clínicos.

Secuencia:

Parámetros de búsqueda:

El perfil de parámetros que debe ser usado para esta interación es el ProfileParameters-ITI-96

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "ITI-96",
            "part": [
                {
                    "name": "name",
                    "valueString": "Barrios"
                },
                {
                    "name": "identifier",
                    "valueString": "CodeSystem-12345"
                }
            ]
        }
    ]
}

Ejemplo de respuesta:

{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [
    {
      "resource": {
        "resourceType": "CodeSystem",
        "id": "icd-10",
        "url": "http://hl7.org/fhir/sid/icd-10",
        "content": "complete"
        ...
      }
    }
  ]
}

3. Consulta de Documentos por Identificador del Paciente (Search Composition by Patient Identifier)

Descripción:
Facilita la búsqueda de documentos clínicos (Composition) relacionados a un paciente específico utilizando su identificador.

Secuencia:

Parámetros de búsqueda:

El perfil de parámetros que debe ser usado para esta interación es el ProfileParameters-ITI-18

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "ITI-18",
            "part": [
                {
                    "name": "patient.identifier",
                    "valueIdentifier": {
                        "type": {
                            "coding": [
                                {
                                    "system": "https://ApiDomain.org/CodeSystem/Tipo-Identificacion",
                                    "code": "CC",
                                    "display": "Cédula de Ciudadania"
                                }
                            ]
                        },
                        "value": "123456780"
                    }
                },
                {
                    "name": "patient.birthDate",
                    "valueDate": "1999-01-08"
                }
            ]
        }
    ]
}

Ejemplo de respuesta:

{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [
    {
      "resource": {
        "resourceType": "Composition",
        "id": "COMP-APH-001",
        "identifier": {
          "value": "COMP-APH-001"
        },
        "status": "final",
        "type": {
          "coding": [{
            "code": "34111-5",
            "display": "Emergency department Note"
          }]
        },
        "subject": {
          "reference": "Patient/3642390034"
        }
      },
      ...
      {
        ...        
      }
    }
  ]
}

4. Obtención de Documento Completo (GET Composition Document)

Descripción:
Recupera un documento clínico completo, incluyendo la Composition y todos los recursos relacionados a un evento clínico específico.

Secuencia:

Parámetros de búsqueda:

El perfil de parámetros que debe ser usado para esta interación es el ProfileParameters-ITI-43

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "ITI-43",
            "valueId": "Composition-0196a277"
        }
    ]
}

Ejemplo de respuesta:

{
  "resourceType": "Bundle",
  "type": "document",
  "entry": [
    {
      "resource": {
        "resourceType": "Composition",
        "id": "COMP-APH-001",
        "status": "final",
        "type": {
          "coding": [{
            "code": "34111-5",
            "display": "Emergency department Note"
          }]
        },
        "title": "Reporte de Urgencias",
        "date": "2025-03-18T08:30:00Z"
      }
    },
    {
      "resource": {
        "resourceType": "Observation",
        "id": "OBS-PHYS-001",
        "status": "completed",
        "code": {
          "text": "Examen físico"
        }
      }
    },
    ...
  ]
}