Files
Khaemhat/docs/wiki/Vendite.md
T
Alby96andClaude Opus 5.5 88de272b3e docs: avoid ambiguous Unicode and record Gitea planning in STATUS
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>
2026-11-10 22:44:14 +01:00

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, famiglia sales.* · 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

020 · Fattura di vendita · righe 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).

021 · Fattura di vendita · testata Mockup 021 — scheda Testata con i gruppi Documento, Controparte, Condizioni, Magazzino e trasporto (anteprima ridotta).

022 · Fattura di vendita · tema scuro 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

026 · Preventivo / offerta con revisioni 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).

  1. Crea il preventivo, inserisci le righe e invialo per e-mail.
  2. Se il cliente chiede modifiche usa Nuova revisione: la versione precedente resta consultabile come superata.
  3. Segna l'esito con Accettato o Rifiutato.
  4. 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

027 · Ordine cliente · evasione e residui 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)

028 · DDT · dati di trasporto, colli, firme 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

  1. Vendite → Fatture, Nuovo (Ctrl+N) oppure parti da un ordine o da un DDT con Evadi da….
  2. Scegli il cliente (F4 per cercare): condizioni, listino, agente e destinazione vengono proposti.
  3. Inserisci le righe: il prezzo segue l'ordine netto cliente → listino cliente → listino base → prezzo articolo (vedi Articoli e listini).
  4. Controlla castelletto IVA, scadenze e totali.
  5. Conferma ed emetti: assegna il numero, blocca il documento, scarica il magazzino (accompagnatoria), genera scadenze e registrazione contabile.
  6. 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)

029 · Nota 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

030 · Fatturazione differita · procedura guidata Mockup 030 — procedura in quattro passi: parametri, selezione dei DDT non fatturati nel periodo, anteprima delle fatture, generazione (anteprima ridotta).

  1. 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.
  2. Selezione DDT: elenco dei DDT non fatturati nel periodo con la fattura che verrà generata; togli la spunta ai DDT da escludere.
  3. Anteprima fatture: numero di fatture e totale.
  4. 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 esempio FT/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

025 · Anteprima di stampa / PDF 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