Gitea flags en dash, multiplication sign, minus sign and single angle quotes as confusable characters, which put a warning on most pages; use plain equivalents (docs/SPEC.md stays untouched). STATUS.md now lists the issue numbers per milestone, the items waiting for the owner and the open specification questions tracked by issue #114. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
18 KiB
Vendite
Stato: bozza · Ultima revisione: 2026-11-10 · Versione software: non ancora rilasciata (milestone M5) Modulo di licenza: CORE (XML SDI con EINV, contabilizzazione con ACCT, partite con FIN) · Permessi principali:
sales.invoice.issue,sales.deliverynote.reopen, famigliasales.*· Specifica: SPEC §11.3, §11.4
Il modulo Vendite gestisce l'intero ciclo attivo: preventivi, ordini clienti, DDT, fatture (immediate, accompagnatorie, differite, acconti, semplificate), note di credito e di debito, pro-forma, parcelle, la fatturazione differita guidata e i corrispettivi registrati a mano. Tutti i documenti usano lo stesso motore e la stessa maschera.
Dove si trova
Menu Vendite → Preventivi, Ordini clienti, DDT, Fatture, Note di credito, Fatturazione differita.
Il motore dei documenti in sintesi
Ogni tipo di documento è descritto da una definizione che stabilisce: numeratore e sezionale, causale di magazzino (se il documento carica o scarica merce), effetti (impegno, scarico, partite, registrazione contabile), da quali documenti può essere evaso (ad esempio un DDT da un ordine), tipo documento SDI (TD), causale contabile, registro IVA e modello di stampa.
I documenti sono collegati riga per riga: quando un DDT evade un ordine, ogni riga del DDT ricorda la riga d'ordine di origine e la quantità evasa. Così Khaemhat calcola i residui, permette di riaprirli e scrive nel file XML della fattura i riferimenti all'ordine (DatiOrdineAcquisto) e ai DDT (DatiDDT).
Preventivo ──trasforma──► Ordine cliente ──evadi──► DDT ──fattura differita──► Fattura TD24
└────────────── evadi ──────────────► Fattura immediata TD01
Alla conferma, in un'unica operazione indivisibile, il documento riceve il numero, muove il magazzino, genera le scadenze e le partite, crea la registrazione contabile e gli allegati: o riesce tutto o non cambia nulla.
La maschera di un documento di vendita
Mockup 020 — fattura in bozza: toolbar con Conferma ed emetti, XML SDI, Contabilizza, Evadi da…; intestazione; righe con riga descrittiva; castelletto IVA, scadenze e totali (anteprima ridotta).
Mockup 021 — scheda Testata con i gruppi Documento, Controparte, Condizioni, Magazzino e trasporto (anteprima ridotta).
Mockup 022 — la stessa fattura in tema scuro con accento Malachite (anteprima ridotta).
La struttura è quella descritta in Interfaccia e scorciatoie: toolbar, intestazione a tre blocchi, schede Righe (si apre lì), Testata, Totali, Trasporto, Scadenze, Dati SDI/PA, Note, Allegati, Collegamenti, Storico.
| Gruppo della Testata | Campi |
|---|---|
| Documento | Tipo documento, Sezionale/Numero, Data *, Registro IVA, Competenza IVA, Valuta, Cambio, Vostro riferimento |
| Controparte | Cliente *, Destinazione, Fatturare a, Agente, Listino |
| Condizioni | Pagamento, Inizio rate (es. fine mese), Banca azienda, Sconto piede %, Spese incasso, Bollo (automatico) |
| Magazzino e trasporto | Causale magazzino, Deposito, Vettore, Porto, Colli |
Scegliendo il cliente, Khaemhat propone destinazione, listino, pagamento, agente e banca dalle sue condizioni commerciali; dal tipo documento propone causale e deposito.
Le righe hanno: articolo, descrizione, UM, quantità, prezzo, sconti (anche 5+2), codice IVA, importo, deposito,
data di consegna. Le righe descrittive (solo testo) servono per riferimenti e note. Sotto la griglia: castelletto
IVA (imponibile e imposta per codice IVA, esigibilità), scadenze (rate con data, metodo e importo) e
totali.
Tipi di documento e codici TD
| Documento | Codice TD (SDI) | Note |
|---|---|---|
| Fattura immediata | TD01 | emessa contestualmente alla cessione o prestazione |
| Fattura accompagnatoria | TD01 | fattura con i dati di trasporto, fa anche da documento di trasporto e scarica il magazzino |
| Fattura di acconto/anticipo su fattura | TD02 | |
| Fattura di acconto/anticipo su parcella | TD03 | |
| Nota di credito | TD04 | riferita alla fattura da stornare |
| Nota di debito | TD05 | |
| Parcella | TD06 | con ritenuta d'acconto e cassa previdenza |
| Fattura semplificata | TD07 | per importi fino a 400 euro |
| Nota di credito semplificata | TD08 | |
| Nota di debito semplificata | TD09 | |
| Fattura differita (beni con DDT, servizi documentati) | TD24 | art. 21, comma 4, lett. a) DPR 633/72 |
| Fattura differita (triangolazioni interne) | TD25 | art. 21, comma 4, terzo periodo, lett. b) |
| Cessione di beni ammortizzabili e passaggi interni | TD26 | anche dalle dismissioni dei cespiti |
| Autoconsumo o cessioni gratuite senza rivalsa (omaggi) | TD27 | |
| Pro-forma | — | non è un documento fiscale: niente numerazione fiscale né XML |
Le autofatture e le integrazioni (TD16-TD29) sono negli Acquisti. L'elenco completo dei codici è in Fiscalità italiana.
Preventivi
Mockup 026 — preventivo inviato, revisione 2 di 2, collegato a un'opportunità CRM; azioni Trasforma in ordine, Nuova revisione, Accettato, Rifiutato (anteprima ridotta).
Il preventivo (offerta) ha una validità (es. 30 giorni, con data di scadenza) e uno stato (Bozza, Inviato, Accettato, Rifiutato). Le schede sono Righe, Testata, Totali, Condizioni e note, Revisioni, Allegati, CRM; sotto le righe il pannello Revisioni elenca le versioni con data, totale ed esito (Superata, Inviata).
- Crea il preventivo, inserisci le righe e invialo per e-mail.
- Se il cliente chiede modifiche usa Nuova revisione: la versione precedente resta consultabile come superata.
- Segna l'esito con Accettato o Rifiutato.
- Trasforma in ordine crea l'ordine cliente con le stesse righe e collega i due documenti.
Con il modulo CRM il preventivo è collegato all'opportunità e ne aggiorna valore e fase (vedi CRM). L'intestazione mostra anche il margine a chi può vedere i costi.
Ordini clienti
Mockup 027 — ordine di una PA con split payment, evaso al 38%: righe con ordinato, evaso, residuo, disponibile e stato; documenti collegati (anteprima ridotta).
Azioni contestuali: Genera DDT, Genera fattura, Impegna, Ordina a fornitore, Chiudi residuo.
- Evasione: la griglia Righe e stato di evasione mostra per ogni riga quantità ordinata, evasa, residua e disponibile, con uno stato (Evaso, Parziale, Impegnato, Da ordinare, Aperto) e una barra di avanzamento. Il pannello Documenti collegati elenca DDT e fatture già generati e gli ordini fornitore nati dall'ordine.
- Impegnato: un ordine confermato impegna la merce, che resta in giacenza ma non è più disponibile per altri.
- Residui: le quantità non evase restano aperte finché non vengono consegnate o chiuse con Chiudi residuo.
- Ordina a fornitore: per le righe non disponibili crea un ordine fornitore.
- Fido e scaduto: se il cliente supera il fido o ha pagamenti scaduti, la conferma è bloccata; chi ha il permesso di forzatura può procedere indicando il motivo.
- Dati PA: per la pubblica amministrazione la scheda Dati PA (CIG/CUP) raccoglie CIG, CUP e riferimenti alla determina, riportati poi nell'XML della fattura.
DDT (documenti di trasporto)
Mockup 028 — DDT confermato e scaricato, da fatturare: scheda Trasporto con causale, vettore, porto, colli e pesi, firme (anteprima ridotta).
Il DDT accompagna la merce e scarica il magazzino alla conferma. Azioni: Stampa 3 copie, Fattura questo DDT, Etichette colli, Riapri.
| Gruppo (scheda Trasporto) | Campi |
|---|---|
| Trasporto | Causale del trasporto (vendita, reso, conto visione…), Trasporto a mezzo (mittente, destinatario, vettore), Vettore, Porto, resa (Incoterms), Inizio trasporto (data e ora), Targa, Annotazioni |
| Colli e pesi | Aspetto esteriore dei beni, Numero colli, Peso lordo, Peso netto, Volume, Pallet, Tracking |
| Firme | Conducente, Vettore, Destinatario (firme sulla stampa) |
Il DDT si stampa in tre copie. Un DDT confermato ha le righe non modificabili; Riapri (permesso
sales.deliverynote.reopen) storna lo scarico e lo rigenera alla nuova conferma. I resi da cliente si
registrano con un DDT con causale di reso, che ricarica il magazzino.
Fatture
- Vendite → Fatture, Nuovo (
Ctrl+N) oppure parti da un ordine o da un DDT con Evadi da…. - Scegli il cliente (F4 per cercare): condizioni, listino, agente e destinazione vengono proposti.
- Inserisci le righe: il prezzo segue l'ordine netto cliente → listino cliente → listino base → prezzo articolo (vedi Articoli e listini).
- Controlla castelletto IVA, scadenze e totali.
- Conferma ed emetti: assegna il numero, blocca il documento, scarica il magazzino (accompagnatoria), genera scadenze e registrazione contabile.
- XML SDI genera il file FatturaPA, che si invia dal canale configurato (vedi Fatturazione elettronica).
Una fattura emessa non si modifica. Per correggerla si emette una nota di credito; se l'XML non è ancora stato inviato allo SDI si può annullare indicando il motivo.
Note di credito (TD04)
Mockup 029 — nota di credito che storna una riga della fattura per reso merce difettosa, con rientro a magazzino e compensazione della partita (anteprima ridotta).
La nota di credito indica la fattura stornata, il motivo e la causale (ad esempio reso da cliente); se c'è un reso la merce rientra a magazzino. Il pannello Partite mostra l'effetto sulla partita della fattura (ad esempio chiude parzialmente la rata 1/1). L'XML è di tipo TD04 e riporta il riferimento alla fattura d'origine. La nota di debito (TD05) funziona allo stesso modo per gli addebiti integrativi.
Pro-forma
Documento non fiscale (ad esempio per chiedere un anticipo): stessa maschera della fattura, senza numerazione fiscale, senza XML e senza registrazione contabile. Si trasforma in fattura quando serve.
Parcelle (TD06)
Per le aziende o gli studi che emettono parcelle: la parcella calcola la cassa previdenza (contributo integrativo, con IVA propria) e la ritenuta d'acconto che il cliente tratterrà, e mostra il netto a pagare. Gli acconti su parcella usano TD03.
Fatturazione differita guidata
Mockup 030 — procedura in quattro passi: parametri, selezione dei DDT non fatturati nel periodo, anteprima delle fatture, generazione (anteprima ridotta).
- Parametri: DDT dal… al…, data fattura, sezionale, tipo (Fattura differita TD24), raggruppa (per cliente, rispettando la preferenza di raggruppamento del cliente), Genera XML SDI, Invia e-mail al cliente.
- Selezione DDT: elenco dei DDT non fatturati nel periodo con la fattura che verrà generata; togli la spunta ai DDT da escludere.
- Anteprima fatture: numero di fatture e totale.
- Generazione: numera le fatture, le contabilizza e, se richiesto, genera l'XML. I riferimenti ai DDT sono riportati in riga e nell'XML (DatiDDT).
La fattura differita va emessa entro il giorno 15 del mese successivo a quello delle consegne. La stessa procedura è eseguibile da attività programmata (vedi Automazioni).
Stati
| Documenti (preventivi, ordini, DDT) | Significato |
|---|---|
| Bozza | modificabile, senza numero definitivo, nessun effetto |
| Confermato | numerato, effetti applicati (impegno, scarico) |
| Evaso parzialmente / Evaso | una parte o tutto è passato al documento successivo |
| Chiuso | concluso (anche con residuo chiuso a mano) |
| Annullato | annullato con motivo |
| Fatture e note | Significato |
|---|---|
| Bozza | modificabile |
| Emessa | numerata, contabilizzata, immutabile |
| XML generato | file FatturaPA pronto |
| Inviata allo SDI | in attesa di esito |
| Consegnata | recapitata al cliente |
| Scartata | rifiutata dallo SDI: va corretta e rigenerata |
| Non consegnata | impossibile recapitarla: è disponibile nell'area riservata del cliente |
Altri badge indicano lo stato contabile (Non contabilizzata), del magazzino (Scaricato) o della fatturazione (Da fatturare).
Numerazione
- Formato
{prefisso}/{anno}/{numero a 6 cifre}, ad esempioFT/2026/000418, per sezionale (FT, NC, DDT…) e anno, configurato nei numeratori (vedi Tabelle azienda). - Il numero è assegnato alla conferma, in modo atomico: le bozze non consumano numeri.
- Per fatture e note di credito non sono ammessi buchi e la data non può essere anteriore a quella dell'ultimo documento numerato nello stesso sezionale.
- La data deve cadere in un periodo fiscale aperto (vedi esercizi e periodi in Tabelle azienda).
Calcolo dei totali
| Elemento | Regola |
|---|---|
| Imponibile di riga | quantità x prezzo x (1 - sconto 1) x (1 - sconto 2)…, arrotondato a 2 decimali (arrotondamento commerciale) |
| Castelletto IVA | imponibili raggruppati per codice IVA; imposta calcolata per aliquota sul totale del gruppo |
| Spese | trasporto, incasso ecc. con il proprio codice IVA |
| Sconto piede | ripartito sulle righe |
| Bollo | 2,00 euro automatici se le operazioni esenti, non imponibili o fuori campo IVA superano 77,47 euro; la scheda del cliente indica se è a carico del cliente |
| Ritenuta d'acconto | sulle parcelle, calcolata sull'imponibile previsto; il netto a pagare la esclude |
| Cassa previdenza | contributo sulle parcelle, con IVA propria |
| Split payment | per PA e soggetti obbligati: l'IVA è esposta ma versata dal cliente all'Erario; il totale da versare è il solo imponibile (esigibilità S) |
| Reverse charge | fattura senza IVA con natura N6.x: l'imposta la integra il cliente |
| IVA per cassa | esigibilità differita al pagamento per chi ha aderito al regime (gestione completa prevista in fase 2) |
Scadenze: generate dalla condizione di pagamento (rate, giorni, fine mese, giorno fisso, percentuali, IVA sulla prima rata, sconto cassa); l'eventuale differenza di arrotondamento va sull'ultima rata.
Stampa, PDF ed e-mail
Mockup 025 — anteprima di stampa della fattura: modello, copie, lingua, zoom (anteprima ridotta).
Ctrl+P apre l'anteprima di stampa in una nuova scheda: si scelgono modello, numero di copie e
lingua, si ingrandisce (50%, 100%, adatta) e si stampa, si scarica il PDF o lo si invia. La stampa contiene le
diciture di legge previste ed è sempre in tema chiaro. Ogni PDF generato diventa un allegato versionato del
documento (vedi Allegati e file).
L'invio per e-mail o PEC allega il PDF (e, se richiesto, l'XML o la copia di cortesia ZIP) usando i modelli e-mail dell'azienda; il canale preferito è nelle condizioni del cliente.
Collegamenti, duplicazione e corrispettivi
- Collegamenti: la scheda omonima mostra i documenti di origine e quelli generati (ordine → DDT → fattura) con le quantità; l'icona Collegamenti della toolbar apre lo stesso elenco.
- Duplica crea un nuovo documento in bozza con le stesse righe; la trasformazione cambia tipo mantenendo i collegamenti (preventivo → ordine).
- Corrispettivi: le vendite al dettaglio si registrano a mano come corrispettivi giornalieri.
Report
Giornale vendite, fatturato per cliente, agente, categoria e articolo (vedi Report), DDT da fatturare, ordini aperti, provvigioni agenti, margini (con il modulo REPORT).
Permessi e licenza
Le vendite sono nel modulo CORE. Emettere una fattura richiede sales.invoice.issue; riaprire un DDT
sales.deliverynote.reopen; forzare un blocco di fido un permesso di tipo override. La generazione e l'invio
dell'XML richiedono EINV, la registrazione contabile ACCT, partite e incassi FIN.
Domande frequenti
- Non riesco a confermare la fattura: "data anteriore all'ultima numerata". Nello stesso sezionale esiste una fattura con data successiva: correggi la data o usa un altro sezionale.
- Il bollo non viene calcolato. Il bollo è automatico solo se la parte esente, non imponibile o fuori campo supera 77,47 euro; controlla i codici IVA delle righe.
- Devo correggere una fattura già inviata. Emetti una nota di credito (TD04) e una nuova fattura.
Pagine correlate
Anagrafiche · Articoli e listini · Magazzino · Allegati e file · Fatturazione elettronica · Contabilità · Scadenzario · CRM · Fiscalità italiana