Guía MHD para el Intercambio de Información de Salud en Chile, published by Hl7 Chile. This guide is not an authorized publication; it is the continuous build for version 0.1.0-ballot1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7Chile/MHD-CL/ and changes regularly. See the Directory of published versions

Transacciones asociadas a MHD

Transacciones MHD

Esta página describe las transacciones utilizadas para registrar, buscar y recuperar documentos clínicos mediante IHE Mobile access to Health Documents (MHD) sobre HL7 FHIR R4.

La implementación utiliza los perfiles de IHE MHD para el intercambio documental y los perfiles de CL Core para representar las entidades nacionales, como pacientes, profesionales y organizaciones.

Contenido

• Actores MHD
• Transacción 1: Registrar un documento — ITI-65
• Transacción 2: Buscar documentos — ITI-67
• Transacción 3: Recuperar un documento — ITI-68
• Códigos de respuesta HTTP
• Seguridad

Actores MHD

Transacción 1: Registrar un documento — ITI-65

Nombre IHE: Provide Document Bundle
Actores: Document Source → Document Recipient
Método HTTP: POST [base]

Descripción

La transacción ITI-65 permite enviar documentos clínicos y sus metadatos al receptor documental. La solicitud se representa mediante un Bundle FHIR de tipo transaction, que debe procesarse de manera atómica: todas las entradas se procesan correctamente o la transacción completa es rechazada.

Recursos de la transacción

La guía local debe declarar expresamente si el contenido se envía como Binary, como un Bundle FHIR de tipo document o se mantiene en un repositorio externo mediante la opción de referencias no contenidas.

Solicitud

POST [base]
Content-Type: application/fhir+json
Accept: application/fhir+json

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:submission-set",
      "resource": {
        "resourceType": "List",
        "status": "current",
        "mode": "working"
      },
      "request": {
        "method": "POST",
        "url": "List"
      }
    },
    {
      "fullUrl": "urn:uuid:document-reference",
      "resource": {
        "resourceType": "DocumentReference",
        "status": "current"
      },
      "request": {
        "method": "POST",
        "url": "DocumentReference"
      }
    },
    {
      "fullUrl": "urn:uuid:clinical-document",
      "resource": {
        "resourceType": "Bundle",
        "type": "document"
      },
      "request": {
        "method": "POST",
        "url": "Bundle"
      }
    }
  ]
}

Diagrama de secuencia

Respuesta exitosa

El éxito de la transacción se informa mediante un estado HTTP general 200 OK. Cada entrada del Bundle de respuesta indica el resultado individual de su operación, normalmente 201 Created para los recursos creados.

{
  "resourceType": "Bundle",
  "type": "transaction-response",
  "entry": [
    {
      "response": {
        "status": "201 Created",
        "location": "List/123/_history/1"
      }
    },
    {
      "response": {
        "status": "201 Created",
        "location": "DocumentReference/456/_history/1"
      }
    },
    {
      "response": {
        "status": "201 Created",
        "location": "Bundle/789/_history/1"
      }
    }
  ]
}

Transacción 2: Buscar documentos — ITI-67

Nombre IHE: Find Document References
Actores: Document Consumer → Document Responder
Método HTTP: GET [base]/DocumentReference

Descripción

La transacción ITI-67 permite al Document Consumer buscar referencias documentales en el Document Responder mediante el recurso DocumentReference. El resultado entrega los metadatos de cada documento y la dirección desde la cual recuperarlo mediante ITI-68.

El servidor DEBE soportar los parámetros de búsqueda obligatorios definidos por IHE MHD para ITI-67. La presente guía puede además establecer restricciones, combinaciones recomendadas o parámetros adicionales para responder a las necesidades de la implementación local. Los parámetros y requisitos detallados se especifican formalmente en el CapabilityStatement MHD Responder de esta guía.

Parámetros de búsqueda

Solicitud por identificador del paciente

GET [base]/DocumentReference?patient.identifier=[system]|[value]&status=current
Accept: application/fhir+json

Ejemplo:

GET [base]/DocumentReference?patient.identifier=https://www.registrocivil.cl/run|9999999-9&status=current

La búsqueda es la forma definida por IHE MHD para ITI-67. La lectura directa es una interacción FHIR estándar que este servidor declara en el CapabilityStatement MHD Responder.

Diagrama de secuencia

Respuesta exitosa

La respuesta será 200 OK, incluso cuando no se encuentren documentos. En ese caso, el Bundle.total será 0 y no contendrá entradas de resultados.

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "fullUrl": "https://servidor.example.org/fhir/DocumentReference/456",
      "resource": {
        "resourceType": "DocumentReference",
        "id": "456",
        "status": "current",
        "subject": {
          "reference": "Patient/123"
        },
        "content": [
          {
            "attachment": {
              "contentType": "application/fhir+json",
              "url": "https://servidor.example.org/fhir/Bundle/789",
              "title": "Documento clínico"
            }
          }
        ]
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Transacción 3: Recuperar un documento — ITI-68

Nombre IHE: Retrieve Document
Actores: Document Consumer → Document Responder
Método HTTP: GET [URL del documento]

Descripción

La transacción ITI-68 permite recuperar el documento previamente localizado mediante ITI-67. El consumidor debe utilizar la dirección indicada en DocumentReference.content.attachment.url.

Cuando el documento se representa como un Bundle FHIR de tipo document, la dirección puede corresponder a un endpoint como:

GET [base]/Bundle/[id]

Si el documento se almacena como Binary o en un repositorio documental externo, se utiliza directamente la URL informada en el DocumentReference.

Encabezados

El consumidor puede utilizar el encabezado Accept para indicar el formato requerido:

GET [DocumentReference.content.attachment.url]
Accept: application/fhir+json

El formato solicitado debe ser compatible con el tipo informado en DocumentReference.content.attachment.contentType.

Diagrama de secuencia

Respuesta exitosa: documento FHIR

{
  "resourceType": "Bundle",
  "id": "789",
  "type": "document",
  "timestamp": "2026-08-17T10:30:00-03:00",
  "entry": [
    {
      "resource": {
        "resourceType": "Composition",
        "id": "composition-1",
        "status": "final"
      }
    },
    {
      "resource": {
        "resourceType": "Patient",
        "id": "patient-1"
      }
    }
  ]
}

Códigos de respuesta HTTP

Cuando se produce un error, el servidor debería entregar un recurso OperationOutcome con información suficiente para identificar la causa.

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "invalid",
      "diagnostics": "El recurso no cumple con el perfil declarado."
    }
  ]
}

Seguridad

Las transacciones deben ejecutarse mediante HTTPS y aplicar los mecanismos de autenticación, autorización, control de acceso y auditoría definidos por la infraestructura nacional o institucional.

Como mínimo, la implementación debe considerar:

• autenticación del sistema solicitante;
• autorización según operación y paciente;
• protección de la confidencialidad e integridad de los documentos;
• registro de auditoría de las operaciones;
• trazabilidad de accesos y recuperaciones;
• cumplimiento de las políticas de consentimiento aplicables.

Referencias

• IHE MHD — Provide Document Bundle ITI-65
• IHE MHD — Find Document References ITI-67
• IHE MHD — Retrieve Document ITI-68
• HL7 FHIR R4