Saltar a contenido

Avisos de vencimiento de documentos

Tipo de página: explicación (el porqué y los conceptos). Para quién: quien administra la documentación de los locales y quien configura quién recibe los avisos. Páginas hermanas: guía Cómo cargar un documento legal del local y su vencimiento · referencia Documentación Legal y Notificaciones · explicación Cómo funcionan las notificaciones.

La idea

Una habilitación vencida puede significar una clausura. Por eso Hexalba avisa cuando un documento está por vencer o ya venció, sin que nadie tenga que acordarse de revisar la pantalla. El aviso se arma con tres decisiones: cuándo avisar, a quién y por qué canal.

Cuándo se avisa

Cada documento tiene una fecha de vencimiento (opcional) y un número de días de aviso. A partir de esos dos datos, cada día el documento está en uno de tres estados:

Estado Cuándo Se avisa
Vencido La fecha de vencimiento ya pasó Sí, todos los días hasta que se renueve
Por vencer Faltan, como mucho, los días de aviso (incluye el propio día del vencimiento) Sí
En regla Faltan más días que los de aviso, o el documento no tiene vencimiento No

Ejemplo: una habilitación vence el 30 de junio y tiene 10 días de aviso. El 19 de junio todavía no avisa; desde el 20 de junio (diez días antes) figura como "por vencer"; el 1 de julio pasa a "vencido" y sigue avisando hasta que alguien cargue el nuevo vencimiento.

Por qué los días son por documento

El valor por defecto es 10 días, pero se puede cambiar documento por documento, de 0 a 365. No todos los documentos necesitan el mismo margen: renovar una habilitación municipal puede llevar semanas, mientras que un certificado que se renueva en el día tal vez solo necesita el aviso el mismo día (0 días). Los documentos que existían antes de esta función tomaron 10.

Las fechas se comparan como días completos del calendario argentino, sin horas: no importa a qué hora se mira, el cambio de estado ocurre a la medianoche argentina.

A quién se avisa

El aviso lo recibe quien tenga, en su rol, las dos acciones:

  • Aviso de documentos vencidos o por vencer (notif_documento_vencimiento), que define quién quiere recibir el aviso.
  • Ver Documentación Legal (ver_documentos_local), porque el aviso lleva a esa pantalla y no tiene sentido mandar a alguien a un lugar al que no puede entrar.

El aviso es uno solo por persona y suma los documentos de todos los locales a los que esa persona tiene acceso, con el desglose: "2 documentos vencidos y 1 por vencer". Al tocarlo se abre la pantalla en el primer local con alertas, y la pantalla avisa si hay otros locales en la misma situación. El alcance de locales siempre sale de los accesos de la persona en el sistema, no de lo que mande su navegador.

La acción se asigna por rol, en la configuración de Roles y permisos.

Por qué un aviso en el dashboard y no un push

El aviso aparece en el banner de notificaciones del inicio y en la campanita, igual que los conteos pendientes y las facturas rechazadas. No hay push al celular, ni widget, ni tarea programada. Esto significa que:

  • El aviso se calcula cada vez que se abre el inicio o se carga la campanita, a partir del estado actual de los documentos. Siempre está al día.
  • Desaparece solo cuando se renueva el vencimiento, se quita la fecha o se elimina el documento. No hay nada que marcar como leído.
  • No te interrumpe: lo ves cuando entrás a la aplicación. Si nadie entra, no hay aviso; por eso conviene que lo reciba al menos un rol que se conecte a diario.

Que el aviso quede solo dentro de la aplicación, en el banner del inicio y en la campanita, sin push ni widget, es una decisión a propósito: así el celular no se llena de notificaciones por algo que se resuelve con tiempo.

Cómo se apaga el aviso

Como el aviso refleja el estado de los documentos, no hay forma de "descartarlo": se va cuando el documento deja de estar vencido o por vencer, es decir, cuando alguien carga la renovación con su nueva fecha. Mientras quede al menos un documento en alerta en alguno de tus locales, el aviso sigue. Cómo renovar un documento, paso a paso: Cómo cargar un documento legal del local y su vencimiento.