FHIR Bulk Data

• Estás desarrollando un cliente de datos masivos que necesita iniciar exportaciones, sondear el estado y descargar archivos NDJSON desde un servidor FHIR.
• Estás implementando compatibilidad con $export en el lado del servidor y necesitas comprender los requisitos de conformidad, la estructura del manifiesto o las declaraciones de CapabilityStatement.
• Necesitas filtrar exportaciones de gran tamaño por tipo de recurso, intervalo de fechas o criterios de búsqueda FHIR utilizando parámetros como _type, _since o _typeFilter.
• Estás integrando SMART Backend Services (credenciales de cliente OAuth 2.0 + JWT) para un acceso masivo seguro de servidor a servidor.

• Solo necesitas recuperar recursos FHIR individuales a través de REST estándar — usa una habilidad FHIR general en su lugar.
• Tu caso de uso implica transmisión de datos en tiempo real o casi en tiempo real en lugar de exportación por lotes.
• Estás trabajando con un formato de exportación masiva propietario que no sigue el IG de Acceso a Datos Masivos de HL7.

Te guía a través de cada etapa del ciclo de vida de la exportación masiva: solicitud de inicio, manejo de 202 Accepted, sondeo de estado con Retry-After y X-Progress, análisis del manifiesto, descarga de archivos y limpieza con DELETE.

Cubre Patient/$export (todos los pacientes), Group/[id]/$export (alcance de cohorte) y [base]/$export (nivel de sistema), incluyendo cuándo usar cada uno y cómo el alcance afecta la salida.

Guía detallada sobre todos los parámetros compatibles: _outputFormat, _since, _until, _type, _elements, _typeFilter, includeAssociatedData, organizeOutputBy y allowPartialManifests.

Reglas precisas para producir y consumir JSON delimitado por saltos de línea: un recurso por línea, codificación UTF-8, terminación de línea correcta, sin saltos de línea incrustados y tipo de medio correcto (application/fhir+ndjson).

Explica el flujo de credenciales de cliente OAuth 2.0 con aserción JWT requerida para el acceso masivo de servidor a servidor, incluyendo la estructura de solicitud de token y el uso de tokens de portador.

Cubre la interpretación de OperationOutcome, la limitación de velocidad (429 Too Many Requests), la expiración de tokens (401), trabajos no encontrados (404), y estrategias para clientes de sondeo resilientes en FHIR Bulk Data.

Implementa un cliente que inicie una exportación, sondee la URL de estado con retroceso exponencial, analice el manifiesto completo y transmita archivos NDJSON para su procesamiento posterior.

Configura un servidor FHIR para admitir $export, devolver respuestas HTTP correctas en cada etapa del flujo de trabajo y declarar la conformidad mediante CapabilityStatement.

Usa Group/$export con los parámetros _type, _since y _typeFilter para exportar únicamente los tipos de recursos y rangos de fechas necesarios para un caso de uso específico de análisis o investigación.

Diagnostica y resuelve errores de exportación masiva interpretando respuestas OperationOutcome, comprendiendo la semántica de los códigos de estado HTTP y gestionando casos límite como manifiestos parciales y salidas paginadas.