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.. \$1 | Membros específicos cujos dados devem ser exportados. Quando omitidos, todos os membros do Grupo são exportados. | | \$1type | 0,1 | Lista delimitada por vírgula dos tipos de recursos FHIR a serem exportados. | | \$1since | 0,1 | Inclua somente recursos atualizados após essa data e hora. | | \$1until | 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. | | \$1includeEOB2xWoFinancial | 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)](https://hl7.org/fhir/us/core/STU6.1/), o [CARIN Blue Button Implementation Guide](https://hl7.org/fhir/us/carin-bb/) e o [Da Vinci Prior Authorization Support Implementation](https://hl7.org/fhir/us/davinci-pas/) 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` `PractitionerRole``Organization`,`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](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html). 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](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html). 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 `ExplanationOfBenefit`Os 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](https://hl7.org/fhir/us/carin-bb/) em seus perfis Basis correspondentes, removendo dados financeiros. Por exemplo, um `C4BB ExplanationOfBenefit Oral` recurso é transformado em`C4BB 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](getting-started-setting-up.md#setting-up-export-permissions). 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 + 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](getting-started-setting-up.md#setting-up-export-permissions). ## 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 + [Lista de atribuição de membros da Da Vinci IG](https://build.fhir.org/ig/HL7/davinci-atr/) + [Intercâmbio de Dados do Jogador Da Vinci (IG)](https://hl7.org/fhir/us/davinci-pdex/) + [CARIN Consumer Directed Player Data Exchange IG](https://build.fhir.org/ig/HL7/carin-bb/) + [Guia de implementação principal dos EUA](https://www.hl7.org/fhir/us/core/) + [Especificação de acesso a dados em massa do FHIR](https://hl7.org/fhir/uv/bulkdata/)