Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Operazione di esportazione dati FHIR R4 $davinci-data-export per HealthLake

L'$davinci-data-exportoperazione è un'operazione FHIR asincrona da cui è possibile esportare dati sanitari. AWS HealthLake Questa operazione supporta diversi tipi di esportazione, tra cui Member Attribution (ATR), PDex Provider Access e Member Access API. Payer-to-Payer È una versione specializzata del $export funzionamento standard FHIR, progettata per soddisfare i requisiti delle guide all'implementazione. DaVinci

Caratteristiche chiave

Operazione Endpoint

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

Parametri della richiesta

Tipi di risorsa supportati

I tipi di risorse supportati dipendono dal tipo di esportazione specificato. Per le esportazioni ATR, sono supportati i seguenti tipi di risorse:

Per le esportazioni PDex (Provider Access e Member Access), sono supportati tutti i tipi di risorse cliniche e relative ai reclami in aggiunta ai tipi precedenti. Payer-to-Payer Per un elenco completo dei tipi di risorse supportati, consulta la US Core Implementation Guide (STU 6.1), la CARIN Blue Button Implementation Guide e la Da Vinci Prior Authorization Support Implementation Guide.

Tipi di esportazione

L'$davinci-data-exportoperazione supporta i seguenti tipi di esportazione. È possibile specificare il tipo di esportazione utilizzando il exportType parametro.

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

Con il tipo di esportazione ATR, puoi esportare i dati della Member Attribution List. Utilizzate questo tipo di esportazione per recuperare risorse relative all'attribuzione per i membri di un gruppo. Per ulteriori informazioni, consulta l'operazione di esportazione ATR Da Vinci.

Tipi di esportazione PDex

Tutti i tipi di esportazione PDex condividono gli stessi profili e la stessa logica di filtraggio supportati. Per ulteriori informazioni, consulta l'API Da Vinci PDex Provider Access. Sono supportati i seguenti profili:

Per le esportazioni di PDex, le risorse cliniche e relative ai reclami vengono scoperte automaticamente per ogni paziente del Gruppo. Non è necessario fare riferimento esplicito a queste risorse nella risorsa del Gruppo. L'operazione cerca tutte le risorse relative al comparto pazienti (ad esempioObservation,,, Condition Coverage RelatedPersonMedicationRequest, eExplanationOfBenefit) che appartengono ai pazienti attribuiti. Solo i tipi di ATR (PatientGroup,,,) non riferiti al compartimento dei pazienti richiedono riferimenti espliciti nel Practitioner GruppoPractitionerRole. Organization Location

Logica di supporto e inclusione del profilo

Per le esportazioni PDex, l'$davinci-data-exportoperazione utilizza le dichiarazioni di profilo nell'meta.profileelemento per determinare quali risorse includere nell'esportazione.

ExplanationOfBenefit Gestione delle risorse

ExplanationOfBenefitLe risorse (EOB) sono incluse o escluse dalle esportazioni PDex in base alle relative meta.profile dichiarazioni:

Trasformazione dei dati finanziari

Una volta impostata_includeEOB2xWoFinancial=true, l'operazione trasforma le ExplanationOfBenefit risorse CARIN BB 2.x nei profili Basis corrispondenti rimuovendo i dati finanziari. Ad esempio, una C4BB ExplanationOfBenefit Oral risorsa viene trasformata inC4BB ExplanationOfBenefit Oral Basis, il che rimuove i dati finanziari dal record in base alla specifica FHIR.

L'operazione rimuove i seguenti elementi di dati finanziari in due scenari: quando trasforma una risorsa CARIN BB 2.x Financial nel relativo profilo Basis (utilizzando_includeEOB2xWoFinancial=true) e quando rimuove i dati finanziari residui da una risorsa CARIN BB 2.x Basis:

L'operazione aggiorna anche i metadati del profilo durante la trasformazione:

Regole di rilevamento del profilo

L'operazione utilizza le seguenti regole per rilevare e convalidare i profili:

Filtraggio temporale per le esportazioni PDex

HealthLake applica un filtro temporale di 5 anni per i tipi di esportazione Payer-to-Payer (hl7.fhir.us.davinci-pdex.p2p) e Member Access (). hl7.fhir.us.davinci-pdex.member Il filtro si basa sulla data dell'ultimo aggiornamento della risorsa. I tipi di esportazione di Provider Access (hl7.fhir.us.davinci-pdexehl7.fhir.us.davinci-pdex#provider-snapshot) non sono soggetti ad alcun limite temporale. Per i tipi di esportazione con limitazioni temporali, il filtro si applica a tutte le risorse ad eccezione dei seguenti tipi di risorse di attribuzione principali, che vengono sempre esportati indipendentemente dall'età:

Queste risorse amministrative e demografiche sono esenti perché forniscono un contesto essenziale per i dati esportati. Le esportazioni ATR non sono soggette ad alcun filtro temporale.

Richieste di esempio

Gli esempi seguenti mostrano come avviare processi di esportazione per diversi tipi di esportazione.

Esportazione 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"
    }
  }
}

Esportazione di Provider Access con ExplanationOfBenefit rimozione dei dati finanziari

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

Esportazione di istantanee di Provider Ac

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 esportazione

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

Esportazione di Member Access per un paziente specifico

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

Risposta di esempio

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

Relazioni con le risorse

L'operazione esporta le risorse in base alle loro relazioni all'interno dell'Elenco di attribuzione dei membri:

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

Fonti di risorse

Gestione del Job

Ciclo di vita del processo

Formato di output

Gestione errori

L'operazione restituisce HTTP 400 Bad Request con un OperationOutcome per le seguenti condizioni:

Sicurezza e autorizzazione

$davinci-data-exportè un'operazione di backend in blocco autorizzata tramite autorizzazioni IAM o ambiti SMART on FHIR (OAuth 2.0) a livello di sistema; le richieste che presentano ambiti a livello di paziente o utente vengono rifiutate. L'operazione non valuta le risorse FHIR Consent per filtrare o limitare i dati esportati.

Best practice

Limitazioni

Risorse aggiuntive