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-export`operazione è 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.. \$1 | Membri specifici di cui esportare i dati. Se omesso, tutti i membri del Gruppo vengono esportati. | | \$1type | 0.1. | Elenco delimitato da virgole di tipi di risorse FHIR da esportare. | | \$1since | 0.1.. | Includi solo le risorse aggiornate dopo questa data e ora. | | \$1until | 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. | | \$1includeEOB2xWoFinancial | 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)](https://hl7.org/fhir/us/core/STU6.1/), la [CARIN Blue Button Implementation Guide](https://hl7.org/fhir/us/carin-bb/) e la [Da Vinci Prior Authorization Support](https://hl7.org/fhir/us/davinci-pas/) Implementation Guide. ## Tipi di esportazione L'`$davinci-data-export`operazione 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`, `Practitioner``PractitionerRole`,`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](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html). 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](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html). 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-export`operazione utilizza le dichiarazioni di profilo nell'`meta.profile`elemento per determinare quali risorse includere nell'esportazione. ### ExplanationOfBenefit Gestione delle risorse `ExplanationOfBenefit`Le 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](https://hl7.org/fhir/us/carin-bb/) nei profili Basis corrispondenti rimuovendo i dati finanziari. Ad esempio, una `C4BB ExplanationOfBenefit Oral` risorsa viene trasformata in`C4BB 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.profile`viene 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](getting-started-setting-up.md#setting-up-export-permissions) 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](getting-started-setting-up.md#setting-up-export-permissions) 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 + [Elenco di attribuzione dei soci Da Vinci IG](https://build.fhir.org/ig/HL7/davinci-atr/) + [Da Vinci Payer Data Exchange IG](https://hl7.org/fhir/us/davinci-pdex/) + [IG CARIN Consumer Directed Payer Data Exchange](https://build.fhir.org/ig/HL7/carin-bb/) + [Guida all'implementazione di base negli Stati Uniti](https://www.hl7.org/fhir/us/core/) + [Specifiche FHIR Bulk Data Access](https://hl7.org/fhir/uv/bulkdata/)