El error se ve antes de subir, no tres días después
La prevalidación corre las mismas reglas del Ministerio sobre el archivo antes de descargarlo. Cada error dice paciente, servicio y campo, y la corrección no pasa por el portal.
Salud·Reactive Move
De un rechazo del Ministerio tres días después a saber qué falta antes de subir el archivo.
Cómo Reactive Move pasó a generar sus RIPS desde las mismas citas que ya tenía en la agenda, con cada error ubicado por paciente, servicio y campo.
9 de 10pacientes sin un dato obligatorio al medir las fichas
15 díaspor período: un archivo oficial por quincena
0campos inventados: lo que falta queda excluido, no maquillado
El problema
Los RIPS son el registro que toda institución de salud en Colombia debe reportar al Ministerio por cada atención prestada. Desde 2026 la Resolución 948 exige entregarlos en un formato JSON exacto, validado contra catálogos oficiales de procedimientos (CUPS), diagnósticos (CIE-10) y municipios. Un archivo con un campo mal escrito se rechaza completo.
Reactive Move atiende más de mil citas al mes en dos sedes y lleva su agenda en AgendaPro. Pero AgendaPro no genera RIPS, y la ficha del paciente que sirve para agendar no es la que exige el Ministerio: faltaban el sexo, la fecha de nacimiento o el tipo de documento en buena parte de los registros.
El resultado era un ciclo ciego:
- El validador del Ministerio rechazaba el archivo tres días después de subirlo, y sin decir en qué paciente o servicio estaba el error.
- Nadie sabía, antes de generar, cuántos pacientes se podían reportar y cuántos no.
- Al medir las fichas el 9 de septiembre de 2026, 240 de 240 tenían documento, 188 tenían fecha de nacimiento y solo 25 tenían sexo, un campo obligatorio.
- Cada corrección manual volvía a empezar el ciclo de tres días.
Lo que construimos
Construimos el módulo de RIPS dentro del backoffice que ya leía AgendaPro para los KPIs de la clínica. Cada quincena, el sistema toma las citas atendidas, las cruza con la ficha de cada paciente y con la cédula de cada fisioterapeuta, y produce el archivo oficial con el nombre y la estructura que exige la resolución. Lo que no se puede reportar queda en una lista de exclusiones con su motivo, en lugar de rellenarse con datos falsos.
- 01Cobertura de fichas antes de generar: una pestaña muestra por paciente qué dato obligatorio falta y permite corregirlo a mano o sincronizarlo desde AgendaPro. El equipo sabe cuántos pacientes entran al archivo antes de producirlo.
- 02Parametrización clínica: cada servicio de la agenda se mapea a su código CUPS y su diagnóstico; cada fisioterapeuta lleva su cédula; los catálogos oficiales (10,024 CUPS y 12,634 CIE-10) se cargan con versión y fecha.
- 03Generación determinista: regenerar un período produce exactamente el mismo archivo, verificado con una huella SHA-256, y los consecutivos de cada paciente nunca cambian una vez asignados.
- 04Prevalidación con las reglas del Ministerio: antes de descargar, el sistema corre las reglas de validación del anexo técnico y reglas propias de la clínica, y ubica cada error por paciente, servicio y campo.
- 05Ciclo de vida del período: borrador, exitoso, descargado, reportado y aprobado con el código único de validación del Ministerio, o rechazado. El historial queda registrado y el generador corre solo los días 1 y 16.
Nada de esto reemplaza a la agenda ni a la facturación: el módulo lee AgendaPro y produce el archivo. El equipo lo sube al portal del Ministerio y registra la respuesta en el sistema. Al cierre de septiembre de 2026 el módulo está en piloto: la generación corre sobre citas reales y la clínica está completando las fichas que faltaban; las cifras de aprobación llegarán con los primeros períodos reportados.
El resultado
La cobertura se mide, no se adivina
La pestaña de cobertura mostró que 9 de cada 10 pacientes no eran reportables por un solo campo. Ese dato convirtió un problema invisible en una lista de fichas por completar.
Un archivo que no miente
Los pacientes con ficha incompleta quedan en exclusiones con su motivo. El archivo que se sube contiene solo lo que cumple, y regenerarlo da el mismo resultado byte por byte.
Sin trabajo nuevo para el equipo clínico
Las citas ya estaban en AgendaPro. El módulo las lee; el equipo solo completa la ficha del paciente una vez y mapea cada servicio a su código una vez.
El sistema por dentro
Imágenes de referencia del producto entregado. Los datos que aparecen son ilustrativos y no corresponden a información real de clientes ni de operación.
El método Forabi
- 01Consulta gratuita
Leímos la Resolución 948 y el anexo técnico con la asesora de la clínica y definimos el corte quincenal y qué se hace con un paciente que no se puede reportar.
- 02Diseño
Modelamos el período como una máquina de estados y el archivo como el resultado de una función pura: mismas citas, mismo archivo.
- 03Construcción
Sincronización de fichas desde AgendaPro, parametrización de servicios y profesionales, motor de generación, validador y la interfaz de tres pestañas, en cinco semanas.
- 04Adopción
Medimos la cobertura real de las fichas y la clínica empezó a completar los datos que faltaban antes del primer período reportado.
- 05Soporte continuo
Los catálogos oficiales se actualizan con versión y el módulo se ajusta cuando el Ministerio cambia el anexo técnico.