Passa al contenuto principale

Get dashboard notifications and pending actions

GET 
/company/notifications/dashboard

Recupera informazioni consolidate per la dashboard delle notifiche aziendali, includendo notifiche non lette e avvisi di azioni in sospeso come aste senza firma.

Obiettivo​

Consentire alle aziende di visualizzare in un unico endpoint tutti gli avvisi critici e le notifiche in sospeso, ottimizzando l'esperienza utente nella dashboard principale.

Casi d'uso​

  • Dashboard principale: Caricamento iniziale della dashboard aziendale
  • Aggiornamento in tempo reale: Refresh periodico delle notifiche
  • Avvisi di firma: Promemoria per aste in attesa di firma da parte dell'azienda
  • Monitor attività: Monitoraggio delle notifiche non lette

Flusso dei dati​

L'endpoint implementa un sistema di priorità con slot limitati (massimo 6 elementi):

flowchart TD
    A[Request Dashboard] --> B{User Authenticated?}
    B -->|No| C[404 USER_NOT_FOUND]
    B -->|Yes| D{Company Exists?}
    D -->|No| E[401 CIA_NOT_FOUND]
    D -->|Yes| F[Get Company Data]
    F --> G{Missing Signature?}
    G -->|Yes| H[companyMissingSignature: true]
    G -->|No| I[companyMissingSignature: false]
    H --> J[Find Auctions Without Signature]
    I --> J
    J --> K{Count > 6?}
    K -->|Yes| L[Limit: 6 Auctions]
    K -->|No| M[Use All Auctions]
    L --> N[Calculate Available Slots]
    M --> N
    N --> O{Slots > 0?}
    O -->|No| P[Return Dashboard]
    O -->|Yes| Q[Get Unread Notifications]
    Q --> R[Fill Available Slots]
    R --> S[Return Dashboard - 200]

Campi di risposta​

companyMissingSignature (boolean):

  • true: L'azienda non ha completato il processo di firma
  • false: L'azienda ha una firma registrata

**notSignedAu

Request​

Responses​

Dashboard delle notificazioni recuperato con successo.

L'oggetto di risposta contiene fino a 6 elementi distribuiti tra:

  • Aste in attesa di firma (priorità massima)
  • Notifiche non lette (occupano gli slot rimanenti)