Rutas

Analítica Integrada Salud: Rutas es una aplicación que permite crear y/o configurar diferentes rutas integrales de atención con el fin de calcular metas de ejecución con base en una población. De este cálculo se crean notas técnicas que pueden utilizarse cómo esquema base para construir contratos con modalidad prospectiva.

La aplicación se alimenta de dos fuentes de información:

Una tabla con datos acerca de la población.
Las rutas configuradas por el administrador.

En este documento se indicarán las instrucciones para correr y utilizar la aplicación.

Manual de uso

En esta sección se explica cómo utilizar la aplicación y sus funcionalidades. Muchas de las características de interfaz son similares a las de otras aplicaciones de Analítica Integrada Salud, por lo cual se hará referencia a otros documentos explicando los componentes generales.

La aplicación está compuesta por tres secciones principales:

Filtros: Se encargan de ayudar al analista a segmentar la población en grupos específicos.
Informe: En esta sección se pueden crear informes de una ruta aplicada a la población seleccionada.
Editor: Permite crear, modificar y configurar diferentes rutas.

Filtros

Para conocer el proceso de aplicar filtros en la aplicación, dirigirse a la documentación de filtros. La tabla a la cual se le aplicará los filtros será la tabla poblacional brindanda. Una vez estos esten completados, recordar que es necesario presionar el botón aplicar filtros para continuar con el análisis de los registros filtrados.

Creación de informes

Para generar un informe se debe dirigir a la sección Informes. Esta sección se divide en dos partes. Al lado izquierdo de la pantalla se encuentran los parámetros para generar el informe y en la parte derecha se encuentran los informes desarrollados hasta la fecha.

Parámetros de generación

Ruta: En esta selección se debe elegir la ruta sobre la cual se va a generar el informe.

Variables de segmentación (Opcional): En esta selección se define si se quiere dividir el informe conforme a alguna variable que se encuentre en la tabla de la población. Por ejemplo, si la tabla de población incluyera una variable con el municipio del paciente, se podría generar el informe por municipio seleccionando esta variable en este menú.

Tarifario (Opcional): Si se tiene algún tarifario con el que se quieran reemplazar los valores de las diferentes actividades, se debe seleccionar en este menú. Es necesario que la ruta tenga una variable con el código de la tecnología para poder aplicar el tarifario.

Generar nota técnica por actividad: Para facilitar el seguimiento de las rutas, puede ser necesario generar la nota técnica por actividad. Esta opción no afecta el cálculo de los valores pero, afecta la forma en que se muestra la nota técnica. Cambia el agrupador por el código de la tecnología, facilitando así el seguimiento.

Una vez seleccionados los parámetros hacer clic en el botón generar informes.

Consulta de informes

Para navegar por los informes de la aplicación, se debe seleccionar la pestaña del informe a consultar.

Descripción del informe

Existen 3 informes construidos hasta la fecha. A continuación una breve descripción de cada uno:

Informe población general: Muestra la población existente por edad, genero y la(s) variables de segmentación seleccionadas. Es decir, si se selecciona la variable municipio, la tabla mostrará el número de personas por municipio, edad y genero de manera agrupada.
Informe nota técnica: Genera nota técnica por rango edad, agrupador, campos compartidos, campos opcionales, y variables de seguimiento. La nota técnica calcula población, frecuencias, frecuencias per cápita, precios y precios per cápita mensuales y anuales.

¡Importante!

La población que se muestra en la nota técnica es la población del rango de edades segmentada por los campos compartidos. Este cálculo es indiferente del genero. Se muestra la población tanto masculina como femenina. Si se desea segmentar la población por genero esta variable debe ser agregada en el campo Variables de segmentación.
Informe frecuencias: Tabla con calculos de frecuencias poblacionales y precios asociados a las frecuencias. Las frecuencias son calculadas teniendo en cuenta las variables almacenadas en la ruta. Es importante recalcar que cada fila hace referencia a una actividad para una determinada población.

Los tres informes explicados anteriormente, pueden ser descargados a un archivo excel o csv mediante el botón Descargar.

Es importante tener en cuenta que la nota técnica generada a partir del informe con la ruta seleccionada, puede ser guardada haciendo clic sobre el botón Guardar Nota técnica.

Importante: Las notas técnicas tienen campos requeridos obligatorios (ublicados en la parte izquierda de la ventana) los cuales deben ser diligenciados por el usuario para ser guardadas. Adicionalmente, en la parte derecha se busca almacenar campos con información opcional.

Creación y mantenimiento de rutas (Editor)

Las rutas en la aplicación se crean a través de un archivo en formato JSON. Cada ruta tiene su propio archivo en el cual se definen las diferentes actividades y las características de la población quien la recibe. Esto se puede modificar y administrar dentro de la sección Editor.

Para conocer las funcionalidades de crear, modificar, heredar y/o eliminar registros del catálogo de rutas, invitamos al lector a revisar la sección Gestión catálogos en Funcionalidad general.

Escribir una ruta

Para escribir una ruta es necesario familiarizarse un poco con el formato JSON. No es necesario ser programador o ingeniero para poder diligenciar las rutas; sin embargo, conocer la especificación puede ayudar.

Estructura mínima

Cada ruta se conforma de la misma manera. Se conforman a partir de bloques con diferentes características que representan una actividad. Las características mínimas que debe incluir un bloque son:

id: Un identificador único de la actividad. Puede ser un código CUPS, un id del ERP, etc.
frecuencia: La(s) frecuencia(s) de esa actividad para la población descrita en el bloque.
prevalencia: La(s) prevalencia(s) sobre la población descrita en el bloque.
genero: El género o géneros de la población que recibirá la actividad.
precio_unitario: El precio unitario de la actividad.

Cada JSON se verá de la siguiente manera:

[
  {},
  {},
  ...
]

Cada bloque se abre con un { y se cierra con }. Dentro de las llaves {} se van a incluir las características del bloque. Cuando se crea una nueva ruta, la aplicación automáticamente muestra el siguiente JSON como plantilla.

[
  {
    "frecuencia": 0,
    "prevalencia": 0,
    "edad": 0,
    "genero": "",
    "id": "",
    "precio_unitario": 0
  }
]

En este caso todas las características están vacías para que el administrador las complete.

Especificación: id

El campo id debe ser de tipo string (texto), por lo cual debe ir entre comillas "". Este debe identificar a la actividad que se esta describiendo. Esto no significa que el id solo pueda ser mencionado una vez en la ruta, simplemente significa que el bloque esta describiendo cómo debe ejecutarse esa actividad.

Especificación: genero

El campo genero puede ser un string (texto) o un arreglo de strings. Este campo le dirá a la aplicación a quienes aplicar esta ruta. Por ejemplo, si se especifica masculino y femenino, se aplicará la misma frecuencia, prevalencia y precio a las personas de género masculino y feminino para las edades especificadas.

Si se quiere aplicar a un solo género: "genero": "M".
Si se quiere aplicar a multiples géneros: "genero": ["M", "F"].

Especificación: edad, frecuencia y prevalencia

Los campos edad, frecuencia y prevalencia están conectados directamente. Estos pueden ser un solo valor numérico o un arreglo de números del mismo tamaño. Este detalle es importante porque si no se sigue la especificación generarán un error de inmediato.

Si edad no se incluye, se asume que la frecuencia y prevalencia es para toda la población.

Ejemplo: prevalencia y frecuencia uniformes

Si se quisiera agregar una actividad que se aplique a la población de edades 1, 2, 3 y 4 con una misma frecuencia y prevalencia, se tendría que especificar las edades pero solo una frecuencia y prevalencia. En este caso, la actividad tendría una frecuencia de 1 y una prevalencia de 1 (100%) para las edades especificadas.

[
  {
    "frecuencia": 1,
    "prevalencia": 1,
    "edad": [1, 2, 3, 4],
    "genero": "M",
    "id": "ejemplo1",
    "precio_unitario": 0
  }
]

Ejemplo: diferentes frecuencias

Si la frecuencia varía según la edad pero la prevalencia no, la frecuencia se definiría como un arreglo del mismo tamaño que edad. Donde cada valor corresponde a la frecuencia para la edad en la misma posición.

En el siguiente ejemplo, los pacientes de un año tendrían una frecuencia de 1, los pacientes de 2 años tendrían una frecuencia de 3, y los de 3 y 4 años tendrían una frecuencia de 5. Sin embargo, todos mantendrían la misma prevalencia del 100%.

[
  {
    "frecuencia": [1, 3, 5, 5],
    "prevalencia": 1,
    "edad": [1, 2, 3, 4],
    "genero": "M",
    "id": "ejemplo2",
    "precio_unitario": 0
  }
]

Ejemplo: diferentes frecuencias y prevalencias

Si cada edad tuviera una frecuencia y prevalencia diferente se haría lo mismo que en el ejemplo anterior. Se expandiría para darle un valor a cada edad según la posición.

[
  {
    "frecuencia": [1, 3, 5, 5],
    "prevalencia": [0.5, 0.75, 0.9, 0.95],
    "edad": [1, 2, 3, 4],
    "genero": "M",
    "id": "ejemplo2",
    "precio_unitario": 0
  }
]

Generalización

Los ejemplos mostrados anteriormente permiten visualizar como se podría especificar las diferentes prevalencias y frecuencias para la población. Sin embargo, también se podrían tener diferentes prevalencias pero una frecuencia uniforme. También se podrían dividir en diferentes bloques si esto hace más fácil el manejo de la ruta. Estas decisiones quedan a disposición de cada administrador.

Especificación: Precio unitario

El precio unitario es un solo valor numérico con el precio unitario de la actividad. Si la actividad tiene diferentes precios con base en diferentes características, estas deben diligenciarse en diferentes bloques.

Especificación: Campos opcionales y adicionales

Los campos opcionales y adicionales se dividen en tres diferentes tipos.

Campos opcionales integrados

Estos campos son adicionales pero afectan de forma pre-programada el comportamiento de la aplicación.

agrupador: Este campo es de tipo string (texto) y define el agrupador al que pertenece la actividad. Esto se vera reflejado en la nota técnica.

Campos compartidos

Precaución: Si se incluye un campo compartido en alguna actividad, debe incluirse en todos los bloques.

Los campos compartidos son campos que llevan exactamente el mismo nombre que alguna variable en la tabla de población. Estos se encargan de aplicar la actividad solamente a la población que cumple las características especificadas. Adicionalmente, todo campo compartido esta conectado, por lo cual deben ser todos del mismo tamaño o únicos.

Si en la tabla de población existe una variable cohorte y quisiéramos aplicar una actividad solo a los pacientes de las cohortes VIH y DM se especificaría de la siguiente manera:

[
  {
    "frecuencia": 1,
    "prevalencia": 1,
    "edad": 50,
    "genero": "M",
    "id": "ejemplo3",
    "precio_unitario": 0,
    "cohorte": ["VIH", "DM"]
  }
]

Si la tabla también incluyera una variable de municipio y se quisiera solo aplicar a usuarios de Bogotá pertenecientes a la cohorte de VIH o DM, podría hacerse la siguiente manera:

[
  {
    "frecuencia": 1,
    "prevalencia": 1,
    "edad": 50,
    "genero": "M",
    "id": "ejemplo4",
    "precio_unitario": 0,
    "cohorte": ["VIH", "DM"],
    "municipio": "Bogotá"
  }
]

Campos adicionales

Los campos adicionales no afectan a la población correspondiente y solo sirven como guía para identificar las actividades. Estos campos podrían ser una descripción de la actividad. Se recomienda que estos campos siempre sean de tamaño 1.