Composición

Trabajar con FHIR R4 4.0.1 Recursos de composición.

Seleccione una operación para este recurso:

El diagrama resume las solicitudes y respuestas de Composition. Consulte Interacciones REST de FHIR soportadas para conocer el modelo de interacción compartida.


Un cliente FHIR envía solicitudes a la API de composición R4 de DDFS. La búsqueda devuelve un paquete; la creación, lectura y actualización devuelve un recurso; vread devuelve una versión histórica; delete devuelve HTTP 204 sin cuerpo. Las operaciones personalizadas y los errores con formato FHIR pueden devolver OperationOutcome.

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

Capacidad de composiciónSoporte o requisito
Creación condicionalNo soportado.
Actualización condicionalNo soportado.
Paquetes de transaccionesNo soportado.

Contenido y validación necesarios

Para obtener respuestas compartidas de error de validación, consulte OperationOutcome errors.

Detalle de composiciónRequisito o comportamiento
Contenido necesarioProporcione status (preliminary, final, amended o entered-in-error), escriba, date (tiempo de edición), al menos un autor y un título.
Regla de recursoEn cambio, los valores primitivos necesarios pueden tener una extensión válida que explique el valor ausente.
Filtros de tokenLa composición conserva identificadores, referencias, atestaciones, relaciones, eventos, secciones anidadas, descripciones y extensiones en cada versión de recurso.
Filtros de tokenUn relationship requiere exactamente un targetIdentifier o targetReference.
sectionCada sección requiere texto, entradas o subsecciones (cmp-1); emptyReason solo se permite sin entradas (cmp-2).
Referencias de pacientesLas 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 recursoLa 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

Detalle de composiciónRequisito o comportamiento
Regla de recursoLas búsquedas comunes incluyen _id y _lastUpdated.
Referencias de pacientesLas 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 fechaLa fecha no busca event.period ni la hora de última actualización del servidor.
Filtros de tokenLas búsquedas de token aceptan el valor, system|value, |value o system|.
Filtros de tokenUn parámetro de token acepta un único valor no modificado, sin alternativas de coma ni incidencias repetidas.
Referencias de pacientesEl paciente admite referencias literales y el modificador :identifier, sin encadenamiento.
Filtros de fechaLa fecha y _lastUpdated aceptan hasta dos límites repetidos con comparadores eq, ne, gt, lt, ge, le, sa, eb y ap.
LimitacionesNo se admiten alternativas de coma.
Regla de recursoUtilice los controles de resultados compartidos para la paginación, los recuentos y los totales descritos en FHIR Search Parameters.
Regla de recursoSe 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ónRequisito o comportamiento
Regla de recursoLa composición participa en entradas de lote independientes R4 en POST /api/fhir/r4.
Regla de recursoUna entrada no válida no deshace otras entradas correctas.
LimitacionesLa creación condicional, la actualización condicional y las transacciones no están soportadas.
LimitacionesEl 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.
standaloneUna composición independiente no constituye en sí misma un paquete de documentos FHIR.