FHIR

Explicación del FHIR Bundle: los nueve tipos y cuándo usar cada uno

Un FHIR Bundle es un contenedor para varios recursos. Los nueve tipos de bundle en FHIR R4 (document, message, transaction, transaction-response, batch, batch-response, history, searchset, collection), cómo una transacción difiere de un lote, y un ejemplo mínimo en JSON.

por Publicado 2 min de lectura

Respuesta corta: Un Bundle es el recurso FHIR que agrupa otros recursos: resultados de búsqueda, un conjunto de escrituras enviadas en una solicitud, un documento clínico como un resumen del paciente o un mensaje. Su type indica qué significa el grupo y cómo debe manejarlo un servidor.

Los nueve tipos en FHIR R4

  • searchset: los resultados de una búsqueda, con enlaces de paginación.
  • transaction: escrituras procesadas de forma "todo o nada"; si una falla, ninguna se aplica.
  • batch: escrituras procesadas de forma independiente; cada entrada tiene éxito o falla por sí sola.
  • transaction-response / batch-response: lo que el servidor devuelve para cada una.
  • document: un documento clínico (la primera entrada es una Composition), como el Resumen Internacional del Paciente; se firma o almacena en su totalidad.
  • message: un mensaje, la primera entrada es un MessageHeader.
  • history: las versiones de los recursos.
  • collection: un conjunto de recursos sin un significado adicional.

Transacción vs. lote

Utilice una transacción cuando los recursos dependan unos de otros, por ejemplo, un Paciente y las Observaciones que lo referencian: las referencias entre entradas pueden usar identificadores temporales urn:uuid: que el servidor resuelve. Utilice un lote para operaciones independientes donde el éxito parcial sea aceptable.

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {"fullUrl": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a",
     "resource": {"resourceType": "Patient", "name": [{"family": "Example"}]},
     "request": {"method": "POST", "url": "Patient"}},
    {"resource": {"resourceType": "Observation", "status": "final",
       "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]},
       "subject": {"reference": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a"},
       "valueQuantity": {"value": 72, "unit": "/min", "system": "http://unitsofmeasure.org", "code": "/min"}},
     "request": {"method": "POST", "url": "Observation"}}
  ]
}

En Anpheros

Anpheros Platform acepta bundles de transacción y lote y devuelve bundles de searchset con paginación; el Resumen Internacional del Paciente se devuelve como un bundle de documento. Consulte el sandbox de FHIR para probarlos, y el Resumen Internacional del Paciente en FHIR.

Páginas relacionadas

Fuentes

Preguntas frecuentes

¿Cuál es la diferencia entre una transacción FHIR y un lote?

Una transacción es "todo o nada"; un lote procesa cada entrada de forma independiente.

¿Cómo referencio un recurso creado en el mismo bundle?

Asígnele un fullUrl como urn:uuid:... y úselo como referencia; en una transacción, el servidor lo reemplaza con el id real.

¿Qué tipo es un resumen de paciente?

Un bundle de documento cuya primera entrada es una Composition.

¿Por qué mi búsqueda devuelve un Bundle?

Los resultados de búsqueda son siempre un bundle de searchset, con enlaces a la siguiente página.

Anpheros Platform

Pruébalo gratis en el sandbox

Tu primera llamada FHIR en 5 minutos. Una API HL7 FHIR R4 con el consentimiento del paciente integrado: pruébala en el sandbox y luego conecta tu propia app o sistema de clínica.

Gratis · 30 pacientes sintéticos · sin tarjeta

Esta guía es informativa y no sustituye la consulta médica. Para decisiones sobre tu salud, habla con tu médico. En una emergencia, llama al número de emergencias local (112 en Europa).
Escrito por
El equipo de Anpheros

Anpheros crea un historial médico que el paciente controla y puede compartir con cualquier clínica, en una plataforma HL7 FHIR R4, con sede en la UE. Estas guías te ayudan a entender y organizar tu salud; no reemplazan a tu médico.

Sobre Anpheros →