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:
GroupPatientCoverageRelatedPersonPractitionerPractitionerRoleOrganizationLocation
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)
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
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.profileconjunto 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=truedefinido, 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.xC4BB 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
totalTodos os
adjudicationelementos comamounttypefatiaTodos os
item.adjudicationelementos 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ásicoA 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.profilecanônico URLsUm 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:
PatientCoverageOrganizationPractitionerPractitionerRoleRelatedPersonLocationGroup
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 filaIN_PROGRESS- O trabalho está sendo processado ativamenteCOMPLETED- Job concluído com sucesso, arquivos disponíveis para downloadFAILED- 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
DataAccessRoleArnnã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
patientparâmetro não está formatado comoPatient/id,Patient/id,...Uma ou mais referências de pacientes são inválidas ou não pertencem ao Grupo especificado
O valor do
exportTypeparâmetro não é um tipo de exportação compatívelO
_typeparâmetro contém tipos de recursos que não são compatíveis com o tipo de exportação especificado.O
_typeparâmetro não contém os tipos de recursos necessários (Group,Patient,Coverage) para o tipo dehl7.fhir.us.davinci-atrexportaçãoO valor do
_includeEOB2xWoFinancialparâ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
Os mecanismos de autorização padrão do FHIR se aplicam
A função de acesso a dados deve ter as permissões necessárias do IAM para operações do S3 e do KMS. Para ver a lista completa das permissões necessárias, consulte Configuração de permissões para trabalhos de exportaçã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
_sinceparâmetro para exportações incrementaisFiltragem de pacientes: use o
patientparâmetro quando precisar apenas de dados de membros específicosMonitoramento 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=truequando precisar de dados de sinistros sem informações financeirasGerenciamento 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
patientparâmetroA 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