Composición
Trabajar con FHIR R4 4.0.1 Recursos de composición.
Seleccione una operación para este recurso:
- Buscar composición
- Leer composición
- Leer versión de composición
- Crear composición
- Actualizar composición
- Suprimir composición
- Composición de eliminación firme
- Depurar composición suprimida
El diagrama resume las solicitudes y respuestas de Composition. Consulte Interacciones REST de FHIR soportadas para conocer el modelo de interacción compartida.
Definición de FHIR R4: https://hl7.org/fhir/R4/composition.html. Consulte códigos de respuesta de interacción y respuestas de error comunes.
Interacciones y permisos
- Ciclo de vida de los recursos: crear, leer, leer con versiones, actualizar, suprimir de software y condiciones previas de versión.
- PUT como creación y restauración: creación/restauración, metadatos gestionados por el servidor, cabeceras de respuesta y preferencias de devolución.
- Respuestas de interacción: códigos
statuscorrectos. - OperationOutcome errors: errores comunes y cuerpos de respuesta.
- Solicitudes de lote: procesamiento de entrada independiente.
| Capacidad de composición | Soporte o requisito |
|---|---|
| Creación condicional | No soportado. |
| Actualización condicional | No soportado. |
| Paquetes de transacciones | No soportado. |
- Autenticación y ámbitos: tokens portadores, configuración de ámbito y acceso restringido. Los ámbitos de recursos necesarios se muestran en cada página de operación.
- Operaciones de eliminación y depuración de datos: elegibilidad para supresión permanente y permisos adicionales.
- Hard Delete y Purge Deleted: puntos finales de recursos y ámbitos necesarios; consulte también la guía de depuración compartida.
Contenido y validación necesarios
Para obtener respuestas compartidas de error de validación, consulte OperationOutcome errors.
| Detalle de composición | Requisito o comportamiento |
|---|---|
| Contenido necesario | Proporcione status (preliminary, final, amended o entered-in-error), escriba, date (tiempo de edición), al menos un autor y un título. |
| Regla de recurso | En cambio, los valores primitivos necesarios pueden tener una extensión válida que explique el valor ausente. |
| Filtros de token | La composición conserva identificadores, referencias, atestaciones, relaciones, eventos, secciones anidadas, descripciones y extensiones en cada versión de recurso. |
| Filtros de token | Un relationship requiere exactamente un targetIdentifier o targetReference. |
section | Cada sección requiere texto, entradas o subsecciones (cmp-1); emptyReason solo se permite sin entradas (cmp-2). |
| Referencias de pacientes | Las entradas de sección contenidas con un subject conocido deben estar de acuerdo con el enfoque de sección, heredado de la sección principal o la composición subject cuando está ausente. |
| Regla de recurso | La lectura o la lectura con versiones de un recurso unknown devuelve 404; las lecturas actuales de los recursos suprimidos devuelven 410. |
{"resourceType":"Composition","identifier":{"system":"urn:example:composition","value":"synthetic-report"},"status":"final","type":{"coding":[{"system":"http://loinc.org","code":"11502-2"}]},"subject":{"reference":"Patient/p"},"date":"2026-10-22T10:00:00Z","author":[{"reference":"Practitioner/author"}],"title":"Synthetic genetic report"}
Búsquedas
- Operación de búsqueda: puntos finales, tabla de parámetros completa, formularios y ejemplos soportados.
- Controles de búsqueda comunes: controles compartidos y enlaces de paginación proporcionados por el servidor.
- Tipos de Valores y Sintaxis y Comparadores, Modificadores y Cadenas: sintaxis compartida. Utilice solo los formularios soportados por este recurso.
| Detalle de composición | Requisito o comportamiento |
|---|---|
| Regla de recurso | Las búsquedas comunes incluyen _id y _lastUpdated. |
| Referencias de pacientes | Las búsquedas de recursos son identifier (el único Composition.identifier), patient (solo temas del paciente), type, category, status y date (tiempo de edición de la composición). |
| Filtros de fecha | La fecha no busca event.period ni la hora de última actualización del servidor. |
| Filtros de token | Las búsquedas de token aceptan el valor, system|value, |value o system|. |
| Filtros de token | Un parámetro de token acepta un único valor no modificado, sin alternativas de coma ni incidencias repetidas. |
| Referencias de pacientes | El paciente admite referencias literales y el modificador :identifier, sin encadenamiento. |
| Filtros de fecha | La fecha y _lastUpdated aceptan hasta dos límites repetidos con comparadores eq, ne, gt, lt, ge, le, sa, eb y ap. |
| Limitaciones | No se admiten alternativas de coma. |
| Regla de recurso | Utilice los controles de resultados compartidos para la paginación, los recuentos y los totales descritos en FHIR Search Parameters. |
| Regla de recurso | Se ignora el parámetro _sort. |
GET /api/fhir/r4/Composition?patient=Patient/p&type=http%3A%2F%2Floinc.org%7C11502-2&status=final&date=ge2026-01-01&date=lt2027-01-01
Lote y limitaciones
| Detalle de composición | Requisito o comportamiento |
|---|---|
| Regla de recurso | La composición participa en entradas de lote independientes R4 en POST /api/fhir/r4. |
| Regla de recurso | Una entrada no válida no deshace otras entradas correctas. |
| Limitaciones | La creación condicional, la actualización condicional y las transacciones no están soportadas. |
| Limitaciones | El episodio clínico/contexto, el autor/la organización, las búsquedas detalladas de secciones, las nuevas cadenas, los compuestos, el texto completo, las operaciones de generación de documentos y la certificación US Core están fuera del ámbito admitido. |
standalone | Una composición independiente no constituye en sí misma un paquete de documentos FHIR. |