Inmunización
Trabajar con los recursos de inmunización FHIR R4 4.0.1.
Seleccione una operación para este recurso:
- Buscar vacunas
- Leer vacunación
- Leer versión de vacunación
- Crear vacuna
- Actualizar vacuna
- Eliminar vacuna
- Vacunación de eliminación inmediata
- Purga de vacunas eliminadas
El diagrama resume las solicitudes y respuestas de Immunization. Consulte Interacciones REST de FHIR soportadas para conocer el modelo de interacción compartida.
Definición de FHIR R4: https://hl7.org/fhir/R4/immunization.html. Consulte códigos de respuesta de interacción y respuestas de error comunes.
El punto final del recurso es /api/fhir/r4/Immunization. R6 Las variables de vacunación no están disponibles. Compruebe los metadatos R4 before de la instancia que activan este recurso.
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 vacunación | Soporte o requisito |
|---|---|
| Formas de ámbito adicionales | La lectura/búsqueda también acepta el ámbito de lectura heredado; las escrituras aceptan los ámbitos CRUD SMART aplicables o system/Immunization.write. |
| Restricciones del recurso | Los permisos de lectura/búsqueda restringidos soportan _id, _lastUpdated, identifier, patient (incluido :identifier), status, date y vaccine-code. |
| Restricciones del recurso | Por ejemplo, system/Immunization.rs?patient=Patient/example&status=completed solo permite eventos completed para ese paciente. |
| Restricciones del recurso | Las restricciones combinadas utilizan AND; date y _lastUpdated permiten dos límites. |
| 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 búsqueda
- 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.
Para obtener respuestas compartidas de error de validación, consulte OperationOutcome errors.
| Detalle de vacunación | Requisito o comportamiento |
|---|---|
| Contenido necesario | Proporcione status (completed, entered-in-error o not-done), vaccineCode, una referencia de paciente y exactamente un occurrenceDateTime o occurrenceString. |
| Filtros de token | El recurso conserva los identificadores, las extensiones, los metadatos primitivos, el contenido histórico y el ejecutor anidado, la educación, la reacción y los elementos protocolApplied. |
| Referencias | La educación debe incluir documentType o referencia. |
| Elementos de opción | protocolApplied requiere exactamente una opción doseNumber; seriesDoses es opcional y también permite una opción. |
| Referencias de pacientes | Búsqueda de GET y soporte de POST /_search con codificación de formulario _id, _lastUpdated, identifier, patient, status, date y vaccine-code, además de controles de resultados compartidos, filtros de perfil y etiqueta. |
| Limitaciones | identifier, status y vaccine-code aceptan un token no modificado en formato system|value, |value o system|; las alternativas de token repetidas y separadas por comas no están soportadas. |
| Estado | Los tokens de estado utilizan el sistema code implícito http://hl7.org/fhir/event-status; status=http://hl7.org/fhir/event-status|completed coincide con los eventos completed, mientras que un token sin sistema explícito no lo hace. |
| Limitaciones | patient acepta una referencia de paciente o el modificador de referencia :identifier existente; no se admiten nuevas cadenas. |
| Filtros de fecha | Se aplican los comparadores de fechas eq, ne, gt, ge, lt, le, sa, eb y ap, con como máximo dos límites date repetidos combinados mediante AND. |
| Filtros de fecha | date solo busca en occurrenceDateTime: occurrenceString no tiene date inventado y no coincide con los filtros date. |
| Limitaciones | El episodio clínico, el personal clínico, la organización, la reacción detallada, las nuevas cadenas, los compuestos y los filtros de texto completo no son compatibles. |
GET /api/fhir/r4/Immunization?patient=Patient/example&vaccine-code=http://hl7.org/fhir/sid/cvx%7C207&status=completed&date=ge2026-01-01&date=lt2027-01-01
Ejemplo
{"resourceType":"Immunization","status":"completed","vaccineCode":{"coding":[{"system":"http://hl7.org/fhir/sid/cvx","code":"207"}]},"patient":{"reference":"Patient/example"},"occurrenceDateTime":"2026-01-15T12:00:00Z"}