Passa al contenuto principale

Digitally sign an awarded auction

POST 
/company/bid-auctions/:service_code/sign

Permette al trasportatore vincitore firmare digitalmente l'assegnazione di un'asta.
La firma viene effettuata tramite un'immagine di firma autografa caricata dall'utente.

Obiettivo​

Formalizzare legalmente l'accettazione del trasporto da parte del trasportatore vincitore,
generando automaticamente i documenti e i registri necessari per il processo logistico.

Effetti Collaterali Automatici ⚠️​

Questo endpoint esegue automaticamente le seguenti operazioni al completamento:

  1. Creazione del Delivery:

    • Viene creato un record di delivery associato all'asta
    • Il delivery viene inizializzato con i dati dell'asta
    • Viene stabilita la relazione auction.delivery → delivery._id

  2. Generazione dell'eCMR:

    • Viene generato automaticamente il documento eCMR (Carta di Porte Digitale)
    • L'eCMR viene associato al delivery appena creato
    • Viene inizializzato con i dati di trasporto dell'asta

  3. Aggiornamento degli Stati:

    • L'asta viene contrassegnata come firmata
    • Viene impostato signed_by_trucker: true
    • Vengono registrati data e ora della firma

  4. Relazioni tra Entità:

    Auction → Delivery → eCMR  
    (auction._id) (delivery.auction) (ecmr.delivery)

Requisiti del File di Firma​

  • Formato: JPEG o PNG
  • Dimensione massima: 5MB
  • Risoluzione minima: 300x100px
  • Contenuto: Immagine di firma autografa leggibile

Casi d'Uso​

  • Trasportatore vincitore firma l'accettazione di un'asta assegnata
  • Sistema che genera automaticamente delivery ed eCMR dopo la firma
  • Integrazione con flussi automatizzati di gestione del trasporto

Note Importanti​

  • Solo il trasportatore vincitore può firmare
  • L'asta deve essere nello stato awarded

Request​

Responses​

Firma registrata con successo. L'asta passa allo stato 'completed' e viene creato il delivery.

Response Headers