Documentación · DataLab

Notificaciones

El sistema central de avisos de la plataforma: una campana en el header que te cuenta lo que pasa —una nueva carga pendiente, una aprobación, un rechazo— y te lleva justo al lugar donde tienes que actuar, sin que nada se te escape.

Un aviso para cada momento importante

Las notificaciones viven en un sistema central en la base de datos en vivo, bajo /notificaciones. Cada evento relevante de la plataforma —una carga que necesita revisión, una decisión sobre una carga— genera una notificación que se dirige a quien tiene que enterarse. No hay que ir a buscar el estado: la plataforma te avisa.

Nueva carga pendiente

Cuando un área envía una carga, los administradores reciben el aviso para revisarla. El trabajo entra a la Mesa sin correos manuales de por medio.

Aprobación

Cuando una carga se aprueba, el responsable recibe la buena noticia y el enlace directo a la operación, para seguir con el procesamiento o el siguiente periodo.

Rechazo / devolución

Si una carga se devuelve, el responsable se entera de inmediato con el aviso, para corregir y reenviar sin esperar a descubrirlo por su cuenta.

La campana del header

En la parte superior de DataLab hay una campana con un contador de no leídas. Al abrirla se despliega un panel con las notificaciones recientes: cada una muestra su tipo, su título, su mensaje y un enlace que te lleva al lugar donde ocurrió. Lo que ya viste deja de contar.

1

El contador te avisa

La campana muestra cuántas notificaciones tienes sin leer. Un vistazo basta para saber si hay algo que atender.

2

Abres el panel

Al hacer clic se despliega el panel de recientes con las últimas notificaciones dirigidas a ti, cada una con su tipo, título y mensaje.

3

Vas al enlace

Cada notificación incluye un link que te lleva directo al punto de acción: la carga por revisar, la operación aprobada, la que hay que corregir.

4

Se marca como leída

Lo que ya viste se registra por usuario en usuarios/{emailKey}/notif_leidas, así que el contador solo refleja lo que aún no has revisado.

Espacio para screenshot El panel de notificaciones abierto desde la campana La campana del header con el contador de no leídas y el panel desplegado mostrando las notificaciones recientes: tipo, título, mensaje y enlace de cada aviso.

Tipos de notificación

Cada notificación tiene un type que define su tono visual, para distinguir de un vistazo una buena noticia de algo que requiere atención:

info

Un aviso informativo: algo que conviene saber, sin urgencia ni acción obligada.

success

Una buena noticia: algo salió bien, como una carga aprobada o un proceso completado.

warn

Una advertencia: algo pide tu atención, como una carga pendiente por revisar.

error

Un problema: algo falló o fue rechazado y necesita corregirse.

Anatomía de una notificación

Cada registro bajo /notificaciones guarda los mismos campos. Esta es la referencia de qué contiene y para qué sirve cada uno:

CampoQué guarda
app La aplicación que originó el aviso, para saber de dónde viene dentro de la plataforma.
type El tipo: info success warn error, que define su tono visual.
title El título corto del aviso, p. ej. «Nueva carga pendiente».
message El mensaje con el detalle de lo que ocurrió.
link El enlace al lugar donde actuar: la carga, la revisión, la operación.
timestamp El momento en que se generó, para ordenar las recientes.
target El destinatario: all, admin o un correo / emailKey específico (ver abajo).

A quién llega cada aviso: el target

El campo target decide quién ve la notificación. Con tres opciones cubre desde un anuncio general hasta un aviso para una sola persona:

targetQuién la recibe
all Todos los usuarios de la plataforma.
admin Solo los administradores. Es el caso de «Nueva carga pendiente»: llega a quienes revisan en la Mesa.
correo / emailKey Una persona específica. Es el caso de la aprobación o el rechazo: llega al responsable de esa carga.
Las lecturas son por usuario. Marcar una notificación como leída no la borra ni afecta a los demás: se anota en usuarios/{emailKey}/notif_leidas. Por eso una notificación con target: all puede estar leída para ti y seguir en no leídas para otra persona.
¿Por dónde sigo? Para entender qué acciones disparan estos avisos, revisa Operaciones y su ciclo de vida de las cargas. Para saber por qué a ti te llegan unos avisos y a otras personas otros, mira los roles.