Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Funcionamiento FHIR R4 `$davinci-data-export` para HealthLake La `$davinci-data-export` operación es una operación FHIR asíncrona desde la que puede exportar datos de atención médica. AWS HealthLake Esta operación admite varios tipos de exportación, como la atribución de miembros (ATR), el acceso a PDex proveedores y el acceso a miembros. Payer-to-Payer APIs Es una versión especializada de la `$export` operación estándar del FHIR, diseñada para cumplir con los requisitos de las guías de DaVinci implementación. ## Características principales de + *Procesamiento asíncrono*: sigue el patrón estándar de solicitudes asíncronas del FHIR + Exportación a *nivel de grupo: exporta los datos de los miembros de un recurso grupal* específico + *Múltiples tipos de exportación*: admite ATR (atribución de miembros), acceso a PDex proveedores y Payer-to-Payer acceso a miembros APIs + *Soporte integral de perfiles*: incluye US Core, CARIN Blue Button y PDex perfiles + *Filtrado flexible*: admite el filtrado por pacientes, tipos de recursos y rangos de tiempo + *Salida NDJSON*: proporciona datos en formato JSON delimitado por líneas nuevas ## Punto final de la operación ``` GET [base]/Group/[id]/$davinci-data-export POST [base]/Group/[id]/$davinci-data-export ``` ## Parámetros de la solicitud | Parámetro | Cardinalidad | Description (Descripción) | | --- | --- | --- | | patient | 0.. \$1 | Miembros específicos cuyos datos se van a exportar. Si se omite, se exportan todos los miembros del grupo. | | \$1type | 0.1. | Lista delimitada por comas de los tipos de recursos del FHIR que se van a exportar. | | \$1since | 0.1 | Incluya únicamente los recursos actualizados después de esta fecha y hora. | | \$1until | 0.1.. | Incluya únicamente los recursos actualizados antes de esta fecha y hora. | | exportType | 0.1.. | Tipo de exportación que se va a realizar. 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. Predeterminado: hl7.fhir.us.davinci-atr. | | \$1includeEOB2xWoFinancial | 0.1.. | Especifica si se deben incluir los ExplanationOfBenefit recursos de CARIN BB 2.x sin datos financieros. Predeterminado: false. | ### Tipos de recursos admitidos Los tipos de recursos admitidos dependen del tipo de exportación que especifique. Para las exportaciones ATR, se admiten los siguientes tipos de recursos: + `Group` + `Patient` + `Coverage` + `RelatedPerson` + `Practitioner` + `PractitionerRole` + `Organization` + `Location` Para PDex las exportaciones (Provider Access y Member Access), se admiten todos los tipos de recursos clínicos y de reclamaciones, además de los tipos anteriores. Payer-to-Payer Para obtener una lista completa de los tipos de recursos compatibles, consulte la [Guía de implementación básica de EE. UU. (STU 6.1)](https://hl7.org/fhir/us/core/STU6.1/), la Guía de implementación de [CARIN Blue Button y la Guía de implementación](https://hl7.org/fhir/us/carin-bb/) del [soporte de autorización previa de Da Vinci](https://hl7.org/fhir/us/davinci-pas/). ## Tipos de exportación La `$davinci-data-export` operación admite los siguientes tipos de exportación. El tipo de exportación se especifica mediante el `exportType` parámetro. | Tipo de exportación | Finalidad | Alcance de los datos | Límite temporal | | --- | --- | --- | --- | | hl7.fhir.us.davinci-atr | Lista de atribuciones de miembros | Recursos relacionados con la atribución | Ninguno | | hl7.fhir.us.davinci-pdex | API de acceso para proveedores | Datos clínicos y de reclamaciones de los pacientes atribuidos | 5 años | | hl7.fhir.us.davinci-pdex.p2p | Payer-to-Payer Intercambio | Datos históricos de los miembros para las transiciones de seguros | 5 años | | hl7.fhir.us.davinci-pdex.member | API de acceso para miembros | Datos de salud propios del miembro | 5 años | **nota** En el caso de PDex las exportaciones, el límite temporal de 5 años no se aplica a los tipos de recursos ATR (`Group``Patient``Coverage`,`RelatedPerson`,`Practitioner`,`PractitionerRole`,`Organization`,`Location`). Estos recursos siempre se incluyen independientemente de la edad. ### ATR (hl7.fhir.us.davinci-atr) Con el tipo de exportación ATR, puedes exportar los datos de la lista de atribución de miembros. Usa este tipo de exportación para recuperar recursos relacionados con la atribución para los miembros de un grupo. Para obtener más información, consulte la operación de [exportación de ATR de Da Vinci](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html). Tipos de recursos admitidos `Group`, `Patient`, `Coverage`, `RelatedPerson`, `Practitioner`, `PractitionerRole`, `Organization`, `Location` Filtrado temporal No se aplica ningún filtrado temporal. Todos los recursos coincidentes se exportan independientemente de la fecha. ### PDex Tipos de exportación Todos los tipos de PDex exportación comparten los mismos perfiles compatibles y la misma lógica de filtrado. Para obtener más información, consulte la [API de Da Vinci PDex Provider Access](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html). Se admiten los siguientes perfiles: + US Core 3.1.1, 6.1.0 y 7.0.0 + PDex Autorización previa (no se admite para el acceso de los miembros) + Perfiles básicos de CARIN BB 2.x: pacientes hospitalizados, ambulatorios, institucionales, profesionales, orales, farmacéuticos NonClinician Acceso para proveedores () `hl7.fhir.us.davinci-pdex` Permite a los proveedores de la red recuperar los datos de los pacientes atribuidos. Payer-to-Payer (`hl7.fhir.us.davinci-pdex.p2p`) Permite el intercambio de datos entre los pagadores cuando un paciente cambia de seguro. Acceso de miembros () `hl7.fhir.us.davinci-pdex.member` Permite a los miembros acceder a sus propios datos de salud. Este tipo de exportación puede incluir datos financieros en los recursos de reclamaciones. ## Lógica de inclusión y soporte de perfiles En el caso de PDex las exportaciones, la `$davinci-data-export` operación utiliza declaraciones de perfil en el `meta.profile` elemento para determinar qué recursos incluir en la exportación. ### ExplanationOfBenefit Manejo de recursos `ExplanationOfBenefit`Los recursos (EOB) se incluyen o excluyen de PDex las exportaciones en función de sus `meta.profile` declaraciones: + ExplanationOfBenefit los recursos con un perfil CARIN BB 1.x se excluyen de la exportación. + ExplanationOfBenefit los recursos sin ningún `meta.profile` conjunto se excluyen de la exportación. + ExplanationOfBenefit siempre se incluyen los recursos con un perfil CARIN BB 2.x Basis. + ExplanationOfBenefit los recursos con un perfil CARIN BB 2.x que contiene datos financieros se excluyen de forma predeterminada. Cuando `_includeEOB2xWoFinancial=true` están configurados, se incluyen sin datos financieros y el recurso se transforma en el perfil base correspondiente. + ExplanationOfBenefit los recursos con un perfil de autorización PDex previa siempre se incluyen. ### Transformación de datos financieros Cuando se configura`_includeEOB2xWoFinancial=true`, la operación transforma los ExplanationOfBenefit recursos de [CARIN BB 2.x en](https://hl7.org/fhir/us/carin-bb/) sus perfiles básicos correspondientes mediante la eliminación de los datos financieros. Por ejemplo, un `C4BB ExplanationOfBenefit Oral` recurso se transforma en`C4BB ExplanationOfBenefit Oral Basis`, lo que elimina los datos financieros del registro según la especificación de la FHIR. Los siguientes elementos de datos financieros se eliminan durante la transformación: + Todos los elementos se dividen `total` + Todos los `adjudication` elementos con rebanada `amounttype` + Todos los `item.adjudication` elementos con información sobre el importe La operación también actualiza los metadatos del perfil durante la transformación: + `meta.profile`se actualiza a la URL canónica del perfil básico + La versión se ha actualizado a la versión básica CARIN BB 2.x + Los recursos existentes en el almacén de datos no se modifican + Los recursos exportados no se devuelven al almacén de datos ### Reglas de detección de perfiles La operación utiliza las siguientes reglas para detectar y validar los perfiles: + La detección de versiones se basa en la versión `meta.profile` canónica URLs + Se incluye un recurso si ALGUNO de sus perfiles declarados coincide con los criterios de exportación + La validación del perfil se produce durante el procesamiento de la exportación ## Filtrado temporal de cinco años para PDex las exportaciones Para todos los tipos de PDex exportación, HealthLake aplica un filtro temporal de 5 años en función de cuándo se actualizó el recurso por última vez. El filtro temporal se aplica a todos los recursos, excepto a los siguientes tipos de recursos de atribución principales, que siempre se exportan independientemente de su antigüedad: + `Patient` + `Coverage` + `Organization` + `Practitioner` + `PractitionerRole` + `RelatedPerson` + `Location` + `Group` Estos recursos administrativos y demográficos están exentos porque proporcionan un contexto esencial para los datos exportados. Las exportaciones de ATR no están sujetas a ningún filtrado temporal. ## Solicitudes de ejemplo Los siguientes ejemplos muestran cómo iniciar trabajos de exportación para diferentes tipos de exportación. *Exportación 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" } } } ``` *Exportación de Provider Access con eliminación de datos ExplanationOfBenefit financieros* ``` 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 ``` *Exportación de Member Access para un 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 ``` ## Respuesta de ejemplo ``` { "datastoreId": "eaee622d8406b41eb86c0f4741201ff9", "jobStatus": "SUBMITTED", "jobId": "48d7b91dae4a64d00d54b70862f33f61" } ``` ## Relaciones de recursos La operación exporta los recursos en función de sus relaciones dentro de la lista de atribuciones de miembros: ``` Group (Attribution List) ├── Patient (Members) ├── Coverage → RelatedPerson (Subscribers) ├── Practitioner (Attributed Providers) ├── PractitionerRole → Location └── Organization (Attributed Providers) ``` ### Fuentes de recursos | Recurso | Ubicación de la fuente | Description (Descripción) | | --- | --- | --- | | Patient | Group.member.entity | Los pacientes que son miembros de la lista de atribuciones | | Coverage | Group.member.extension:coverageReference | Cobertura que dio lugar a la afiliación de los pacientes | | Organization | Group.member.extension:attributedProvider | Organizaciones a las que se atribuyen los pacientes | | Practitioner | Group.member.extension:attributedProvider | Profesionales individuales a los que se atribuyen los pacientes | | PractitionerRole | Group.member.extension:attributedProvider | Funciones de los profesionales a las que se atribuyen los pacientes | | RelatedPerson | Coverage.subscriber | Suscriptores de la cobertura | | Location | PractitionerRole.location | Ubicaciones asociadas a las funciones de los profesionales | | Group | Punto final de entrada | La propia lista de atribuciones | ## Gestión de trabajos Comprobar el estado del trabajo `GET [base]/export/[job-id]` Cancelar trabajo `DELETE [base]/export/[job-id]` ### Ciclo de vida del trabajo + `SUBMITTED`- Se ha recibido el trabajo y se ha puesto en cola + `IN_PROGRESS`- Job se está procesando activamente + `COMPLETED`- Job finalizado correctamente, archivos disponibles para descargar + `FAILED`- El trabajo encontró un error ## Output Format (Formato de salida) + *Formato de archivo*: NDJSON (JSON delimitado por nueva línea) + *Organización de archivos*: archivos separados para cada tipo de recurso + *Extensión de archivo*: .ndjson + *Ubicación: depósito* y ruta de S3 especificados ## Gestión de errores La operación devuelve una solicitud incorrecta de HTTP 400 con un valor OperationOutcome para las siguientes condiciones: Errores de autorización La función de IAM especificada en `DataAccessRoleArn` no tiene permisos suficientes para realizar la operación de exportación. Para ver la lista completa de los permisos de S3 y KMS necesarios, consulte [Configurar los permisos para los trabajos de exportación](getting-started-setting-up.md#setting-up-export-permissions). Errores de validación de parámetros + El `patient` parámetro no tiene el formato `Patient/id,Patient/id,...` + Una o más referencias de pacientes no son válidas o no pertenecen al grupo especificado + El valor del `exportType` parámetro no es un tipo de exportación compatible + El `_type` parámetro contiene tipos de recursos que no son compatibles con el tipo de exportación especificado + En el `_type` parámetro faltan los tipos de recursos necesarios (`Group`,`Patient`,`Coverage`) para el tipo de `hl7.fhir.us.davinci-atr` exportación + El valor del `_includeEOB2xWoFinancial` parámetro no es un booleano válido Errores de validación de recursos + El recurso de grupo especificado no existe en el banco de datos + El recurso de grupo especificado no tiene miembros + Uno o más miembros del grupo hacen referencia a recursos para pacientes que no existen en el almacén de datos ## Seguridad y autorización + Se aplican los mecanismos de autorización estándar del FHIR + La función de acceso a los datos debe tener los permisos de IAM necesarios para las operaciones de S3 y KMS. Para ver la lista completa de los permisos necesarios, consulte [Configurar los permisos para los trabajos de exportación](getting-started-setting-up.md#setting-up-export-permissions). ## Prácticas recomendadas + *Selección del tipo de recurso*: solicite únicamente los tipos de recursos que necesite para minimizar el tamaño de la exportación y el tiempo de procesamiento + *Filtrado basado en el tiempo*: utilice el `_since` parámetro para exportaciones incrementales + *Filtrado de pacientes*: utilice el `patient` parámetro cuando solo necesite datos de miembros específicos + *Supervisión del trabajo*: compruebe periódicamente el estado del trabajo para grandes exportaciones + *Gestión de errores*: Implemente la lógica de reintento adecuada para los trabajos fallidos + *Conocimiento del filtro temporal*: para PDex las exportaciones, tenga en cuenta el filtro temporal de 5 años al seleccionar los tipos de recursos + *Eliminación de datos financieros*: `_includeEOB2xWoFinancial=true` utilícelo cuando necesite datos de reclamaciones sin información financiera + *Gestión de perfiles*: asegúrese de que los recursos cuenten con las declaraciones de perfil adecuadas, compárelos con los perfiles de destino antes de su ingestión y utilice el control de versiones de los perfiles para controlar el comportamiento de exportación ## Limitaciones + Se puede especificar un máximo de 500 pacientes en el parámetro `patient` + La exportación se limita únicamente a las operaciones a nivel de grupo + Solo admite el conjunto predefinido de tipos de recursos para cada tipo de exportación + La salida siempre está en formato NDJSON + PDex las exportaciones están limitadas a 5 años de datos clínicos y de reclamaciones + La transformación de datos financieros solo se aplica a los perfiles CARIN BB 2.x ExplanationOfBenefit ## Recursos adicionales + [Lista de atribuciones de miembros de Da Vinci (IG)](https://build.fhir.org/ig/HL7/davinci-atr/) + [Intercambio de datos de jugadores Da Vinci IG](https://hl7.org/fhir/us/davinci-pdex/) + [Sistema de intercambio de datos de pagadores dirigido al consumidor de CARIN](https://build.fhir.org/ig/HL7/carin-bb/) + [Guía de implementación básica de EE. UU.](https://www.hl7.org/fhir/us/core/) + [Especificación de acceso masivo a datos del FHIR](https://hl7.org/fhir/uv/bulkdata/)