Flusso Documenti

📘 Questa guida spiega nel dettaglio come trasformare un documento in un altro e tracciare l'intero ciclo di vendita.

Cos'è il Flusso Documenti?

Il flusso documenti è il sistema che permette di:

  1. Trasformare un documento in un altro tipo (es. preventivo → ordine)
  2. Consolidare più documenti in uno (es. 3 DDT → 1 fattura)
  3. Tracciare la catena di derivazione tra documenti collegati

Pannello Storico Documenti

Quando apri un documento, il pannello laterale "Storico documenti" mostra una timeline cronologica di tutti i documenti collegati:

┌─────────────────────────────────────────┐
│  📜 STORICO DOCUMENTI                   │
├─────────────────────────────────────────┤
│                                         │
│  ● 15 Gen 2026                         │
│    Preventivo • Offerta accettata      │
│    QUO-2026-0015                       │
│                                         │
│  ● 20 Gen 2026                         │
│    Ordine • Ordine confermato          │
│    ORD-2026-0008                       │
│                                         │
│  ● 25 Gen 2026  ← (documento corrente) │
│    DDT • Consegna effettuata           │
│    DDT-2026-0012                       │
│                                         │
│  ● 31 Gen 2026                         │
│    Fattura • In attesa di pagamento    │
│    FAT-2026-0003                       │
│                                         │
│  ┌─────────────────────────────────┐   │
│  │ + Nuovo documento derivato       │   │
│  └─────────────────────────────────┘   │
└─────────────────────────────────────────┘

Elementi della timeline

Elemento Descrizione
Data Data del documento
Tipo Badge colorato con tipo documento
Stato descrittivo Label contestuale (es. "Offerta inviata", "Fattura pagata")
Codice Codice documento (riga secondaria, discreto)
Indicatore Il documento corrente è evidenziato in blu

Trasformazioni disponibili

Non tutte le trasformazioni sono possibili. Ecco la matrice:

Da ↓ / A → Ordine DDT Fattura Nota Credito
Preventivo ✅ ✅ ✅ ❌
Ordine ❌ ✅ ✅ ❌
DDT ❌ ❌ ✅ ❌
Fattura ❌ ❌ ❌ ✅
Nota Credito ❌ ❌ ❌ ❌

Come trasformare un documento

1. Requisiti

  • Il documento origine deve essere in stato Confermato
  • Le righe non devono essere già state trasferite completamente

2. Procedura

  1. Apri il documento origine
  2. Clicca su "Nuovo documento derivato" nel pannello Storico documenti
  3. Seleziona il tipo di destinazione
  4. Scegli le righe e le quantità da trasferire
  5. Conferma la trasformazione

3. Selezione righe

La finestra di trasformazione mostra:

Colonna Descrizione
☑️ Seleziona la riga da includere
Prodotto Descrizione dell'articolo
Q.tà origine Quantità nel documento origine
Q.tà disponibile Quantità non ancora trasferita
Q.tà da trasferire Quantità da includere nel nuovo documento
Prezzo Prezzo unitario
Totale Importo riga

💡 Puoi trasferire quantità parziali: se un ordine ha 100 unità, puoi creare un DDT per 30 e un altro DDT per 70.

Tracciamento quantità

Lema tiene traccia delle quantità trasferite riga per riga:

ORDINE ORD-2026-0001
┌──────────────────────────────────────────────────┐
│ Riga │ Prodotto     │ Ordinato │ Consegnato │ Da │
│──────│──────────────│──────────│────────────│────│
│  1   │ Widget A     │    100   │     60     │ 40 │
│  2   │ Widget B     │     50   │     50     │  0 │ ✓
│  3   │ Servizio X   │      1   │      0     │  1 │
└──────────────────────────────────────────────────┘

Questo ti permette di:

  • Vedere quanto manca da consegnare/fatturare
  • Creare DDT parziali per spedizioni scaglionate
  • Sapere quando un ordine è completamente evaso

Consolidamento DDT

Il consolidamento permette di creare una fattura da più DDT:

Quando usarlo

  • Fatturazione a fine mese per clienti con consegne frequenti
  • Raggruppare più spedizioni in un'unica fattura
  • Ridurre il numero di documenti fiscali

Come fare

  1. Vai alla lista DDT
  2. Seleziona i DDT da consolidare (stesso cliente, stato "Confermato")
  3. Clicca "Consolida in Fattura"
  4. Verifica l'anteprima e conferma

Risultato

DDT-2026-0010 (15/01)  ──┐
DDT-2026-0015 (18/01)  ──┼──► FAT-2026-0005 (31/01)
DDT-2026-0020 (25/01)  ──┘

La fattura conterrà tutte le righe dei DDT consolidati, con riferimento ai documenti di trasporto.

Link tra documenti

Tabella document_links

Ogni trasformazione crea un record nella tabella document_links:

Campo Descrizione
source_id ID documento origine
source_type Tipo origine (quote, order, ecc.)
target_id ID documento destinazione
target_type Tipo destinazione
link_type derived (trasformazione) o consolidated (raggruppamento)

Tabella document_line_links

Per ogni riga trasferita:

Campo Descrizione
source_line_id ID riga origine
target_line_id ID riga destinazione
source_quantity Quantità originale
transferred_quantity Quantità trasferita

API per sviluppatori

POST /api/documents/transform

Trasforma un documento in un altro tipo.

{
  "sourceId": "doc_abc123",
  "targetType": "invoice",
  "lines": [
    { "sourceLineId": "line_1", "quantity": 10 },
    { "sourceLineId": "line_2", "quantity": 5 }
  ]
}

POST /api/documents/consolidate

Consolida più documenti in uno.

{
  "sourceIds": ["ddt_001", "ddt_002", "ddt_003"],
  "targetType": "invoice"
}

GET /api/documents/:id/flow

Restituisce la catena di documenti collegati.

{
  "ancestors": [
    { "id": "quo_001", "type": "quote", "code": "QUO-2026-0001" }
  ],
  "descendants": [
    { "id": "ord_001", "type": "order", "code": "ORD-2026-0001" },
    { "id": "fat_001", "type": "invoice", "code": "FAT-2026-0001" }
  ]
}

Domande frequenti

Posso annullare una trasformazione?

No direttamente. Se hai creato un documento per errore, puoi annullarlo (stato "Annullato"), ma non viene ripristinata la quantità disponibile nel documento origine.

Posso trasformare lo stesso preventivo più volte?

Sì, se ci sono ancora righe con quantità disponibile. Puoi creare più ordini dallo stesso preventivo.

I prezzi vengono aggiornati nella trasformazione?

No, i prezzi vengono copiati dal documento origine. Se vuoi prezzi diversi, modifica il documento destinazione prima di confermarlo.

Cosa succede se elimino un documento nella catena?

Non puoi eliminare documenti confermati. Se annulli un documento intermedio, la catena rimane visibile ma quel documento risulterà "Annullato".

Prossimi passi