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 de exportação de dados FHIR R4 $davinci-data-export para 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 APIs de Atribuição de Membros (ATR), PDex Provider Access e Member Access. Payer-to-Payer É 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

Ponto final da operação

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

Parâmetros da solicitação

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:

Para exportações de PDex (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 oferece suporte aos seguintes tipos de exportação. Você especifica o tipo de exportação usando o exportType parâmetro.

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 exportação PDex

Todos os tipos de exportação PDex 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:

Para exportações de PDex, os recursos clínicos e de sinistros são descobertos automaticamente para cada paciente do Grupo. Você não precisa referenciar explicitamente esses recursos no recurso do Grupo. A operação busca todos os recursos do compartimento do paciente (comoObservation,,Condition, Coverage RelatedPersonMedicationRequest, eExplanationOfBenefit) que pertencem aos pacientes atribuídos. Somente Patient os tipos de ATR que não são do compartimento do paciente (Practitioner,, PractitionerRoleOrganization,Location) exigem referências explícitas no Grupo. Group

Suporte de perfil e lógica de inclusão

Para exportações de PDex, 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 das exportações do PDex com base em suas meta.profile declarações:

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.

A operação remove os seguintes elementos de dados financeiros em dois cenários: quando transforma um recurso financeiro do CARIN BB 2.x em seu perfil Basis (usando_includeEOB2xWoFinancial=true) e quando remove dados financeiros residuais de um recurso do CARIN BB 2.x Basis:

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

Regras de detecção de perfil

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

Filtragem temporal para exportações PDex

HealthLake aplica um filtro temporal de 5 anos para os tipos de exportação Payer-to-Payer (hl7.fhir.us.davinci-pdex.p2p) e Member Access (hl7.fhir.us.davinci-pdex.member). O filtro é baseado em quando o recurso foi atualizado pela última vez. Os tipos de exportação (hl7.fhir.us.davinci-pdexehl7.fhir.us.davinci-pdex#provider-snapshot) do Provider Access não estão sujeitos a nenhum limite temporal. Para os tipos de exportação temporalmente limitados, o filtro se aplica a todos os recursos, exceto aos seguintes tipos principais de recursos de atribuição, que são sempre exportados independentemente da idade:

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

Exportação instantânea do Provider Access

GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?exportType=hl7.fhir.us.davinci-pdex%23provider-snapshot

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

Gestão de Job

Ciclo de vida da tarefa

Output Format

Tratamento de erros

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

Segurança e autorização

$davinci-data-exporté uma operação em massa de back-end autorizada por meio de permissões do IAM ou SMART em nível de sistema em escopos FHIR (OAuth 2.0); solicitações que apresentam escopos em nível de paciente ou usuário são rejeitadas. A operação não avalia os recursos de consentimento do FHIR para filtrar ou restringir os dados exportados.

Práticas recomendadas

Limitações

Recursos adicionais