Passa al contenuto principale

Get dashboard statistics

GET 
/company/dashboard/

Restituisce statistiche di aste e consegne per la dashboard aziendale di Cargoffer.

Fornisce metriche aggregate dell'attività operativa e finanziaria di aste e consegne per la dashboard aziendale, consentendo analisi delle prestazioni e monitoraggio dell'attività in un intervallo di date specifico.

Obiettivo​

Consentire alle aziende di visualizzare le prestazioni delle proprie operazioni logistiche mediante indicatori chiave di prestazione (KPI) basati su aste e consegne effettuate.

Casi d'uso​

  • Dashboard principale: visualizzazione dei KPI dell'ultimo anno (valori predefiniti)
  • Report trimestrali: GET /?minDate=2024-01-01&maxDate=2024-03-31
  • Analisi mensile: GET /?minDate=2024-05-01&maxDate=2024-05-31
  • Analisi annuale: GET /?minDate=2023-01-01&maxDate=2023-12-31

Metriche delle aste​

Per ogni gruppo di aste vengono restituiti i seguenti dati aggregati:

  • total_sale: Importo totale delle vendite calcolato secondo la logica delle offerte
  • total_auctions: Quantità di aste nel gruppo
  • total_savings: Risparmio totale vs prezzo iniziale (total_start_price - total_sale)
  • sumBidWinner: Somma degli importi delle offerte vincenti
  • total_start_price: Somma dei prezzi iniziali di tutte le aste

Calcolo di total_sale per asta:

  1. Se esiste un'offerta vincente (bidWinner): utilizza l'importo di quell'offerta
  2. Altrimenti, se esiste un'offerta assegnata (bidAsigned): utilizza l'importo di quell'offerta
  3. Se non ha alcuna offerta: utilizza il prezzo iniziale (start_price)

Gruppi di aste:

  • auctions: Tutte le aste (stati: planned, published, awarded, approved)
  • publishedAuctions: Aste

Request​

Responses​

Statistiche recuperate con successo. Contiene i seguenti gruppi di dati:

Gruppi di aste (AuctionStats):

  • auctions: Tutte le aste (pianificate, pubblicate, aggiudicate, approvate)
  • publishedAuctions: Aste pubblicate
  • awardedAuctions: Aste aggiudicate
  • approvedAuctions: Aste approvate
  • plannedAuctions: Aste pianificate

Gruppi di consegne (DeliveryStats):

  • plannedDeliveries: Consegne pianificate
  • collectedDeliveries: Consegne ritirate
  • deliveredDeliveries: Consegne completate

Ogni gruppo di aste include: total_sale, total_auctions, total_savings, sumBidWinner, total_start_price Ogni gruppo di consegne include: total_sale, total_deliveries, sumBidWinner

Response Headers