$questionnaire-packageOperación FHIR para HealthLake

La $questionnaire-package operación recupera un paquete completo que contiene un cuestionario del FHIR y todas sus dependencias necesarias para procesar y procesar el cuestionario. Esta operación implementa la Guía de implementación de las plantillas y reglas de documentación (DTR) de Da Vinci, que permite la representación dinámica de los formularios para los requisitos de documentación en los flujos de trabajo de atención médica.

Funcionamiento

Casos de uso

Punto de conexión de la API

POST /datastore/{datastoreId}/r4/Questionnaire/$questionnaire-package  
Content-Type: application/fhir+json

Parámetros de solicitud

Parámetros de entrada

El cuerpo de la solicitud debe contener un recurso de parámetros del FHIR con los siguientes parámetros:

Reglas de validación de parámetros

Debe proporcionarse al menos UNO de los siguientes datos (además de los obligatorioscoverage):

Combinaciones de solicitudes válidas:

Ejemplo de solicitud

POST /datastore/example-datastore/r4/Questionnaire/$questionnaire-package  
Content-Type: application/fhir+json  
Authorization: Bearer <your-token>  
  
{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": {  
        "resourceType": "Coverage",  
        "id": "example-coverage",  
        "status": "active",  
        "beneficiary": {  
          "reference": "Patient/example-patient"  
        },  
        "payor": [{  
          "reference": "Organization/example-payer"  
        }],  
        "class": [{  
          "type": {  
            "coding": [{  
              "system": "http://terminology.hl7.org/CodeSystem/coverage-class",  
              "code": "group"  
            }]  
          },  
          "value": "12345"  
        }]  
      }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/home-oxygen-therapy|2.0"  
    },  
    {  
      "name": "order",  
      "resource": {  
        "resourceType": "ServiceRequest",  
        "id": "example-service-request",  
        "status": "active",  
        "intent": "order",  
        "code": {  
          "coding": [{  
            "system": "http://www.ama-assn.org/go/cpt",  
            "code": "94660",  
            "display": "Continuous positive airway pressure ventilation (CPAP)"  
          }]  
        },  
        "subject": {  
          "reference": "Patient/example-patient"  
        }  
      }  
    },  
    {  
      "name": "changedSince",  
      "valueDateTime": "2024-01-01T00:00:00Z"  
    }  
  ]  
}

Formato de las respuestas

Respuesta correcta (200 OK)

La operación devuelve un recurso de parámetros FHIR que contiene uno o más Package Bundles. Cada Package Bundle incluye:

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "PackageBundle",  
      "resource": {  
        "resourceType": "Bundle",  
        "id": "questionnaire-package-example",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle"]  
        },  
        "type": "collection",  
        "timestamp": "2024-03-15T10:30:00Z",  
        "entry": [  
          {  
            "fullUrl": "http://example.org/fhir/Questionnaire/home-oxygen-therapy",  
            "resource": {  
              "resourceType": "Questionnaire",  
              "id": "home-oxygen-therapy",  
              "url": "http://example.org/fhir/Questionnaire/home-oxygen-therapy",  
              "version": "2.0",  
              "status": "active",  
              "title": "Home Oxygen Therapy Documentation",  
              "item": [  
                {  
                  "linkId": "1",  
                  "text": "Patient diagnosis",  
                  "type": "choice",  
                  "answerValueSet": "http://example.org/fhir/ValueSet/oxygen-diagnoses"  
                }  
              ]  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/Library/oxygen-prepopulation",  
            "resource": {  
              "resourceType": "Library",  
              "id": "oxygen-prepopulation",  
              "url": "http://example.org/fhir/Library/oxygen-prepopulation",  
              "version": "1.0",  
              "type": {  
                "coding": [{  
                  "system": "http://terminology.hl7.org/CodeSystem/library-type",  
                  "code": "logic-library"  
                }]  
              },  
              "content": [{  
                "contentType": "text/cql",  
                "data": "bGlicmFyeSBPeHlnZW5QcmVwb3B1bGF0aW9u..."  
              }]  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/ValueSet/oxygen-diagnoses",  
            "resource": {  
              "resourceType": "ValueSet",  
              "id": "oxygen-diagnoses",  
              "url": "http://example.org/fhir/ValueSet/oxygen-diagnoses",  
              "status": "active",  
              "expansion": {  
                "timestamp": "2024-03-15T10:30:00Z",  
                "contains": [  
                  {  
                    "system": "http://hl7.org/fhir/sid/icd-10",  
                    "code": "J44.0",  
                    "display": "COPD with acute lower respiratory infection"  
                  },  
                  {  
                    "system": "http://hl7.org/fhir/sid/icd-10",  
                    "code": "J96.01",  
                    "display": "Acute respiratory failure with hypoxia"  
                  }  
                ]  
              }  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/QuestionnaireResponse/example-prepopulated",  
            "resource": {  
              "resourceType": "QuestionnaireResponse",  
              "id": "example-prepopulated",  
              "questionnaire": "http://example.org/fhir/Questionnaire/home-oxygen-therapy|2.0",  
              "status": "in-progress",  
              "subject": {  
                "reference": "Patient/example-patient"  
              },  
              "basedOn": [{  
                "reference": "ServiceRequest/example-service-request"  
              }],  
              "item": [  
                {  
                  "linkId": "1",  
                  "text": "Patient diagnosis",  
                  "answer": [{  
                    "valueCoding": {  
                      "system": "http://hl7.org/fhir/sid/icd-10",  
                      "code": "J44.0",  
                      "display": "COPD with acute lower respiratory infection"  
                    }  
                  }]  
                }  
              ]  
            }  
          }  
        ]  
      }  
    },  
    {  
      "name": "Outcome",  
      "resource": {  
        "resourceType": "OperationOutcome",  
        "issue": [{  
          "severity": "information",  
          "code": "informational",  
          "details": {  
            "text": "Successfully retrieved questionnaire package"  
          }  
        }]  
      }  
    }  
  ]  
}

Flujo de trabajo operativo

¿Cómo HealthLake procesa su solicitud

Cuando llames$questionnaire-package, HealthLake realiza los siguientes pasos:

Resultado: un paquete completo e independiente listo para renderizarse.

Respuestas de error

400: solicitud maligna

Se devuelve cuando la validación de la solicitud falla.

{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "error",  
    "code": "required",  
    "details": {  
      "text": "At least one of 'questionnaire' or 'order' must be provided along with 'coverage'"  
    }  
  }]  
}

4.2.4 Dependencia fallida

Se devuelve cuando no se puede recuperar un recurso dependiente.

{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "warning",  
    "code": "not-found",  
    "details": {  
      "text": "Referenced Library 'http://example.org/fhir/Library/missing-library' could not be retrieved"  
    }  
  }]  
}

401 sin autorización

Se devuelve cuando faltan credenciales de autenticación o no son válidas.

403: prohibido

Se devuelve cuando el usuario autenticado no tiene permiso para acceder a los recursos solicitados.

406 No es aceptable

Se devuelve cuando no se puede proporcionar el tipo de contenido solicitado.

Conflicto, 409

Se devuelve cuando hay un conflicto de versiones o de simultaneidad.

410 Se ha ido

Se devuelve cuando el recurso solicitado se ha eliminado permanentemente.

429 Demasiadas solicitudes

Se devuelve cuando se superan los límites de velocidad.

500 Error de servidor interno

Se devuelve cuando se produce un error inesperado en el servidor.

501 No implementado

Se devuelve cuando la operación solicitada aún no está implementada.

Reglas de validación

Validación de entradas

QuestionnaireResponse validación

Deduplicación de recursos

Especificaciones de rendimiento

Permisos necesarios

Para utilizar la $questionnaire-package operación, asegúrese de que su función de IAM tenga:

SMART en FHIR Scopes

Alcances mínimos requeridos:

Notas importantes sobre la implementación

Estrategia de recuperación de recursos

Prioridad de identificación del cuestionario:

Resolución de dependencias

Bibliotecas CQL:

ValueSets:

QuestionnaireResponse prepoblación

La operación puede devolver un QuestionnaireResponse con datos rellenados previamente cuando:

Criterios de búsqueda para QuestionnaireResponse:

Se modificó el filtrado de recursos

Cuando se proporciona el changedSince parámetro:

Múltiples paquetes

La operación puede devolver varios Package Bundles cuando:

Cada Package Bundle es autónomo y cuenta con todas las dependencias necesarias.

Casos de uso comunes

Caso de uso 1: documentación de autorización previa

Escenario: un proveedor debe recopilar la documentación necesaria para obtener una autorización previa para la oxigenoterapia domiciliaria.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Patient's insurance coverage */ }  
    },  
    {  
      "name": "order",  
      "resource": {  
        "resourceType": "ServiceRequest",  
        "code": {  
          "coding": [{  
            "system": "http://www.ama-assn.org/go/cpt",  
            "code": "94660"  
          }]  
        }  
      }  
    }  
  ]  
}

Resultado: devuelve un paquete con el cuestionario de oxigenoterapia, rellenado previamente con los datos vitales del paciente y los códigos de diagnóstico del EHR.

Caso de uso 2: recupere una versión específica del cuestionario

Escenario: un proveedor necesita una versión específica de un cuestionario para cumplir con los requisitos.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/dme-request|3.1.0"  
    }  
  ]  
}

Resultado: devuelve exactamente la versión 3.1.0 del cuestionario de solicitud del DME con todas las dependencias.

Caso de uso 3: comprobar si hay actualizaciones

Escenario: un proveedor quiere comprobar si algún recurso del cuestionario se ha actualizado desde la última consulta.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/medication-request"  
    },  
    {  
      "name": "changedSince",  
      "valueDateTime": "2024-03-01T00:00:00Z"  
    }  
  ]  
}

Resultado: devuelve solo los recursos que se hayan modificado después del 1 de marzo de 2024 o un paquete vacío si no ha cambiado nada.

Caso de uso 4: pedidos múltiples

Escenario: un proveedor envía varias solicitudes de servicio que pueden requerir cuestionarios diferentes.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "order",  
      "resource": { /* ServiceRequest for imaging */ }  
    },  
    {  
      "name": "order",  
      "resource": { /* ServiceRequest for DME */ }  
    }  
  ]  
}

Resultado: devuelve varios Package Bundles, uno para cada cuestionario aplicable.

Integración con otros Da Vinci IGs

Descubrimiento de requisitos de cobertura (CRD)

Integración del flujo de trabajo:

Soporte de autorización previa (PAS)

Integración del flujo de trabajo:

Intercambio de datos clínicos (CDex)

Integración del flujo de trabajo:

Guía para solucionar problemas

Problema: No se devolvió el cuestionario

Posibles causas:

Soluciones:

Problema: Faltan dependencias en el paquete

Posibles causas:

Soluciones:

Problema: Empty Package con ChangedSince

Posibles causas:

Soluciones:

Problema: QuestionnaireResponse no se ha rellenado previamente

Posibles causas:

Soluciones:

Prácticas recomendadas

1. Utilice Canonical URLs con las versiones

Especifique siempre los números de versión cuando solicite cuestionarios específicos:

{  
  "name": "questionnaire",  
  "valueCanonical": "http://example.org/fhir/Questionnaire/dme|2.1.0"  
}

Por qué: Garantiza la coherencia y evita cambios inesperados cuando se actualizan los cuestionarios.

2. Aproveche los cambios desde entonces para mejorar el rendimiento

Para los cuestionarios a los que se accede con frecuencia, utilícelos changedSince para minimizar la transferencia de datos:

{  
  "name": "changedSince",  
  "valueDateTime": "2024-03-10T15:30:00Z"  
}

Por qué: reduce la latencia y el uso de ancho de banda al recuperar solo los recursos actualizados.

3. Incluya información completa sobre la cobertura

Proporcione detalles de cobertura completos para garantizar la correcta selección del cuestionario:

{  
  "name": "coverage",  
  "resource": {  
    "resourceType": "Coverage",  
    "beneficiary": { "reference": "Patient/123" },  
    "payor": [{ "reference": "Organization/payer-abc" }],  
    "class": [{ /* Group/plan information */ }]  
  }  
}

Por qué: Ayuda a HealthLake identificar los cuestionarios y requisitos específicos del pagador.

Operaciones de relacionadas