View a markdown version of this page

Operação FHIR R4 para $davinci-data-export HealthLake - AWS HealthLake

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Operação FHIR R4 para $davinci-data-export HealthLake

A $davinci-data-export operação é uma operação FHIR assíncrona que você pode usar para exportar dados de saúde. AWS HealthLake Essa operação oferece suporte a vários tipos de exportação, incluindo Atribuição de Membro (ATR) Payer-to-Payer, Acesso ao PDex Provedor e Acesso ao Membro. APIs É uma versão especializada da $export operação padrão do FHIR, projetada para atender aos requisitos dos guias de DaVinci implementação.

Recursos principais

  • Processamento assíncrono: segue o padrão de solicitação assíncrona FHIR

  • Exportação em nível de grupo: exporta dados para membros em um recurso de grupo específico

  • Vários tipos de exportação: suporta ATR (atribuição de membros), acesso de PDex provedor e acesso de membros Payer-to-Payer APIs

  • Suporte abrangente de perfis: inclui US Core, CARIN Blue Button e PDex perfis

  • Filtragem flexível: suporta a filtragem por pacientes, tipos de recursos e intervalos de tempo

  • Saída NDJSON: fornece dados no formato JSON delimitado por nova linha

Ponto final da operação

GET [base]/Group/[id]/$davinci-data-export POST [base]/Group/[id]/$davinci-data-export

Parâmetros da solicitação

Parâmetro Cardinalidade Description
patient 0.. * Membros específicos cujos dados devem ser exportados. Quando omitidos, todos os membros do Grupo são exportados.
_type 0,1 Lista delimitada por vírgula dos tipos de recursos FHIR a serem exportados.
_since 0,1 Inclua somente recursos atualizados após essa data e hora.
_until 0,1 Inclua somente recursos atualizados antes dessa data e hora.
exportType 0,1 Tipo de exportação a ser executada. Valores válidos: hl7.fhir.us.davinci-atr, hl7.fhir.us.davinci-pdex, hl7.fhir.us.davinci-pdex.p2p, hl7.fhir.us.davinci-pdex.member. Padrão: hl7.fhir.us.davinci-atr.
_includeEOB2xWoFinancial 0,1 Especifica se os recursos do CARIN BB 2.x devem ser incluídos com ExplanationOfBenefit os dados financeiros removidos. Padrão: false.

Tipos de recursos compatíveis

Os tipos de recursos suportados dependem do tipo de exportação que você especificar. Para exportações de ATR, os seguintes tipos de recursos são suportados:

  • Group

  • Patient

  • Coverage

  • RelatedPerson

  • Practitioner

  • PractitionerRole

  • Organization

  • Location

Para PDex exportações (Provider Access e Member Access), todos os tipos de recursos clínicos e de sinistros são suportados, além dos tipos anteriores. Payer-to-Payer Para obter uma lista completa dos tipos de recursos suportados, consulte o US Core Implementation Guide (STU 6.1), o CARIN Blue Button Implementation Guide e o Da Vinci Prior Authorization Support Implementation Guide.

Tipos de exportação

A $davinci-data-export operação suporta os seguintes tipos de exportação. Você especifica o tipo de exportação usando o exportType parâmetro.

Tipo de exportação Finalidade Escopo de dados Limite temporal
hl7.fhir.us.davinci-atr Lista de atribuição de membros Recursos relacionados à atribuição Nenhum
hl7.fhir.us.davinci-pdex API de acesso do provedor Dados clínicos e de reclamações de pacientes atribuídos 5 anos
hl7.fhir.us.davinci-pdex.p2p Payer-to-Payer Troca Dados históricos de associados para transições de seguros 5 anos
hl7.fhir.us.davinci-pdex.member API de acesso de membros Dados de saúde do próprio membro 5 anos
nota

Para PDex exportações, o limite temporal de 5 anos não se aplica aos tipos de recursos ATR (Group,,Patient,Coverage,RelatedPerson,, Practitioner PractitionerRoleOrganization,Location). Esses recursos estão sempre incluídos, independentemente da idade.

ATR (hl7.fhir.us.davinci-atr)

Com o tipo de exportação ATR, você pode exportar dados da Lista de Atribuição de Membros. Use esse tipo de exportação para recuperar recursos relacionados à atribuição para membros de um grupo. Para obter mais informações, consulte a Operação de exportação de ATR Da Vinci.

Tipos de recursos compatíveis

Group, Patient, Coverage, RelatedPerson, Practitioner, PractitionerRole, Organization, Location

Filtragem temporal

Nenhuma filtragem temporal é aplicada. Todos os recursos correspondentes são exportados independentemente da data.

PDex Tipos de exportação

Todos os tipos de PDex exportação compartilham os mesmos perfis suportados e a mesma lógica de filtragem. Para obter mais informações, consulte a API Da Vinci PDex Provider Access. Os seguintes perfis são compatíveis:

  • US Core 3.1.1, 6.1.0 e 7.0.0

  • PDex Autorização prévia (não suportada para acesso de membros)

  • Perfis básicos do CARIN BB 2.x: Institucional de Internação, Institucional Ambulatorial, Profissional, Oral, Farmácia NonClinician

Acesso do provedor (hl7.fhir.us.davinci-pdex)

Permite que os provedores da rede recuperem dados de pacientes atribuídos.

Payer-to-Payer (hl7.fhir.us.davinci-pdex.p2p)

Permite a troca de dados entre pagadores quando um paciente muda de seguro.

Acesso de membro (hl7.fhir.us.davinci-pdex.member)

Permite que os membros acessem seus próprios dados de saúde. Esse tipo de exportação pode incluir dados financeiros nos recursos de sinistros.

Suporte de perfil e lógica de inclusão

Para PDex exportações, a $davinci-data-export operação usa declarações de perfil no meta.profile elemento para determinar quais recursos incluir na exportação.

ExplanationOfBenefit Tratamento de recursos

ExplanationOfBenefitOs recursos (EOB) são incluídos ou excluídos PDex das exportações com base em suas meta.profile declarações:

  • ExplanationOfBenefit recursos com um perfil CARIN BB 1.x são excluídos da exportação.

  • ExplanationOfBenefit recursos sem meta.profile conjunto são excluídos da exportação.

  • ExplanationOfBenefit recursos com um perfil CARIN BB 2.x Basis estão sempre incluídos.

  • ExplanationOfBenefit recursos com um perfil CARIN BB 2.x que contém dados financeiros são excluídos por padrão. Quando _includeEOB2xWoFinancial=true definido, eles são incluídos com os dados financeiros retirados e o recurso é transformado no perfil Basis correspondente.

  • ExplanationOfBenefit recursos com um perfil de autorização PDex prévia estão sempre incluídos.

Transformação de dados financeiros

Quando você configura_includeEOB2xWoFinancial=true, a operação transforma os ExplanationOfBenefit recursos do CARIN BB 2.x em seus perfis Basis correspondentes, removendo dados financeiros. Por exemplo, um C4BB ExplanationOfBenefit Oral recurso é transformado emC4BB ExplanationOfBenefit Oral Basis, o que retira os dados financeiros do registro de acordo com a especificação FHIR.

Os seguintes elementos de dados financeiros são removidos durante a transformação:

  • Todos os elementos são cortados total

  • Todos os adjudication elementos com amounttype fatia

  • Todos os item.adjudication elementos com informações de quantidade

A operação também atualiza os metadados do perfil durante a transformação:

  • meta.profileé atualizado para o URL canônico do perfil básico

  • A versão é atualizada para a versão base do CARIN BB 2.x

  • Os recursos existentes no armazenamento de dados não são modificados

  • Os recursos exportados não são mantidos de volta ao armazenamento de dados

Regras de detecção de perfil

A operação usa as seguintes regras para detectar e validar perfis:

  • A detecção de versão é baseada no código meta.profile canônico URLs

  • Um recurso é incluído se QUALQUER um de seus perfis declarados corresponder aos critérios de exportação.

  • A validação do perfil ocorre durante o processamento da exportação

Filtragem temporal de cinco anos para exportações PDex

Para todos os tipos de PDex exportação, HealthLake aplica um filtro temporal de 5 anos com base na última atualização do recurso. O filtro temporal se aplica a todos os recursos, exceto aos seguintes tipos principais de recursos de atribuição, que são sempre exportados independentemente da idade:

  • Patient

  • Coverage

  • Organization

  • Practitioner

  • PractitionerRole

  • RelatedPerson

  • Location

  • Group

Esses recursos administrativos e demográficos são isentos porque fornecem contexto essencial para os dados exportados. As exportações de ATR não estão sujeitas a nenhuma filtragem temporal.

Solicitações de amostra

Os exemplos a seguir mostram como iniciar trabalhos de exportação para diferentes tipos de exportação.

Exportação ATR

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&exportType=hl7.fhir.us.davinci-atr POST https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&exportType=hl7.fhir.us.davinci-atr Content-Type: application/json { "DataAccessRoleArn": "arn:aws:iam::444455556666:role/your-healthlake-service-role", "JobName": "attribution-export-job", "OutputDataConfig": { "S3Configuration": { "S3Uri": "s3://your-export-bucket/EXPORT-JOB", "KmsKeyId": "arn:aws:kms:region:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab" } } }

Exportação do Provider Access com remoção de dados ExplanationOfBenefit financeiros

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,MedicationRequest,ExplanationOfBenefit&exportType=hl7.fhir.us.davinci-pdex&_includeEOB2xWoFinancial=true

Payer-to-Payer exportar

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Coverage,ExplanationOfBenefit,Condition,Procedure&exportType=hl7.fhir.us.davinci-pdex.p2p&_includeEOB2xWoFinancial=true

Exportação de acesso de membro para um paciente específico

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,ExplanationOfBenefit,MedicationRequest&exportType=hl7.fhir.us.davinci-pdex.member&patient=Patient/example-patient-id

Resposta da amostra

{ "datastoreId": "eaee622d8406b41eb86c0f4741201ff9", "jobStatus": "SUBMITTED", "jobId": "48d7b91dae4a64d00d54b70862f33f61" }

Relações de recursos

A operação exporta recursos com base em seus relacionamentos na Lista de atribuição de membros:

Group (Attribution List) ├── Patient (Members) ├── Coverage → RelatedPerson (Subscribers) ├── Practitioner (Attributed Providers) ├── PractitionerRole → Location └── Organization (Attributed Providers)

Fontes de recursos

Recurso Localização da fonte Description
Patient Group.member.entity Os pacientes que são membros da lista de atribuição
Coverage Group.member.extension:coverageReference Cobertura que resultou na adesão do paciente
Organization Group.member.extension:attributedProvider Organizações às quais os pacientes são atribuídos
Practitioner Group.member.extension:attributedProvider Profissionais individuais aos quais os pacientes são atribuídos
PractitionerRole Group.member.extension:attributedProvider Funções profissionais às quais os pacientes são atribuídos
RelatedPerson Coverage.subscriber Assinantes da cobertura
Location PractitionerRole.location Locais associados às funções dos profissionais
Group Ponto final de entrada A própria lista de atribuições

Gestão de Job

Verifique o status do trabalho

GET [base]/export/[job-id]

Cancelar trabalho

DELETE [base]/export/[job-id]

Ciclo de vida da tarefa

  • SUBMITTED- Job foi recebido e colocado na fila

  • IN_PROGRESS- O trabalho está sendo processado ativamente

  • COMPLETED- Job concluído com sucesso, arquivos disponíveis para download

  • FAILED- Job encontrou um erro

Output Format

  • Formato de arquivo: NDJSON (JSON delimitado por nova linha)

  • Organização de arquivos: arquivos separados para cada tipo de recurso

  • Extensão do arquivo: .ndjson

  • Localização: bucket e caminho do S3 especificados

Tratamento de erros

A operação retorna HTTP 400 Bad Request com uma OperationOutcome das seguintes condições:

Erros de autorização

A função do IAM especificada em DataAccessRoleArn não tem permissões suficientes para realizar a operação de exportação. Para obter a lista completa das permissões necessárias do S3 e do KMS, consulte Configuração de permissões para trabalhos de exportação.

Erros de validação de parâmetros
  • O patient parâmetro não está formatado como Patient/id,Patient/id,...

  • Uma ou mais referências de pacientes são inválidas ou não pertencem ao Grupo especificado

  • O valor do exportType parâmetro não é um tipo de exportação compatível

  • O _type parâmetro contém tipos de recursos que não são compatíveis com o tipo de exportação especificado.

  • O _type parâmetro não contém os tipos de recursos necessários (Group,Patient,Coverage) para o tipo de hl7.fhir.us.davinci-atr exportação

  • O valor do _includeEOB2xWoFinancial parâmetro não é um booleano válido

Erros de validação de recursos
  • O recurso de grupo especificado não existe no armazenamento de dados

  • O recurso de grupo especificado não tem membros

  • Um ou mais membros do Grupo fazem referência a recursos do paciente que não existem no armazenamento de dados

Segurança e autorização

Práticas recomendadas

  • Seleção do tipo de recurso: solicite somente os tipos de recursos necessários para minimizar o tamanho da exportação e o tempo de processamento

  • Filtragem baseada em tempo: use o _since parâmetro para exportações incrementais

  • Filtragem de pacientes: use o patient parâmetro quando precisar apenas de dados de membros específicos

  • Monitoramento de trabalhos: verifique regularmente o status do trabalho para grandes exportações

  • Tratamento de erros: implemente a lógica de repetição adequada para trabalhos com falha

  • Reconhecimento do filtro temporal: para PDex exportações, considere o filtro temporal de 5 anos ao selecionar os tipos de recursos

  • Remoção de dados financeiros: use _includeEOB2xWoFinancial=true quando precisar de dados de sinistros sem informações financeiras

  • Gerenciamento de perfil: garanta que os recursos tenham declarações de perfil apropriadas, valide os perfis de destino antes da ingestão e use o controle de versão do perfil para controlar o comportamento de exportação

Limitações

  • Máximo de 500 pacientes pode ser especificado no patient parâmetro

  • A exportação é limitada somente às operações em nível de grupo

  • Suporta apenas o conjunto predefinido de tipos de recursos para cada tipo de exportação

  • A saída está sempre no formato NDJSON

  • PDex as exportações são limitadas a 5 anos de dados clínicos e de sinistros

  • A transformação de dados financeiros só se aplica aos perfis CARIN BB 2.x ExplanationOfBenefit

Recursos adicionais