Passa al contenuto principale

Create New Transport Auction

POST 
/company/auction

Crea una nuova asta di trasporto merci seguendo un flusso strutturato. Richiede autenticazione JWT valida e verifica di un piano di pagamento attivo.

Consente alle aziende di pubblicare offerte di trasporto per ricevere offerte da vettori.

Obiettivo​

Facilitare la creazione di aste pubbliche o private di trasporto con tutte le informazioni necessarie affinché i vettori possano fare offerte per il servizio.

Casi d'Uso​

  • Creare un'asta pubblica per ricevere offerte multiple da vettori
  • Generare una bozza d'asta per revisione prima della pubblicazione
  • Salvare configurazioni di percorsi frequenti come preferiti

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta] --> B{Utente Autenticato?}
  B -->|No| C[401 Non Autorizzato]
  B -->|Sì| D{Piano di Pagamento Attivo?}
  D -->|No| E[404 Nessun Piano di Pagamento]
  D -->|Sì| F{Date in UTC?}
  F -->|No| G[400 Formato Data Non Valido]
  F -->|Sì| H{Indirizzi Validi?}
  H -->|No| I[400 Indirizzo Non Valido]
  H -->|Sì| J{Pesi/Volume Positivi?}
  J -->|No| K[400 Carico Non Valido]
  J -->|Sì| L[Crea Asta - 201]

Request​

Responses​

Asta creata con successo