Funzionamento FHIR R4 $davinci-data-export per HealthLake - AWS HealthLake
Caratteristiche chiaveOperazione EndpointParametri della richiestaTipi di esportazioneLogica di supporto e inclusione del profiloFiltraggio temporale quinquennale per le esportazioni PDexRichieste di esempioRisposta di esempioRelazioni con le risorseGestione del JobFormato di outputGestione erroriSicurezza e autorizzazioneBest practiceLimitazioniRisorse aggiuntive

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à.

Funzionamento 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. Payer-to-Payer APIs È una versione specializzata del $export funzionamento standard FHIR, progettata per soddisfare i requisiti delle guide all'implementazione. DaVinci

Caratteristiche chiave

  • Elaborazione asincrona: segue lo schema di richiesta asincrona FHIR standard

  • Esportazione a livello di gruppo: esporta i dati per i membri all'interno di una specifica risorsa del gruppo

  • Diversi tipi di esportazione: supporta ATR (Member Attribution), PDex Provider Access e Member Access Payer-to-Payer APIs

  • Profile Support completo: include US Core, CARIN Blue Button e PDex profili

  • Filtraggio flessibile: supporta il filtraggio per pazienti, tipi di risorse e intervalli di tempo

  • Output NDJSON: fornisce dati in formato JSON delimitato da nuove righe

Operazione Endpoint

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

Parametri della richiesta

Parametro Cardinalità Description
patient 0.. * Membri specifici di cui esportare i dati. Se omesso, tutti i membri del Gruppo vengono esportati.
_type 0.1. Elenco delimitato da virgole di tipi di risorse FHIR da esportare.
_since 0.1.. Includi solo le risorse aggiornate dopo questa data e ora.
_until 0.1.. Includi solo le risorse aggiornate prima di questa data e ora.
exportType 0.1.. Tipo di esportazione da eseguire. Valori validi: hl7.fhir.us.davinci-atr, hl7.fhir.us.davinci-pdex, hl7.fhir.us.davinci-pdex.p2p, hl7.fhir.us.davinci-pdex.member. Default: hl7.fhir.us.davinci-atr.
_includeEOB2xWoFinancial 0.1. Specifica se includere le ExplanationOfBenefit risorse CARIN BB 2.x con i dati finanziari rimossi. Default: false.

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:

  • Group

  • Patient

  • Coverage

  • RelatedPerson

  • Practitioner

  • PractitionerRole

  • Organization

  • Location

Per PDex le esportazioni (Provider Access e Member Access), oltre ai tipi precedenti, sono supportati tutti i tipi di risorse cliniche e relative ai reclami. 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.

Tipo di esportazione Scopo Ambito dei dati Limite temporale
hl7.fhir.us.davinci-atr Elenco di attribuzione dei membri Risorse relative all'attribuzione Nessuno
hl7.fhir.us.davinci-pdex API Provider Access Dati clinici e relativi ai reclami relativi ai pazienti attribuiti 5 anni
hl7.fhir.us.davinci-pdex.p2p Payer-to-Payer Scambio Dati storici dei membri per le transizioni assicurative 5 anni
hl7.fhir.us.davinci-pdex.member API di accesso ai membri Dati sanitari propri del socio 5 anni
Nota

Per PDex le esportazioni, il limite temporale di 5 anni non si applica ai tipi di risorse ATR (Group,,Patient,Coverage,RelatedPerson, PractitionerPractitionerRole,Organization). Location Queste risorse sono sempre incluse indipendentemente dall'età.

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 risorsa supportati

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

Filtraggio temporale

Non viene applicato alcun filtro temporale. Tutte le risorse corrispondenti vengono esportate indipendentemente dalla data.

PDex Tipi di esportazione

Tutti i tipi di PDex esportazione 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:

  • US Core 3.1.1, 6.1.0 e 7.0.0

  • PDex Autorizzazione preventiva (non supportata per l'accesso ai membri)

  • CARIN BB 2.x Profili di base: ospedaliero istituzionale, ambulatoriale istituzionale, professionale NonClinician, orale, farmaceutico

Accesso al fornitore () hl7.fhir.us.davinci-pdex

Consente ai provider in rete di recuperare i dati dei pazienti per i pazienti attribuiti.

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

Consente lo scambio di dati tra i pagatori quando un paziente cambia assicurazione.

Accesso per i membri () hl7.fhir.us.davinci-pdex.member

Consente ai membri di accedere ai propri dati sanitari. Questo tipo di esportazione può includere dati finanziari nelle risorse relative ai reclami.

Logica di supporto e inclusione del profilo

Per PDex le esportazioni, 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 PDex esportazioni in base alle loro meta.profile dichiarazioni:

  • ExplanationOfBenefit le risorse con un profilo CARIN BB 1.x sono escluse dall'esportazione.

  • ExplanationOfBenefit le risorse senza meta.profile set sono escluse dall'esportazione.

  • ExplanationOfBenefit le risorse con un profilo CARIN BB 2.x Basis sono sempre incluse.

  • ExplanationOfBenefit le risorse con un profilo CARIN BB 2.x che contiene dati finanziari sono escluse per impostazione predefinita. Quando _includeEOB2xWoFinancial=true è impostato, vengono incluse con i dati finanziari rimossi e la risorsa viene trasformata nel profilo Basis corrispondente.

  • ExplanationOfBenefit le risorse con un profilo di autorizzazione PDex preventiva sono sempre incluse.

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.

I seguenti elementi di dati finanziari vengono rimossi durante la trasformazione:

  • Tutte le suddivisioni sugli elementi total

  • Tutti gli adjudication elementi con slice amounttype

  • Tutti gli item.adjudication elementi con informazioni sulla quantità

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

  • meta.profileviene aggiornato all'URL canonico del profilo Basis

  • La versione è aggiornata alla versione CARIN BB 2.x Basis

  • Le risorse esistenti nell'archivio dati non vengono modificate

  • Le risorse esportate non vengono salvate in modo persistente nell'archivio dati

Regole di rilevamento del profilo

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

  • Il rilevamento della versione si basa sul codice canonico meta.profile URLs

  • Una risorsa viene inclusa se UNO QUALSIASI dei suoi profili dichiarati soddisfa i criteri di esportazione

  • La convalida del profilo avviene durante l'elaborazione dell'esportazione

Filtraggio temporale quinquennale per le esportazioni PDex

Per tutti i tipi di PDex esportazione, HealthLake applica un filtro temporale di 5 anni basato sull'ultimo aggiornamento della risorsa. Il filtro temporale si applica a tutte le risorse ad eccezione dei seguenti tipi di risorse di attribuzione principali, che vengono sempre esportati indipendentemente dall'età:

  • Patient

  • Coverage

  • Organization

  • Practitioner

  • PractitionerRole

  • RelatedPerson

  • Location

  • Group

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

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

Risorsa Ubicazione della fonte Description
Patient Group.member.entity I pazienti che sono membri della lista di attribuzione
Coverage Group.member.extension:coverageReference Copertura che ha portato all'iscrizione dei pazienti
Organization Group.member.extension:attributedProvider Organizzazioni a cui vengono attribuiti i pazienti
Practitioner Group.member.extension:attributedProvider Professionisti individuali a cui vengono attribuiti i pazienti
PractitionerRole Group.member.extension:attributedProvider Ruoli professionali a cui vengono attribuiti i pazienti
RelatedPerson Coverage.subscriber Abbonati alla copertura
Location PractitionerRole.location Sedi associate ai ruoli professionali
Group Endpoint di input La lista di attribuzione stessa

Gestione del Job

Verifica lo stato del lavoro

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

Annullamento di un processo

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

Ciclo di vita del processo

  • SUBMITTED- Il lavoro è stato ricevuto e messo in coda

  • IN_PROGRESS- Job è in fase di elaborazione attiva

  • COMPLETED- Job terminato con successo, file disponibili per il download

  • FAILED- Job ha riscontrato un errore

Formato di output

  • Formato di file: NDJSON (Newline Delimited JSON)

  • Organizzazione dei file: file separati per ogni tipo di risorsa

  • Estensione del file: .ndjson

  • Posizione: bucket e percorso S3 specificati

Gestione errori

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

Errori di autorizzazione

Il ruolo IAM specificato in DataAccessRoleArn non dispone di autorizzazioni sufficienti per eseguire l'operazione di esportazione. Per l'elenco completo delle autorizzazioni S3 e KMS richieste, consulta Configurazione delle autorizzazioni per i lavori di esportazione.

Errori di convalida dei parametri

  • Il patient parametro non è formattato come Patient/id,Patient/id,...

  • Uno o più riferimenti ai pazienti non sono validi o non appartengono al gruppo specificato

  • Il valore del exportType parametro non è un tipo di esportazione supportato

  • Il _type parametro contiene tipi di risorse che non sono supportati per il tipo di esportazione specificato

  • Nel _type parametro mancano i tipi di risorse richiesti (Group,Patient,Coverage) per il tipo di hl7.fhir.us.davinci-atr esportazione

  • Il valore del _includeEOB2xWoFinancial parametro non è un valore booleano valido

Errori di convalida delle risorse

  • La risorsa di gruppo specificata non esiste nell'archivio dati

  • La risorsa di gruppo specificata non ha membri

  • Uno o più membri del gruppo fanno riferimento a risorse per i pazienti che non esistono nell'archivio dati

Sicurezza e autorizzazione

  • Si applicano i meccanismi di autorizzazione FHIR standard

  • Il ruolo di accesso ai dati deve disporre delle autorizzazioni IAM richieste per le operazioni S3 e KMS. Per l'elenco completo delle autorizzazioni richieste, consulta Configurazione delle autorizzazioni per i lavori di esportazione.

Best practice

  • Selezione del tipo di risorsa: richiedete solo i tipi di risorse necessari per ridurre al minimo le dimensioni di esportazione e i tempi di elaborazione

  • Filtraggio basato sul tempo: utilizza il _since parametro per le esportazioni incrementali

  • Filtraggio dei pazienti: utilizza il patient parametro quando sono necessari solo i dati per membri specifici

  • Job Monitoring: controlla regolarmente lo stato del lavoro per esportazioni di grandi dimensioni

  • Gestione degli errori: Implementa una logica di ripetizione corretta per i lavori non riusciti

  • Consapevolezza del filtro temporale: per PDex le esportazioni, considera il filtro temporale quinquennale quando selezioni i tipi di risorse

  • Rimozione dei dati finanziari: da utilizzare _includeEOB2xWoFinancial=true quando sono necessari i dati relativi ai reclami senza informazioni finanziarie

  • Gestione dei profili: assicurati che le risorse dispongano di dichiarazioni di profilo appropriate, esegui la convalida rispetto ai profili di destinazione prima dell'ingestione e utilizza il controllo delle versioni dei profili per controllare il comportamento di esportazione

Limitazioni

  • Nel parametro è possibile specificare un massimo di 500 pazienti patient

  • L'esportazione è limitata alle sole operazioni a livello di gruppo

  • Supporta solo il set predefinito di tipi di risorse per ogni tipo di esportazione

  • L'output è sempre in formato NDJSON

  • PDex le esportazioni sono limitate a 5 anni di dati clinici e relativi ai reclami

  • La trasformazione dei dati finanziari si applica solo ai profili CARIN BB 2.x ExplanationOfBenefit

Risorse aggiuntive