Concetti fondamentali

Comprendi i building block di Mative Cloud Fleet Management: ordini, payload, autisti, veicoli, flotte e le loro relazioni.

Ordini

Un Ordine rappresenta un'attività di consegna o un lavoro di servizio con:

• Stato che avanza attraverso un ciclo di vita definito (creato → consegnato → avviato → completato)
• Un Payload contenente luoghi di ritiro/consegna e articoli
• Autista e veicolo assegnati
• Una Configurazione Ordine che definisce il workflow e il metodo di proof of delivery

Stati dell'ordine

Stato	Sempre presente?	Significato
creato	Sì	Ordine in attesa di dispatch
consegnato	Sì	Ordine inviato all'autista
avviato	Sì	Autista ha accettato e sta lavorando
annullato	Sì	Ordine cancellato prima del completamento
completato	Configurabile	Ordine consegnato

I primi quattro stati sono statici (non rimovibili). Lo stato completato può essere sostituito da qualsiasi attività personalizzata con il flag complete: true.

Tra avviato e il completamento, i passi intermedi che l'autista deve eseguire sono definiti dal flusso attività della Configurazione Ordine.

Payload

Un Payload definisce:

• Ritiro — luogo di origine per la raccolta degli articoli
• Consegna — destinazione principale
• Reso — indirizzo opzionale per la restituzione
• Entità — articoli individuali con numeri di tracciamento, dimensioni, peso, barcode/SKU
• Tappe — fermate intermedie per percorsi multi-stop (ognuna può richiedere proof of delivery individuale)

Configurazione Ordine

Una Configurazione Ordine è un template riutilizzabile che definisce:

• Il flusso di attività (sequenza di stati)
• Le definizioni dei campi entità
• Il metodo di proof of delivery (firma, foto, QR, dati custom)
• Campi personalizzati a livello di ordine

Configurazioni multiple supportano diversi tipi di servizio (consegna standard, ritiro e consegna, cold chain, ecc.).

Autisti

Un Autista esegue gli ordini tramite l'app mobile FM Mobile, con memorizzazione di:

• Posizione in tempo reale (latitudine, longitudine, direzione, velocità)
• Stato online/offline
• Assegnazione ordine corrente
• Competenze e vincoli (distanza massima, finestra temporale, competenze richieste)
• Orario turni

Veicoli

Un Veicolo è un asset della flotta con memorizzazione di:

• Marca, modello, anno, tipo di carrozzeria, colore
• Targa e VIN
• Capacità (peso in kg, volume in m³)
• Posizione in tempo reale
• Stato (attivo, inattivo, manutenzione, offline)

Flotte

Una Flotta raggruppa logicamente autisti e veicoli per:

• Zona geografica o area di servizio
• Tipo di servizio (espresso, standard, notturno)
• Turno (flotta mattutina, flotta serale)
• Fornitore o subappaltatore

Sedi

Una Sede è un luogo salvato e riutilizzabile con:

• Dettagli completi dell'indirizzo e coordinate precise
• Numero di telefono di contatto
• Collegamento ai Contatti
• Visualizzazione sulla mappa live

Contatti

I Contatti sono le persone e le aziende nelle operazioni:

• Cliente — destinatario della consegna
• Fornitore — origine degli articoli
• Facilitatore — coordina l'ordine

Fornitori

I Fornitori sono vettori terzi o fornitori di servizi con i propri pool di autisti e flotte.

Come tutto si collega

Config Ordine ─────────────────────── definisce flusso attività + campi entità
     │
     ▼
  Ordine ──── Payload ── Ritiro / Consegna / Entità / Tappe
     │           │
     │           └── NumeroTracciamento (per entità)
     │
     ├── Autista (assegnato)
     ├── Veicolo (assegnato)
     ├── Preventivo (tariffazione)
     ├── Percorso (direzioni calcolate)
     ├── Prove (firma / foto / QR)
     └── Manifesto (dopo commit Orchestratore)
        └── TappaManifesto (ogni ordine nel manifesto)