Saltar a contenido

Notas técnicas

Analítica Integrada de Salud: Notas técnicas es una aplicación que permite generar, almacenar, editar y hacer seguimiento notas técnicas.

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

Manual de uso

En esta sección se explica como 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 cuatro secciones principales:

  1. Dashboard: Espacio destinado a observar las características de una nota técnica.
  2. Editor: Permite crear, eliminar, modificar notas técnicas.
  3. Escenarios: Tiene como finalidad generar posibles escenarios de contratación a partir de la prestación histórica de los servicios que permita analizar la ejecución y definir una nota técnica a partir de los ajustes realizados.
  4. Seguimiento: Permite hacer el seguimiento a la ejecución de una nota técnica.

Dashboard

La sección dashboard contiene características de las notas técnica creadas.

En la parte superior se puede observar una tabla con las notas técnicas. Cada fila representa una nota técnica. Si se desea obtener información sobre una nota técnica, se debe hacer clic sobre la fila de la tabla dónde se ubica esta misma.

Existen bloques con cajas de información de notas técnicas distribuidas de la siguiente forma:

Estas solo se mostrarán si el usuario tiene los campos incluidos en la nota técnica.

  1. Superiores: Nombre de entidad, número de contrato, tipo de agrupación, cohorte, Valor total mes, población y valor per cápita.
  2. Inferiores: Contiene campos cómo franja de riesgo``inclusiones, exclusiones y observaciones.

Adicionalmente, para visualizar la distribución de frecuencias, valor mensual y costo medio entre agrupadores, seleccionar la pestaña Dashboard agrupadores.

Para visualizar la función de costo efectivo para agrupadores con límites de ejecución asociado a las frecuencias, se debe dirigir a la pestaña Costo medio efectivo. El objetivo de la gráfica es comparar la tendencia del costo medio al aumentar la frecuencia de atención. El aumento de la frecuencia hace que el costo medio del agrupador reduzca. Cuando la prestación es menor a aquella que se encuentra en el límite inferior se hará una devolución por parte del prestador a la entidad pagadora (solo si este existe). Si la prestación supera el límite superior la entidad pagadora reconocerá las prestaciones adicionales.

Esto solo aplica a nota técnicas que cuenten con límites de ejecución.

Creación y mantenimiento de notas técnicas (Editor)

El módulo editor de notas técnicas permite agregar, eliminar, modificar y sincronizar notas técnicas del catálogo almacenado en base de datos. El módulo editor de notas técnicas contiene las mismas funcionalidades que el módulo de rutas, con una adición, sincronizar notas.

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.

Sincronizar notas técnicas

Botón para actualizar el catálogo de notas técnicas. En caso de que otra aplicación o usuario haya modificado el catálogo de notas técnicas, el botón sincronizar permite ver los cambios más recientes.

Descargar o cargar backups

Esta funcionalidad permite descargar un backup con el catálogo de notas técnicas almacenadas hasta el momento del descargue.

Adicionalmente, el usuario puede cargar el backup de notas técnicas. El archivo debe contener la misma estructura que el archivo de descargue y es importante tener en cuenta que al aprobar el cargue no es posible realizar una acción reversible. A continuación posibles inconvenientes al hacer un backup:

Escribir una nota en formato JSON

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

Estructura mínima

La estructura de las notas técnicas están estadarizadas. Estás deben contener información sobre la población e información con estadísticos de los agrupadores relacionados a la nota técnica.

A continuación los componentes mínimos del json con el tipo de dato. Los tres puntos hacen referencia a que pueden existir más y que deben especificarse.

[
{
  "poblacion": númerico,
  "prestador": carácter,
  "departamento": carácter,
  "cod_departamento": númerico,
  "ciudades": carácter,
  "vigente": boolean,
  "agrupadores": {
    "agrupador 1": {n = númerico, cm = númerico, ...},
    "agrupador 2": {n = númerico, cm = númerico, ...},
    ...
    "agrupador n": {n = númerico, cm = númerico, ...},
  }
}
]
Ejemplo: Breve ejemplo de una nota técnica:
{
  "poblacion": 40000,
  "prestador": "MD&CO Cali",
  "departamento": "Valle del Cauca",
  "cod_departamento": 76,
  "ciudades": "Cali, Palmira",
  "vigente": true,
  "agrupadores": {
    "HOSPITALARIO": {
      "n": 4230,
      "cm": 150000
    },
    "AMBULATORIO": {
      "n": 504,
      "cm": 278714
    },
    "URGENCIAS": {
      "n": 153,
      "cm": 42235
    }
  }
}

En caso de definir límites inferiores o superiores en uno o varios agrupadores, se debe adicionar los campos n_min y/o n_max. Manteniendo la nota técnica anterior, el siguiente ejemplo ilustra la adición de límites en el agrupador URGENCIAS:

    "URGENCIAS": {
      "n": 153,
      "cm": 42235,
      "n_min": 80,
      "n_max": 245,
    }

Crear una nota técnica con escenarios

En este módulo se pueden generar notas técnicas a partir de la combinación de diferentes escenarios. Para la generación de las notas técnicas se utiliza la ejecución de facturación y el usuario puede interactuar con la aplicación para lograr el ajuste deseado. A continuación se observa el flujo de procesos recomendados a seguir.

1. Opciones de escenarios

Conjunto de opciones que permiten generar un escenario. Las opciones son:

  1. Variables: Una o más variables por las cuales realizar la nota técnica.
  2. Variable de valor: Especifica el nombre de la columna con el valor.
  3. Unidades: Permiten observar el comportamiento de las variables. Típicamente, las unidades de conteo son: prestaciones (por cantidad o registro), pacientes, facturas o episodios. (ver sección Funcionalidad General / unidades.)

Presionar el botón generar para ver resultados.

2. ¿Nota técnica deseada?

El anterior paso genera una nota técnica a partir de las opciones escogidas más unos gráficos que ayudan a comparar el costo medio o frecuencias a través del tiempo.

Con la información suministrada por la aplicación, el analista debe decidir si guardar la nota técnica (dirigirse al paso 4) o realizar ajustes hasta encontrar la nota técnica deseada (dirigirse al paso 3)

3. Ajuste analista

La aplicación permite modificar la población objetivo de la nota técnica, con las barras deslizables en la parte superior de la pantalla se pueden modificar las frecuencias y costos medios de un agrupador o combinación de agrupadores si se escogieron más de dos variables en opciones de escenarios.

En caso que el analista realice un ajuste en alguna frecuencia, la nota técnica se modificará en las columnas Frecuencia a mes, Valor a mes y Frecuencia per capita. Si el ajuste se realiza sobre en el costo medio, la nota técnica se modificará en las columnas Costo medio y Valor mes.

Las gráficas en la parte inferior derecha hacen referencia al costo medio o frecuencia de la descriptiva de la población junto con unas trazas que muestran la media para frecuencias y costo medio; y percentil 75 y mediana para la gráfica de costo medio. Por último, el valor ajustado por el analista en la parte superior se verá reflejado con la traza de ajuste analista.

Una vez realizados los ajustes necesarios y si se la nota técnica define lo necesitado por el analista, se puede proceder con el paso de guardar nota técnica.

4. Guardar nota técnica

En la parte superior se observa una pestaña con el nombre Guardar en la nube. Al dar clic sobre este botón, se mostrará una nueva ventana para que el usuario diligencie la información de la nueva nota técnica a guardar.

El formulario cuenta con campos requeridos y campos recomendados: - Requeridos: Ubicados en la parte izquierda de la ventana. Estos campos permiten guardar la información de la nota técnica en el catálogo. - Recomendados: Ubicado en la parte derecha de la ventana. Campos informativos que brindan información detallada de la nota técnica.

Al presionar el botón guardar, la nota técnica se creará como un nuevo registro en el catálogo de notas técnicas guardadas en la base de datos.

Integraciones con otros módulos

Para utilizar tarifarios y agrupadores de otras aplicaciones revisar la sección Integraciones.

Seguimiento a notas técnicas

El módulo de seguimiento permite evaluar la ejecución de un contrato durante un periodo determinado.

Parámetros

Para poder hacerle seguimiento a una nota técnica se debe seleccionar esta en la casilla Nota técnica. Después, se deben seleccionar las variables en el conjunto de datos cargados que contenga los agrupadores incluidos en la nota técnica. Después seleccionar la variable valor y la unidad de conteo para el informe.

Gráfica e indicadores resumen

El informe está compuesto por un conjunto de indicadores, una gráfica de serie de tiempo, y por último, en la parte inferior se observa una gráfica de barras con las diferencias entre los valores esperados y los valores de la nota técnica.

A continuación una descripción de los indicadores: 1. Valor base nota técnica: La suma del costo medio multiplicado por la frecuencia contratada de cada agrupador más o menos ajustes (si aplica). 2. Valor facturado: La suma del valor en facturación o en los RIPS. 3. Valor con costo medio: La suma de las frecuencias ejecutadas multiplicadas por los costos medios de cada agrupador de la nota técnica. 4. Diferencia con el valor facturado: La suma del valor en facturación o en los RIPS para los agrupadores de la nota técnica menos el valor a ejecutar. 5. Diferencia con frecuencias por costo medio: La multiplicación del costo medio por las frecuencias de cada agrupador menos el valor a ejecutar.

La gráfica de tiempo ilustra el valor contratado, valor ejecutado con facturación, valor ejecutado con frecuencias y valor total pagado acumulado en la línea de tiempo.

En la gráfica de la parte inferior se muestran diferentes indicadores del seguimiento. Esos serían: Valor facturado, valor costo medio o frecuencias. Si el usuario selecciona un agrupador en la nota técnica (tabla) la gráfica mostrará solo datos relacionados a ese agrupador, si no se realiza una selección la gráfica mostrará la suma de todos los agrupadores.

Descargar seguimiento

Por último, para descargar un informe del seguimiento se debe presionar el botón descargar, el cual contiene 4 informes:

  1. nota técnica
  2. tabla maestra con toda información descriptiva más caracteristicas de la nota técnica.
  3. frecuencias: información referente a las frecuencias de la nota técnica.
  4. facturación: información referente a los valores de la nota técnica.
  5. Por último, un diccionario con los nombres de los campos.
Diccionario
Nombre columna Descripción
unidad_conteo La unidad de conteo utilizada para el agrupador
Frecuencia El conteo de frecuencias para el agrupador
Suma La suma del valor (según los datos) para el agrupador
Media La media del agrupador por unidad de conteo
.ais_anio + .ais_mes El año y mes del registro
frec_mes La frecuencia mensual para el agrupador según la nota técnica
cm El costo medio de la agrupación según la nota técnica
frec_mes_max El límite superior de frecuencias
frec_mes_min El límite inferior de frecuencias
valor_esperado/valor_mes El valor esperado según la nota técnica
valor_cm El valor ejecutado según la multiplicación de la frecuencia por el costo medio
diff_lim La diferencia entre el conteo de frecuencias y los límites
diff_frec La diferencia entre el conteo de frecuencias y las frecuencias de la nota técnica
frec_efectiva El conteo de frecuencias efectivo después de tomar en cuenta los límites de ejecución
diff_efectiva La diferencia entre la frecuencia efectiva y las frecuencias de la nota técnica
diff_valor_suma La diferencia entre la suma del valor y el valor esperado de la nota técnica
diff_valor_frec La diferencia entre el valor según el costo medio y las frecuencias con el valor esperado de la nota técnica
diff_efectiva_x_cm La diferencia efectiva multiplicada por el costo medio
valor_contratado El valor total reconocido después de las diferencias con los límites
diff_facturado La diferencia entre la suma del valor y el valor contratado después de las diferencias con límites
frecuencia_pc La frecuencia mensual para un agrupador entre la población contratada