View a markdown version of this page

Funcionamiento FHIR R4 $davinci-data-export para HealthLake - AWS HealthLake

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.. * Miembros específicos cuyos datos se van a exportar. Si se omite, se exportan todos los miembros del grupo.
_type 0.1. Lista delimitada por comas de los tipos de recursos del FHIR que se van a exportar.
_since 0.1 Incluya únicamente los recursos actualizados después de esta fecha y hora.
_until 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.
_includeEOB2xWoFinancial 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), la Guía de implementación de CARIN Blue Button y la Guía de implementación del soporte de autorización previa de Da Vinci.

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 (GroupPatientCoverage,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.

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

ExplanationOfBenefitLos 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 sus perfiles básicos correspondientes mediante la eliminación de los datos financieros. Por ejemplo, un C4BB ExplanationOfBenefit Oral recurso se transforma enC4BB 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.profilese 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.

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.

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