FHIR Bulk Data

• Você está criando um cliente de dados em massa que precisa iniciar exportações, verificar o status e baixar arquivos NDJSON de um servidor FHIR.
• Você está implementando suporte a $export no lado do servidor e precisa entender os requisitos de conformidade, a estrutura do manifesto ou as declarações de CapabilityStatement.
• Você precisa filtrar grandes exportações por tipo de recurso, intervalo de datas ou critérios de busca FHIR usando parâmetros como _type, _since ou _typeFilter.
• Você está integrando o SMART Backend Services (credenciais de cliente OAuth 2.0 + JWT) para acesso em massa seguro de servidor para servidor.

• Você só precisa recuperar recursos FHIR individuais via REST padrão — use uma skill FHIR genérica.
• Seu caso de uso envolve streaming de dados em tempo real ou quase em tempo real, em vez de exportação em lote.
• Você está trabalhando com um formato de exportação em massa proprietário que não segue o HL7 Bulk Data Access IG.

Orienta você em cada etapa do ciclo de vida da exportação em massa: requisição de início, tratamento do 202 Accepted, verificação de status com Retry-After e X-Progress, análise do manifesto, download de arquivos e limpeza com DELETE.

Abrange Patient/$export (todos os pacientes), Group/[id]/$export (escopo por coorte) e [base]/$export (nível de sistema), incluindo quando usar cada um e como o escopo afeta a saída.

Orientações detalhadas sobre todos os parâmetros suportados: _outputFormat, _since, _until, _type, _elements, _typeFilter, includeAssociatedData, organizeOutputBy e allowPartialManifests.

Regras precisas para produzir e consumir JSON Delimitado por Nova Linha: um recurso por linha, codificação UTF-8, terminação de linha correta, sem novas linhas incorporadas e tipo de mídia correto (application/fhir+ndjson).

Explica o fluxo de credenciais de cliente OAuth 2.0 com asserção JWT exigido para acesso bulk servidor a servidor, incluindo a estrutura da requisição de token e o uso de bearer token.

Aborda a interpretação de OperationOutcome, limitação de taxa (429 Too Many Requests), expiração de token (401), job não encontrado (404) e estratégias para clientes de polling resilientes.

Implemente um cliente que inicia uma exportação, verifica periodicamente a URL de status com backoff exponencial, analisa o manifesto completo e transmite arquivos NDJSON para processamento downstream.

Configure um servidor FHIR para suportar $export, retornar respostas HTTP corretas em cada etapa do fluxo de trabalho e declarar conformidade por meio do CapabilityStatement.

Use Group/$export com os parâmetros _type, _since e _typeFilter para exportar apenas os tipos de recursos e intervalos de datas necessários para um caso de uso específico de análise ou pesquisa.

Diagnostique e resolva erros de exportação em massa interpretando respostas OperationOutcome, compreendendo a semântica de status HTTP e tratando casos extremos como manifestos parciais e saída paginada.