Saltar al contenido principal

Crear nueva notificación (Solo Admin)

POST 

/notifications

Crea una nueva notificación en el sistema. Solo usuarios administradores pueden usar este endpoint. La mayoría de notificaciones se crean automáticamente por el sistema cuando ocurren eventos.

Validaciones:

  • Debe especificarse company_user O trucker_cia, pero no ambos
  • El tipo debe ser uno de los tipos válidos definidos en el sistema
  • Título máximo 255 caracteres, mensaje máximo 1000 caracteres
  • Fechas programadas deben ser futuras
  • Rate limiting: máximo 10 notificaciones por minuto por usuario

Campos obligatorios:

  • type: Tipo de notificación
  • title: Título descriptivo
  • message: Mensaje detallado
  • company_user O trucker_cia: Destinatario

Campos opcionales:

  • priority: Nivel de prioridad (default: medium)
  • data: Datos adicionales específicos del tipo
  • relatedEntityType y relatedEntityId: Entidad relacionada
  • scheduledFor: Programar envío para fecha futura
  • expiresAt: Fecha de expiración automática

Ejemplo de uso:

  • Notificaciones administrativas o de mantenimiento
  • Comunicaciones específicas a usuarios o empresas
  • Mensajes programados para envío futuro

Request

Responses

Notificación creada exitosamente