Saltar al contenido principal

Get dashboard notifications

GET 
/company/dashboard

Retorna un resumen de las notificaciones empresariales más importantes para el dashboard de Cargoffer.

Tipos de notificaciones incluidas:

  • Nuevas ofertas de transportistas en subastas activas
  • Cambios de estado en entregas (recogida, en tránsito, entregada)
  • Alertas de retrasos o incidencias en rutas
  • Vencimientos de documentación (seguros, licencias)
  • Confirmaciones de entrega y documentos CMR
  • Facturas y pagos pendientes
  • Actualizaciones de normativas de transporte

Casos de uso:

  • Dashboard ejecutivo con alertas prioritarias
  • Centro de notificaciones empresarial
  • Monitor de operaciones en tiempo real
  • Alertas de cumplimiento normativo
  • Seguimiento de KPIs críticos

Funcionalidades:

  • Notificaciones categorizadas por prioridad
  • Marcado de leído/no leído
  • Filtrado por tipo de evento
  • Integración con calendario de entregas

Flujo típico:

  1. El cliente llama a este endpoint al cargar el dashboard o cuando detecta cambios
  2. El servidor valida el token JWT y obtiene el ID de la compañía
  3. Consulta las notificaciones no leídas y las últimas 10 notificaciones
  4. Retorna el conteo de no leídas y el listado de notificaciones
  5. El cliente actualiza la UI mostrando el contador y la lista

Consideraciones:

  • Las notificaciones se ordenan por fecha de creación descendente
  • El límite máximo de notificaciones retornadas es 10
  • Solo se incluyen notificaciones de la compañía del usuario
  • El endpoint es cacheable por 60 segundos para optimización

Ejemplo de implementación:

// Ejemplo de llamada desde frontend
async function fetchDashboardNotifications() {
  const response = await fetch('/company/notifications/dashboard', {
    headers: {
      'Authorization': `Bearer ${userToken}`
    }
  });
  const data = await response.json();
  updateNotificationBadge(data.unreadCount);
  renderNotificationsList(data.lastNotifications);
}

Request​

Responses​

Operación exitosa

Response Headers