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:
GroupPatientCoverageRelatedPersonPractitionerPractitionerRoleOrganizationLocation
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)
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
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.profileconjunto 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=trueestá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 enC4BB 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
totalTodos los
adjudicationelementos con rebanadaamounttypeTodos los
item.adjudicationelementos 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ásicoLa 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.profilecanónica URLsSe 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:
PatientCoverageOrganizationPractitionerPractitionerRoleRelatedPersonLocationGroup
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 colaIN_PROGRESS- Job se está procesando activamenteCOMPLETED- Job finalizado correctamente, archivos disponibles para descargarFAILED- 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
DataAccessRoleArnno 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
patientparámetro no tiene el formatoPatient/id,Patient/id,...Una o más referencias de pacientes no son válidas o no pertenecen al grupo especificado
El valor del
exportTypeparámetro no es un tipo de exportación compatibleEl
_typeparámetro contiene tipos de recursos que no son compatibles con el tipo de exportación especificadoEn el
_typeparámetro faltan los tipos de recursos necesarios (Group,Patient,Coverage) para el tipo dehl7.fhir.us.davinci-atrexportaciónEl valor del
_includeEOB2xWoFinancialpará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
_sinceparámetro para exportaciones incrementalesFiltrado de pacientes: utilice el
patientparámetro cuando solo necesite datos de miembros específicosSupervisió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=trueutilícelo cuando necesite datos de reclamaciones sin información financieraGestió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
patientLa 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