Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
836a316b05 | ||
|
|
246d6f9357 | ||
|
|
b78260beb0 | ||
|
|
9d7cb9e71f | ||
|
|
fb12411404 | ||
|
|
709bb13532 | ||
|
|
0debd82983 | ||
|
|
f38b5894ce | ||
|
|
aef0a0d233 | ||
|
|
4014373797 | ||
|
|
5bbc2120a1 | ||
|
|
562bf98092 | ||
|
|
5fbbe4d3a4 | ||
|
|
b12dc79317 | ||
|
|
88a0c8ce9c | ||
|
|
cfca29d71c | ||
|
|
9e3ba92993 | ||
|
|
838362bfe1 | ||
|
|
7f8cb57a08 | ||
|
|
4b759ee96e | ||
|
|
cd4cb85562 | ||
|
|
ced689b297 | ||
|
|
eb301fa570 | ||
|
|
f8b72f4d17 | ||
|
|
eeabb12f96 | ||
|
|
20b2421eea | ||
|
|
9a40adecfe | ||
|
|
2c56c0dff0 | ||
|
|
cd3e22e8c7 | ||
|
|
4123ccacb2 | ||
|
|
826042f828 | ||
|
|
f12848865d | ||
|
|
ddd2273f7e | ||
|
|
fa9304834a |
No files matched your search
@@ -7,6 +7,282 @@ un'immagine `gitea.encke-hake.ts.net/balbosoft/khaemhat:X.Y.Z`.
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [0.9.0] - 2026-11-13
|
||||
|
||||
M9 - Fatturazione elettronica. Le fatture emesse diventano file FatturaPA controllati prima dell'invio con i codici
|
||||
dello SDI e partono dal canale scelto dalle regole di instradamento (PEC, SdICoop o due intermediari); le notifiche
|
||||
aggiornano da sole file e documenti, gli scarti si correggono e si rigenerano, le fatture dei fornitori arrivano in
|
||||
una casella da registrare e i file di un periodo si esportano per la conservazione.
|
||||
|
||||
### Added
|
||||
- File FatturaPA (#74, ADR 0039): `FatturaPaWriter` scrive `FPR12`, `FPA12` e `FSM10` v1.2 con nome
|
||||
`IT<identificativo>_<progressivo>.xml` e progressivo in base 36 mai riusato; il modello del documento viene da
|
||||
`EInvoiceBuilder` (cedente, cessionario, ritenute, cassa, bollo, sconti, riferimenti, DDT, riepilogo IVA,
|
||||
pagamenti, allegati).
|
||||
- Controllo prima dell'invio (#74): `FatturaPaValidator` ripete offline i controlli dello SDI con lo stesso codice
|
||||
(00305-00473) e le tolleranze delle specifiche 1.9.1, più la struttura contro uno schema incorporato;
|
||||
*Controlla senza generare* sul cruscotto.
|
||||
- Notifiche SDI (#75): `SdiReceiptReader` legge RC, NS, MC, NE, DT, AT, SE e MT; ogni notifica è conservata una sola
|
||||
volta, abbinata al file e applicata al file e al documento nella stessa transazione; import manuale di XML, P7M e
|
||||
ZIP del portale; pagina *Notifiche SDI* con filtri e download.
|
||||
- Canali (#76, #77): PEC con SMTP e un client IMAP e un lettore MIME scritti in casa (primo invio a
|
||||
`sdi01@pec.fatturapa.it`, poi l'indirizzo appreso dallo SDI, cartella di archivio), SdICoop SOAP/MTOM con
|
||||
certificato client, Intermediario A (chiave API) e Intermediario B (utente e password) dietro lo stesso contratto
|
||||
`IEInvoiceTransport` (ADR 0040); prova di connessione, pausa, segreti cifrati.
|
||||
- Instradamento (#77): regole *Sempre*, *Cliente PA*, *Cliente specifico*, *Tipo documento* e *Volume giornaliero*
|
||||
con canale di riserva (`SdiRouter`); pagina *Canali di trasmissione* (mockup 059).
|
||||
- Lettura dei canali (#76): attività `einvoice.poll` ogni 15 minuti e *Leggi i canali ora*; un messaggio si conferma
|
||||
solo quando tutti i suoi file sono salvati. Ricezione push di SdICoop su `POST /sdicoop/{azienda}` con la chiave
|
||||
di ricezione nell'intestazione `X-Khaemhat-SdiCoop-Key` e il certificato reciproco sul reverse proxy.
|
||||
- Cruscotto SDI (#74, #75, mockup 058): sei contatori, viste *Emesse*, *Autofatture* e *Da fare*, filtri e
|
||||
ricerca, documenti da generare, *Genera + invia*, *Invia*, *Correggi*, *Segna come inviata*, download dell'XML,
|
||||
storico del file con le versioni sostituite, esito della trasmissione; avvisi sulla Home per scarti e file da
|
||||
inviare (`EInvoiceFeedSource`).
|
||||
- Copia di cortesia (#74): il PDF del documento con il file FatturaPA allegato (`/AF`).
|
||||
- Fatture ricevute (#79): casella delle fatture dei fornitori dai canali o caricate (XML, P7M, metadati, ZIP) senza
|
||||
doppioni, registrazione singola o in blocco con l'import del ciclo passivo, scarto e ripristino, download.
|
||||
- Conservazione (#79): pacchetto ZIP di un periodo (fino a due anni) con `emesse/`, `ricevute/`, `notifiche/`,
|
||||
`indice.csv` con SHA-256 e `LEGGIMI.txt`, e l'elenco dei pacchetti preparati.
|
||||
- Fatturazione elettronica nei dati di esempio con il modulo EINV (#80): canale PEC in pausa, Intermediario A
|
||||
disattivato, tre regole, i file delle fatture demo con consegne, uno scarto corretto, una mancata consegna e file
|
||||
in attesa, tre fatture di fornitori da registrare.
|
||||
- Rimozione dei dati di esempio (#80, ADR 0040): `DemoDataRemover` guidato dallo schema delle migrazioni elimina le
|
||||
righe `is_demo` e quelle che appartengono loro in una transazione e si ferma se dati dell'utente vi fanno
|
||||
riferimento; `scripts/seed.sh --remove-demo [--company CODICE]`; il seed stampa il tempo impiegato.
|
||||
- Permessi `einvoice.document.read`, `einvoice.document.send`, `einvoice.inbox.read`, `einvoice.inbox.import`,
|
||||
`einvoice.channel.manage`; testi in `Resources/it-IT/EInvoicing.json`.
|
||||
- Tabelle `e_invoices`, `e_invoice_notifications`, `e_invoice_inbox`, `e_invoice_channels`, `e_invoice_routing`,
|
||||
`e_invoice_conservation` (migrazione `M20261113_004`).
|
||||
- ADR 0039 e 0040; pagina wiki *Fatturazione elettronica* completa con le schermate (#81).
|
||||
|
||||
### Changed
|
||||
- Il menu *Fatturazione elettronica* ha le voci *Cruscotto SDI*, *Fatture ricevute*, *Notifiche SDI*,
|
||||
*Conservazione* e *Canali di trasmissione*, ognuna con il suo permesso; *Dichiarazioni d'intento* resta in M10.
|
||||
- Una fattura scartata dallo SDI torna modificabile e si rigenera con un nuovo file.
|
||||
- I seeder dimostrativi marcano come demo anche le righe scritte dai servizi per loro (registrazioni, partite,
|
||||
pagamenti, mandati, estratti conto).
|
||||
- Il modello delle fatture ricevute è condiviso con quello delle emesse (`EInvoice*` nelle astrazioni fiscali).
|
||||
|
||||
## [0.8.0] - 2026-11-13
|
||||
|
||||
M8 - Scadenzario e tesoreria. Le partite aperte di clienti e fornitori si chiudono con incassi e pagamenti che si
|
||||
contabilizzano da soli; distinte RiBa, SDD e bonifici SEPA con il file per l'home banking, presentazione, accredito
|
||||
e insoluti; riconciliazione dell'estratto conto con abbinamento automatico; solleciti con interessi di mora e flusso
|
||||
di cassa.
|
||||
|
||||
### Added
|
||||
- Scadenzario (#69, ADR 0038): partite aperte di clienti e fornitori dalla contabilità con stati, aging in cinque
|
||||
fasce, filtri, modifica di scadenza, metodo, banca e contestazione, estratto conto della controparte con gli
|
||||
interessi di mora, export CSV.
|
||||
- Incassi e pagamenti (#69): su più partite della stessa controparte, totali o parziali, con abbuoni, spese bancarie,
|
||||
differenze cambio e note di credito; registrazione `INC` o `PAG` nella stessa transazione; annullamento con storno;
|
||||
la ritenuta d'acconto di una parcella diventa dovuta quando la fattura è saldata. Elenchi *Incassi* e *Pagamenti*.
|
||||
- Distinte (#70): RiBa nel tracciato CBI (`RibaCbiWriter`), SDD core e B2B in `pain.008.001.08` e bonifici SEPA in
|
||||
`pain.001.001.09` (`SepaXmlWriter`); candidati con controllo di IBAN, ABI/CAB e mandato; bozza, file, presentazione
|
||||
su *Effetti all'incasso* o con anticipo *salvo buon fine*, accredito, insoluto con riapertura della partita e
|
||||
spese come nuova partita del cliente.
|
||||
- Mandati SDD (#70) con riferimento univoco, schema core o B2B, firma, revoca, sequenza FRST/RCUR.
|
||||
- Riconciliazione bancaria (#71): import di estratti CSV (colonne riconosciute dall'intestazione), CBI e CAMT.053
|
||||
senza doppioni (impronta dei movimenti); proposte con confidenza da partite, incassi e pagamenti registrati, F24,
|
||||
accrediti e insoluti di distinte e regole salvate (`BankMatcher`); conferma singola o di tutte le proposte dal
|
||||
90%; abbinamento manuale, registrazione su conto con regola, *Ignora*, *Annulla abbinamento*; saldo banca, saldo
|
||||
contabile e differenza.
|
||||
- Solleciti (#72): tre livelli modificabili con giorni, modello, canali (e-mail, PEC, lettera PDF), interessi di
|
||||
mora, avviso all'agente e blocco del cliente; proposta di invio che esclude PA, partite contestate e in distinta;
|
||||
anteprima PDF, invio con la coda di posta, lettere in un PDF unico, registro degli invii; attività programmata
|
||||
`finance.dunning` nei giorni feriali alle 7:00 per i livelli automatici.
|
||||
- Interessi di mora del D.Lgs. 231/2002 nel pacchetto italiano (`LatePaymentRulesIt`): tasso BCE del semestre più
|
||||
8 punti, 10,15% nel primo semestre 2026 e 10,40% nel secondo.
|
||||
- Flusso di cassa (#72) a 30-365 giorni per settimana o mese da partite, effetti presentati, ordini non fatturati,
|
||||
registrazioni ricorrenti e F24, con le fonti selezionabili e il punto più basso.
|
||||
- Scadenze di incassi e pagamenti e crediti scaduti sulla Home (`TreasuryFeedSource`).
|
||||
- Menu *Scadenzario* con otto voci; testi in `Resources/it-IT/Treasury.json`; permessi `finance.schedule.*`,
|
||||
`finance.payment.*`, `finance.bank.reconcile`.
|
||||
- Tesoreria nei dati di esempio con il modulo FIN (#73): banca, versamento dei soci, incassi e pagamenti, distinta
|
||||
accreditata con un insoluto, distinta s.b.f. in bozza, mandato, estratto CSV da riconciliare con una regola, primo
|
||||
sollecito.
|
||||
- Tabelle `payments`, `payment_lines`, `remittances`, `remittance_lines`, `sdd_mandates`, `bank_statements`,
|
||||
`bank_statement_lines`, `bank_match_rules`, `dunning_levels`, `dunning_letters`; nuove colonne di
|
||||
`gl_open_items` e `bank_accounts.creditor_id` (migrazione `M20261113_003`).
|
||||
- Conti *Perdite su cambi*, *Utili su cambi* e *Interessi di mora attivi* nel piano dei conti PMI standard (240 conti).
|
||||
- ADR 0038; pagina wiki *Scadenzario* completa con le schermate.
|
||||
|
||||
### Changed
|
||||
- La rettifica della registrazione di un documento mantiene le partite già incassate o pagate.
|
||||
- Il menu *Fatturazione elettronica* mostra M9 come milestone.
|
||||
|
||||
### Fixed
|
||||
- Le strisce di riepilogo non si schiacciano più nelle pagine più alte della finestra.
|
||||
|
||||
## [0.7.0] - 2026-11-13
|
||||
|
||||
M7 - Contabilità generale e IVA. Ogni fattura, nota e autofattura si contabilizza da sola nella stessa transazione,
|
||||
con le righe IVA nel suo registro, le partite aperte e la ritenuta; la prima nota in partita doppia con registrazioni
|
||||
provvisorie, definitive e storni; registri IVA, liquidazione periodica con F24 e LIPE, ritenute, bollo virtuale,
|
||||
partitari, mastrini e bilancio di verifica.
|
||||
|
||||
### Added
|
||||
- Piano dei conti a tre livelli (#62, ADR 0036): mastro, conto e sottoconto (`MM.CC.SSS`), natura, tipo, voce CEE,
|
||||
partitario, rilevanza IVA; modello italiano *PMI standard* di 237 conti nel pacchetto fiscale
|
||||
(`ItalianLedgerTemplate`), albero con ricerca, scheda e mastrino con saldo progressivo e stampa.
|
||||
- Causali contabili con righe proposte, registro IVA, apertura delle partite e causale di storno (#62): `FV`, `NCV`,
|
||||
`FA`, `NCA`, `AFRC`, `CORR`, `INC`, `PAG`, `RIT`, `RITS`, `LIQ`, `F24`, `GIRO`, `SPB`, `STO` e altre.
|
||||
- Prima nota (#63): registrazioni in partita doppia con cliente o fornitore sui conti con partitario, centro di
|
||||
costo e righe IVA; bozza, registrata (numero per anno) e definitiva (numero del libro giornale) con *Rendi
|
||||
definitive*; storno; *Chiudi lo sbilancio*; filtri e paginazione.
|
||||
- Registrazioni ricorrenti (#63): copia di una registrazione modello mensile, trimestrale, semestrale o annuale fino
|
||||
a una data, job di sistema `ledger.recurring` ogni giorno alle 5:00 e *Genera ora*.
|
||||
- Contabilizzazione automatica dei documenti (#64, ADR 0037): fatture, note di debito, parcelle, note di credito,
|
||||
fatture e note fornitore, autofatture e integrazioni scrivono la registrazione alla conferma (`PostingEngine`,
|
||||
`LedgerPoster`), la riscrivono con lo stesso numero alla modifica e la tolgono o la stornano all'annullamento;
|
||||
scissione dei pagamenti, IVA indetraibile sul costo, rivalsa cassa e bollo; *Contabilizza documenti* per i
|
||||
documenti confermati prima.
|
||||
- Registri IVA vendite, acquisti, autofatture e corrispettivi (#65) con riepilogo per aliquota, stampa di prova e
|
||||
definitiva con numerazione delle pagine.
|
||||
- Liquidazione IVA mensile o trimestrale (#65): IVA a debito e a credito, pro rata, credito e debito riportati,
|
||||
interessi trimestrali, minimo di versamento, acconto di dicembre (storico, previsionale, effettivo); conferma con la
|
||||
registrazione `LIQ`, il blocco dei periodi e il versamento F24; riapertura; file della comunicazione LIPE
|
||||
(`IVP18`) e dati F24. Regole e codici tributo nel pacchetto italiano (`VatSettlementRulesIt`).
|
||||
- Ritenute d'acconto operate e subite (#66): da versare quando la fattura del professionista è pagata, registrazioni
|
||||
`RIT` e `RITS`, codice 1040 al 16 del mese dopo; dati della certificazione unica in CSV.
|
||||
- Bollo virtuale per trimestre (#66) con soglia dei 5.000 euro, codici 2521-2524 e scadenze.
|
||||
- Prospetto F24 per scadenza (#66) con export dei dati e registrazione del pagamento `F24` sulla banca
|
||||
dell'azienda.
|
||||
- Partitari clienti e fornitori con estratto conto e partite aperte, bilancio di verifica per mastri, conti e
|
||||
sottoconti con centro di costo e risultato del periodo, libro giornale di prova e definitivo in PDF (#67).
|
||||
- Menu *Contabilità*; testi in `Resources/it-IT/Ledger.json`; permessi `ledger.account.*`, `ledger.entry.*`,
|
||||
`vat.register.read`, `vat.settlement.*`.
|
||||
- Contabilità nei dati di esempio (#68): documenti contabilizzati, fattura del professionista pagata, noleggio
|
||||
mensile della stampante come ricorrente, liquidazioni dei mesi passati confermate e F24 scaduti pagati.
|
||||
- Tabelle `gl_accounts`, `gl_journal_templates`, `gl_journal_template_lines`, `gl_entries`, `gl_entry_lines`,
|
||||
`gl_entry_vat`, `gl_open_items`, `gl_recurring_entries`, `vat_registers`, `vat_register_prints`,
|
||||
`vat_settlements`, `vat_settlement_lines`, `tax_payments`, `withholdings` (migrazione `M20261113_002`).
|
||||
- ADR 0036 e 0037; pagine wiki *Contabilità*, *IVA* e *Fiscalità italiana* complete con le schermate.
|
||||
|
||||
### Changed
|
||||
- *Bollo virtuale* passa dal menu *Fatturazione elettronica* al menu *Contabilità*.
|
||||
- Il seed di base e *Aggiorna da tabelle base* aggiungono piano dei conti, causali e registri IVA alle aziende
|
||||
esistenti.
|
||||
|
||||
## [0.6.0] - 2026-11-12
|
||||
|
||||
M6 — Acquisti e Magazzino. Il ciclo passivo dall'ordine al fornitore alla fattura protocollata, le fatture
|
||||
elettroniche ricevute importate in bozza, le autofatture con la loro scadenza e un magazzino che si aggiorna da solo
|
||||
con i documenti: giacenze per deposito, costo medio, inventario, riordino e valorizzazione.
|
||||
|
||||
### Added
|
||||
- Movimenti di magazzino dai documenti (#59, ADR 0035): alla conferma DDT, fatture immediate e accompagnatorie, note,
|
||||
DDT e fatture fornitore, note di credito fornitore e movimenti `MM` scrivono i loro movimenti nella stessa
|
||||
transazione (`inventory_entries`, `inventory_entry_lines`); l'annullamento li toglie. La causale del tipo documento
|
||||
decide carico, scarico o trasferimento; la fattura di un DDT non muove di nuovo la merce, la nota di credito la
|
||||
muove all'inverso. Tabella `item_balances` con giacenza per deposito, impegnato (ordini clienti) e ordinato
|
||||
(ordini fornitore).
|
||||
- Costo medio ponderato per articolo ricalcolato dalla storia dei movimenti a ogni modifica, anche per documenti con
|
||||
data passata; ultimo costo e date di ultimo carico e scarico; il prezzo della fattura fornitore corregge il costo
|
||||
dei carichi che fattura.
|
||||
- Documenti del ciclo passivo nelle maschere dei documenti (#55, #56, #58): ordini fornitori, ricevimenti merce (DDT
|
||||
fornitore con il numero e la data del fornitore), fatture e note di credito fornitore con **protocollo** IVA alla
|
||||
conferma e rifiuto del doppio numero del fornitore nello stesso anno, autofatture e movimenti di magazzino con
|
||||
causale e depositi. Menu *Acquisti* e *Magazzino*.
|
||||
- Controllo dei prezzi: sulla fattura fornitore un avviso elenca le righe con un prezzo diverso dall'ordine o dal
|
||||
ricevimento e la differenza totale.
|
||||
- Autofatture e integrazioni: il pacchetto italiano (`SelfInvoiceRulesIt`) riconosce dalla fattura del fornitore
|
||||
l'integrazione dovuta (TD16, TD17, TD18, TD19, TD28) e la scadenza; la fattura lo mostra con **Crea autofattura**,
|
||||
che prepara la bozza con l'aliquota ordinaria; *Acquisti → Autofatture* elenca le integrazioni da emettere. Tipi
|
||||
`AF20`-`AF29` nelle tabelle di base.
|
||||
- Lettura delle fatture elettroniche ricevute (#57): `FatturaPaReader` (FPR12, FPA12, FSM10, lotti, allegati) e
|
||||
lettore CMS/CAdES dei file `.p7m` con verifica dell'impronta e della firma, scritti in casa.
|
||||
- Import delle fatture passive (#57): *Acquisti → Importa fatture* legge XML, P7M e ZIP, trova o crea il fornitore,
|
||||
segnala doppioni, tipi non d'acquisto, totali diversi e firme non verificate, e registra in bozza fatture (TD01,
|
||||
TD02, TD03, TD05, TD06, TD24-TD27) e note di credito (TD04, TD08) con articoli abbinati per codice del fornitore,
|
||||
EAN e codice, codice IVA per aliquota e natura, sconti di riga e file allegato. Le regole TD stanno nel pacchetto
|
||||
fiscale (`IncomingInvoiceRulesIt`).
|
||||
- Giacenze e disponibilità (#60): indicatori, filtri per deposito, categoria e stato (*Disponibile*, *Da riordinare*,
|
||||
*Sottoscorta*, *Esaurito*), movimenti di un articolo con saldo progressivo.
|
||||
- Inventario fisico (#60): apertura per deposito, data e categoria con la giacenza contabile congelata, conteggi
|
||||
scritti o importati dal file del lettore, rettifiche `INVP` e `INVN` alla data del conteggio; tabelle `stock_takes`
|
||||
e `stock_take_lines`.
|
||||
- Proposta di riordino (#60): articoli sotto il punto di riordino o la scorta minima, quantità dal lotto o dalla
|
||||
soglia con il minimo d'ordine del fornitore, fornitore preferito con prezzo e arrivo previsto, ordini fornitore in
|
||||
bozza uno per fornitore.
|
||||
- Valorizzazione a data con costo medio, ultimo costo o costo standard e classi ABC; ricostruzione del magazzino da
|
||||
interfaccia con avanzamento e come job di sistema `inventory.rebuild` ogni domenica alle 2:15.
|
||||
- Widget *Sottoscorta* della dashboard con i dati veri.
|
||||
- Dati di esempio di acquisti e magazzino (#61): esistenze iniziali, ordini ricevuti per intero e in parte, fatture
|
||||
con una differenza di prezzo e una integrazione AF18 da emettere, un inventario in conteggio.
|
||||
- ADR 0035; pagine wiki *Acquisti* e *Magazzino* complete con le schermate, guida all'uso aggiornata.
|
||||
|
||||
### Changed
|
||||
- Import *Giacenze iniziali*: non è più solo verifica, scrive e conferma un movimento `APE` per deposito.
|
||||
- I documenti confermati senza numero interno (DDT fornitore) si presentano come *Senza numero* invece di *Bozza*.
|
||||
- *Tipi documento*: fattura immediata, fattura e nota di credito fornitore ricevono la causale di magazzino (`SCA`,
|
||||
`CAR`, `RESF`); la migrazione la assegna anche nelle aziende esistenti dove manca. I tipi `AF20`-`AF29` mancanti si
|
||||
aggiungono con *Aggiorna da tabelle base* o `scripts/seed.sh --base`.
|
||||
|
||||
## [0.5.0] - 2026-11-12
|
||||
|
||||
M5 — Motore documenti e Vendite. Un solo motore per tutti i documenti, con numerazione, totali, scadenze e
|
||||
collegamenti riga per riga, e le maschere del ciclo attivo: dal preventivo alla fattura stampata e inviata per
|
||||
e-mail, con un anno di vendite nei dati di esempio e una guida all'uso nella wiki.
|
||||
|
||||
### Added
|
||||
- Motore documenti (#47, ADR 0032): un solo motore per vendite, acquisti e magazzino. Ogni tipo documento ha un
|
||||
**genere** (17: preventivo, ordine cliente, DDT, fatture immediate, accompagnatorie, differite e di acconto, note
|
||||
di credito e di debito, parcella, pro forma, autofattura, ordine fornitore, DDT fornitore, fattura e nota di credito
|
||||
fornitore, movimento di magazzino) che ne decide famiglia, ciclo di vita, effetti, righe ammesse, documenti evadibili
|
||||
e permessi. Tabelle `sale_quotations`, `sale_orders`, `sale_documents`, `purchase_orders`, `purchase_documents`,
|
||||
`inventory_documents` con le righe e `document_links`.
|
||||
- Stati e azioni ammesse per stato (`DocumentStateMachine`): ciclo *documento* (bozza, confermato, evaso in parte,
|
||||
evaso, chiuso, annullato), *fattura* (bozza, emessa, XML generato, inviata, consegnata, scartata, non consegnata,
|
||||
annullata) e *semplice*; fattura emessa immutabile, annullamento con motivo solo prima dell'invio allo SDI.
|
||||
- Numerazione alla conferma dentro la transazione e sotto il lock del numeratore (advisory lock su PostgreSQL, lock di
|
||||
scrittura su SQLite): nessun numero doppio, un rollback restituisce il numero, controllo della data fuori sequenza
|
||||
sui numeratori senza buchi, numeratore dell'anno nuovo creato da solo, elenco dei numeri mancanti.
|
||||
- Evasione riga per riga: copia e trasformazione dei documenti con le quantità residue, collegamenti registrati alla
|
||||
conferma e tolti all'annullamento, stato evaso/evaso in parte calcolato dalle righe, chiusura e riapertura del
|
||||
residuo. Servizio generico `DocumentService<THeader, TLine>` per famiglia e `DocumentCopyService`.
|
||||
- Totali dei documenti (#48, ADR 0033): importo di riga con sconti a cascata, spese e righe di sconto, sconto di
|
||||
piede sulle merci, prezzi IVA compresa scorporati per aliquota, castelletto IVA per codice con imposta sul totale del
|
||||
gruppo, esigibilità (immediata, differita, split payment), bollo sopra 77,47 euro di operazioni senza IVA (addebitato
|
||||
al cliente o no), cassa previdenza con la sua IVA, ritenuta d'acconto (anche sul 50% o 20% per gli agenti), ENASARCO,
|
||||
netto a pagare. Scadenze dalle condizioni di pagamento con fine mese, giorno fisso, mesi esclusi del cliente, IVA
|
||||
sulla prima rata e arrotondamento sull'ultima. Tabelle `document_tax_summaries` e `document_installments`,
|
||||
ricalcolate a ogni salvataggio.
|
||||
- Copia di più documenti della stessa controparte in uno solo (`MergeAsync`), con una riga di riferimento per ognuno:
|
||||
la base della fatturazione differita. Le note di credito e di debito ricordano la fattura che correggono.
|
||||
|
||||
- Maschere delle vendite (#49, #50): radar di preventivi, ordini, DDT, fatture e note con ricerca, filtri per tipo,
|
||||
stato e anno; un'unica maschera documento con intestazione, righe (articolo con F4, sconti a cascata, righe
|
||||
descrittive, di spesa e di sconto), Testata, Trasporto per DDT e fatture accompagnatorie, Totali, Scadenze, Note,
|
||||
Allegati, Collegamenti e Storico; azioni Conferma, Emetti, Duplica, Chiudi, Riapri, Annulla con motivo, *Segna come
|
||||
rifiutato* per i preventivi e **Crea …** con la scelta delle righe e delle quantità residue.
|
||||
- Fatturazione differita guidata (#51): DDT confermati e non fatturati del periodo, per tutti i clienti o uno, una
|
||||
fattura differita TD24 per cliente o per DDT, in bozza o già emessa, con i riferimenti ai DDT nelle righe.
|
||||
- Stampa dei documenti (#52, ADR 0034): anteprima di stampa A4 e PDF disegnati dallo stesso modello (dati
|
||||
dell'azienda e logo, controparte, campi, righe, riepilogo IVA, scadenze, totali, trasporto con le firme, diciture e
|
||||
filigrane), generatore *Stampa del documento in PDF* con versioni negli allegati, documento segnato come stampato.
|
||||
- Invio per e-mail (#52, ADR 0034): destinatari, oggetto e testo proposti dal modello con i campi `{{Numero}}`,
|
||||
`{{Cliente}}`…, PDF allegato e salvato come nuova versione, coda in background con tre tentativi, client SMTP
|
||||
scritto in casa (STARTTLS, TLS, AUTH PLAIN e LOGIN) configurato da `KHAEMHAT_SMTP_*`, esito nel log *E-mail/PEC*.
|
||||
- Log, sezione *Documenti* (#53): conferme ed emissioni con il numero, chiusure, riaperture, annullamenti ed
|
||||
eliminazioni delle bozze.
|
||||
- Dati di esempio (#53): profilo dell'azienda demo e un anno di vendite costruite con il motore (6 preventivi, 4
|
||||
ordini, 5 DDT, 8 fatture e pro forma, 1 nota di credito) in tutti gli stati, idempotenti.
|
||||
- Wiki: pagina [Guida all'uso](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Guida-utente) con il percorso
|
||||
completo e le schermate; [Vendite](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Vendite) riscritta con
|
||||
le schermate reali; schermate dell'accesso in *Primi passi*.
|
||||
|
||||
### Changed
|
||||
- `README.md` è ora la guida di installazione per chi sviluppa (prerequisiti, avvio, test, migrazioni, immagine).
|
||||
- L'emissione di una fattura o di una nota richiede il codice IVA su ogni riga (non descrittiva).
|
||||
- *Tipi documento*: nuovo campo obbligatorio **Genere** (i tipi di base lo ricevono dalla migrazione); *Numeratori*:
|
||||
nuovo campo **Data dell'ultimo numero**.
|
||||
- *Clienti*, condizioni di vendita: **mesi esclusi** (due mesi senza scadenze e il giorno del mese dopo in cui slittano).
|
||||
|
||||
### Fixed
|
||||
- `scripts/run-dev.sh` sotto Git Bash su Windows scriveva i dati in una cartella `b` sul disco invece che in
|
||||
`.data/dev`.
|
||||
|
||||
## [0.4.0] - 2026-11-12
|
||||
|
||||
M4 — Tabelle, anagrafiche, articoli. Il pacchetto fiscale italiano, il profilo e le tabelle dell'azienda con i dati
|
||||
|
||||
@@ -5,72 +5,195 @@
|
||||
# Khaemhat
|
||||
|
||||
**Gestionale ERP + CRM per piccole e medie imprese italiane**, scritto da zero in C# 14 su .NET 10 con interfaccia
|
||||
Blazor Server, PostgreSQL (o SQLite per demo e test) e **nessuna libreria esterna**. Si installa **solo con Docker**:
|
||||
l'unico artefatto distribuito è l'immagine nel registro pacchetti di Gitea.
|
||||
Blazor Server, PostgreSQL (o SQLite per demo e test) e **nessuna libreria esterna**. Si distribuisce **solo come
|
||||
immagine Docker** nel registro pacchetti di Gitea.
|
||||
|
||||
> **Stato:** sviluppo avviato. M0 (struttura, immagine Docker, CI) consegna la versione 0.0.1 con una pagina
|
||||
> "in costruzione"; le funzioni arrivano milestone dopo milestone. Vedi [`docs/STATUS.md`](docs/STATUS.md) e la
|
||||
Questo file è la **guida di installazione per chi sviluppa**: come preparare il computer, compilare, avviare,
|
||||
provare e pubblicare. Chi **usa** il gestionale parte dalla
|
||||
[Guida all'uso](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Guida-utente) nella wiki; chi lo **installa**
|
||||
su un server da [Installazione Docker](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Installazione-Docker)
|
||||
o [Installazione Unraid](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Installazione-Unraid).
|
||||
|
||||
> **Stato:** sviluppo in corso, versioni 0.x. Ultima milestone chiusa: **M5 — Motore documenti e Vendite** (0.5.0).
|
||||
> Punto di ripresa in [`docs/STATUS.md`](docs/STATUS.md), piano in
|
||||
> [Roadmap](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Roadmap).
|
||||
|
||||
Il nome viene da Khaemhat (Mahu), scriba reale e sovrintendente al doppio granaio dell'Alto e del Basso Egitto sotto
|
||||
Amenhotep III: un contabile e un magazziniere dell'antichità. Vedi
|
||||
[Origine del nome](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Origine-del-nome).
|
||||
## 1. Prerequisiti
|
||||
|
||||
## Cosa farà
|
||||
| Strumento | Versione | A cosa serve |
|
||||
|---|---|---|
|
||||
| **.NET SDK** | 10.0.100 o successiva della stessa *feature band* (vedi [`global.json`](global.json)) | compilare, provare, avviare |
|
||||
| **Git** | qualunque recente | il repository; su Windows anche **Git Bash**, che esegue gli script `scripts/*.sh` |
|
||||
| **Docker** | facoltativo | costruire e provare l'immagine; PostgreSQL e Redis per i test sui motori reali |
|
||||
| **PostgreSQL** | 16 o 17, facoltativo | i test di integrazione sul motore di produzione (`KHAEMHAT_TEST_PG`) |
|
||||
|
||||
- Anagrafiche, articoli, listini, tabelle; vendite e acquisti con motore documenti unico; magazzino.
|
||||
- Contabilità generale, IVA, F24, LIPE, ritenute, bollo, cespiti, Intrastat, chiusura e bilancio CEE.
|
||||
- Scadenzario, incassi e pagamenti, RiBa/SDD/SEPA, riconciliazione bancaria, solleciti.
|
||||
- Fatturazione elettronica FatturaPA con canali SDI (PEC integrata, SdICoop, intermediari).
|
||||
- CRM (lead, pipeline, attività, campagne, ticket), automazioni, API REST e server MCP.
|
||||
- Più aziende sulla stessa istanza (un database di sistema + un database per azienda), moduli attivabili con
|
||||
licenza, temi chiaro/scuro, dashboard a widget.
|
||||
Non servono Node.js, npm, bundler, IDE particolari né pacchetti NuGet oltre a quelli ammessi: un editor qualunque
|
||||
va bene (Visual Studio, Rider, VS Code con C# Dev Kit). Lingua dei messaggi del compilatore: per avere gli errori in
|
||||
inglese, `DOTNET_CLI_UI_LANGUAGE=en`.
|
||||
|
||||
## Installazione
|
||||
## 2. Clonare
|
||||
|
||||
```bash
|
||||
docker pull gitea.encke-hake.ts.net/balbosoft/khaemhat:<versione>
|
||||
git clone https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat.git
|
||||
```
|
||||
|
||||
- Qualunque host Docker: [`deploy/docker-compose.yml`](deploy/docker-compose.yml) (con PostgreSQL) e
|
||||
[`deploy/.env.example`](deploy/.env.example); per una prova veloce
|
||||
[`deploy/docker-compose.sqlite.yml`](deploy/docker-compose.sqlite.yml).
|
||||
- Unraid: template [`deploy/unraid/khaemhat.xml`](deploy/unraid/khaemhat.xml) o
|
||||
[`deploy/docker-compose.unraid.yml`](deploy/docker-compose.unraid.yml) con [`deploy/.env.example`](deploy/.env.example).
|
||||
- Guide: [Installazione Unraid](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Installazione-Unraid) ·
|
||||
[Installazione Docker](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Installazione-Docker) ·
|
||||
[Primi passi](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Primi-passi).
|
||||
In rete locale anche `http://192.168.30.23:3000/BalboSoft/Khaemhat.git` o, con una chiave SSH,
|
||||
`ssh://git@192.168.30.23:2222/BalboSoft/Khaemhat.git`. Il ramo principale è `main`; si lavora su rami
|
||||
`feat/<n>-descrizione`, `fix/…`, `docs/…` (vedi [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md)).
|
||||
|
||||
## Sviluppo
|
||||
## 3. Com'è fatto il repository
|
||||
|
||||
Serve l'SDK .NET 10 (`global.json`); Docker solo per costruire e provare l'immagine.
|
||||
| Cartella | Contenuto |
|
||||
|---|---|
|
||||
| `src/Khaemhat.Core` | entità, regole, macchine a stati dei documenti, nessuna dipendenza |
|
||||
| `src/Khaemhat.Data`, `.Data.Sqlite`, `.Data.PostgreSql` | micro-ORM, migrazioni, provider dei due motori |
|
||||
| `src/Khaemhat.Application` | servizi applicativi: sicurezza, tabelle, anagrafiche, motore documenti, stampe, seed |
|
||||
| `src/Khaemhat.Infrastructure` | file (PDF, fogli di calcolo, archivi), posta SMTP, cache, licenze, sicurezza: scritti in casa |
|
||||
| `src/Khaemhat.Fiscal.Abstractions`, `.Fiscal.Italy` | il pacchetto paese: tutto ciò che è italiano |
|
||||
| `src/Khaemhat.Web` | host Blazor Server, componenti, pagine, risorse dei testi in `Resources/it-IT/*.json` |
|
||||
| `tests/*` | MSTest, un progetto per strato |
|
||||
| `tools/*` | strumenti di sviluppo: licenze (`LicenseTool`), comuni e CAP (`PlacesTool`), modello dati (`DataModelTool`) |
|
||||
| `docker/`, `deploy/` | Dockerfile ed entrypoint; compose, `.env.example`, template Unraid |
|
||||
| `scripts/` | build, test, avvio, seed, migrazioni, pubblicazione |
|
||||
| `docs/` | specifica, ADR, architettura, mockup e la wiki (`docs/wiki/`) |
|
||||
|
||||
## 4. Compilare
|
||||
|
||||
```bash
|
||||
scripts/build.sh
|
||||
```
|
||||
|
||||
Controlla l'allowlist dei pacchetti (`scripts/check-packages.sh` su `Directory.Packages.props`) e compila
|
||||
`Khaemhat.sln` in Release con **warning come errori** e gli analyzer di piattaforma. L'equivalente a mano:
|
||||
|
||||
```bash
|
||||
dotnet build Khaemhat.sln -c Release -warnaserror
|
||||
```
|
||||
|
||||
## 5. Avviare in locale
|
||||
|
||||
```bash
|
||||
scripts/run-dev.sh
|
||||
```
|
||||
|
||||
Avvia Khaemhat su <http://localhost:5080> con SQLite in `.data/dev` (ignorata da git) e queste impostazioni di
|
||||
sviluppo, ognuna sovrascrivibile esportando la variabile prima di lanciare lo script:
|
||||
|
||||
| Variabile | Valore di sviluppo |
|
||||
|---|---|
|
||||
| `KHAEMHAT_DATA_DIR`, `KHAEMHAT_SYSTEM_DB` | `.data/dev`, `sqlite://…/.data/dev/system.db` |
|
||||
| `KHAEMHAT_SECRET_KEY` | una chiave fissa **solo per lo sviluppo** |
|
||||
| `KHAEMHAT_SUPERUSER`, `KHAEMHAT_SUPERUSER_PASSWORD` | `root` e la password iniziale scritta nello script |
|
||||
| `KHAEMHAT_COMPANY_CODE`, `KHAEMHAT_COMPANY_NAME` | `DEMO`, *Khaemhat Demo S.r.l.* |
|
||||
| `KHAEMHAT_LICENSE_MODE` | `test`: tutti i moduli attivi con i codici di prova |
|
||||
| `KHAEMHAT_SEED_DEMO` | `true`: la prima azienda nasce con i dati di esempio (anagrafiche, articoli, un anno di vendite) |
|
||||
|
||||
Al primo accesso Khaemhat chiede di cambiare la password e di collegare un'app di autenticazione (il super utente
|
||||
ha la verifica in due passaggi obbligatoria): conserva la chiave e i codici di recupero. Per ripartire da zero ferma
|
||||
il server e cancella `.data/dev`.
|
||||
|
||||
Altre cose utili in sviluppo:
|
||||
|
||||
- **Invio di e-mail**: senza `KHAEMHAT_SMTP_HOST` e `KHAEMHAT_SMTP_FROM` l'invio è spento. Per provarlo serve un
|
||||
server SMTP di prova sulla tua macchina, ad esempio
|
||||
`KHAEMHAT_SMTP_HOST=127.0.0.1 KHAEMHAT_SMTP_PORT=2525 KHAEMHAT_SMTP_SECURITY=NONE KHAEMHAT_SMTP_FROM=ufficio@example.com scripts/run-dev.sh`;
|
||||
l'esito di ogni invio è nel log, sezione *E-mail/PEC*.
|
||||
- **Dati di base e di esempio** su un database esistente: `scripts/seed.sh --base` oppure `scripts/seed.sh --demo`
|
||||
(aggiungono solo ciò che manca; meglio con il server fermo).
|
||||
- **Catalogo dei componenti**: <http://localhost:5080/sviluppo/componenti> mostra i mattoni dell'interfaccia.
|
||||
- **Tutte le variabili** `KHAEMHAT_*` sono in
|
||||
[Installazione Docker](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Installazione-Docker) e
|
||||
[`docs/DEPLOY.md`](docs/DEPLOY.md). Una configurazione non valida ferma l'avvio con l'elenco degli errori.
|
||||
|
||||
Prima di ricompilare ferma il server: su Windows l'eseguibile in esecuzione blocca le DLL e la build ritenta la copia
|
||||
(avviso MSB3026) fino a fallire.
|
||||
|
||||
## 6. Provare
|
||||
|
||||
```bash
|
||||
scripts/test.sh
|
||||
scripts/test.sh --filter "FullyQualifiedName~Documents"
|
||||
```
|
||||
|
||||
Esegue l'allowlist e tutti i test in Release. SQLite è sempre provato; i test che avviano
|
||||
l'applicazione intera usano un'istanza vera su una porta libera. I test sul **PostgreSQL** reale partono quando
|
||||
`KHAEMHAT_TEST_PG` indica un ruolo con `CREATEDB` (ogni test crea e cancella il proprio database):
|
||||
|
||||
```bash
|
||||
docker run -d --name khaemhat-pg-test -e POSTGRES_PASSWORD=prova -p 55432:5432 postgres:17
|
||||
KHAEMHAT_TEST_PG="postgres://postgres:prova@localhost:55432/postgres" scripts/test.sh
|
||||
```
|
||||
|
||||
Senza la variabile quei test risultano *saltati*. In CI (`.gitea/workflows/ci.yml`) i test girano su ogni pull request verso `main`; il job PostgreSQL
|
||||
(16 e 17) sui tag e all'avvio manuale.
|
||||
|
||||
Regole che i test fanno rispettare: nessun pacchetto fuori allowlist, dipendenze tra progetti nel verso giusto,
|
||||
nessun testo italiano scritto nei componenti (vanno nelle risorse `Resources/it-IT/*.json`), chiavi di testo
|
||||
esistenti, sezione del modello dati aggiornata.
|
||||
|
||||
## 7. Database e migrazioni
|
||||
|
||||
```bash
|
||||
scripts/new-migration.sh company create_sales_documents # nuova migrazione numerata
|
||||
scripts/gen-datamodel.sh # rigenera la parte generata di docs/DATA-MODEL.md
|
||||
scripts/gen-datamodel.sh --check # solo verifica (la fa anche un test)
|
||||
```
|
||||
|
||||
Le migrazioni si applicano da sole all'avvio, al database di sistema e a quello di ogni azienda. Il codice non deve
|
||||
dipendere dal motore: ogni query passa dal micro-ORM e gira identica su SQLite e PostgreSQL.
|
||||
|
||||
## 8. Immagine Docker
|
||||
|
||||
```bash
|
||||
scripts/build.sh # allowlist dei pacchetti + build con warning come errori
|
||||
scripts/test.sh # tutti i test (PostgreSQL con KHAEMHAT_TEST_PG, Redis con KHAEMHAT_TEST_REDIS)
|
||||
scripts/run-dev.sh # avvio locale su http://localhost:5080 con SQLite in .data/dev
|
||||
docker build -f docker/Dockerfile -t khaemhat:dev .
|
||||
docker compose -f deploy/docker-compose.sqlite.yml up # prova veloce con SQLite
|
||||
```
|
||||
|
||||
Processo, rami e Definition of Done in [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md).
|
||||
L'immagine pubblicata è `gitea.encke-hake.ts.net/balbosoft/khaemhat:<versione>` (e `:latest`, mai in produzione). La
|
||||
costruisce `.gitea/workflows/release.yml` quando si spinge un tag `vX.Y.Z` (segreto `REGISTRY_TOKEN` con
|
||||
`write:package`), che crea anche la release Gitea con le note del [`CHANGELOG.md`](CHANGELOG.md). Se il runner non è
|
||||
disponibile:
|
||||
|
||||
## Documentazione
|
||||
```bash
|
||||
GITEA_TOKEN=… scripts/publish-image.sh v0.5.0
|
||||
```
|
||||
|
||||
Non si producono installer, eseguibili o pacchetti `.msi/.exe/.deb`: l'unico artefatto è l'immagine
|
||||
([ADR 0010](docs/adr/0010-solo-docker-nessun-installer.md)). Le versioni restano **0.x** finché il prodotto è in
|
||||
sviluppo.
|
||||
|
||||
## 9. Documentazione e wiki
|
||||
|
||||
La wiki è in `docs/wiki/` e si aggiorna nella stessa unità di lavoro del codice: una funzione senza documentazione
|
||||
non è finita. Il workflow `wiki.yml` la pubblica nel wiki Gitea a ogni push su `main` che la tocca; a mano:
|
||||
`scripts/publish-wiki.sh`. Le schermate stanno in `docs/wiki/img/` e si fanno sull'applicazione vera con i dati di
|
||||
esempio. La stessa wiki è inclusa nell'immagine e si apre con `F1` dentro il gestionale.
|
||||
|
||||
| Cosa | Dove |
|
||||
|---|---|
|
||||
| Wiki (guida utente e amministratore) | <https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki> (sorgente in [`docs/wiki/`](docs/wiki/)) |
|
||||
| Specifica normativa | [`docs/SPEC.md`](docs/SPEC.md) |
|
||||
| Regole operative ed emendamenti | [`CLAUDE.md`](CLAUDE.md) |
|
||||
| Processo di sviluppo | [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md) |
|
||||
| Processo, rami, Definition of Done | [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md) |
|
||||
| Architettura, dati, moduli, API, MCP | [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md), [`docs/DATA-MODEL.md`](docs/DATA-MODEL.md), [`docs/MODULES.md`](docs/MODULES.md), [`docs/API.md`](docs/API.md), [`docs/MCP.md`](docs/MCP.md) |
|
||||
| Installazione e sicurezza | [`docs/DEPLOY.md`](docs/DEPLOY.md), [`docs/SECURITY.md`](docs/SECURITY.md) |
|
||||
| Decisioni architetturali | [`docs/adr/`](docs/adr/) |
|
||||
| Mockup | [`docs/mockups/`](docs/mockups/README.md) |
|
||||
| Mockup (specifica visiva) | [`docs/mockups/`](docs/mockups/README.md) |
|
||||
| Novità | [`CHANGELOG.md`](CHANGELOG.md) |
|
||||
| Wiki pubblicata | <https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki> |
|
||||
|
||||
## Pianificazione
|
||||
## 10. Regole del codice in breve
|
||||
|
||||
Il lavoro è organizzato in [issue](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/issues) raggruppate per
|
||||
- C# 14 su .NET 10, `Nullable` attivo, warning come errori, `.editorconfig`; JavaScript solo come interop minimo in
|
||||
`wwwroot/js`.
|
||||
- **Nessuna libreria esterna**: framework Microsoft, `Npgsql`, `Microsoft.Data.Sqlite` e, nei test, MSTest.
|
||||
- Codice, commenti e commit in **inglese**; interfaccia in **italiano** dalle risorse.
|
||||
- Tutto ciò che è fiscale italiano sta in `Khaemhat.Fiscal.Italy`.
|
||||
- Commit *Conventional Commits* che dicono cosa cambia e perché e citano l'issue (`#n`); pull request verso `main`
|
||||
con `Closes #n`.
|
||||
|
||||
Il lavoro è organizzato in [issue](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/issues) per
|
||||
[milestone](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/milestones) (M0-M14) e nei
|
||||
[progetti](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/projects) *Khaemhat 1.0 — Sviluppo* e
|
||||
*Khaemhat 1.1+ — Fase 2*.
|
||||
[progetti](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/projects).
|
||||
|
||||
Il nome viene da Khaemhat (Mahu), scriba reale e sovrintendente al doppio granaio dell'Alto e del Basso Egitto sotto
|
||||
Amenhotep III: vedi [Origine del nome](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Origine-del-nome).
|
||||
@@ -206,28 +206,28 @@ menu *Fatturazione elettronica* se `EINV` è attivo e da *Contabilità* se è at
|
||||
| Voce | Contenuto |
|
||||
|---|---|
|
||||
| Licenza | `FIN` |
|
||||
| Responsabilità | partite aperte e aging, incassi e pagamenti con abbuoni e differenze cambio, insoluti, distinte RiBa (CBI), SDD (`pain.008`), bonifici SEPA (`pain.001`), riconciliazione bancaria (CSV/CBI/CAMT.053), solleciti a livelli con interessi di mora, flusso di cassa 90 giorni |
|
||||
| Entità | `OpenItem`, `Payment(+Line)`, `Remittance(+Line)`, `SddMandate`, `BankStatement(+Line)`, `BankMatchRule`, `DunningRun(+Line)`, `DunningLevel` |
|
||||
| Servizi | `OpenItemService`, `PaymentService`, `RemittanceService`, `SddMandateService`, `BankStatementImportService`, `BankReconciliationService`, `DunningService`, `CashFlowForecastService`, `AgingReportService`, `InstallmentPoster` |
|
||||
| Maschere e mockup | partite e aging (053, `OpenItemsPage`), registra incasso (054, `PaymentDialog`), distinte (055, `RemittancePage`), solleciti (056, `DunningPage`), riconciliazione (057, `BankReconciliationPage`) |
|
||||
| Permessi | proposte: `finance.open_item.read`, `finance.payment.write`, `finance.remittance.write`, `finance.dunning.run`, `finance.reconciliation.write` |
|
||||
| Responsabilità | partite aperte (le `gl_open_items` della contabilità) e aging, incassi e pagamenti con abbuoni, spese e differenze cambio, insoluti, distinte RiBa (CBI), SDD (`pain.008.001.08`), bonifici SEPA (`pain.001.001.09`), mandati, riconciliazione bancaria (CSV/CBI/CAMT.053), solleciti a livelli con interessi di mora, flusso di cassa 30-365 giorni, scadenze sulla Home |
|
||||
| Entità | `OpenItem` (Ledger), `Payment(+Line)`, `Remittance(+Line)`, `SddMandate`, `BankStatement(+Line)`, `BankMatchRule`, `DunningLevel`, `DunningLetter` |
|
||||
| Servizi | `ScheduleService`, `PaymentService`, `RemittanceService`, `MandateService`, `BankReconciliationService`, `DunningService` (+ job `finance.dunning`), `CashFlowService`, `TreasuryFeedSource`, `DemoTreasurySeeder`; nel core `AgingCalculator`, `PaymentAllocator`, `BankMatcher`, `SepaXmlWriter`, `CsvStatementReader`, `Camt053Reader`; nel pacchetto italiano `RibaCbiWriter`, `CbiStatementReader`, `LatePaymentRulesIt` (ADR 0038) |
|
||||
| Maschere e mockup | partite e aging (053, `SchedulePage`), registra incasso (054, `PaymentDialog`), incassi e pagamenti (`PaymentsPage`), distinte (055, `RemittancesPage`), mandati (`MandatesPage`), solleciti (056, `DunningPage`), riconciliazione (057, `ReconciliationPage`), flusso di cassa (`CashFlowPage`) |
|
||||
| Permessi | `finance.schedule.read`, `finance.schedule.write`, `finance.payment.read`, `finance.payment.write`, `finance.bank.reconcile` |
|
||||
| Log | Contabilità (proposta: SPEC §9.5 non ha una sezione "Tesoreria"); invio solleciti in E-mail/PEC |
|
||||
| Wiki | [Scadenzario](wiki/Scadenzario.md) |
|
||||
| Milestone | M8 `v0.8.0` |
|
||||
| Milestone | M8 `v0.8.0` (consegnata) |
|
||||
|
||||
### 3.11 EInvoicing — Fatturazione elettronica
|
||||
|
||||
| Voce | Contenuto |
|
||||
|---|---|
|
||||
| Licenza | `EINV` |
|
||||
| Responsabilità | generazione e validazione XML FatturaPA (`FPR12`/`FPA12`/`FSM10`), lettura passive e P7M, notifiche SDI, quattro canali (PEC integrata, SdICoop, Intermediario A, Intermediario B) con instradamento, cruscotto, inbox, export per la conservazione, autofatture da inviare |
|
||||
| Entità | `EInvoice`, `SdiNotification`, `EInvoiceInboxFile`, `SdiChannel`, `SdiRoutingRule`, `ConservationPackage` |
|
||||
| Servizi | `EInvoiceService`, `EInvoiceExportService`, `SdiChannelService`, `SdiInboxService`, `SdiNotificationImportService`, `PurchaseInvoiceImportService`, `ConservationExportService`; nel pacchetto paese `FatturaPaWriter`, `FatturaPaValidator`, `FatturaPaReader`, `SdiRouter`, i quattro `ISdiTransport` |
|
||||
| Maschere e mockup | cruscotto SDI (058, `EInvoiceDashboard`), canali SDI (059, `SdiChannelsPage`), bollo virtuale (060, `StampDutyPage`), dichiarazioni d'intento e plafond (061, `IntentDeclarationsPage`) |
|
||||
| Permessi | proposte: `einvoicing.invoice.generate`, `einvoicing.invoice.send`, `einvoicing.channel.write`, `einvoicing.inbox.import` |
|
||||
| Responsabilità | file FatturaPA (`FPR12`/`FPA12`/`FSM10`) con controlli offline e codici dello SDI, quattro canali (PEC, SdICoop, Intermediario A, Intermediario B) con instradamento e canale di riserva, lettura dei canali programmata e push SdICoop, notifiche, correzione degli scarti, copia di cortesia PDF con l'XML allegato, fatture ricevute da registrare, pacchetti per la conservazione, autofatture da inviare, rimozione dei dati di esempio |
|
||||
| Entità | `EInvoice` (`e_invoices`), `EInvoiceNotification` (`e_invoice_notifications`), `EInvoiceInboxFile` (`e_invoice_inbox`), `EInvoiceChannelSetting` (`e_invoice_channels`), `SdiRoutingRule` (`e_invoice_routing`), `ConservationExport` (`e_invoice_conservation`) |
|
||||
| Servizi | `EInvoiceService`, `EInvoiceChannelService`, `EInvoicePollingService` (+ job `einvoice.poll`), `SdiPushService` (endpoint `POST /sdicoop/{azienda}`), `SdiInboxService`, `ConservationExportService`, `EInvoiceFeedSource`, `DemoEInvoiceSeeder`, `DemoDataRemover`; nel core `SdiRouter`, `EInvoiceStates`; nel pacchetto italiano `FatturaPaWriter`, `FatturaPaValidator`, `FatturaPaReader`, `SdiReceiptReader`, `PecSdiTransport`, `SdiCoopTransport`, `IntermediaryATransport`, `IntermediaryBTransport`, `SdiCoopPushReader` (ADR 0039, 0040) |
|
||||
| Maschere e mockup | cruscotto SDI (058, `EInvoiceDashboardPage`), canali e instradamento (059, `EInvoiceChannelsPage`), fatture ricevute (`EInvoiceInboxPage`), notifiche (`EInvoiceNotificationsPage`), conservazione (`ConservationPage`); dichiarazioni d'intento e plafond (061) in M10; bollo virtuale (060) in *IVA* dalla 0.7 |
|
||||
| Permessi | `einvoice.document.read`, `einvoice.document.send`, `einvoice.inbox.read`, `einvoice.inbox.import`, `einvoice.channel.manage` |
|
||||
| Log | SDI/e-invoicing; invio e lettura PEC in E-mail/PEC; intermediari in Integrazioni |
|
||||
| Wiki | [Fatturazione-elettronica](wiki/Fatturazione-elettronica.md) |
|
||||
| Milestone | M9 `v0.9.0` (con seed demo completo); dichiarazioni d'intento in M10 |
|
||||
| Milestone | M9 `v0.9.0` (consegnata); dichiarazioni d'intento in M10 |
|
||||
|
||||
### 3.12 Crm — CRM
|
||||
|
||||
|
||||
@@ -2,20 +2,29 @@
|
||||
|
||||
> Punto di ripresa per ogni sessione. Aggiornare a fine sessione.
|
||||
|
||||
**Ultimo aggiornamento:** 2026-11-12
|
||||
**Milestone corrente:** M5 — Motore documenti e Vendite (issue #47-#54, nel progetto in *Da fare*). M4 chiusa:
|
||||
PR #121 in `main`, tag `v0.4.0`, immagine e release.
|
||||
**Prossimo passo:** M5, a partire dal motore documenti (#47) e dal calcolo dei totali (#48). #35 (PNG ad alta
|
||||
risoluzione) resta aperta e non blocca; #45 resta aperta solo per le banche ABI/CAB (manca una fonte con licenza
|
||||
compatibile).
|
||||
Da recuperare: profilo dell'azienda demo (indirizzo, partita IVA) prima dei documenti di M5; misure di riferimento su PostgreSQL in `docs/DATA-MODEL.md` §6.1; indicatore di robustezza della
|
||||
password (mockup 003); schede *Layout salvati* e *Notifiche* (con le e-mail, M5) del profilo; rinomina e
|
||||
filtro predefinito nei radar.
|
||||
**Ultimo aggiornamento:** 2026-11-13
|
||||
**Milestone corrente:** M10 — Cespiti, Intrastat, chiusura e bilancio (issue #82-#87), da iniziare. M9 chiusa: PR in
|
||||
`main`, tag `v0.9.0`, immagine e release.
|
||||
**Prossimo passo:** M10 dall'issue #82. #35 (PNG ad alta risoluzione) resta aperta e non blocca; #45 resta aperta solo
|
||||
per le banche ABI/CAB (manca una fonte con licenza compatibile).
|
||||
Da recuperare: misure di riferimento su PostgreSQL in `docs/DATA-MODEL.md` §6.1; indicatore di robustezza della
|
||||
password (mockup 003); schede *Layout salvati* e *Notifiche* del profilo; rinomina e filtro predefinito nei radar;
|
||||
logo PNG nel PDF (oggi solo JPEG, ADR 0034); coda della posta persistente e modelli e-mail per azienda (M12).
|
||||
Da M6: schermata dell'import fatture con file caricati (serve un caricamento via CDP); nei movimenti di un articolo il
|
||||
numero del fornitore al posto di *DDT fornitore* senza numero; FIFO e LIFO a lotti (dopo la 1.0).
|
||||
Da M7: schermata del bollo virtuale (la demo non ha fatture esenti sopra 77,47 euro); import di causali e voci di
|
||||
bilancio dal file `khaemhat-coa.json`; scritture delle rimanenze e libro inventari (M10); IVA per
|
||||
cassa (fase 2).
|
||||
Da M8: tracciati CBI e SEPA da provare con un home banking reale; tabella semestrale dei tassi di mora da aggiornare a
|
||||
gennaio e luglio (ADR 0038); blocco per fido su ordini e documenti; report di tesoreria in *Report* (M12).
|
||||
Da M9: schema XSD ufficiale FatturaPA al posto di quello scritto in casa (serve il permesso di scaricarlo);
|
||||
intermediari reali e accreditamento SdICoop (#78, ADR 0040); conformità PDF/A-3 dichiarata della copia di cortesia;
|
||||
pulsanti *Carica* e *Rimuovi dati di esempio* nell'interfaccia (M12); dichiarazioni d'intento (M10).
|
||||
|
||||
## Fatto
|
||||
|
||||
- Specifica normativa in `docs/SPEC.md`; `CLAUDE.md` con emendamenti E1-E7.
|
||||
- ADR 0001-0031.
|
||||
- ADR 0001-0040.
|
||||
- Mockup in `docs/mockups/` (22 in alta risoluzione + galleria, 88 miniature, `mockup.css`, indice).
|
||||
- Icone in `assets/`; deploy in `deploy/` (compose Unraid, `.env.example`, template Unraid).
|
||||
- Documentazione tecnica: `ARCHITECTURE.md`, `DATA-MODEL.md` (provvisorio, sarà generato), `MODULES.md`, `API.md`,
|
||||
@@ -59,6 +68,45 @@ filtro predefinito nei radar.
|
||||
aggiornamento massivo (ADR 0030); import/export guidato CSV/XLSX/JSON con tracciato del piano dei conti (ADR 0031);
|
||||
21 anagrafiche e 120 articoli di esempio; screenshot reali nella wiki. Test: 631 verdi in locale, 21 di PostgreSQL
|
||||
saltati; immagine costruita in locale e avviata da zero con SQLite e dati di esempio.
|
||||
- **M5 (chiusa, `v0.5.0`, PR #124):** motore documenti (#47, ADR 0032): generi e definizioni dei tipi documento, sei famiglie
|
||||
di tabelle con le righe e `document_links`, stati con azioni ammesse, numerazione atomica alla conferma (provata in
|
||||
concorrenza su SQLite e su PostgreSQL 18 in locale), copia e trasformazione con evasione riga per riga; totali,
|
||||
castelletto IVA, bollo, ritenute, cassa e scadenze (#48, ADR 0033); radar e maschera dei documenti di vendita con
|
||||
*Crea …* (#49, #50); fatturazione differita guidata (#51); anteprima di stampa e PDF dallo stesso modello, invio per
|
||||
e-mail con SMTP e coda scritti in casa (#52, ADR 0034); log *Documenti*; profilo e un anno di vendite di esempio;
|
||||
wiki con la *Guida all'uso* e le schermate reali, README come guida per sviluppatori (#53). Test: 660 verdi in
|
||||
locale, 23 di PostgreSQL saltati (girano in CI).
|
||||
- **M6 (chiusa, `v0.6.0`, PR #125):** movimenti di magazzino dai documenti nella
|
||||
stessa transazione, costo medio ponderato ricalcolato dalla storia, impegnato e ordinato, correzione del costo dalla
|
||||
fattura fornitore (#59, ADR 0035); ordini fornitori, ricevimenti, fatture e note di credito fornitore con protocollo,
|
||||
doppioni rifiutati, controllo dei prezzi, autofatture TD16-TD29 consigliate dal pacchetto italiano con scadenza
|
||||
(#55, #56, #58); lettura FatturaPA e `.p7m` (CMS scritto in casa) e import delle fatture passive in bozza (#57);
|
||||
giacenze, movimenti di un articolo, inventario fisico, proposta di riordino, valorizzazione con classi ABC,
|
||||
ricostruzione anche come job settimanale, widget *Sottoscorta* (#60); giacenze iniziali da file con movimento `APE`;
|
||||
acquisti e magazzino nei dati di esempio, wiki *Acquisti* e *Magazzino* con le schermate, guida all'uso (#61).
|
||||
Test: 709 verdi in locale, 23 di PostgreSQL saltati (girano in CI).
|
||||
- **M7 (chiusa, `v0.7.0`):** piano dei conti a tre livelli con il modello *PMI standard* di 237 conti, causali con righe
|
||||
proposte (#62, ADR 0036); prima nota con bozze, registrazioni, definitive con numero del libro giornale e storni,
|
||||
ricorrenti con job giornaliero (#63); contabilizzazione automatica di fatture, note, parcelle e autofatture nella
|
||||
transazione del documento con righe IVA, partite e ritenute (#64, ADR 0037); registri IVA con stampa definitiva,
|
||||
liquidazione mensile o trimestrale con pro rata, interessi, minimo, acconto, F24 e LIPE (#65); ritenute operate e
|
||||
subite, dati CU, bollo virtuale con soglie, prospetto F24 con pagamento (#66); partitari, mastrini, bilancio di
|
||||
verifica, libro giornale (#67); contabilità nei dati di esempio con la liquidazione verificata a mano in un test,
|
||||
wiki *Contabilità*, *IVA* e *Fiscalità italiana* con le schermate (#68). Test: 754 verdi in locale, 23 di PostgreSQL saltati (girano in CI).
|
||||
- **M8 (chiusa, `v0.8.0`):** scadenzario sulle partite della contabilità con aging, incassi e pagamenti multipli e
|
||||
parziali con abbuoni, spese, cambi e storno (#69, ADR 0038); distinte RiBa CBI, SDD `pain.008` e bonifici
|
||||
`pain.001` con presentazione, anticipo s.b.f., accredito e insoluti, mandati SDD (#70); riconciliazione bancaria
|
||||
CSV/CBI/CAMT.053 senza doppioni con confidenza e regole (#71); solleciti a tre livelli con interessi di mora e job
|
||||
automatico, flusso di cassa, scadenze sulla Home (#72); tesoreria nei dati di esempio con FIN, wiki *Scadenzario*
|
||||
con le schermate (#73). Test: 823 verdi in locale, anche quelli di PostgreSQL (18) con un container locale.
|
||||
- **M9 (chiusa, `v0.9.0`):** file FatturaPA `FPR12`/`FPA12`/`FSM10` con controllo offline dei codici SDI e schema
|
||||
scritto in casa (#74, ADR 0039); notifiche RC/NS/MC/NE/DT/AT/SE/MT senza doppioni che muovono file e documento,
|
||||
correzione degli scarti, copia di cortesia PDF con l'XML allegato (#75); canali PEC (IMAP e MIME in casa),
|
||||
SdICoop SOAP/MTOM e due intermediari generici con instradamento e riserva, job `einvoice.poll` e push SdICoop su
|
||||
`/sdicoop/{azienda}` (#76, #77, ADR 0040); fatture ricevute da registrare e pacchetti di conservazione (#79);
|
||||
fatturazione nei dati di esempio e rimozione dei dati di esempio guidata dallo schema (#80); wiki *Fatturazione
|
||||
elettronica* con le schermate (#81). #78 (scelta degli intermediari, accreditamento SdICoop) resta aperta.
|
||||
Test: 874 verdi in locale, anche quelli di PostgreSQL (18) con un container locale.
|
||||
- Su Gitea: etichette, milestone M0-M14, 114 issue con checklist, progetti *Khaemhat 1.0 — Sviluppo* (M0-M13)
|
||||
e *Khaemhat 1.1+ — Fase 2* (M14). Numerazione: M0 #1-#6 e #114, M1 #7-#14, M2 #15-#24, M3 #25-#36,
|
||||
M4 #37-#46, M5 #47-#54, M6 #55-#61, M7 #62-#68, M8 #69-#73, M9 #74-#81, M10 #82-#87, M11 #88-#91,
|
||||
@@ -105,12 +153,12 @@ Emersi durante la stesura della documentazione. Si decidono con un ADR quando si
|
||||
|
||||
### Contabilità, IVA, e-fattura, CRM (dalla stesura delle pagine funzionali)
|
||||
|
||||
12. Scadenza IVA di settembre: mockup 046 la mette al 16/10/2026, mockup 047 nell'F24 del 16/11/2026 (corretto: 16/10 per i mensili).
|
||||
12. Scadenza IVA di settembre: mockup 046 la mette al 16/10/2026, mockup 047 nell'F24 del 16/11/2026 (corretto: 16/10 per i mensili). **Deciso in M7: ADR 0037, il 16 del mese successivo.**
|
||||
13. Bollo sulle cessioni intracomunitarie: il mockup 060 lo addebita su N3.2, ma cessioni intra-UE ed esportazioni ne sono esenti; la regola del bollo va legata al codice IVA con esclusioni.
|
||||
14. Funzioni di fase 2 nelle schermate di M7: ventilazione dei corrispettivi (046) e IVA per cassa completa sono in M14 per §20.
|
||||
14. Funzioni di fase 2 nelle schermate di M7: ventilazione dei corrispettivi (046) e IVA per cassa completa sono in M14 per §20. **Confermato in M7: non implementate.**
|
||||
15. Moduli ambigui: bollo e dichiarazioni d'intento sotto ACCT e EINV (§8.1); export commercialista sotto ACCT e REPORT; Intrastat e LIPE nel menu e-fattura nei mockup; §10.2 senza voce Intrastat.
|
||||
16. Stato "Provvisorio" dell'esercizio nel mockup 052, non previsto da SPEC (aperto / in chiusura / chiuso).
|
||||
17. Codici conto incoerenti tra mockup (fornitori 05.02.001 in 040/043, 02.03.001 in 042).
|
||||
17. Codici conto incoerenti tra mockup (fornitori 05.02.001 in 040/043, 02.03.001 in 042). **Deciso in M7: ADR 0036, piano PMI standard (clienti 05.01.001, fornitori 14.01.001).**
|
||||
18. Regola R-005 del mockup 072 "riapre in bozza" una fattura scartata: contrasta con l'immutabilità della fattura emessa.
|
||||
19. Codice campagne `CMP-…` (068) non presente nelle maschere di §11.12.
|
||||
20. Codice di scarto 00327 citato in §18 senza descrizione.
|
||||
|
||||
@@ -0,0 +1,65 @@
|
||||
# ADR 0032 - Motore documenti: comportamento per genere, tabelle per famiglia, numerazione alla conferma
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-12
|
||||
- **Modifica:** SPEC §11.3; milestone M5, issue #47
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.3 vuole un solo motore per tutti i documenti (vendita, acquisto, magazzino), guidato da definizioni
|
||||
dichiarative, con tabelle per famiglia (`sale_quotations`, `sale_orders`, `sale_documents`, `purchase_orders`,
|
||||
`purchase_documents`, `inventory_documents`, ognuna con le righe), `document_links` per l'evasione, gli stati
|
||||
`Draft → Confirmed → (PartiallyFulfilled | Fulfilled) → Closed`, `Cancelled` e per le fatture
|
||||
`Draft → Issued → SdiGenerated → SdiSent → (SdiDelivered | SdiRejected | SdiNotDelivered)`, la numerazione alla
|
||||
conferma con la data non anteriore all'ultimo numero del sezionale. Restavano aperti: dove sta il comportamento di un
|
||||
tipo documento (la tabella `document_types` è modificabile dall'utente e il suo `kind` dice solo la famiglia di
|
||||
numerazione), come si numera per anno quando il numeratore è per anno, quando nasce un legame di evasione, che cosa
|
||||
fa la copia, quali tabelle servono già adesso.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Genere e definizione.** Il comportamento sta in codice, per **genere** (`DocumentKind`: preventivo, ordine
|
||||
cliente, DDT, fattura immediata, accompagnatoria, differita, di acconto, nota di credito, nota di debito, parcella,
|
||||
pro forma, autofattura, ordine fornitore, DDT fornitore, fattura fornitore, nota di credito fornitore, movimento di
|
||||
magazzino). `DocumentBehaviors` dà per ogni genere: famiglia (tabella), direzione, ciclo di vita, effetti
|
||||
(magazzino, impegnato, ordinato, contabilità, scadenze, e-fattura), tipi di riga ammessi, generi da cui evade
|
||||
(sorgenti) e permessi. La tabella `document_types` riceve la colonna `document_kind`: ogni tipo dell'utente
|
||||
sceglie un genere e aggiunge numeratore, causale di magazzino, TD SDI, causale contabile, registro IVA, modello di
|
||||
stampa. `DocumentDefinition` è l'unione dei due (tipo + comportamento) e si legge con `DocumentDefinitionService`.
|
||||
I tipi seminati prendono il genere dalla migrazione e dal modello del pacchetto paese.
|
||||
2. **Tre cicli di vita.** `DocumentStateMachine` conosce tre cicli: *ordine* (preventivi, ordini, DDT, pro forma:
|
||||
bozza, confermato, evaso parzialmente, evaso, chiuso, annullato), *fattura* (fatture e autofatture di vendita:
|
||||
bozza, emessa, XML generato, inviata, consegnata, scartata, non consegnata, annullata) e *semplice* (fatture
|
||||
fornitore, movimenti: bozza, confermato, annullato). Per ogni stato dice le azioni ammesse; un'azione non ammessa
|
||||
è rifiutata con `document.action.not-allowed`. Si modifica solo una bozza, oltre a ordini e preventivi confermati
|
||||
non evasi; la fattura emessa è immutabile: si annulla con un motivo finché l'XML non è inviato (o se scartato),
|
||||
altrimenti si fa una nota di credito. Gli stati di evasione non sono azioni: li calcola `FulfillmentCalculator`.
|
||||
3. **Numerazione alla conferma.** `DocumentNumberingService` numera nella stessa transazione della conferma, sotto il
|
||||
lock `numerator:<codice>:<anno>` (advisory lock di transazione su PostgreSQL, lock di scrittura su SQLite): un
|
||||
rollback restituisce il numero, quindi non nascono buchi. Il numeratore del tipo vale per il suo codice; per
|
||||
l'anno della data si usa la riga (codice, anno) e, se manca, si crea copiando formato, prefisso e sezionale
|
||||
dell'ultima. Sui numeratori **senza buchi** (fatture, autofatture, protocollo acquisti) la data non può
|
||||
precedere l'ultima numerata (`document_numerators.last_date`) e la conferma chiede il periodo aperto quando il
|
||||
genere ha effetto contabile. `FindGapsAsync` elenca i numeri mancanti di un numeratore. Un documento numerato non
|
||||
si elimina: si annulla e il numero resta.
|
||||
4. **Tabelle.** Sei testate e sei tabelle di righe con le stesse colonne (classi base `DocumentHeader` e
|
||||
`DocumentLine`), più `document_links` (riga destinazione → riga sorgente, quantità). Le tabelle del castelletto IVA
|
||||
e delle rate arrivano con il calcolo dei totali (#48), i campi di trasporto sono già nella testata.
|
||||
5. **Evasione.** Una riga copiata da un documento evadibile tiene la riga d'origine (`source_family`,
|
||||
`source_line_id`). Il legame in `document_links` nasce alla **conferma** del documento destinazione e sparisce al
|
||||
suo annullamento; dopo ogni cambio `FulfillmentCalculator` ricalcola la quantità evasa delle righe sorgente e lo
|
||||
stato del documento sorgente (confermato, evaso parzialmente, evaso). Le righe con saldo forzato contano come
|
||||
evase; un documento chiuso o annullato non cambia stato.
|
||||
6. **Copia.** `DocumentCopyService` crea una bozza da un documento esistente verso lo stesso tipo (duplicazione) o un
|
||||
altro della stessa direzione (trasformazione). Se il genere destinazione evade il genere sorgente si copiano le
|
||||
quantità residue e le righe tengono l'origine, altrimenti si copiano le quantità intere senza legame.
|
||||
7. **Servizio generico.** `DocumentService<THeader, TLine>` (uno per famiglia) espone crea, leggi, salva, conferma,
|
||||
annulla, chiudi, riapri, elimina e copia; il lavoro su più famiglie (evasione, copia) passa da `DocumentEngine`, che
|
||||
tratta testate e righe tramite le classi base.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Un tipo documento nuovo dell'utente funziona senza codice se usa un genere esistente; un genere nuovo è codice.
|
||||
- Gli effetti sono dichiarati ma si applicano con i moduli: magazzino in M6, contabilità in M7, scadenze in M8,
|
||||
e-fattura in M8. Il calcolo dei totali e delle rate è #48, le maschere sono #49-#51.
|
||||
- La numerazione concorrente è provata su SQLite e PostgreSQL (test dei dati, eseguiti su PostgreSQL 16 e 17 ai tag).
|
||||
@@ -0,0 +1,55 @@
|
||||
# ADR 0033 - Totali, castelletto IVA e scadenze dei documenti
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-12
|
||||
- **Modifica:** SPEC §11.3; milestone M5, issue #48
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.3 chiede un `DocumentTotalsCalculator` (imponibile di riga, sconti a cascata, castelletto per codice IVA,
|
||||
spese, sconto di piede, bollo, ritenuta, cassa previdenza, split payment, reverse charge, IVA per cassa) e un
|
||||
`InstallmentGenerator` (fine mese, giorno fisso, percentuali, IVA sulla prima rata, arrotondamento sull'ultima), con
|
||||
tabelle `_tax_summary` e `_installments` per ogni famiglia. Restavano aperti: dove si applica lo sconto di piede,
|
||||
come si gestiscono i prezzi IVA compresa, che cosa entra nella base della ritenuta e della cassa, dove si salvano
|
||||
castelletto e scadenze, quando si ricalcolano.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Calcolo puro.** `DocumentTotalsCalculator` e `InstallmentGenerator` sono funzioni senza database, provate con
|
||||
casi numerici di riferimento. L'arrotondamento e il bollo vengono da `ITaxEngine` del pacchetto paese.
|
||||
2. **Riga.** Importo = quantità × prezzo × (1 − s1)(1 − s2)…, al centesimo con metà lontano da zero. Spese e sconti
|
||||
senza quantità valgono una volta; le righe di sconto sono negative; le righe descrittive non contano.
|
||||
3. **Sconto di piede** (formula come `10+5`): si applica a ogni riga di merce, non alle spese, e solo nel castelletto.
|
||||
La riga conserva il suo importo, il documento registra quanto lo sconto ha tolto (`footer_discount_amount`).
|
||||
4. **Castelletto** per codice IVA, con l'imposta calcolata sul totale del gruppo (come `DatiRiepilogo`). Con i
|
||||
**prezzi IVA compresa** si somma il lordo del gruppo e si scorpora una volta sola. L'esigibilità è quella del
|
||||
codice IVA, del documento (IVA per cassa) o *S* con lo **split payment**. Il reverse charge non ha bisogno di
|
||||
regole: i codici N6.x hanno aliquota zero.
|
||||
5. **Cassa previdenza, ritenuta, ENASARCO.** La base è la somma delle righe non escluse
|
||||
(`withholding_excluded`, ad esempio le spese anticipate in nome del cliente), dopo lo sconto di piede. La cassa
|
||||
entra nel castelletto con l'IVA indicata o con quella della prima riga imponibile; la ritenuta si calcola sulla
|
||||
quota della base (100% per i professionisti, 50% o 20% per gli agenti), con la cassa se è soggetta. Ritenuta,
|
||||
ENASARCO e IVA in split payment si tolgono dal **netto a pagare**, non dal totale.
|
||||
6. **Bollo** sulle fatture e note di vendita quando gli importi senza IVA che lo richiedono superano la soglia del
|
||||
pacchetto paese (77,47 euro): è sempre indicato; entra nel totale solo se addebitato al cliente.
|
||||
7. **Scadenze** dal netto a pagare e dalle rate della condizione di pagamento; con *IVA sulla prima rata* l'IVA
|
||||
effettivamente incassata va tutta sulla prima. Fine mese e giorno fisso: con fine mese il giorno fisso è del mese
|
||||
successivo, senza fine mese è il primo giorno fisso non anteriore. I **mesi esclusi** stanno nelle condizioni di
|
||||
vendita del cliente e spostano la scadenza a un giorno del mese successivo (10 se non indicato). Le scadenze
|
||||
esistono per fatture, note, fatture fornitore e, come previsione, per preventivi, ordini e pro forma.
|
||||
8. **Due tabelle condivise invece di dodici.** Castelletto e scadenze stanno in `document_tax_summaries` e
|
||||
`document_installments` con la colonna `family`, come `document_links`: le righe non hanno vincoli verso una
|
||||
sola tabella e il codice resta unico per tutte le famiglie. Diverge dalla lettera di §11.3 (una coppia di tabelle
|
||||
per famiglia), non dalla sostanza.
|
||||
9. **Quando.** Il motore ricalcola a ogni salvataggio (bozze e righe di documenti ancora aperti) e riscrive
|
||||
castelletto e scadenze nella stessa transazione. Un documento emesso non cambia più, quindi i suoi totali restano
|
||||
quelli dell'emissione. Lo scadenzario vero (partite, incassi) arriva con M8 e parte da queste righe.
|
||||
10. **Revisioni dei preventivi.** Modificare un preventivo confermato aumenta il numero di revisione: il numero
|
||||
del documento resta lo stesso.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Le maschere mostrano castelletto, totali e scadenze ricalcolati durante la modifica con lo stesso codice del
|
||||
salvataggio (anteprima senza scrittura).
|
||||
- Il file FatturaPA (M9) troverà lo sconto di piede da ripartire sulle righe e il castelletto già pronto.
|
||||
- Lo sconto cassa resta fuori: si gestirà con gli incassi (M8).
|
||||
@@ -0,0 +1,47 @@
|
||||
# ADR 0034 - Stampa e invio dei documenti
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-12
|
||||
- **Modifica:** SPEC §9.4, §12.6; milestone M5, issue #52
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §9.4 chiede l'anteprima di stampa (mockup 025) e il PDF di ogni documento come allegato versionato; §12.6 l'invio
|
||||
per e-mail con modelli, allegati ed esito nel log. Il vincolo di §1 esclude librerie esterne per PDF, posta e modelli.
|
||||
Restavano aperti: come tenere uguali anteprima e PDF, dove stanno le diciture, quali immagini accetta il PDF, come si
|
||||
invia la posta senza una libreria, che cosa succede se il server di posta non risponde.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Un solo modello di stampa.** `DocumentPrintService` costruisce un `DocumentPrintModel` (intestazione dell'azienda
|
||||
dal profilo, controparte, campi, righe, riepilogo IVA, scadenze, totali, trasporto, firme, diciture, filigrana) già
|
||||
formattato con la cultura italiana. L'anteprima HTML (`SalesPrintPage`) e il PDF (`DocumentPdfGenerator`, sopra il
|
||||
`PdfWriter` di M3) disegnano lo stesso modello: un campo nuovo compare in tutti e due.
|
||||
2. **Diciture nelle risorse.** Etichette, diciture di legge (split payment, pro forma non valida ai fini fiscali,
|
||||
fattura differita) e filigrane (*Bozza*, *Annullato*, *Dato dimostrativo*) stanno in `Resources/it-IT/Print.json`.
|
||||
I modelli di stampa configurabili per tipo documento di §9.4 restano per M12; fino ad allora il tipo documento
|
||||
sceglie solo quali blocchi compaiono (il trasporto e le firme per DDT e fatture accompagnatorie).
|
||||
3. **Logo.** Nell'anteprima compare qualunque immagine del profilo; nel PDF solo un **JPEG**, perché il `PdfWriter`
|
||||
incorpora i JPEG senza decodificarli (DCTDecode) e un decodificatore PNG scritto in casa non vale il costo ora.
|
||||
Con un PNG il PDF esce senza logo.
|
||||
4. **Il PDF è un allegato.** Il generatore `documents.pdf` è un `IFileGenerator`: *Salva come allegato* e l'invio per
|
||||
e-mail creano una nuova versione, così resta la copia esatta di ciò che è uscito. Il documento registra i flag
|
||||
*stampato* e *inviato* (con la sola permission di lettura, perché non cambiano il contenuto) e lo storico.
|
||||
5. **SMTP scritto in casa.** `SmtpMailSender` parla SMTP su `TcpClient`/`SslStream`: EHLO, STARTTLS o TLS implicito,
|
||||
AUTH PLAIN o LOGIN, un messaggio per connessione, timeout di 60 secondi. `MimeMessageWriter` scrive
|
||||
`multipart/mixed` con testo e allegati in base64 e intestazioni non ASCII come *encoded word*. Configurazione da
|
||||
`KHAEMHAT_SMTP_*` finché non c'è la pagina *Impostazioni* (M12).
|
||||
6. **Coda in memoria.** `MailQueue` è un servizio in background con un canale limitato a 500 messaggi: tre tentativi
|
||||
a 30 e 60 secondi, ogni passo nel log, sezione *E-mail/PEC*. Chi invia non aspetta il server. Un messaggio in coda
|
||||
quando il processo si ferma si perde e il log lo dice; una coda persistente arriva se servirà con le automazioni
|
||||
(M12).
|
||||
7. **Modelli con campi.** Oggetto e testo vengono da `Print.Mail.*` con i campi `{{Documento}}`, `{{Numero}}`,
|
||||
`{{Data}}`, `{{Cliente}}`, `{{Azienda}}`, `{{Totale}}` (`MailTemplateRenderer`; un campo sconosciuto resta
|
||||
com'è, così l'errore si vede). L'utente li modifica prima di inviare; i modelli per azienda arrivano con M12.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Anteprima e PDF non divergono e si provano insieme (il modello ha i suoi test).
|
||||
- Nessuna dipendenza nuova; il client SMTP è provato contro un server finto in-process.
|
||||
- Limiti noti: niente PNG nel PDF, niente coda persistente, niente modelli per azienda, niente PEC dedicata (arriva
|
||||
con il canale SDI via PEC in M9).
|
||||
@@ -0,0 +1,80 @@
|
||||
# ADR 0035 - Magazzino e ciclo passivo
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-12
|
||||
- **Modifica:** SPEC §11.5, §11.6, §12.12; milestone M6, issue #55-#61
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.6 chiede giacenze per deposito con impegnato, ordinato e disponibile aggiornati nella stessa transazione del
|
||||
documento, costo medio ponderato (FIFO e LIFO predisposti), inventario fisico, proposta di riordino, valorizzazione a
|
||||
data e una ricostruzione; §11.5 il ciclo passivo con protocollo IVA, import delle fatture elettroniche ricevute,
|
||||
controllo dei prezzi rispetto all'ordine e autofatture TD16-TD29. Il motore documenti di M5 (ADR 0032) sa già quali
|
||||
generi hanno effetto *Inventory*; restavano aperti: come si registra un movimento, come si calcola il costo quando i
|
||||
documenti arrivano fuori ordine di data, come non contare due volte la merce di una fattura nata da un DDT, come
|
||||
portare le novità nelle aziende create prima, dove stanno le regole italiane di autofatture e import.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **La causale decide, il genere filtra.** Ogni tipo documento ha una causale di magazzino (`inventory_reasons`:
|
||||
carico, scarico, nessun effetto; flag *trasferimento* e *muove il valore*). `StockEffectMatrix` (in `Khaemhat.Core`)
|
||||
dice quali generi la applicano (DDT, fatture immediate e accompagnatorie, note, DDT e fatture fornitore, note di
|
||||
credito fornitore, movimenti `MM`) e quali hanno costi d'acquisto che muovono la media (DDT fornitore, fattura
|
||||
fornitore, movimento con prezzo). Ordini clienti e fornitori non muovono la giacenza: il loro **residuo** è
|
||||
l'impegnato e l'ordinato. Le causali di base sono 12 (`CAR`, `SCA`, `RESC`, `RESF`, `TRA`, `INVP`, `INVN`, `CVU`,
|
||||
`CVR`, `OMA`, `AUTO`, `APE`).
|
||||
2. **Movimenti come righe derivate.** `InventoryPoster` gira dentro la transazione del motore documenti: alla conferma
|
||||
scrive un `inventory_entries` per documento con una riga per articolo e deposito (`inventory_entry_lines`, quantità
|
||||
nell'unità base, con segno); all'annullamento o alla modifica di un documento in vigore lo riscrive da capo. Le righe
|
||||
che vengono da un documento che ha già mosso la merce nello stesso verso (la fattura di un DDT) sono saltate;
|
||||
la nota di credito di una fattura la muove all'inverso.
|
||||
3. **Storia ricalcolata, non saldi incrementali.** Dopo ogni modifica la storia degli articoli toccati viene
|
||||
ripercorsa per data e ordine di registrazione (`StockCostCalculator`): giacenza per deposito, costo medio ponderato
|
||||
dell'articolo su tutti i depositi, ultimo costo, date di ultimo carico e scarico, e i risultati vanno in
|
||||
`item_balances` e nella scheda articolo. Così un documento con una data passata dà lo stesso risultato di uno
|
||||
inserito in ordine. Ogni carico con valore sposta la media; gli altri movimenti escono alla media del momento; con
|
||||
giacenza a zero o negativa il carico successivo fissa la media. La giacenza negativa non blocca la conferma (non
|
||||
si fermano le consegne), si vede nelle giacenze e nella dashboard.
|
||||
4. **La fattura corregge il costo del carico.** Il prezzo di una fattura fornitore confermata sostituisce, per la quota
|
||||
fatturata, il costo dei carichi dei DDT fornitore che fattura; la differenza di prezzo rispetto a ordine e ricevimento
|
||||
è anche mostrata come avviso sulla fattura (`PurchaseService.PriceDifferencesAsync`), senza bloccare.
|
||||
5. **Ricostruzione.** `InventoryService.RebuildAsync` cancella i movimenti e riposta tutti i documenti in vigore,
|
||||
dal più vecchio e, a parità di data, i DDT prima delle fatture, poi ricalcola ogni articolo; gira a mano (con
|
||||
avanzamento) e ogni domenica come job di sistema `inventory.rebuild`.
|
||||
6. **Inventario come documento a sé.** `stock_takes` e `stock_take_lines` fotografano la giacenza contabile alla
|
||||
data del conteggio; la registrazione crea due movimenti `MM` (`INVP` e `INVN`) alla stessa data. Gli articoli non
|
||||
contati non vengono toccati; non c'è blocco dei movimenti durante il conteggio, perché le rettifiche sono datate
|
||||
e la storia ricalcolata tiene conto dei movimenti successivi.
|
||||
7. **Valorizzazione.** Costo medio ponderato, ultimo costo e costo standard a qualsiasi data, con classi ABC (80% e
|
||||
95% del valore). FIFO e LIFO restano **predisposti**: il criterio è un parametro del calcolo
|
||||
(`StockValuationMethod`) e i movimenti conservano data, quantità e costo di ogni carico, ma i due metodi non sono
|
||||
ancora offerti perché richiedono i lotti di carico, rimandati a dopo la 1.0.
|
||||
8. **Tabelle di base nelle aziende esistenti.** La migrazione `M20261113_001_CreateInventory` crea le tabelle e
|
||||
assegna la causale ai tipi di base che non l'hanno (`FI` → `SCA`, `FF` → `CAR`, `NCF` → `RESF`), senza toccare una
|
||||
causale scelta dall'utente. I tipi nuovi (`AF20`-`AF29`) e le causali mancanti si aggiungono con *Aggiorna da
|
||||
tabelle base* o `scripts/seed.sh --base`, che aggiungono i codici mancanti senza modificare quelli esistenti
|
||||
(ADR 0026). Il tracciato
|
||||
*Giacenze iniziali* scrive un movimento `APE` per deposito.
|
||||
9. **Regole italiane nel pacchetto fiscale.** `ISelfInvoiceRules` (`SelfInvoiceRulesIt`) decide dall'anagrafica del
|
||||
fornitore (paese, UE), dal genere delle righe (beni o servizi) e dalle nature IVA quale autofattura serve (TD16,
|
||||
TD17, TD18, TD19, TD28) e la scadenza (15 del mese successivo; 90 giorni per TD20 e TD29).
|
||||
`IIncomingInvoiceRules` (`IncomingInvoiceRulesIt`) traduce il tipo FatturaPA nel tipo documento d'acquisto (TD01,
|
||||
TD02, TD03, TD05, TD06, TD24-TD27 in `FF`; TD04 e TD08 in `NCF`; gli altri sono rifiutati). L'applicazione non
|
||||
conosce i codici TD.
|
||||
10. **Import delle fatture ricevute.** `PurchaseInvoiceImportService` legge XML, P7M e ZIP con il lettore di #57, trova
|
||||
il fornitore per partita IVA o codice fiscale (o lo crea), rifiuta i doppioni (stesso fornitore, numero, anno),
|
||||
abbina le righe per codice del fornitore, EAN e codice articolo, il codice IVA per aliquota e natura, porta gli
|
||||
sconti percentuali nello sconto di riga e gli altri nel prezzo netto, e salva una bozza con il file allegato.
|
||||
Totale diverso, firma non verificata e sconti sul totale sono avvisi, non errori.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Le quantità e i costi sono sempre ricostruibili dai documenti: i movimenti sono un dato derivato e la ricostruzione
|
||||
è anche la verifica di coerenza.
|
||||
- Ricalcolare la storia di un articolo costa più di un aggiornamento incrementale; con le dimensioni di una PMI
|
||||
(migliaia di movimenti per articolo all'anno) resta nell'ordine dei millisecondi, e i documenti toccano pochi
|
||||
articoli alla volta. Se servirà, un punto di partenza annuale (chiusura del magazzino) accorcia la storia.
|
||||
- I documenti fornitore senza numero interno (`DDTF`) si riconoscono dal numero del fornitore; l'interfaccia li mostra
|
||||
come *Senza numero*.
|
||||
- Rimandati: lotti, matricole e ubicazioni; FIFO e LIFO; libro inventari e scritture delle rimanenze (M7); XML delle
|
||||
autofatture e scarico dal canale SDI (M9); report di magazzino stampabili (M13).
|
||||
@@ -0,0 +1,65 @@
|
||||
# ADR 0036 - Contabilità generale
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-13
|
||||
- **Modifica:** SPEC §11.7, §12.11; milestone M7, issue #62, #63, #67, #68
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.7 chiede un piano dei conti a tre livelli con un modello italiano, causali con righe proposte, prima nota
|
||||
in partita doppia con registrazioni provvisorie e definitive, registrazioni ricorrenti, partitari di clienti e
|
||||
fornitori, mastrini, bilancio di verifica e libro giornale. Restavano aperti: come si numerano le registrazioni,
|
||||
quando una registrazione non si può più toccare, come si correggono gli errori, dove sta il modello del piano dei
|
||||
conti, come si portano piano e causali nelle aziende create prima di M7.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Piano dei conti a tre livelli.** `gl_accounts` con codice `MM.CC.SSS` (mastro, conto, sottoconto), padre,
|
||||
natura (attività, passività, costo, ricavo, ordine), tipo (generico, clienti, fornitori, banca, cassa, IVA,
|
||||
tributi), voce del bilancio CEE, flag *partitario*, *rilevante IVA* e *chiusura automatica*. Si registra solo sui
|
||||
sottoconti; i conti con partitario chiedono il cliente o il fornitore sulla riga. Un conto con movimenti o con
|
||||
sottoconti non si elimina (si disattiva). Le regole sui codici stanno in `AccountCodes` (`Khaemhat.Core`).
|
||||
2. **Il modello sta nel pacchetto fiscale.** `ILedgerTemplate` (`ItalianLedgerTemplate`) dà il piano *PMI standard*
|
||||
(237 conti, da `Data/piano-dei-conti.csv`), le causali, i registri IVA, il conto di ogni ruolo contabile
|
||||
(`PostingRole`: clienti, fornitori, IVA vendite e acquisti, erario, ritenute, bollo, arrotondamenti...) e quale
|
||||
causale usa ogni tipo documento. L'applicazione non conosce codici di conto italiani.
|
||||
3. **Causali con righe proposte.** `gl_journal_templates` e `gl_journal_template_lines`: area, registro IVA,
|
||||
*apre partite*, *causale di storno*, righe con ruolo o conto, segno e descrizione. La causale di storno non ha
|
||||
righe: copia quelle della registrazione stornata a segni invertiti. Una causale usata non si elimina.
|
||||
4. **Tre stati e due numeri.** Una registrazione (`gl_entries`, `gl_entry_lines`, `gl_entry_vat`) nasce *Bozza*
|
||||
(può non quadrare, non entra nei saldi se non lo si chiede), diventa *Registrata* quando quadra (numero di
|
||||
registrazione per anno, assegnato alla registrazione) e *Definitiva* con **Rendi definitive** fino a una data: le
|
||||
registrazioni ricevono il numero del libro giornale in ordine di data e non si modificano né si eliminano più. Il
|
||||
comando è rifiutato se prima di quella data restano bozze, e dopo non si registra più con una data anteriore
|
||||
all'ultima definitiva. Gli errori su una definitiva si correggono solo con lo
|
||||
**storno** (registrazione `STO` a segni invertiti, una sola per registrazione). `JournalEntryValidator`
|
||||
(`Khaemhat.Core`) controlla quadratura, sottoconti, partitari, righe IVA.
|
||||
5. **Partite aperte.** Le registrazioni con una causale che *apre partite* scrivono `gl_open_items` (una per rata,
|
||||
con scadenza, importo, pagato); il partitario mostra saldo, estratto conto e partite, con le scadute evidenziate.
|
||||
Incassi e pagamenti che chiudono le partite arrivano con la tesoreria (M8).
|
||||
6. **Ricorrenti come copia di un modello.** `gl_recurring_entries` punta a una registrazione modello e ne crea una
|
||||
copia a ogni data (mensile, trimestrale, semestrale, annuale, con la fine del mese mantenuta) fino alla data di
|
||||
fine; il job di sistema `ledger.recurring` gira ogni giorno alle 05:00 e il pulsante *Genera ora* lo anticipa. Le
|
||||
copie sono *Registrate* con origine *Ricorrente*.
|
||||
7. **Saldi calcolati dalle righe.** Mastrini, partitari e bilancio di verifica (`LedgerQueryService`) sommano le
|
||||
righe del periodo, con saldo di apertura dalle righe precedenti, senza tabelle di saldi: le registrazioni toccano
|
||||
poche righe e i totali restano coerenti per costruzione. Il bilancio di verifica raggruppa per mastro, conto e
|
||||
sottoconto, filtra per centro di costo e mostra il risultato del periodo (ricavi meno costi).
|
||||
8. **Stampe.** Libro giornale di prova o definitivo, mastrini, estratti conto e bilancio di verifica sono PDF di
|
||||
`LedgerReport` sul motore di stampa di M5 (ADR 0034).
|
||||
9. **Aziende esistenti.** La migrazione `M20261113_002_CreateLedger` crea le tabelle; i documenti hanno già la
|
||||
colonna *contabilizzato* da M5. Piano dei conti, causali e registri arrivano da `LedgerSeeder` (seed di base, *Aggiorna da tabelle
|
||||
base* o `scripts/seed.sh --base`), che aggiunge i codici mancanti senza toccare quelli esistenti (ADR 0026). La
|
||||
demo (`DemoLedgerSeeder`) contabilizza i documenti demo, paga la fattura del professionista, crea il noleggio
|
||||
mensile della stampante come ricorrente, conferma le liquidazioni dei mesi passati e paga gli F24 scaduti.
|
||||
10. **Permessi.** `ledger.account.read/write`, `ledger.entry.read/write/finalize`; tutto dietro il modulo `ACCT`.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Un errore su una registrazione definitiva lascia sempre traccia (registrazione originale e storno), come chiede il
|
||||
libro giornale.
|
||||
- Sommare le righe a ogni richiesta costa più di un saldo memorizzato; con le dimensioni di una PMI (decine di
|
||||
migliaia di righe l'anno) resta sotto il secondo, e gli indici su conto e data coprono le query. La chiusura
|
||||
dell'esercizio (M10) porta i saldi di apertura e accorcia la storia.
|
||||
- Rimandati: chiusura e riapertura dell'esercizio, bilancio CEE riclassificato, cespiti (M10); incassi, pagamenti e
|
||||
riconciliazione bancaria (M8); budget per centro di costo.
|
||||
@@ -0,0 +1,72 @@
|
||||
# ADR 0037 - Contabilizzazione dei documenti, IVA e F24
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-13
|
||||
- **Modifica:** SPEC §11.7, §11.8, §12.11; milestone M7, issue #64, #65, #66
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.7 e §11.8 chiedono che fatture, note e autofatture si contabilizzino da sole, con registri IVA,
|
||||
liquidazione periodica, acconto, comunicazione LIPE, ritenute d'acconto, certificazione unica, bollo virtuale e
|
||||
prospetto F24. Restavano aperti: quando si scrive la registrazione di un documento, come si corregge, come si
|
||||
calcola la liquidazione, cosa succede se la si riapre, dove stanno codici tributo e scadenze italiane.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Contabilizzazione nella transazione del documento.** `LedgerPoster` gira nel motore documenti, come
|
||||
`InventoryPoster` (ADR 0035), e solo con il modulo `ACCT` attivo. Fatture (immediate, accompagnatorie,
|
||||
differite, di acconto), note di debito e parcelle sono *vendite*; la nota di credito è una vendita a segni
|
||||
invertiti; fattura e nota fornitore sono *acquisti*; autofatture e integrazioni vanno in entrambi i registri. La
|
||||
modifica di un documento in vigore riscrive la sua registrazione **con lo stesso numero**; l'annullamento la
|
||||
elimina o, se è definitiva, la storna. Una registrazione che viene da un documento non si modifica a mano: si
|
||||
corregge il documento. I documenti confermati prima della licenza si contabilizzano in blocco
|
||||
(`LedgerService.PostPendingAsync`, pulsante *Contabilizza documenti*).
|
||||
2. **Regole di registrazione in `PostingEngine`** (`Khaemhat.Core`, senza accesso ai dati): vendita = cliente Dare
|
||||
per il totale, ricavi Avere per conto dell'articolo o della riga, rivalsa cassa e bollo addebitato Avere, IVA
|
||||
vendite Avere; scissione dei pagamenti = l'IVA torna dal cliente al conto dell'erario; acquisto = fornitore Avere,
|
||||
costi Dare con l'IVA indetraibile sommata al costo, IVA acquisti Dare; autofattura = IVA acquisti Dare e IVA
|
||||
vendite Avere. Sconti di testata e arrotondamenti vanno sulla riga più grande, così la registrazione quadra sempre
|
||||
al centesimo. Un conto mancante blocca la conferma con un errore che dice quale ruolo configurare.
|
||||
3. **Righe IVA e partite dal documento.** Il castelletto del documento diventa `gl_entry_vat` nel registro della
|
||||
causale (`VEN1`, `VEN-RC`, `ACQ1`, `ACQ-RC`, `CORR`) con protocollo, data IVA, esigibilità e quota indetraibile;
|
||||
le rate diventano partite aperte; la ritenuta del documento diventa una riga di `withholdings`.
|
||||
4. **Registri e stampa definitiva.** I registri IVA si leggono per periodo con il riepilogo per aliquota; la stampa
|
||||
definitiva (`vat_register_prints`) parte dal giorno dopo l'ultima stampa definitiva e continua la numerazione delle
|
||||
pagine dell'anno. Il blocco del periodo viene dalla liquidazione (punto 5), non dalla stampa.
|
||||
5. **Liquidazione in `VatSettlementCalculator`** (`Khaemhat.Core`): IVA a debito delle vendite e dei corrispettivi
|
||||
esigibili (l'esigibilità differita resta fuori), IVA a credito degli acquisti al netto dell'indetraibile e del pro
|
||||
rata, credito o debito del periodo precedente, acconto di dicembre, interessi dell'1% sul trimestrale (anche sul
|
||||
quarto, versato a marzo con il codice 6099), minimo di versamento sotto il quale il debito passa al periodo dopo. Periodicità dal profilo
|
||||
azienda. La liquidazione si **calcola** quante volte si vuole e si **conferma** in ordine: la conferma scrive la
|
||||
registrazione `LIQ` (IVA vendite Dare, IVA acquisti Avere, interessi Dare, erario c/liquidazione Avere), segna i
|
||||
periodi fiscali come liquidati (da lì documenti e registrazioni con IVA in quelle date sono rifiutati, ADR 0026
|
||||
sui periodi) e crea il versamento F24 se c'è da pagare. La si può **riaprire** finché il suo F24
|
||||
non è pagato e nessuna liquidazione successiva è confermata.
|
||||
6. **Regole italiane nel pacchetto fiscale.** `IVatSettlementRules` (`VatSettlementRulesIt`) dà minimo (25,82),
|
||||
interessi trimestrali, acconto (88%, minimo 103,29, metodi storico, previsionale ed effettivo), codici tributo
|
||||
(6001-6012, 6031-6033, 6099 con rateazione 0101, 6013 e 6035 per l'acconto, 1040 per le ritenute, 2521-2524 per il
|
||||
bollo), scadenze (16 del mese, agosto al 20, acconto al 27 dicembre, giorno lavorativo successivo) e soglie del
|
||||
bollo virtuale (5.000 euro sul primo e secondo trimestre). `IPeriodicVatReturnWriter` (`LipeWriter`) scrive il
|
||||
file LIPE (fornitura `IVP18`); `ITaxPaymentFormExporter` esporta i dati F24 in CSV.
|
||||
7. **Tributi come versamenti.** `tax_payments` raccoglie ogni riga da versare (IVA, acconto, ritenute, bollo) con
|
||||
codice, periodo e scadenza; il prospetto F24 le raggruppa per scadenza. *Registra pagamento* scrive la
|
||||
registrazione `F24` (erario Dare per origine, banca Avere) e segna le righe come pagate; si annulla eliminando o
|
||||
stornando quella registrazione.
|
||||
8. **Ritenute.** Quelle *operate* nascono dalle fatture dei professionisti: in attesa finché la fattura non è
|
||||
pagata, poi da versare (registrazione `RIT`, riga F24 al 16 del mese dopo); quelle *subite* nascono dalle
|
||||
parcelle emesse (registrazione `RITS`, credito per ritenute). I dati della certificazione unica si esportano in
|
||||
CSV per anno e percipiente.
|
||||
9. **Nessun invio telematico.** Khaemhat prepara LIPE, dati F24 e dati CU; l'invio resta all'utente o
|
||||
all'intermediario con i servizi dell'Agenzia delle Entrate.
|
||||
10. **Permessi.** `vat.register.read`, `vat.settlement.read/confirm`, oltre a quelli di ADR 0036.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Documenti e contabilità non divergono: la registrazione è un dato derivato, scritto nella stessa transazione, e
|
||||
una contabilizzazione in blocco la ricostruisce.
|
||||
- Correggere un documento di un periodo già liquidato è rifiutato dal blocco dei periodi: si corregge con una nota
|
||||
di variazione, come prevede la norma, oppure si riapre la liquidazione.
|
||||
- La verifica a mano della demo è un test (`DemoLedgerTests`): la prima liquidazione con IVA è ricalcolata dai
|
||||
registri e confrontata con quella confermata.
|
||||
- Rimandati: dichiarazione IVA annuale, Intrastat, F24 telematico, plafond e dichiarazioni d'intento, IVA per cassa
|
||||
con chiusura automatica delle partite (con gli incassi di M8).
|
||||
@@ -0,0 +1,70 @@
|
||||
# ADR 0038 - Scadenzario, distinte, riconciliazione bancaria e solleciti
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-13
|
||||
- **Modifica:** SPEC §11.8, §10.3; milestone M8, issue #69, #70, #71, #72
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.8 chiede lo scadenzario di clienti e fornitori con incassi e pagamenti (abbuoni, differenze cambio,
|
||||
insoluti), le distinte RiBa, SDD e bonifici SEPA, i mandati, la riconciliazione bancaria con import CSV/CBI/CAMT.053
|
||||
e abbinamento automatico, i solleciti con interessi di mora e il flusso di cassa. Restavano aperti: dove vivono le
|
||||
partite, come si contabilizzano distinte e insoluti, quali versioni dei tracciati produrre senza librerie esterne
|
||||
(SPEC §1), come evitare i doppioni dell'estratto conto, come stimare la confidenza degli abbinamenti, dove stanno i
|
||||
tassi di mora e cosa fa la demo senza licenza FIN.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Le partite sono quelle della contabilità.** Lo scadenzario non ha una tabella sua: legge e aggiorna
|
||||
`gl_open_items`, scritte dalla contabilizzazione dei documenti (ADR 0037). Incassi e pagamenti (`payments`,
|
||||
`payment_lines`) chiudono le partite e scrivono **subito** la registrazione INC o PAG nella stessa transazione,
|
||||
con abbuoni, spese e differenze cambio sui conti dei ruoli di registrazione del pacchetto fiscale
|
||||
(`AllowanceIncome`, `AllowanceExpense`, `BankCharges`, `ExchangeGain`, `ExchangeLoss`). La rettifica di una
|
||||
registrazione mantiene le partite già saldate. L'annullamento di un incasso storna la registrazione e riapre le
|
||||
partite; la ritenuta d'acconto di una parcella diventa dovuta quando la fattura è saldata del tutto.
|
||||
2. **Distinte in quattro passi.** Bozza (le partite passano *In distinta*) → file generato → presentazione → accredito.
|
||||
RiBa e SDD alla presentazione spostano il credito da *Clienti* a *Effetti all'incasso* (`BillsForCollection`); con
|
||||
il *salvo buon fine* la banca accredita subito su *Banche c/anticipi* (`BankAdvances`). L'accredito chiude il conto
|
||||
effetti o l'anticipo. I bonifici SEPA pagano i fornitori già alla presentazione. L'**insoluto** riapre la partita
|
||||
come *Insoluta*, riprende l'importo dalla banca e trasforma le spese in una **nuova partita** del cliente, così il
|
||||
recupero passa dallo scadenzario come ogni altra rata.
|
||||
3. **Tracciati scritti in casa.** RiBa nel tracciato CBI a record di 120 caratteri (IB, 14, 20, 30, 40, 50, 51, 70,
|
||||
EF), scritto dal pacchetto italiano (`RibaCbiWriter`); SDD in `pain.008.001.08` e bonifici in `pain.001.001.09`
|
||||
con `XmlWriter` (`SepaXmlWriter`, nel core perché SEPA non è solo italiano). Le specifiche CBI e gli schemi
|
||||
ISO 20022 non si possono scaricare durante lo sviluppo: i tracciati seguono la documentazione pubblica nota e i
|
||||
test controllano lunghezze, posizioni, totali e struttura. Il file va caricato a mano nell'home banking; il
|
||||
collegamento diretto (CBI online, PSD2) è fuori da M8.
|
||||
4. **Estratti conto senza doppioni.** Ogni movimento importato ha un'**impronta** SHA-256 di conto, data contabile,
|
||||
importo, descrizione e riferimento normalizzati e del numero di movimenti uguali che lo precedono nello stesso
|
||||
file; l'impronta è unica per conto, quindi rimportare un file o file sovrapposti salta i movimenti già presenti.
|
||||
Il CSV si riconosce dalla riga di intestazione (separatore, nomi italiani o inglesi, colonne di entrate e uscite
|
||||
o importo con segno); il CBI dai record RH/61-64/EF; CAMT.053 dallo spazio dei nomi.
|
||||
5. **Confidenza a punti.** `BankMatcher` (core) assegna 50 punti all'importo esatto (40 se entro la tolleranza del
|
||||
candidato, per esempio un insoluto con spese), +30 per un numero di documento, CRO o riferimento trovato nella
|
||||
descrizione, +30 per le parole chiave del candidato, +25 per l'IBAN della controparte, +20 per il nome, e +10/+5/0/-10
|
||||
per la distanza fra le date (≤3, ≤15, ≤60, oltre). Una **regola** salvata che riconosce il testo vale 98. La
|
||||
proposta si conferma a mano o in blocco sopra la soglia di **90**: sotto, la scelta resta all'utente.
|
||||
6. **Interessi di mora nel pacchetto.** `ILatePaymentRules` (astrazioni) e `LatePaymentRulesIt` portano il tasso
|
||||
del D.Lgs. 231/2002: tasso BCE di riferimento del semestre più 8 punti, da una **tabella semestrale** nel codice
|
||||
(2,15% nel primo semestre 2026, 2,40% nel secondo) che va aggiornata a ogni comunicato del MEF; dopo l'ultima riga
|
||||
vale l'ultimo tasso. Gli interessi si mostrano nei solleciti e nell'estratto conto, non si contabilizzano.
|
||||
7. **Solleciti.** Tre livelli predefiniti (7, 20 e 45 giorni) modificabili; canali come flag (e-mail, PEC, lettera
|
||||
PDF); esclusi PA, partite contestate e in distinta. L'invio usa la coda di posta dell'invio documenti (ADR 0034); le lettere si
|
||||
scaricano in un PDF unico. L'attività `finance.dunning` (giorni feriali alle 7:00) invia solo i livelli
|
||||
*Automatico* e solo per e-mail e PEC.
|
||||
8. **Permessi.** Cinque codici: `finance.schedule.read`/`write`, `finance.payment.read`/`write`,
|
||||
`finance.bank.reconcile`, tutti nel modulo `FIN`; le registrazioni chiedono anche `ACCT`.
|
||||
9. **Demo solo con FIN.** `DemoTreasurySeeder` usa gli stessi servizi del programma, che controllano la licenza:
|
||||
senza il modulo FIN attivo la demo salta la tesoreria invece di scrivere dati che l'azienda non potrebbe vedere.
|
||||
10. **Flusso di cassa calcolato al momento.** Nessuna tabella: saldo contabile di banche e cassa, partite aperte,
|
||||
effetti presentati senza anticipo, residuo degli ordini (30 giorni dopo la consegna), registrazioni ricorrenti
|
||||
che muovono la banca e F24 non pagati; lo scaduto cade nel primo periodo.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Contabilità e scadenzario non possono divergere: c'è una sola fonte delle partite.
|
||||
- La tabella dei tassi di mora è una manutenzione semestrale del pacchetto italiano (gennaio e luglio).
|
||||
- I tracciati vanno provati con l'home banking reale alla prima installazione; le differenze si correggono nel
|
||||
pacchetto senza toccare i servizi.
|
||||
- Il piano dei conti PMI standard guadagna *Perdite su cambi*, *Utili su cambi* e *Interessi di mora attivi*
|
||||
(240 conti).
|
||||
@@ -0,0 +1,81 @@
|
||||
# ADR 0039 - Fatturazione elettronica: file, stati, canali e ricezione
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-13
|
||||
- **Modifica:** SPEC §11.9, §10.3 (mockup 058 e 059); milestone M9, issue #74, #75, #76, #77, #79
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.9 chiede il file FatturaPA delle fatture emesse con controllo prima dell'invio, la trasmissione allo SDI
|
||||
attraverso quattro canali (PEC integrata, SdICoop, due intermediari) con regole di instradamento, le notifiche che
|
||||
aggiornano lo stato dei documenti, le fatture ricevute, la correzione degli scarti, la copia di cortesia e il
|
||||
pacchetto per la conservazione. Restavano aperti: dove sta il file e come convive con il documento, come si
|
||||
numerano i file, come si controlla il file senza librerie esterne né lo schema ufficiale (SPEC §1, nessun download
|
||||
durante lo sviluppo), come si evitano doppioni di notifiche e fatture ricevute, come si leggono i canali senza perdere
|
||||
messaggi, come riceve SdICoop e come si proteggono le credenziali.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Il file sta nel database.** Ogni file è una riga di `e_invoices` con il contenuto XML, nome, progressivo,
|
||||
canale, identificativo SDI e stato. Lo stato del documento di vendita segue quello del file nella stessa
|
||||
transazione, attraverso il motore dei documenti (`AdvanceExchangeAsync`, azioni `GenerateXml`, `Send`,
|
||||
`MarkDelivered`, `MarkRejected`, `MarkNotDelivered`). Un file scartato **non si cancella**: resta come
|
||||
*sostituito* e il documento torna modificabile; la nuova generazione prende un nuovo progressivo. Un file
|
||||
generato e non ancora inviato si riscrive con lo stesso nome.
|
||||
2. **Nome e progressivo.** `IT<identificativo>_<progressivo>.xml`, progressivo di cinque caratteri in base 36 da un
|
||||
contatore dell'azienda, mai riusato (60.466.175 file per trasmittente).
|
||||
3. **Tutto ciò che è italiano nel pacchetto.** Le astrazioni (`IEInvoiceWriter`, `IEInvoiceValidator`,
|
||||
`IEInvoiceReceiptReader`, `IEInvoiceChannels`, `IEInvoicePushReader`) sono in `Khaemhat.Fiscal.Abstractions`;
|
||||
scrittura, controlli, lettura delle ricevute e i quattro trasporti sono in `Khaemhat.Fiscal.Italy`. Il web non
|
||||
dipende dal pacchetto italiano.
|
||||
4. **Controlli con i codici dello SDI e schema scritto in casa.** `FatturaPaValidator` ripete offline i controlli
|
||||
documentati dall'Agenzia con lo **stesso codice di errore** (00400, 00423, 00471…), con le tolleranze delle
|
||||
specifiche (un centesimo su `PrezzoTotale` e `Imposta`, un euro su `ImponibileImporto`); ciò che richiede i
|
||||
registri dell'Agenzia (partita IVA esistente, codice destinatario accreditato, indice IPA) si controlla solo nella
|
||||
forma. La struttura si controlla contro uno schema XSD **scritto per Khaemhat** sulle regole del formato 1.2
|
||||
(risorsa incorporata `FatturaPA_v1.2_khaemhat.xsd`), perché il file ufficiale non si può scaricare durante lo
|
||||
sviluppo; le specifiche seguite sono la 1.9.1 (`FatturaPaCodeLists.SpecVersion`). Sostituire lo schema con
|
||||
quello ufficiale non cambia il codice.
|
||||
5. **Una notifica entra una volta.** Il nome del file della notifica è unico in `e_invoice_notifications`; un
|
||||
doppione è riconosciuto e segnalato, non applicato due volte. La notifica si abbina al file per nome del file
|
||||
fattura o per identificativo SDI; quella non abbinata resta registrata ed evidenziata. MT e SE si conservano
|
||||
senza cambiare stato. Le fatture ricevute entrano in `e_invoice_inbox` una volta sola (impronta SHA-256 del
|
||||
contenuto).
|
||||
6. **Lettura dei canali senza perdite.** L'attività `einvoice.poll` (ogni 15 minuti) legge i canali attivi e non in
|
||||
pausa; ogni messaggio è **confermato** (archiviato in PEC, `ack` o cancellazione presso l'intermediario) solo dopo
|
||||
che tutti i suoi file sono stati salvati, così un arresto a metà rilegge il messaggio e la deduplicazione scarta
|
||||
ciò che c'è già. Per la PEC si leggono solo i messaggi con mittente `fatturapa.it` e gli allegati `.xml`/`.p7m`
|
||||
del messaggio originale; la cartella di archivio è l'impostazione consigliata.
|
||||
7. **Instradamento a regole.** `SdiRouter` (core) sceglie la prima regola attiva che si applica, nell'ordine:
|
||||
*Sempre*, *Cliente PA*, *Cliente specifico*, *Tipo documento*, *Volume giornaliero*. Ogni regola ha un canale di
|
||||
riserva usato se il primo è in pausa, disattivato o fallisce l'invio. Senza regole vale il primo canale attivo.
|
||||
8. **SdICoop in push.** Lo SDI consegna notifiche e fatture con chiamate SOAP verso l'azienda. Khaemhat espone
|
||||
`POST /sdicoop/{azienda}` (anonimo per l'autenticazione dell'applicazione, senza antiforgery, al massimo 16 MB);
|
||||
`SdiPushService` accetta la chiamata solo se il canale SDICOOP è attivo e l'intestazione
|
||||
`X-Khaemhat-SdiCoop-Key` corrisponde alla chiave di ricezione (confronto a tempo costante delle impronte SHA-256).
|
||||
Il certificato reciproco richiesto dall'Agenzia si verifica sul **reverse proxy**, che aggiunge l'intestazione:
|
||||
Kestrel resta senza configurazione TLS speciale. Il pacchetto legge la busta (`IEInvoicePushReader`) e prepara la
|
||||
risposta SOAP. Risposte: 404 azienda sconosciuta o senza modulo, 401 canale non attivo o chiave errata, 400 corpo
|
||||
illeggibile, 200 dopo il salvataggio.
|
||||
9. **Credenziali cifrate.** Password, chiavi API, chiave di ricezione e certificato PKCS#12 sono cifrati con
|
||||
`ISecretProtector` (scopo `einvoice.channel`) e non tornano mai nell'interfaccia: un campo vuoto mantiene il valore.
|
||||
Gli indirizzi dei servizi devono essere `https` (`http` solo verso `localhost`).
|
||||
10. **Copia di cortesia in PDF.** La stampa del documento con il file FatturaPA come file associato (`/AF`,
|
||||
struttura PDF/A-3). Non si dichiara la conformità PDF/A, che richiederebbe profili colore e font incorporati
|
||||
certificati.
|
||||
11. **Conservazione come esportazione.** Khaemhat non è un conservatore: `ConservationExportService` prepara uno ZIP
|
||||
(`emesse/`, `ricevute/`, `notifiche/`, `indice.csv` con SHA-256, `LEGGIMI.txt`) per al massimo 731 giorni e
|
||||
registra in `e_invoice_conservation` periodo, numero di file, dimensione e impronta.
|
||||
12. **Permessi.** `einvoice.document.read`, `einvoice.document.send`, `einvoice.inbox.read`, `einvoice.inbox.import`,
|
||||
`einvoice.channel.manage`, tutti nel modulo `EINV`.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- La fattura e i suoi file viaggiano insieme in backup e ripristino; il database cresce di qualche kB per fattura.
|
||||
- Gli scarti più comuni si vedono prima dell'invio, con il messaggio che lo SDI darebbe.
|
||||
- Lo schema scritto in casa può essere meno severo di quello ufficiale su dettagli di struttura: quando l'utente
|
||||
autorizza il download, il file ufficiale va messo al posto della risorsa e i test di scrittura rieseguiti.
|
||||
- SdICoop e gli intermediari sono pronti ma vanno attivati solo dopo l'accreditamento e la scelta del fornitore
|
||||
(issue #78, ADR 0040); la PEC funziona da subito.
|
||||
- Le dichiarazioni d'intento (M10) e il formato EN 16931 / UBL arriveranno come altre implementazioni delle stesse
|
||||
astrazioni.
|
||||
@@ -0,0 +1,44 @@
|
||||
# ADR 0040 - Contratti degli intermediari SDI e rimozione dei dati di esempio
|
||||
|
||||
- **Stato:** accettata
|
||||
- **Data:** 2026-11-13
|
||||
- **Modifica:** SPEC §11.9, §14; milestone M9, issue #77, #78, #80
|
||||
|
||||
## Contesto
|
||||
|
||||
SPEC §11.9 prevede due intermediari accreditati come canali verso lo SDI, ma il titolare del progetto non ha ancora
|
||||
scelto i fornitori (issue #78): non ci sono API reali da seguire. SPEC §14 chiede inoltre che i dati di esempio si
|
||||
possano **rimuovere** senza toccare i dati dell'utente; finora ogni milestone aggiungeva tabelle demo e una rimozione
|
||||
scritta a mano avrebbe dovuto essere aggiornata ogni volta.
|
||||
|
||||
## Decisione
|
||||
|
||||
1. **Due contratti generici.** `IntermediaryTransportBase` contiene il ciclo comune (invio, lettura dei file in
|
||||
attesa, conferma, prova); le due classi derivate definiscono solo le richieste:
|
||||
- **Intermediario A** (chiave API, `Authorization: Bearer`): `POST {endpoint}/invoices` con il file e
|
||||
l'intestazione `X-File-Name`, risposta `{ "id", "sdiId" }`; `GET files` per notifiche e fatture in attesa;
|
||||
`POST files/{id}/ack` per confermarle; `GET status` per la prova.
|
||||
- **Intermediario B** (utente e password, `Authorization: Basic`): `POST api/v1/send`, `GET api/v1/inbox`,
|
||||
`DELETE api/v1/inbox/{id}` come conferma, `GET api/v1/ping`.
|
||||
Quando l'utente sceglie i fornitori, ogni contratto diventa l'API reale cambiando solo le richieste della classe
|
||||
derivata; servizi, instradamento, interfaccia e test di integrazione restano uguali.
|
||||
2. **Prima l'accreditamento.** SdICoop e intermediari sono scritti e provati con server finti nei test, ma si
|
||||
attivano in produzione solo dopo accreditamento o contratto (#78). La PEC è il canale che funziona subito.
|
||||
3. **Rimozione guidata dallo schema.** `DemoDataRemover` legge dalle migrazioni le tabelle con la colonna `is_demo`
|
||||
e le chiavi esterne: elimina le righe marcate e quelle delle tabelle senza marca che appartengono loro (righe di
|
||||
documento, giacenze), in ordine di dipendenza e in **una transazione**. Se una riga dell'utente si riferisce a una
|
||||
riga demo (una fattura vera a un cliente demo) non elimina nulla e restituisce le tabelle che lo impediscono.
|
||||
Le entità che possono essere demo implementano `IDemoMarkable`; un nuovo modulo è coperto senza modifiche.
|
||||
4. **Comando.** `scripts/seed.sh --remove-demo [--company CODICE]` (non combinabile con `--base`, `--demo`,
|
||||
`--scale`) stampa le righe rimosse per tabella o le tabelle bloccanti.
|
||||
5. **Demo della fatturazione solo con EINV e senza rete.** `DemoEInvoiceSeeder` usa i servizi del programma, che
|
||||
controllano la licenza; il canale PEC dell'esempio è **in pausa** con credenziali finte e le notifiche sono
|
||||
applicate come se fossero arrivate, così nessun dato dimostrativo raggiunge lo SDI.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Il lavoro per un intermediario reale è limitato a una classe e ai suoi test.
|
||||
- Un database creato prima della marca `is_demo` su tutte le tabelle può bloccare la rimozione: è voluto, l'utente
|
||||
vede quali tabelle controllare.
|
||||
- La rimozione resta un'operazione da super utente e da riga di comando; il pulsante nell'interfaccia arriva con le
|
||||
pagine di amministrazione (M12).
|
||||
@@ -1,178 +1,180 @@
|
||||
# Acquisti
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-10 · **Versione software:** non ancora rilasciata (milestone M6)
|
||||
> **Modulo di licenza:** CORE (XML delle autofatture e canale SDI con EINV, registrazione con ACCT) · **Permessi principali:** famiglia `purchases.*` (codici esatti definiti in sviluppo) · **Specifica:** SPEC §11.3, §11.5
|
||||
> **Stato:** completa per la versione 0.6 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.6.0 (M6)
|
||||
> **Modulo di licenza:** CORE (XML delle autofatture con EINV, registrazione contabile con ACCT) · **Permessi principali:** `purchases.order.*` (ordini fornitore), `inventory.entry.*` (DDT fornitore), `purchases.invoice.*` (fatture, note di credito, import, autofatture) · **Specifica:** SPEC §11.3, §11.5, ADR 0035
|
||||
|
||||
Il modulo **Acquisti** copre il ciclo passivo: **ordini ai fornitori** (anche generati dalla proposta di riordino),
|
||||
**DDT di carico** con controllo delle quantità ricevute, **fatture di acquisto** con protocollo IVA e conti per riga,
|
||||
**note di credito** dei fornitori, **import delle fatture passive** XML/P7M ricevute dallo SDI e le **autofatture e
|
||||
integrazioni** (TD16-TD29) per reverse charge e acquisti dall'estero.
|
||||
Il modulo **Acquisti** copre il ciclo passivo: **ordini ai fornitori** (anche dalla proposta di riordino),
|
||||
**ricevimento della merce** con il DDT del fornitore, **fatture e note di credito dei fornitori** con il protocollo
|
||||
IVA, **import delle fatture elettroniche** ricevute (XML, P7M, ZIP) e le **autofatture e integrazioni** (TD16-TD29)
|
||||
per inversione contabile e acquisti dall'estero.
|
||||
|
||||
> **In questa versione** ci sono ordini, ricevimenti, fatture e note di credito fornitore con protocollo, carico a
|
||||
> magazzino e costo medio, controllo dei prezzi rispetto a ordine e ricevimento, import delle fatture elettroniche e
|
||||
> autofatture in bozza con la loro scadenza. Dalla 0.7 le fatture e le note fornitore **si contabilizzano** da sole
|
||||
> con i registri IVA (vedi [Contabilità](Contabilita) e [IVA](IVA)). Dalla 0.8 le fatture fornitore **si pagano** dallo [Scadenzario](Scadenzario), anche con le distinte di bonifici SEPA. Arrivano più avanti: il **file XML** delle autofatture e lo scarico dal canale SDI (M9).
|
||||
|
||||
## Dove si trova
|
||||
|
||||
Menu **Acquisti** → *Ordini fornitori*, *DDT di carico*, *Fatture di acquisto*, *Import XML SDI*, *Autofatture*.
|
||||
Menu **Acquisti** → *Ordini fornitori*, *Ricevimenti merce*, *Fatture passive*, *Importa fatture*, *Autofatture*.
|
||||
|
||||
Le maschere sono quelle comuni a tutti i documenti (toolbar, intestazione, schede, righe con castelletto e totali):
|
||||
vedi [Interfaccia e scorciatoie](Interfaccia-e-scorciatoie) e [Vendite](Vendite) per il motore documenti.
|
||||
Le maschere sono quelle comuni a tutti i documenti (toolbar, intestazione, schede, righe con castelletto e totali,
|
||||
trasformazioni, stampa, allegati): vedi [Vendite](Vendite) per il funzionamento del motore documenti e
|
||||
[Interfaccia e scorciatoie](Interfaccia-e-scorciatoie) per la tastiera.
|
||||
|
||||
```
|
||||
Proposta di riordino ──► Ordine fornitore ──ricevi merce──► DDT di carico ──registra fattura──► Fattura di acquisto
|
||||
▲
|
||||
Fattura passiva XML/P7M (SDI) ──import──┘ (abbinamento all'ordine o al DDT)
|
||||
Proposta di riordino ──► Ordine fornitore ──Crea DDT fornitore (carico)──► Ricevimento ──Crea Fattura fornitore──► Fattura
|
||||
▲
|
||||
Fattura elettronica XML / P7M / ZIP ──Importa fatture──► Fattura in bozza ─┘
|
||||
Fattura di un fornitore estero o in reverse charge ──Crea autofattura──► Autofattura / integrazione (TD16-TD29)
|
||||
```
|
||||
|
||||
## Ordini fornitori
|
||||
|
||||

|
||||
*Mockup 031 — ordine fornitore confermato, nato dalla proposta di riordino, con il pannello Origine del fabbisogno (anteprima ridotta).*
|
||||
Un **ordine fornitore** (`OF`) dice al fornitore che cosa ti serve; non muove il magazzino ma, una volta
|
||||
**confermato**, aumenta l'**ordinato** degli articoli finché non arriva la merce (vedi [Magazzino](Magazzino)).
|
||||
|
||||
Azioni: **Invia al fornitore** (e-mail con il PDF dell'ordine), **Ricevi merce (DDT carico)**, **Chiudi residuo**.
|
||||
- Scegliendo il fornitore si applicano le sue condizioni (pagamento, banca, porto, valuta).
|
||||
- Scegliendo un articolo, Khaemhat propone il **prezzo del fornitore** dalla scheda articolo (*Fornitori*).
|
||||
- Gli ordini nascono a mano, dalla **proposta di riordino** (un ordine in bozza per fornitore, vedi
|
||||
[Magazzino](Magazzino#proposta-di-riordino)) o copiando un altro documento.
|
||||
- Quando la merce arriva, **Crea DDT fornitore (carico)** porta le righe ancora da ricevere nel ricevimento: puoi scegliere
|
||||
righe e quantità, così un ordine può essere ricevuto in più volte. Lo stato diventa *Evaso in parte* ed *Evaso*;
|
||||
**Chiudi** chiude un residuo che non arriverà più.
|
||||
|
||||
- L'intestazione mostra la **data prevista** di consegna, calcolata come data dell'ordine + **lead time** del
|
||||
fornitore, e lo stato di ricevimento (*Ricevuto 0%*…).
|
||||
- Le righe riportano il **codice del fornitore** per l'articolo; il prezzo proposto è quello del fornitore.
|
||||
- Il pannello **Origine del fabbisogno** spiega perché si ordina: sottoscorta, impegni da ordini clienti, lotto di
|
||||
riordino.
|
||||
- Schede: *Righe*, *Testata*, *Totali*, *Ricevimenti*, *Note*, *Allegati*, *Collegamenti*.
|
||||
- Un ordine confermato aggiorna l'**ordinato** degli articoli (vedi [Magazzino](Magazzino)).
|
||||

|
||||
|
||||
Gli ordini nascono a mano, dalla **proposta di riordino** (un ordine in bozza per fornitore, vedi
|
||||
[Magazzino](Magazzino)) o dall'azione **Ordina a fornitore** di un ordine cliente.
|
||||
## Ricevimenti merce (DDT fornitore)
|
||||
|
||||
## DDT di carico
|
||||
Il **DDT fornitore (carico)** (`DDTF`) registra la merce arrivata. Non ha un numero interno: nella testata scrivi il
|
||||
**numero e la data del DDT del fornitore**, che lo identificano (nell'elenco compare come *Senza numero*).
|
||||
|
||||

|
||||
*Mockup 032 — ricevimento con confronto ordinato/ricevuto, riga con 20 pezzi mancanti e aggiornamento del costo medio (anteprima ridotta).*
|
||||
1. Dall'ordine premi **Crea DDT fornitore (carico)**, oppure crea un ricevimento e richiama l'ordine.
|
||||
2. Controlla le **quantità ricevute** riga per riga e il **deposito** di arrivo.
|
||||
3. **Conferma**: la merce viene **caricata a magazzino** con la causale `CAR` e aggiorna **costo medio** e **ultimo
|
||||
costo** degli articoli; l'ordine segna le quantità evase.
|
||||
|
||||
Il **DDT di carico** registra la merce ricevuta. Azioni: **Registra fattura da questo DDT**, **Stampa etichette**,
|
||||
**Riapri**.
|
||||
Un ricevimento confermato resta modificabile finché non è fatturato; dal ricevimento **Crea Fattura fornitore**
|
||||
prepara la fattura con le stesse righe.
|
||||
|
||||
1. Dall'ordine fornitore premi **Ricevi merce** oppure crea un DDT di carico e usa **Evadi da…** per richiamare
|
||||
l'ordine.
|
||||
2. Indica numero e data del **DDT del fornitore**.
|
||||
3. Conta la merce: per ogni riga inserisci la quantità **ricevuta**; si può **scansionare l'EAN o il codice
|
||||
fornitore** per contare. La colonna *Controllo* segnala le differenze (*OK*, *Mancanti 20*…).
|
||||
4. **Conferma**: la merce viene **caricata a magazzino** (causale *Carico da fornitore*, deposito indicato), si
|
||||
aggiornano **ultimo costo** e **costo medio ponderato** dell'articolo.
|
||||
## Fatture passive
|
||||
|
||||
Se arriva meno del previsto, il **residuo** resta aperto sull'ordine; se non arriverà più si chiude con **Chiudi
|
||||
residuo**. Un messaggio sotto le righe riassume differenze e variazioni del costo medio.
|
||||

|
||||
|
||||
## Fatture di acquisto
|
||||
|
||||

|
||||
*Mockup 033 — fattura di acquisto in bozza nata da XML, con protocollo, flag Verifica prezzi, righe con conto e centro di costo, castelletto con IVA detraibile (anteprima ridotta).*
|
||||
|
||||
Azioni: **Registra (protocolla)**, **Contabilizza**, **Confronta con ordine**, **Apri XML**.
|
||||
La **fattura fornitore** (`FF`) e la **nota di credito fornitore** (`NCF`) registrano i documenti del fornitore.
|
||||
|
||||
| Dato | Descrizione |
|
||||
|---|---|
|
||||
| **Data di registrazione** e **data/numero del documento** del fornitore | la registrazione determina il periodo IVA |
|
||||
| **Protocollo** | numero progressivo del registro IVA acquisti (es. `ACQ/2026/000613`), assegnato alla registrazione |
|
||||
| **Conto e centro di costo per riga** | ogni riga ha il proprio conto di costo e centro di costo (proposti da articolo, categoria o fornitore) |
|
||||
| **Indetraibilità** | codici IVA con indetraibilità parziale o totale (es. telefonia 50%): il castelletto mostra imponibile, imposta e quota **detraibile** |
|
||||
| **Ritenute e cassa** | per i professionisti: ritenuta d'acconto, cassa previdenza; il totale mostra il **netto a pagare** |
|
||||
| **Registrazione contabile** | scheda con l'anteprima della registrazione (con modulo Contabilità) |
|
||||
| **N. documento fornitore** e **data** | numero e data scritti dal fornitore (nella testata) |
|
||||
| **Data** | data di registrazione: decide il periodo IVA |
|
||||
| **Protocollo** | numero progressivo del registro IVA acquisti (numeratore `PRA`), assegnato alla **conferma**; nell'elenco compare nella colonna *Protocollo* |
|
||||
| **Righe** | articoli, righe descrittive e spese con il codice IVA di ogni riga; per i professionisti ritenuta d'acconto e cassa come nelle vendite |
|
||||
| **Scadenze** | calcolate dal pagamento del fornitore |
|
||||
|
||||
Schede: *Righe*, *Testata*, *Totali*, *Scadenze*, *Ritenute e cassa*, *Registrazione contabile*, *Note*,
|
||||
*Allegati*, *Collegamenti*.
|
||||
La fattura nasce dal ricevimento (**Crea Fattura fornitore**), dall'ordine (per servizi o merce senza DDT), dall'**import
|
||||
della fattura elettronica** (vedi sotto) o a mano. **Conferma** assegna il protocollo e la rende definitiva; una
|
||||
fattura confermata si corregge con una **nota di credito fornitore** (**Crea Nota di credito fornitore**).
|
||||
|
||||
**Registra (protocolla)** assegna il protocollo e rende la fattura definitiva; **Contabilizza** crea la registrazione
|
||||
(automatica alla conferma o in batch, secondo le preferenze). La fattura può nascere:
|
||||
**Magazzino.** Una fattura di merce senza DDT carica il magazzino alla conferma; una fattura nata da un ricevimento
|
||||
non carica di nuovo, ma il suo **prezzo corregge il costo** del carico. La nota di credito fornitore scarica la merce
|
||||
resa (causale `RESF`).
|
||||
|
||||
- dal **DDT di carico** (**Registra fattura da questo DDT**), che la collega ai carichi;
|
||||
- dall'**import XML** (vedi sotto);
|
||||
- a mano, ad esempio per fatture cartacee o estere.
|
||||
**Controllo dei prezzi.** Se una riga della fattura ha un prezzo diverso da quello dell'ordine o del ricevimento da
|
||||
cui viene, sopra le righe compare un avviso con la differenza totale e, riga per riga, il prezzo atteso e quello
|
||||
fatturato. È un avviso: decidi tu se registrare la fattura o chiedere una nota di credito.
|
||||
|
||||
Le **note di credito dei fornitori** si registrano allo stesso modo e chiudono le partite collegate.
|
||||
## Importare le fatture elettroniche
|
||||
|
||||
## Import delle fatture passive XML/P7M
|
||||

|
||||
|
||||

|
||||
*Mockup 034 — quattro file in import (pronto, con ritenuta e cassa, fornitore da creare, duplicato) e mappatura delle righe sull'ordine con differenza di prezzo (anteprima ridotta).*
|
||||
**Acquisti → Importa fatture** (o il link nell'elenco delle fatture passive) registra in bozza le fatture ricevute
|
||||
dallo SDI o dal tuo intermediario. Dalla 0.9 le fatture che arrivano dai canali SDI si registrano anche da
|
||||
**Fatturazione elettronica → Fatture ricevute**, con lo stesso import.
|
||||
|
||||
1. Carica i file con **Carica XML / P7M / ZIP**, oppure **Leggi inbox** (cartella di ingresso dell'istanza) o
|
||||
**Scarica dal canale SDI** (con il modulo Fatturazione elettronica).
|
||||
2. Per ogni file Khaemhat legge fornitore, numero, data, tipo documento (TD) e totale e mostra un **esito**:
|
||||
*Pronto*, *Fornitore da creare*, *Duplicato*, oppure avvisi (ad esempio *Ritenuta 20% · cassa 4%*).
|
||||
3. Il **fornitore** viene riconosciuto da **partita IVA o codice fiscale**; se non esiste si crea al volo dai dati
|
||||
dell'XML.
|
||||
4. **Mappatura righe**: ogni riga XML viene abbinata a un articolo cercando, in ordine, il **codice del fornitore**,
|
||||
l'**EAN** e la **descrizione** (ricerca approssimata). Le righe non abbinate diventano descrittive o si abbinano a
|
||||
mano.
|
||||
5. **Abbina a ordine**: confronta prezzi e quantità con l'ordine fornitore; le differenze sono evidenziate (es.
|
||||
*+3,4%*).
|
||||
6. **Salva bozza** o **Registra fattura di acquisto**. Se ci sono differenze la fattura nasce **in bozza** con il
|
||||
flag *Verifica prezzi*.
|
||||
1. **Caricamento**: scegli uno o più file: **XML FatturaPA**, file firmati **.p7m** o archivi **ZIP** che li
|
||||
contengono (fino a 50 MB per file). I file che non sono fatture elettroniche leggibili sono elencati a parte con il
|
||||
motivo.
|
||||
2. **Controllo**: per ogni fattura vedi fornitore (nuovo o già in anagrafica), numero, data, tipo, totale e un esito:
|
||||
*Pronta*, oppure *Già registrata* (stesso fornitore, stesso numero, stesso anno), *Non è un acquisto* (per esempio
|
||||
un'autofattura emessa dall'azienda stessa), *Totale diverso* (il totale del file non torna con le righe), *Firma non
|
||||
verificata*, *Sconto sul totale*. **Leggi** mostra righe, riepilogo IVA e pagamento del file.
|
||||
3. **Registrazione**: spunta le fatture e premi **Registra in bozza**. Per ognuna Khaemhat:
|
||||
- trova il **fornitore** dalla partita IVA o dal codice fiscale, o lo **crea** dai dati del file;
|
||||
- crea una **fattura fornitore** (tipi TD01, TD02, TD03, TD05, TD06, TD24-TD27) o una **nota di credito fornitore**
|
||||
(TD04, TD08) in bozza, con numero e data del fornitore e la causale nelle note;
|
||||
- abbina ogni riga a un **articolo** cercando il **codice del fornitore** (scheda articolo, *Fornitori*), poi l'**EAN**,
|
||||
poi il **codice articolo**; le righe non abbinate diventano righe libere con descrizione, prezzo e IVA;
|
||||
- riporta gli **sconti** percentuali come sconto di riga e gli altri nel prezzo netto;
|
||||
- sceglie il **codice IVA** dell'azienda con la stessa aliquota e natura;
|
||||
- **allega il file** originale alla fattura (scheda *Allegati*, tipo *Fattura elettronica*).
|
||||
|
||||
L'**XML originale** viene allegato alla fattura; per i file **P7M** la **firma CAdES** viene verificata. I file già
|
||||
importati sono riconosciuti come duplicati.
|
||||
Le fatture importate restano **in bozza**: controllale e confermale per protocollarle. Se un codice IVA manca (per
|
||||
esempio una natura non usata finora), aggiungilo in [Tabelle azienda](Tabelle-azienda) → *Codici IVA* e ripeti
|
||||
l'import.
|
||||
|
||||
## Autofatture e integrazioni (TD16-TD29)
|
||||
|
||||

|
||||
*Mockup 035 — integrazione TD17 per servizi da un fornitore estero: IVA integrata, effetto neutro, registri RC vendite e acquisti, scadenza di invio allo SDI (anteprima ridotta).*
|
||||

|
||||
|
||||
Quando l'IVA è dovuta dall'acquirente (inversione contabile) l'azienda deve **integrare** la fattura ricevuta o
|
||||
emettere un'**autofattura**, trasmettendola allo SDI. In Khaemhat questi documenti stanno in **Acquisti →
|
||||
Autofatture** e nascono dalla fattura di acquisto d'origine.
|
||||
Quando l'IVA è dovuta da chi compra (inversione contabile, acquisti dall'estero) l'azienda deve **integrare** la
|
||||
fattura ricevuta o emettere un'**autofattura** e trasmetterla allo SDI. Khaemhat lo riconosce da solo dalla fattura
|
||||
fornitore (paese del fornitore, beni o servizi, natura IVA delle righe) e mostra sopra le righe quale documento serve e **entro quando**:
|
||||
|
||||
| Codice | Documento | Quando si usa |
|
||||
| Tipo | Quando | Scadenza |
|
||||
|---|---|---|
|
||||
| **TD16** | Integrazione fattura reverse charge interno | acquisti nazionali in inversione contabile (art. 17 c.6 DPR 633/72, es. subappalto edile) |
|
||||
| **TD17** | Integrazione/autofattura per acquisto di servizi dall'estero | servizi da fornitori UE ed extra-UE |
|
||||
| **TD18** | Integrazione per acquisto di beni intracomunitari | beni da fornitori UE |
|
||||
| **TD19** | Integrazione/autofattura per acquisto di beni ex art. 17 c.2 DPR 633/72 | beni già in Italia acquistati da soggetti non residenti |
|
||||
| **TD20** | Autofattura per regolarizzazione e integrazione delle fatture | regolarizzazione nei casi previsti (definizione aggiornata dalle specifiche v1.9) |
|
||||
| **TD21** | Autofattura per splafonamento | acquisti oltre il plafond dell'esportatore abituale |
|
||||
| **TD22** | Estrazione beni da deposito IVA | |
|
||||
| **TD23** | Estrazione beni da deposito IVA con versamento dell'IVA | |
|
||||
| **TD28** | Acquisti da San Marino con IVA | fatture cartacee con IVA da operatori sammarinesi |
|
||||
| **TD29** | Comunicazione per omessa o irregolare fatturazione | introdotto con le specifiche v1.9 (dal 1° aprile 2025) |
|
||||
| **AF16** (TD16) | inversione contabile interna: righe con natura N6.x (subappalti, rottami, cellulari…) | 15 del mese dopo il ricevimento |
|
||||
| **AF17** (TD17) | servizi da un fornitore estero, UE o extra UE | 15 del mese dopo |
|
||||
| **AF18** (TD18) | beni da un fornitore di un altro Paese UE | 15 del mese dopo |
|
||||
| **AF19** (TD19) | beni già in Italia comprati da un soggetto non residente (art. 17 c.2) | 15 del mese dopo |
|
||||
| **AF28** (TD28) | acquisti da San Marino con IVA in fattura | 15 del mese dopo |
|
||||
| **AF20**, **AF29** | regolarizzazione di una fattura non ricevuta o irregolare | 90 giorni |
|
||||
| AF21, AF22, AF23 | splafonamento, estrazione da deposito IVA | a mano, quando servono |
|
||||
|
||||
Come funziona (esempio TD17, mockup 035):
|
||||

|
||||
|
||||
1. La fattura estera viene registrata negli acquisti.
|
||||
2. Si crea l'integrazione: le righe sono **riprese dalla fattura estera** con imponibile e aliquota; Khaemhat
|
||||
calcola l'**IVA integrata**.
|
||||
3. **Conferma e genera XML**: nell'XML il **fornitore estero** compare come cedente/prestatore e la **nostra azienda**
|
||||
come cessionario/committente.
|
||||
4. La registrazione va contemporaneamente nel **registro IVA vendite RC** e nel **registro IVA acquisti RC**: l'effetto
|
||||
è **neutro** (IVA a debito = IVA a credito, salvo indetraibilità). Il pannello *Effetto contabile* mostra le due
|
||||
righe.
|
||||
5. L'XML va inviato **entro il 15 del mese successivo**: Khaemhat mostra la scadenza nel documento e un promemoria
|
||||
nella dashboard.
|
||||
**Acquisti → Autofatture** elenca in alto le **integrazioni da emettere**, la scadenza più vicina per prima. **Crea
|
||||
autofattura** (qui o nella fattura fornitore) prepara il documento in bozza: le righe della fattura con il **codice IVA
|
||||
ordinario** al posto della natura, il numero e la data della fattura del fornitore come documento collegato, la data
|
||||
di oggi. Controllalo ed **emettilo**: prende il numero dal numeratore `AUT` delle autofatture.
|
||||
|
||||
Schede: *Righe*, *Testata*, *Registrazione IVA*, *XML SDI*, *Collegamenti*. Le definizioni ufficiali dei codici sono
|
||||
in [Fiscalità italiana](Fiscalita-italiana).
|
||||
Il **file XML** dell'autofattura (con il fornitore come cedente e l'azienda come cessionario) e l'invio allo SDI
|
||||
si fanno dalla vista *Autofatture* della [Fatturazione elettronica](Fatturazione-elettronica) (dalla 0.9); la doppia registrazione nei registri IVA
|
||||
vendite e acquisti si fa da sola alla conferma dell'autofattura (dalla 0.7, vedi [IVA](IVA)). Le definizioni ufficiali dei codici TD sono in
|
||||
[Fiscalità italiana](Fiscalita-italiana).
|
||||
|
||||
## Fatture da fornitori forfettari
|
||||
|
||||
Le fatture dei fornitori in **regime forfettario** non hanno IVA (natura N2.2 nell'XML del fornitore) e riportano il
|
||||
**bollo** quando dovuto; non sono soggette a ritenuta d'acconto. Nella scheda del fornitore il flag *Regime
|
||||
forfettario* (gruppo *Ritenute e contributi*) indica questa situazione; i controlli automatici sulla fattura
|
||||
importata saranno definiti in sviluppo.
|
||||
Le fatture dei fornitori in **regime forfettario** non hanno IVA (natura N2.2) e riportano il **bollo** quando dovuto;
|
||||
non sono soggette a ritenuta. All'import la riga prende il codice IVA dell'azienda con natura N2.2; non serve
|
||||
nessuna autofattura.
|
||||
|
||||
## Stati
|
||||
|
||||
Ordini e DDT di carico seguono gli stati del motore documenti: *Bozza*, *Confermato*, *Ricevuto parzialmente* /
|
||||
*Ricevuto*, *Chiuso*, *Annullato*. Le fatture di acquisto sono *Bozza* finché non vengono **registrate
|
||||
(protocollate)**; i badge indicano anche *Da XML SDI*, *Verifica prezzi*, *Caricato a magazzino*, *Da fatturare*.
|
||||
| Documento | Stati |
|
||||
|---|---|
|
||||
| Ordine fornitore, ricevimento | *Bozza*, *Confermato*, *Evaso in parte*, *Evaso*, *Chiuso*, *Annullato* |
|
||||
| Fattura e nota di credito fornitore | *Bozza*, *Confermato* (protocollata), *Annullato* |
|
||||
| Autofattura | *Bozza*, *Emessa* e, con la fatturazione elettronica, gli stati dello SDI |
|
||||
|
||||
## Permessi e licenza
|
||||
|
||||
Ordini, carichi, fatture di acquisto e import da file sono nel modulo **CORE**. La generazione e l'invio dell'XML
|
||||
delle autofatture e lo scarico dal canale SDI richiedono **EINV**; la registrazione contabile e i registri IVA
|
||||
**ACCT**; i pagamenti **FIN**. Costi e margini sono visibili solo a chi ha il permesso `items.cost.read`.
|
||||
Ordini, ricevimenti, fatture, import e autofatture sono nel modulo **CORE**. Gli ordini richiedono
|
||||
`purchases.order.read`/`write`; i ricevimenti, che muovono il magazzino, `inventory.entry.read`/`write` (e
|
||||
`inventory.entry.post` per confermarli); fatture, note di credito, import e autofatture `purchases.invoice.read`/`write`.
|
||||
L'XML delle autofatture richiederà **EINV**, la registrazione contabile **ACCT**, i pagamenti **FIN**. Costi e margini
|
||||
sono visibili solo con `items.cost.read`.
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
- **L'import segna "Duplicato".** La fattura risulta già importata: non va registrata una seconda volta (il
|
||||
criterio esatto di riconoscimento sarà definito in sviluppo).
|
||||
- **Una riga dell'XML non trova l'articolo.** Aggiungi il codice del fornitore nella scheda articolo (*Fornitori*):
|
||||
la volta successiva l'abbinamento sarà automatico.
|
||||
- **Ho ricevuto meno merce di quella ordinata.** Conferma il DDT con la quantità ricevuta: il residuo resta aperto
|
||||
sull'ordine.
|
||||
- **L'import dice "Già registrata".** Lo stesso fornitore ha già un documento con quel numero nello stesso anno: non
|
||||
va registrata due volte.
|
||||
- **Una riga dell'XML non trova l'articolo.** Aggiungi il codice che usa il fornitore nella scheda articolo
|
||||
(*Fornitori*, codice fornitore): dalla volta successiva l'abbinamento è automatico.
|
||||
- **Ho ricevuto meno merce di quella ordinata.** Conferma il ricevimento con la quantità arrivata: il residuo resta
|
||||
aperto sull'ordine e l'ordinato degli articoli lo tiene in conto.
|
||||
- **La fattura ha un prezzo diverso dall'ordine.** L'avviso sopra le righe lo segnala; se la fattura è giusta
|
||||
confermala e il costo medio si allinea al prezzo fatturato.
|
||||
- **Non vedo l'avviso dell'autofattura.** Compare sulle fatture di fornitori esteri o con righe in natura N6.x,
|
||||
finché non c'è un'autofattura collegata. L'elenco *Integrazioni da emettere* mostra solo le fatture **confermate**.
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Allegati e file
|
||||
|
||||
> **Stato:** completa per M3 (invio e-mail e scanner con M5) · **Ultima revisione:** 2026-11-11 · **Versione software:** 0.3.0 (milestone M3)
|
||||
> **Stato:** completa per M5 (acquisizione da scanner con M13) · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.5.0
|
||||
> **Modulo di licenza:** CORE · **Permessi principali:** `attachments.read`, `attachments.write`, `attachments.delete` · **Specifica:** SPEC §9.4
|
||||
|
||||
Ogni documento e ogni anagrafica può avere **allegati**: file caricati dall'utente (l'ordine del cliente in PDF, una
|
||||
@@ -79,6 +79,11 @@ La sezione **Genera file** del pannello elenca le uscite disponibili per il docu
|
||||
|
||||
**Rigenera** non sovrascrive mai: crea la versione successiva (`v2`, `v3`…) e lascia consultabili le precedenti.
|
||||
|
||||
**In 0.5.0** i documenti di vendita (preventivi, ordini, DDT, fatture, note, pro forma) hanno il generatore **Stampa
|
||||
del documento in PDF**: lo stesso disegno dell'anteprima di stampa (vedi [Vendite](Vendite#stampa-e-pdf)). Lo usano
|
||||
anche **Salva come allegato** dell'anteprima e **Invia per e-mail**, che allega al messaggio la versione appena
|
||||
creata: così tra gli allegati resta sempre la copia esatta di ciò che è stato stampato o inviato.
|
||||
|
||||
Anche i **report** producono file (XLSX, CSV, PDF) scaricabili e, se pianificati, inviati per e-mail come allegati.
|
||||
Le **stampe massive** (ad esempio tutte le fatture del mese) producono un unico **ZIP** scaricato direttamente,
|
||||
senza file temporanei.
|
||||
|
||||
@@ -45,7 +45,8 @@ Il radar elenca le anagrafiche con le colonne **Codice**, **Ragione sociale**, *
|
||||
provincia), **Pagamento**, **Listino** (solo clienti), **Agente** e **Stato**; nei *Contatti* al posto di pagamento e
|
||||
listino c'è il **Tipo** (prospect o lead). Lo stato è un badge: *Attivo*, *Disattivato*, *Bloccato*, *PA · split*,
|
||||
*Privato*, *Impresa UE*, *Impresa extra-UE*, *Anche fornitore* / *Anche cliente*. Le colonne **Fatturato** e
|
||||
**Scaduto** del mockup arrivano con le vendite (M5) e lo scadenzario (M9).
|
||||
**Scaduto** del mockup arrivano con i report dei clienti (M12); lo scaduto di un cliente si vede già nello
|
||||
[Scadenzario](Scadenzario) (*Estratto conto*).
|
||||
|
||||
- Ricerca libera su codice, nome, partita IVA, codice fiscale e città.
|
||||
- Filtri rapidi: **Tipo** (solo contatti), **Soggetto**, **Agente**, **Stato**; all'apertura sono mostrate solo le
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Articoli e listini
|
||||
|
||||
> **Stato:** completa · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.4.0 (milestone M4; giacenze e costi dai movimenti con il magazzino, M6)
|
||||
> **Stato:** completa · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.4.0 (milestone M4; giacenze e costi dai movimenti dalla 0.6.0, M6)
|
||||
> **Modulo di licenza:** CORE · **Permessi principali:** `items.item.read` (consultare), `items.item.write` (inserire, modificare, disattivare, prezzi), `items.item.delete` (eliminare), `items.cost.read` (vedere costi e margini) · **Specifica:** SPEC §11.2, §11.3 (prezzi), §14 · **Decisioni:** ADR 0030
|
||||
|
||||
L'**articolo** descrive ciò che l'azienda vende o compra: merci, servizi, spese, righe descrittive e cespiti. Nella
|
||||
@@ -75,18 +75,20 @@ salvataggio.
|
||||
### Costi
|
||||
|
||||
- **Costo standard**: valore scritto a mano.
|
||||
- **Ultimo costo** e **costo medio**: li aggiornano i carichi di magazzino (DDT di carico, fatture di acquisto) che
|
||||
arrivano con il magazzino (M6); fino ad allora sono valorizzati solo nei dati di esempio. Il costo medio è il
|
||||
criterio di valorizzazione del magazzino (vedi [Magazzino](Magazzino)).
|
||||
- **Ultimo costo** e **costo medio**: li calcolano i carichi di magazzino (DDT fornitore, fatture fornitore, esistenze
|
||||
iniziali, movimenti di carico) dalla versione 0.6.0. Il costo medio è il criterio di valorizzazione del magazzino
|
||||
(vedi [Magazzino](Magazzino#costo-medio-e-valorizzazione)).
|
||||
- Il **margine** è calcolato sul prezzo: (prezzo - costo) / prezzo.
|
||||
- Chi non ha il permesso `items.cost.read` non vede i costi (né nella scheda né nell'elenco né nei listini) e,
|
||||
quando salva, i costi in archivio restano quelli di prima.
|
||||
|
||||
### Giacenze e riordino
|
||||
|
||||
Con **Gestito a magazzino** l'articolo parteciperà a movimenti, giacenze per deposito (*Giacenza, Impegnato,
|
||||
Ordinato, Disponibile, Valore*) e **proposta di riordino**: questi arrivano con il magazzino (M6). Scorta minima,
|
||||
punto e lotto di riordino si possono già compilare.
|
||||
Con **Gestito a magazzino** l'articolo partecipa a movimenti, giacenze per deposito (*Giacenza, Impegnato,
|
||||
Ordinato, Disponibile, Valore*) e **proposta di riordino** (vedi [Magazzino](Magazzino)). **Scorta minima**, **punto
|
||||
di riordino** e **lotto di riordino** decidono lo stato dell'articolo nelle giacenze e la quantità proposta; il
|
||||
**fornitore preferito** della scheda *Fornitori*, con prezzo, minimo d'ordine e lead time, è quello a cui la
|
||||
proposta ordina.
|
||||
|
||||
### Controlli al salvataggio
|
||||
|
||||
|
||||
@@ -50,7 +50,7 @@ Esempi presenti nel mockup (dati dimostrativi):
|
||||
| `dunning` | Solleciti di pagamento | Procedura | `0 9 * * 1` |
|
||||
| `vat-reminder` | Promemoria liquidazione IVA | Notifica | mensile |
|
||||
| `ecb-rates` | Aggiornamento cambi BCE | Procedura | nei giorni feriali |
|
||||
| `sdi-inbox` | Lettura inbox e canali SDI | Procedura | ogni 30 minuti |
|
||||
| `einvoice.poll` | Lettura dei canali SDI (notifiche e fatture ricevute) | Procedura | `*/15 * * * *` |
|
||||
| `report-sales-weekly` | Report vendite settimanale a direzione | Report via e-mail | `0 7 * * 1` |
|
||||
| `reorder` | Proposta di riordino | Procedura | `0 6 * * *` |
|
||||
| `stock-check` | Verifica coerenza giacenze | Verifica | settimanale |
|
||||
@@ -137,13 +137,18 @@ il dettaglio dell'ultima. Le esecuzioni sono registrate nel database di sistema.
|
||||
|
||||
## Job di sistema
|
||||
|
||||
Nella versione 0.2.0 i job di sistema sono questi (orari nel fuso `Europe/Rome`):
|
||||
Nella versione 0.7.0 i job di sistema sono questi (orari nel fuso `Europe/Rome`):
|
||||
|
||||
| Codice | Cosa fa | Quando |
|
||||
|---|---|---|
|
||||
| `system.sessions-cleanup` | elimina le sessioni scadute o revocate da più di 30 giorni, nel database di sistema e in ogni azienda non disattivata | al minuto 15 di ogni ora |
|
||||
| `system.license-check` | ricalcola la licenza; avvisa gli amministratori a 30, 14, 7, 3 e 1 giorno dalla scadenza e quando è scaduta | ogni ora |
|
||||
| `system.log-retention` | elimina gli eventi di log più vecchi della retention del loro livello | ogni notte alle 03:30 |
|
||||
| `system.attachments-trash` | svuota il cestino degli allegati oltre i giorni di conservazione | ogni notte alle 03:45 |
|
||||
| `system.ecb-rates` | scarica i cambi di riferimento della BCE (richiede la rete) | nei giorni feriali alle 16:30 |
|
||||
| `inventory.rebuild` | ricostruisce il magazzino di ogni azienda attiva dai documenti in vigore (vedi [Magazzino](Magazzino#ricostruzione)) | la domenica alle 02:15 |
|
||||
| `ledger.recurring` | crea le registrazioni ricorrenti arrivate alla loro data in ogni azienda con la contabilità (vedi [Contabilità](Contabilita)) | ogni giorno alle 05:00 |
|
||||
| `finance.dunning` | invia per e-mail e PEC i solleciti dei livelli segnati *Automatico* in ogni azienda con il modulo FIN (vedi [Scadenzario](Scadenzario#solleciti); richiede la rete) | nei giorni feriali alle 07:00 |
|
||||
|
||||
Oltre alle attività degli amministratori, Khaemhat esegue sempre alcuni **job di sistema**: pulizia (log e sessioni
|
||||
secondo la retention), controllo della licenza, aggiornamento dei cambi BCE, lettura dell'inbox e dei canali SDI,
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Changelog
|
||||
|
||||
> **Stato:** completa per 0.4.0 · **Ultima revisione:** 2026-11-12
|
||||
> **Stato:** completa per 0.9.0 · **Ultima revisione:** 2026-11-13
|
||||
|
||||
Le novità di ogni versione sono nel file
|
||||
[`CHANGELOG.md`](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/src/branch/main/CHANGELOG.md) del repository
|
||||
@@ -11,6 +11,11 @@ Le novità di ogni versione sono nel file
|
||||
|
||||
| Versione | Data | Contenuto |
|
||||
|---|---|---|
|
||||
| 0.9.0 | 2026-11-13 | M9 — Fatturazione elettronica: file FatturaPA con controllo prima dell'invio e i codici dello SDI; canali PEC, SdICoop e due intermediari con regole di instradamento e canale di riserva; lettura dei canali ogni 15 minuti e ricezione push di SdICoop; notifiche che aggiornano file e documenti; correzione degli scarti; copia di cortesia PDF con l'XML allegato; fatture ricevute da registrare; pacchetti per la conservazione; fatturazione elettronica nei dati di esempio e rimozione dei dati di esempio. |
|
||||
| 0.8.0 | 2026-11-13 | M8 — Scadenzario e tesoreria: partite aperte con aging, incassi e pagamenti con abbuoni, spese e differenze cambio; distinte RiBa, SDD e bonifici SEPA con insoluti, mandati SDD; riconciliazione bancaria CSV, CBI e CAMT.053 con abbinamento automatico; solleciti con interessi di mora; flusso di cassa; tesoreria nei dati di esempio. |
|
||||
| 0.7.0 | 2026-11-13 | M7 — Contabilità generale e IVA: piano dei conti PMI a tre livelli, causali, prima nota con registrazioni provvisorie, definitive e storni, ricorrenti; contabilizzazione automatica di fatture, note e autofatture con righe IVA, partite e ritenute; registri IVA con stampa definitiva, liquidazione mensile o trimestrale con acconto, F24 e LIPE; ritenute d'acconto e dati CU; bollo virtuale; partitari, mastrini, bilancio di verifica e libro giornale; contabilità nei dati di esempio. |
|
||||
| 0.6.0 | 2026-11-12 | M6 — Acquisti e Magazzino: ordini fornitori, ricevimenti, fatture e note di credito fornitore con protocollo e controllo dei prezzi; import delle fatture elettroniche XML, P7M e ZIP con fornitore e articoli abbinati; autofatture e integrazioni TD16-TD29 con la loro scadenza; giacenze per deposito con impegnato, ordinato e costo medio ponderato, movimenti e trasferimenti, inventario fisico, proposta di riordino, valorizzazione con classi ABC, ricostruzione; giacenze iniziali da file; acquisti e magazzino nei dati di esempio. |
|
||||
| 0.5.0 | 2026-11-12 | M5 — Motore documenti e Vendite: preventivi, ordini, DDT, fatture, note di credito, pro forma e parcelle con numerazione senza buchi, castelletto IVA, bollo, ritenute e scadenze; documenti collegati riga per riga e *Crea …* per passare dall'uno all'altro; fatturazione differita guidata; anteprima di stampa e PDF salvato tra gli allegati; invio per e-mail con SMTP interno; un anno di vendite nei dati di esempio; [Guida all'uso](Guida-utente) con le schermate. |
|
||||
| 0.4.0 | 2026-11-12 | M4 — Tabelle, anagrafiche, articoli: pacchetto fiscale italiano, profilo azienda, esercizi e cambi, 26 tabelle azienda con province, comuni e CAP, clienti, fornitori e contatti con controlli e VIES, articoli e listini con prezzi a validità, codici automatici, import/export guidato (anche del piano dei conti, per ora solo verifica) e dati di esempio. |
|
||||
| 0.3.0 | 2026-11-11 | M3 — Framework UI: la finestra di Khaemhat con menu, schede e barra di stato, la dashboard a widget, *Il mio profilo* con temi e colori, ricerca globale, aiuto in app, notifiche, componenti per maschere e liste, allegati e anteprima di stampa (provati su un documento di prova, le maschere gestionali arrivano da 0.4.0). |
|
||||
| 0.2.0 | 2026-11-11 | M2 — Sistema e sicurezza: avvio da variabili d'ambiente, super utente e prima azienda, accesso con password e verifica in due passaggi, utenti, ruoli e permessi, licenze e moduli con codici di prova, log per sezioni, attività programmate. |
|
||||
|
||||
@@ -1,272 +1,321 @@
|
||||
# Contabilità generale
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-10 · **Versione software:** non ancora rilasciata (milestone M7; chiusura esercizio e bilancio CEE in M10)
|
||||
> **Modulo di licenza:** ACCT · **Permessi principali:** `ledger.entry.write`, `ledger.entry.finalize`, `ledger.entry.reopen`, `ledger.account.write`, `ledger.closing.run`, `ledger.export` · **Specifica:** SPEC §11.7, §11.1, §14
|
||||
> **Stato:** completa per la versione 0.7 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.7.0 (M7)
|
||||
> **Modulo di licenza:** ACCT · **Permessi principali:** `ledger.account.read`/`write` (piano dei conti e causali), `ledger.entry.read`/`write` (prima nota, partitari, bilancio), `ledger.entry.finalize` (registrazioni definitive) · **Specifica:** SPEC §11.7, §14, ADR 0036, ADR 0037
|
||||
|
||||
## A cosa serve
|
||||
Il modulo **Contabilità** tiene la **contabilità generale in partita doppia** dell'azienda: piano dei conti, causali,
|
||||
prima nota, registrazioni ricorrenti, partitari di clienti e fornitori, mastrini, bilancio di verifica e libro
|
||||
giornale. È collegato al resto del gestionale: ogni fattura, nota di credito o autofattura confermata scrive da sola
|
||||
la sua registrazione, con le righe IVA e le partite.
|
||||
|
||||
Il modulo Contabilità tiene la **contabilità generale in partita doppia** dell'azienda: piano dei conti, causali,
|
||||
prima nota, partitari e mastrini, esercizi e periodi, chiusura dell'esercizio e bilancio. È collegato al resto del
|
||||
gestionale: ogni documento confermato (fattura di vendita o di acquisto, nota di credito, incasso, pagamento,
|
||||
ammortamento…) genera da solo la propria registrazione partendo dalla **causale contabile** del tipo di documento.
|
||||
La parte fiscale (registri IVA, liquidazione, acconto, F24, LIPE, ritenute d'acconto, bollo virtuale) è descritta
|
||||
nella pagina [IVA](IVA); le regole italiane usate (piano dei conti modello, codici tributo, scadenze) in
|
||||
[Fiscalità italiana](Fiscalita-italiana).
|
||||
|
||||
La parte IVA (registri, liquidazione, F24, LIPE, ritenute, bollo, dichiarazioni d'intento) è descritta nella pagina
|
||||
[IVA](IVA); i cespiti nella pagina [Cespiti](Cespiti); partite, incassi e banche nello [Scadenzario](Scadenzario).
|
||||
> **In questa versione** ci sono il piano dei conti modello *PMI standard* con voci CEE, le causali contabili, la
|
||||
> prima nota manuale con castelletto IVA, la **contabilizzazione automatica** di fatture, note e autofatture, le
|
||||
> registrazioni ricorrenti, lo storno, le registrazioni definitive con il numero di libro giornale, i partitari con
|
||||
> estratto conto e partite, i mastrini, il bilancio di verifica e le stampe del bilancio e del libro giornale.
|
||||
> Dalla 0.8 incassi, pagamenti, distinte e riconciliazione bancaria scrivono le loro registrazioni dallo
|
||||
> [Scadenzario](Scadenzario). Arrivano più avanti: **chiusura
|
||||
> dell'esercizio**, ratei e risconti, **bilancio CEE** riclassificato e **cespiti** (M10). Non ci sono ancora
|
||||
> l'import del piano dei conti da file e l'export per il commercialista.
|
||||
|
||||
## Dove si trova
|
||||
|
||||
Menu laterale **Contabilità**, con le voci **Prima nota**, **Piano dei conti**, **Causali contabili**, **Registri IVA**,
|
||||
**Liquidazione IVA**, **Ritenute**, **Chiusura esercizio**, **Bilancio**. Esercizi e periodi si gestiscono da
|
||||
**Tabelle azienda → Esercizi** (mockup 052). Le voci compaiono solo se il modulo ACCT è licenziato e l'utente ha i
|
||||
permessi (vedi [Licenze e moduli](Licenze-e-moduli) e [Utenti e permessi](Utenti-e-permessi)).
|
||||
Menu **Contabilità** → *Prima nota*, *Piano dei conti*, *Causali*, *Partitari*, *Registri IVA*, *Liquidazione IVA*,
|
||||
*Ritenute e F24*, *Bollo virtuale*, *Bilancio*. Le ultime quattro voci fiscali sono spiegate in [IVA](IVA).
|
||||
|
||||
## Schermate
|
||||
Il menu compare solo se la licenza dell'azienda comprende il modulo **ACCT** e l'utente ha i permessi (vedi
|
||||
[Licenze e moduli](Licenze-e-moduli) e [Utenti e permessi](Utenti-e-permessi)). Esercizi e periodi si gestiscono da
|
||||
**Tabelle azienda → Esercizi** (vedi [Tabelle azienda](Tabelle-azienda)); periodicità IVA e pro rata sono nel
|
||||
**profilo azienda**.
|
||||
|
||||

|
||||
*Mockup 040 — registrazione di prima nota generata da una fattura di acquisto: intestazione con causale FA, stato *Provvisoria* e *Quadrata*, righe in partita doppia con centro di costo e partita, riquadro delle righe IVA (anteprima ridotta)*
|
||||
|
||||

|
||||
*Mockup 041 — giroconto manuale in bozza con sbilancio di € 300,00 evidenziato e suggerimento "Ctrl+D quadra sull'ultima riga" (anteprima ridotta)*
|
||||
|
||||

|
||||
*Mockup 042 — albero dei conti con saldi, dettaglio del sottoconto (natura, tipo, conto padre, voce CEE, riclassificato, flag) e mastrino sotto (anteprima ridotta)*
|
||||
|
||||

|
||||
*Mockup 043 — elenco delle causali con area, registro IVA e "genera partita"; sotto, il modello righe della causale FA con ruoli, segno e base d'importo (anteprima ridotta)*
|
||||
|
||||

|
||||
*Mockup 044 — partitario di un cliente con saldo iniziale, dare/avere del periodo, saldo e scaduto; movimenti con saldo progressivo e stato della partita (anteprima ridotta)*
|
||||
|
||||

|
||||
*Mockup 050 — procedura guidata di chiusura in nove passi raggruppati in cinque fasi (Controlli, Assestamento, Chiusura, Apertura, Stampe), con esito e autore di ogni passo*
|
||||
|
||||

|
||||
*Mockup 051 — bilancio CEE con stato patrimoniale espandibile e conto economico a confronto con l'esercizio precedente (Δ %); viste Verifica, CEE, Riclassificato, Indici*
|
||||
|
||||

|
||||
*Mockup 052 — elenco degli esercizi con stato, registrazioni e ultimo periodo IVA liquidato; sotto, i periodi mensili con stato (Aperto, Liquidato, Bloccato) e interruttore di blocco*
|
||||
|
||||
## Piano dei conti
|
||||
|
||||
Il piano dei conti ha tre livelli con codice **`MM.CC.SSS`** (mastro, conto, sottoconto; per esempio `01.04.001`
|
||||
*Clienti Italia*). Alla creazione dell'azienda viene **precaricato un piano standard per PMI** con le voci di bilancio
|
||||
CEE già associate (nel mockup 042 l'intestazione mostra la versione del modello caricato).
|
||||
|
||||
| Campo | Significato |
|
||||
|---|---|
|
||||
| **Codice** | `MM.CC.SSS`, gerarchico; il conto padre è il livello superiore |
|
||||
| **Descrizione** | obbligatoria |
|
||||
| **Natura** | patrimoniale (attività/passività), economica (costi/ricavi), d'ordine |
|
||||
| **Tipo** | mastro, conto, sottoconto |
|
||||
| **Voce CEE** | voce dello schema di stato patrimoniale (art. 2424 c.c.) o conto economico (art. 2425 c.c.) |
|
||||
| **Riclassificato** | voce del riclassificato finanziario/gestionale (es. *Crediti commerciali*) |
|
||||
| **Partitario clienti/fornitori** | il conto si articola per controparte (vedi sotto) |
|
||||
| **Rilevante IVA** | il conto entra nei controlli IVA |
|
||||
| **Chiusura automatica** | il conto viene chiuso dalla procedura di fine esercizio |
|
||||
| **Movimentabile** | si possono registrare movimenti (di norma solo i sottoconti) |
|
||||
| **Attivo** | i conti disattivati restano nello storico ma non si propongono |
|
||||
|
||||
Selezionando un conto nell'albero si vedono a destra i suoi dati e sotto il **mastrino** (data, registrazione,
|
||||
descrizione, dare, avere, saldo); il pulsante **Mastrino completo** apre la vista intera con i filtri.
|
||||
|
||||
### Importare un piano dei conti
|
||||
|
||||
Non esiste in Italia un formato standard per scambiare il piano dei conti, quindi Khaemhat accetta tre formati:
|
||||
|
||||
| Formato | Uso | Contenuto |
|
||||
|---|---|---|
|
||||
| **CSV** (separatore `;`) | import da altri gestionali o da foglio di calcolo | colonne `codice;descrizione;livello;padre;natura;tipo;voce_cee;riclassifica;flag` |
|
||||
| **XLSX** | come il CSV | stesso tracciato, una riga per conto |
|
||||
| **JSON** (`khaemhat-coa.json`) | export/import completo fra installazioni Khaemhat | conti, voci di bilancio, causali e mappature |
|
||||
|
||||
1. Apri **Contabilità → Piano dei conti** e premi **Importa piano dei conti** (oppure usa la procedura guidata di
|
||||
[Import-Export](Import-Export)).
|
||||
2. Scegli il file e verifica la **mappatura delle colonne**.
|
||||
3. Controlla l'**anteprima**: Khaemhat verifica la coerenza gerarchica (ogni conto ha un padre esistente, il livello
|
||||
corrisponde al codice, le voci CEE esistono) e segnala le righe errate.
|
||||
4. Conferma. Il risultato e gli eventuali errori restano nel report dell'importazione.
|
||||
|
||||
I valori ammessi nelle colonne `natura`, `tipo` e `flag` saranno fissati in sviluppo e riportati qui.
|
||||
|
||||
## Causali contabili e ruoli
|
||||
|
||||
Una **causale contabile** è il modello di una registrazione. Ogni causale ha **righe modello** che non indicano un
|
||||
conto fisso ma un **ruolo**; il ruolo viene risolto nel conto reale al momento della registrazione (il conto del
|
||||
cliente, il conto di ricavo dell'articolo o della sua categoria, il conto IVA del codice IVA…).
|
||||
|
||||
| Ruolo | Esempio di conto risolto |
|
||||
|---|---|
|
||||
| cliente / fornitore | sottoconto del partitario della controparte |
|
||||
| ricavo / costo | conto della riga, dell'articolo o della categoria |
|
||||
| IVA vendite / IVA acquisti | conti IVA del codice IVA |
|
||||
| banca / cassa | conto collegato al conto bancario o alla cassa |
|
||||
| Erario ritenute, cassa previdenza, bollo | conti configurati per azienda |
|
||||
| abbuoni, contropartita | conti configurati o indicati a mano |
|
||||
|
||||
Per ogni riga si indicano anche **dare/avere**, la base dell'importo (totale documento, imponibile riga, IVA
|
||||
detraibile, IVA indetraibile, ritenuta, cassa…), il **registro IVA** e se la riga **genera una partita** nello
|
||||
scadenzario. Il pulsante **Prova su documento** mostra la registrazione che la causale produrrebbe su un documento
|
||||
esistente, senza salvarla.
|
||||
|
||||
Causali di base precaricate: **FV** fattura di vendita, **NCV** nota di credito a cliente, **FA** fattura di
|
||||
acquisto, **NCA** nota di credito da fornitore, **AFRC** integrazione reverse charge (autofatture TD16-TD19),
|
||||
**CORR** corrispettivi, **INC** incasso, **PAG** pagamento, **INS** insoluto, **GIRO** giroconto, **AMM**
|
||||
ammortamenti, **RAT** ratei e risconti, **RIM** rimanenze, chiusura e apertura, **F24**, ritenute versate, stipendi
|
||||
(da import), interessi e commissioni.
|
||||
```
|
||||
Fattura / nota / autofattura ──Conferma──► Registrazione "Da documento" (righe, castelletto IVA, partite)
|
||||
Registrazione manuale ──Registra──► Registrata ──Rendi definitive──► Definitiva (n. libro giornale) ──Storna──► Storno
|
||||
Ricorrente ──ogni notte alle 5:00──► Registrazione "Ricorrente" alla data prevista
|
||||
```
|
||||
|
||||
## Prima nota
|
||||
|
||||
Ogni registrazione ha un numero per esercizio (es. `2026/001205`), data di registrazione, data di competenza,
|
||||
causale, descrizione, documento d'origine, registro IVA e protocollo, stato, periodo e fonte.
|
||||

|
||||
*La prima nota dell'azienda demo: fatture di vendita (FV) e di acquisto (FA), nota di credito (NCV), liquidazioni IVA
|
||||
(LIQ), versamenti F24, ritenuta (RIT) e il noleggio mensile ricorrente, tutte nello stato* Registrata.
|
||||
|
||||
### Registrare a mano
|
||||
**Contabilità → Prima nota** elenca le registrazioni dell'esercizio, la più recente per prima, con numero, data,
|
||||
causale, descrizione, documento, cliente o fornitore, importo e stato. In alto la ricerca (descrizione, numero o
|
||||
documento) e i filtri **Dal**, **Al** e **Stato**; in fondo la paginazione. Un clic sul numero apre la registrazione.
|
||||
|
||||
1. **Contabilità → Prima nota**, premi **+** (Ctrl+N) e scegli la causale.
|
||||
2. Nella scheda **Righe contabili** inserisci conto (F4 apre il piano dei conti), descrizione, controparte, dare o
|
||||
avere, centro di costo, commessa e partita. Ctrl+↓ aggiunge una riga.
|
||||
3. Se la registrazione ha IVA, compila la scheda **Righe IVA** (codice IVA, imponibile, aliquota, imposta, % di
|
||||
indetraibilità, detraibile, natura).
|
||||
4. Controlla la **quadratura** nell'intestazione: Dare, Avere e **Sbilancio**. Se c'è uno sbilancio, **Ctrl+D**
|
||||
lo assegna all'ultima riga.
|
||||
5. **Salva** (Ctrl+S). La registrazione resta *provvisoria*; quando è corretta premi **Rendi definitiva**.
|
||||
La scheda **Registrazioni** contiene l'elenco; la scheda **Ricorrenti** le registrazioni che si ripetono (vedi
|
||||
[sotto](#registrazioni-ricorrenti)). I pulsanti della barra:
|
||||
|
||||
Una registrazione che non quadra si può salvare **solo come bozza** (mockup 041: badge rosso con lo sbilancio) e non
|
||||
può mai diventare definitiva.
|
||||
|
||||
### Stati e regole
|
||||
|
||||
| Stato | Cosa significa | Cosa si può fare |
|
||||
| Pulsante | Cosa fa | Permesso |
|
||||
|---|---|---|
|
||||
| **Bozza / Provvisoria** | in lavorazione, entra nei saldi ma non sul libro giornale definitivo | modificare, eliminare, rendere definitiva (solo se quadra) |
|
||||
| **Definitiva** | numerata in modo continuo sul libro giornale | **immutabile**: si corregge solo con uno **storno** collegato |
|
||||
| **Nuova registrazione** | apre una registrazione vuota | `ledger.entry.write` |
|
||||
| **Contabilizza documenti** | registra in prima nota i documenti di vendita e acquisto confermati di un periodo che non sono ancora contabilizzati | `ledger.entry.write` |
|
||||
| **Rendi definitive** | rende definitive tutte le registrazioni fino a un giorno | `ledger.entry.finalize` |
|
||||
|
||||
- Le registrazioni **generate da un documento** si modificano solo stornando o correggendo il documento d'origine
|
||||
(pulsante **Documento origine** per aprirlo).
|
||||
- Le date sono ammesse solo in **periodi aperti**: un periodo liquidato o bloccato e un esercizio chiuso rifiutano
|
||||
nuove registrazioni con data interna.
|
||||
- **Storna** crea la registrazione inversa collegata all'originale (campo *storno di*).
|
||||
- **Registrazioni ricorrenti**: da una registrazione manuale **Salva modello ricorrente** crea un modello riusabile
|
||||
(affitti, canoni, stipendi…).
|
||||
- **Valuta**: le righe possono essere in valuta estera con il cambio; le differenze cambio si rilevano alla chiusura
|
||||
della partita (vedi [Scadenzario](Scadenzario)).
|
||||
### Gli stati di una registrazione
|
||||
|
||||
| Stato | Significato | Cosa si può fare |
|
||||
|---|---|---|
|
||||
| **Bozza** | in lavorazione, senza numero; può non quadrare; non entra nei saldi | modificare, registrare, eliminare |
|
||||
| **Registrata** | numerata (per esempio `2026/00011`), quadrata, entra nei saldi e nei registri IVA | modificare ed eliminare (se manuale), stornare, rendere definitiva |
|
||||
| **Definitiva** | ha il numero di **libro giornale** | solo **stornare**: non si modifica né si elimina |
|
||||
|
||||
Ogni registrazione indica anche la sua **origine**: *Manuale*, *Da documento*, *Liquidazione IVA*, *Versamento F24*,
|
||||
*Ricorrente*, *Storno*, *Ritenuta*.
|
||||
|
||||
## Registrare a mano
|
||||
|
||||

|
||||
*La registrazione di una fattura di acquisto intracomunitaria: causale FA, registro ACQ1, fornitore in Avere e merci
|
||||
in Dare; nel castelletto IVA il codice NI41 (natura N3.2). La striscia in alto riassume Dare, Avere, Sbilancio e
|
||||
righe.*
|
||||
|
||||
1. **Contabilità → Prima nota → Nuova registrazione**.
|
||||
2. Nella **Testata** scegli la **data** e la **causale**: la causale propone le righe con conti e segni e il
|
||||
**registro IVA**. Scrivi la **descrizione** e, se serve, **numero** e **data del documento**.
|
||||
3. Nelle **Righe** completa per ogni riga il **conto** (si registra solo sui **sottoconti**), il **cliente o
|
||||
fornitore** (obbligatorio sui conti con partitario, come *Clienti Italia* e *Fornitori Italia*), la descrizione,
|
||||
il **centro di costo** e l'importo in **Dare** oppure in **Avere**. **Aggiungi riga** e il cestino aggiungono e
|
||||
tolgono righe.
|
||||
4. Se la registrazione ha IVA, compila il **Castelletto IVA** con **Aggiungi aliquota**: codice IVA, imponibile,
|
||||
imposta e parte indetraibile. Con righe IVA serve un registro IVA.
|
||||
5. Controlla la striscia in alto: **Dare**, **Avere**, **Sbilancio** e numero di **righe**. **Chiudi lo
|
||||
sbilancio** mette la differenza sull'ultima riga senza importo (o su una nuova riga, a cui dai il conto).
|
||||
6. **Salva bozza** conserva il lavoro anche se non quadra; **Registra** salva la registrazione, che deve quadrare, e
|
||||
le assegna il numero.
|
||||
|
||||
Una registrazione con righe IVA non si può datare in un periodo già **liquidato** (vedi [IVA](IVA#liquidazione-iva));
|
||||
nessuna registrazione si può datare in un periodo **bloccato**, in un esercizio chiuso o **prima dell'ultima
|
||||
registrazione definitiva**.
|
||||
|
||||
### Registrazioni che vengono dai documenti
|
||||
|
||||
Le registrazioni *Da documento* non si modificano né si eliminano dalla prima nota: si corregge il **documento** e
|
||||
Khaemhat riscrive la registrazione con lo stesso numero. Se il documento viene annullato, la registrazione sparisce
|
||||
oppure, se era già definitiva, viene stornata.
|
||||
|
||||
### Stornare ed eliminare
|
||||
|
||||
- **Storna** chiede la **data dello storno** e crea una nuova registrazione con Dare e Avere invertiti, collegata
|
||||
all'originale (che diventa *Stornata*). Si stornano solo le registrazioni registrate o definitive, una volta sola.
|
||||
- **Elimina** toglie una registrazione manuale non definitiva. Una registrazione usata come modello di una ricorrente
|
||||
si elimina solo dopo aver tolto la ricorrente.
|
||||
|
||||
### Rendere definitive le registrazioni
|
||||
|
||||
**Rendi definitive** chiede un giorno e rende definitive tutte le registrazioni registrate fino a quel giorno: ognuna
|
||||
riceve il **numero di libro giornale**, in ordine di data, e da quel momento si corregge solo con uno storno.
|
||||
L'operazione non si annulla ed è rifiutata se nel periodo ci sono ancora **bozze** (registrale o eliminale prima).
|
||||
Dopo, nessuna nuova registrazione può avere una data anteriore all'ultima definitiva.
|
||||
|
||||
## Contabilizzazione automatica dei documenti
|
||||
|
||||
Alla conferma di un documento (o in un secondo momento con la procedura **Contabilizzazione documenti**, vedi
|
||||
[Automazioni](Automazioni)) Khaemhat applica la causale contabile del **tipo documento** e genera la registrazione
|
||||
con le righe IVA e le partite di scadenzario, nella stessa transazione del documento. Il documento mostra il flag
|
||||
*contabilizzato* e il collegamento alla registrazione; la registrazione mostra il documento d'origine.
|
||||
Con il modulo ACCT attivo, quando **confermi** (o emetti) uno di questi documenti Khaemhat scrive la sua registrazione
|
||||
**nella stessa operazione**, con le righe IVA nel suo registro, le **partite** dalle rate di scadenza e l'eventuale
|
||||
**ritenuta d'acconto**:
|
||||
|
||||
## Partitari, mastrini ed estratti conto
|
||||
|
||||
Il **partitario** (mockup 044) mostra per un cliente o fornitore: saldo iniziale, dare e avere del periodo, saldo,
|
||||
di cui scaduto e l'elenco dei movimenti con saldo progressivo e stato della partita. Filtri per periodo, conto,
|
||||
stato e "solo definitive". Da qui:
|
||||
|
||||
- **Estratto conto**: genera il PDF da inviare al cliente (resta come allegato, vedi [Allegati e file](Allegati-e-file));
|
||||
- **Sollecito**: apre i solleciti dello [Scadenzario](Scadenzario).
|
||||
|
||||
Il **drill-down** è completo: dal bilancio al conto, dal conto al mastrino, dal mastrino alla registrazione, dalla
|
||||
registrazione al documento.
|
||||
|
||||
## Esercizi e periodi
|
||||
|
||||
In **Tabelle azienda → Esercizi** (mockup 052) ogni esercizio ha inizio, fine, stato, numero di registrazioni,
|
||||
ultimo periodo IVA liquidato, data di blocco, prima pagina del libro giornale e ultima registrazione definitiva.
|
||||
|
||||
| Esercizio | Periodo (mese o trimestre) |
|
||||
|---|---|
|
||||
| **Aperto** — si registra normalmente | **Aperto** — accetta registrazioni |
|
||||
| **In chiusura** — è in corso la procedura di chiusura | **Liquidato** — la liquidazione IVA è stata confermata |
|
||||
| **Chiuso** — sola lettura | **Bloccato** — rifiuta ogni registrazione con data interna |
|
||||
|
||||
**Nuovo esercizio** crea l'esercizio successivo; di norma lo crea la chiusura stessa, in stato provvisorio, per
|
||||
permettere di registrare nel nuovo anno prima di aver chiuso il vecchio. I periodi si bloccano e sbloccano con
|
||||
l'interruttore **Blocco** (permesso di riapertura richiesto).
|
||||
|
||||
## Chiusura dell'esercizio guidata
|
||||
|
||||
**Contabilità → Chiusura esercizio** (mockup 050) guida la chiusura in nove passi. Ogni passo è **ripetibile e
|
||||
annullabile**; le registrazioni generate sono marcate con la fonte `closing/<passo>` e restano provvisorie fino alle
|
||||
stampe definitive.
|
||||
|
||||
| # | Passo | Cosa fa |
|
||||
| Documento | Causale | Registro IVA |
|
||||
|---|---|---|
|
||||
| 1 | Controlli preliminari | nessuna registrazione provvisoria, partite quadrate, IVA liquidata, numerazioni continue |
|
||||
| 2 | Ammortamenti | quote civilistiche e fiscali dei [Cespiti](Cespiti) |
|
||||
| 3 | Ratei e risconti | da competenze dei documenti e inserimenti manuali (**Verifica ratei/risconti**) |
|
||||
| 4 | Rimanenze finali | valorizzazione del [Magazzino](Magazzino) al 31/12 e storno delle iniziali |
|
||||
| 5 | Accantonamenti | svalutazione crediti, TFR (da import) |
|
||||
| 6 | Chiusura conti economici | giroconto a Conto economico e rilevazione del risultato |
|
||||
| 7 | Chiusura conti patrimoniali | giroconto a Stato patrimoniale finale |
|
||||
| 8 | Apertura nuovo esercizio | riporto dei saldi e delle partite aperte |
|
||||
| 9 | Stampe definitive | libro giornale, libro inventari, registri IVA, registro cespiti |
|
||||
| Fattura immediata, accompagnatoria, differita, di acconto; nota di debito; parcella | `FV` | `VEN1` |
|
||||
| Nota di credito a cliente | `NCV` | `VEN1` |
|
||||
| Fattura fornitore | `FA` | `ACQ1` |
|
||||
| Nota di credito fornitore | `NCA` | `ACQ1` |
|
||||
| Autofatture e integrazioni (AF16-AF29) | `AFRC` | `VEN-RC` e `ACQ-RC` |
|
||||
|
||||
1. Apri la procedura e premi **Esegui passo N**: il passo mostra il numero di registrazioni prodotte e l'esito
|
||||
(*Superato*, *Eseguito*, *Da verificare*, *In attesa*).
|
||||
2. Controlla i risultati con l'icona di anteprima e, se serve, torna indietro di un passo.
|
||||
3. Dopo le stampe definitive premi **Blocca esercizio**: l'esercizio diventa **chiuso**, in sola lettura, e le date
|
||||
precedenti al nuovo esercizio vengono rifiutate.
|
||||
Come si formano le righe:
|
||||
|
||||
La chiusura è anche nel catalogo delle procedure ([Automazioni](Automazioni)).
|
||||
- **Vendita**: il **cliente** in Dare per il totale; i **ricavi** in Avere, raggruppati per conto; la **rivalsa
|
||||
della cassa previdenziale** e il **bollo addebitato** al cliente in Avere; l'**IVA vendite** in Avere. Con lo
|
||||
**split payment** l'IVA viene subito tolta al cliente (il cliente paga solo l'imponibile).
|
||||
- **Acquisto**: il **fornitore** in Avere; i **costi** in Dare, con l'**IVA indetraibile** aggiunta al costo;
|
||||
l'**IVA acquisti** in Dare.
|
||||
- **Autofattura e integrazione**: **IVA acquisti** in Dare e **IVA vendite** in Avere, senza cliente né fornitore;
|
||||
il documento compare in entrambi i registri RC, con effetto neutro sulla liquidazione.
|
||||
- **Note di credito**: le stesse righe con i segni invertiti.
|
||||
- Lo **sconto in calce** e gli **arrotondamenti** si ripartiscono sulle righe; i centesimi di differenza vanno sulla
|
||||
riga più grande.
|
||||
|
||||
## Bilancio
|
||||
**Quale conto.** Per ogni riga Khaemhat usa il **Conto ricavi** o **Conto costi** dell'articolo (scheda articolo),
|
||||
per gli acquisti il **Conto di costo** del fornitore, poi il conto del codice IVA e, se manca, quello della causale
|
||||
(`30.01.001` *Ricavi per vendita di merci*, `20.01.001` *Merci c/acquisti*). Il cliente e il fornitore usano il
|
||||
**Conto cliente** o **Conto fornitore** della loro scheda, altrimenti `05.01.001` *Clienti Italia* e `14.01.001`
|
||||
*Fornitori Italia*. Se manca un conto la conferma del documento si ferma con un messaggio che lo dice.
|
||||
|
||||
**Contabilità → Bilancio** (mockup 051) offre quattro viste:
|
||||
**Contabilizza documenti.** I documenti confermati quando ACCT non era attivo (o prima della versione 0.7) si
|
||||
registrano in blocco: **Prima nota → Contabilizza documenti**, scegli **Dal** e **Al** e premi **Contabilizza**. La
|
||||
casella *Ricontabilizza anche i documenti già registrati* riscrive anche le registrazioni esistenti, purché non
|
||||
siano definitive.
|
||||
|
||||
| Vista | Contenuto |
|
||||
## Registrazioni ricorrenti
|
||||
|
||||

|
||||
*Il noleggio mensile della stampante dei dati demo: frequenza mensile, prossima data, registrazione modello e stato.*
|
||||
|
||||
Affitti, canoni, noleggi: una registrazione **ricorrente** copia una **registrazione modello** alle date previste.
|
||||
|
||||
1. Registra una volta la scrittura da ripetere (per esempio *Noleggi* in Dare e *Banca c/c* in Avere).
|
||||
2. **Prima nota → Ricorrenti → Nuova ricorrente**: descrizione, **numero della registrazione modello** (il numero di
|
||||
prima nota, per esempio `2026/00018`), **frequenza** (*Mensile*, *Trimestrale*, *Semestrale*, *Annuale*),
|
||||
**prossima data**, data **Fino al** facoltativa, casella **Sospesa**.
|
||||
3. Ogni notte alle **5:00** l'attività di sistema *Registrazioni ricorrenti* (vedi
|
||||
[Attività programmate](Attivita-programmate)) scrive le registrazioni arrivate a scadenza, con origine
|
||||
*Ricorrente*, e sposta in avanti la prossima data. **Genera ora** fa lo stesso subito.
|
||||
|
||||
Una data di fine mese resta di fine mese (31/01, poi 28/02, poi 31/03). **Apri il modello** apre la registrazione da
|
||||
copiare; eliminando una ricorrente le registrazioni già generate restano.
|
||||
|
||||
## Piano dei conti
|
||||
|
||||

|
||||
*L'albero dei 240 conti del modello PMI standard, il dettaglio del sottoconto 05.01.001 Clienti Italia (sottoconto,
|
||||
attività, tipo Clienti, voce CEE C.II.1, con partitario) e il suo mastrino con il saldo progressivo.*
|
||||
|
||||
Il piano dei conti ha tre livelli con codice **`MM.CC.SSS`**: **mastro** (`05` *Crediti verso clienti*), **conto**
|
||||
(`05.01` *Clienti*) e **sottoconto** (`05.01.001` *Clienti Italia*). Si registra solo sui sottoconti. Con le tabelle
|
||||
di base dell'azienda viene caricato il modello **PMI standard** del pacchetto fiscale: 240 conti con le voci di
|
||||
bilancio CEE già associate (vedi [Fiscalità italiana](Fiscalita-italiana#piano-dei-conti-modello)).
|
||||
|
||||
| Campo | Significato |
|
||||
|---|---|
|
||||
| **Verifica** | bilancio di verifica per conto (dare, avere, saldo); bilancini per centro di costo e commessa |
|
||||
| **CEE** | schema civilistico **ordinario**, **abbreviato** o **micro**, con confronto con l'esercizio precedente e Δ % |
|
||||
| **Riclassificato** | riclassificato finanziario e gestionale |
|
||||
| **Indici** | indici di bilancio |
|
||||
| **Codice** | mastro, conto e sottoconto separati da punti; il conto padre deve esistere |
|
||||
| **Descrizione** | obbligatoria |
|
||||
| **Natura** | *Attività*, *Passività*, *Costo*, *Ricavo*, *Conto d'ordine* |
|
||||
| **Tipo** | *Generico*, *Clienti*, *Fornitori*, *Banca*, *Cassa*, *IVA*, *Tributi*: dice alle registrazioni automatiche che cosa cercare |
|
||||
| **Voce di bilancio CEE** | voce dello schema civilistico (art. 2424 e 2425 c.c.), per esempio `C.II.1` |
|
||||
| **Riclassificazione** | voce del riclassificato, facoltativa |
|
||||
| **Partitario** | le righe indicano il cliente o il fornitore |
|
||||
| **Rilevante IVA** | il conto entra nelle registrazioni con IVA |
|
||||
| **Chiuso in automatico a fine esercizio** | il conto sarà chiuso dalla procedura di fine esercizio (M10) |
|
||||
| **Disattivato** | il conto resta nello storico ma non si usa più |
|
||||
|
||||
L'intestazione indica la data di situazione (anche **infrannuale**) e se include le registrazioni provvisorie.
|
||||
Doppio clic su una voce apre i conti, poi il mastrino, la registrazione e il documento. Il bilancio si stampa e si
|
||||
esporta in XLSX e PDF; la **nota integrativa** è prodotta in bozza. Il formato XBRL è previsto in fase 2
|
||||
([Roadmap](Roadmap)).
|
||||
A sinistra l'**albero** con la ricerca per codice o descrizione; a destra i dati del conto scelto e, per i
|
||||
sottoconti, il **mastrino**: i movimenti del periodo (**Dal**, **Al**) con saldo iniziale, Dare, Avere, **saldo
|
||||
progressivo**, totali e paginazione. **Stampa** scarica il mastrino in PDF; il numero della registrazione la apre.
|
||||
|
||||
## Export per il commercialista
|
||||
**Nuovo conto**, **Modifica** ed **Elimina** richiedono `ledger.account.write`. Un conto con **movimenti** non si
|
||||
elimina (disattivalo); un conto con **sottoconti** si elimina solo dopo di loro.
|
||||
|
||||
Pacchetto **ZIP mensile** con libro giornale, registri IVA, partitari e bilancio in XLSX, CSV e PDF. Si genera a mano
|
||||
o in automatico con la procedura **Export per il commercialista** pianificata ogni mese (vedi [Automazioni](Automazioni)
|
||||
e [Attività programmate](Attivita-programmate)).
|
||||
## Causali contabili
|
||||
|
||||
## Report del modulo
|
||||

|
||||
*Le causali di base con il loro registro IVA; a destra la causale FA Fattura di acquisto: area Acquisti, registro
|
||||
ACQ1, apre partite, e le righe proposte con ruolo, segno e conto.*
|
||||
|
||||
Libro giornale, mastrini, bilancini per centro di costo e commessa, registri IVA, liquidazioni, scadenzario IVA,
|
||||
elenco clienti e fornitori per fatturato, riepilogo per natura IVA, dati dei quadri VE/VF, estratti conto, export per
|
||||
il commercialista. Vedi [Report](Report).
|
||||
Una **causale** è il modello di una registrazione: propone conti, segni e registro IVA. Ogni causale ha:
|
||||
|
||||
## Scorciatoie
|
||||
|
||||
| Tasto | Azione |
|
||||
| Campo | Significato |
|
||||
|---|---|
|
||||
| Ctrl+N / Ctrl+S | nuova registrazione / salva |
|
||||
| Ctrl+D | quadra la registrazione sull'ultima riga |
|
||||
| F4 | ricerca nel piano dei conti dalla cella *Conto* |
|
||||
| Ctrl+↓ | nuova riga |
|
||||
| Ctrl+↑ / Ctrl+↓ (fuori dalla griglia) | registrazione precedente / successiva |
|
||||
| Alt+1…9 | cambia scheda |
|
||||
| **Codice**, **Descrizione** | per esempio `FA` *Fattura di acquisto* |
|
||||
| **Area** | *Generale*, *Vendite*, *Acquisti*, *Tesoreria*, *Imposte*, *Chiusura esercizio* |
|
||||
| **Registro IVA** | il registro delle registrazioni con IVA |
|
||||
| **Apre partite** | le registrazioni aprono partite di clienti o fornitori |
|
||||
| **Causale di storno** | note di credito: i segni del documento si invertono |
|
||||
| **Disattivato** | la causale non si propone più |
|
||||
| **Righe proposte** | per ogni riga **ruolo** (*Cliente*, *Fornitore*, *Ricavo*, *Costo*, *IVA vendite*, *IVA acquisti*, *Banca*, *Cassa*, *Ritenute da versare*, *Ritenute subite*, *Contributo cassa*, *Bollo*, *Arrotondamenti*, *Erario c/IVA*, *IVA split payment* o *Conto indicato*), **segno** Dare o Avere, **conto** e descrizione |
|
||||
|
||||
Elenco completo in [Interfaccia e scorciatoie](Interfaccia-e-scorciatoie).
|
||||
Causali di base: **FV** fattura di vendita, **NCV** nota di credito a cliente, **FA** fattura di acquisto, **NCA**
|
||||
nota di credito da fornitore, **AFRC** autofattura e integrazione reverse charge, **CORR** corrispettivi giornalieri,
|
||||
**INC** incasso da cliente, **PAG** pagamento a fornitore, **RIT** ritenuta d'acconto operata, **RITS** ritenuta
|
||||
d'acconto subita, **LIQ** liquidazione IVA periodica, **F24** versamento con modello F24, **GIRO** giroconto, **SPB**
|
||||
spese e commissioni bancarie, **STO** storno di scrittura.
|
||||
|
||||
Le causali dei documenti, della liquidazione, delle ritenute e dell'F24 sono usate dalle registrazioni automatiche:
|
||||
cambiarne i conti cambia le registrazioni future. Una causale usata da registrazioni non si elimina: disattivala.
|
||||
Per un'azienda creata con una versione precedente, conti, causali e registri mancanti si aggiungono con
|
||||
`scripts/seed.sh --base` (vedi [Dati di base e di esempio](Dati-di-base-e-esempio)).
|
||||
|
||||
## Partitari ed estratto conto
|
||||
|
||||

|
||||
*Il partitario clienti con Dare, Avere, saldo e partite aperte; a destra l'estratto conto di Edilizia Moderna S.p.A. e
|
||||
le sue partite, con le scadenze passate in rosso.*
|
||||
|
||||
**Contabilità → Partitari** ha due schede, **Clienti** e **Fornitori**. L'elenco mostra per ogni soggetto con
|
||||
movimenti Dare, Avere, **Saldo** e numero di partite **aperte**, con ricerca per nome o codice e il **saldo
|
||||
complessivo**.
|
||||
|
||||
Scegliendo un soggetto si vedono:
|
||||
|
||||
- l'**estratto conto** del periodo (**Dal**, **Al**): saldo iniziale, movimenti con documento e saldo progressivo,
|
||||
totali; **Stampa** lo scarica in PDF;
|
||||
- le **partite**: una per rata di ogni documento, con data documento, numero della rata, **scadenza**, importo,
|
||||
pagato e **residuo**; le scadenze superate sono in rosso. *Mostra anche le partite chiuse* aggiunge quelle saldate.
|
||||
|
||||
Le partite nascono dai documenti e si chiudono con gli incassi e i pagamenti registrati nello
|
||||
[Scadenzario](Scadenzario), dove ci sono anche distinte, solleciti e riconciliazione bancaria.
|
||||
|
||||
## Bilancio di verifica e libro giornale
|
||||
|
||||

|
||||
*Il bilancio di verifica dell'azienda demo al livello dei sottoconti, con i totali di conti e mastri; la striscia
|
||||
riassume Dare, Avere, quadratura e risultato del periodo.*
|
||||
|
||||
**Contabilità → Bilancio** mostra i saldi di tutti i conti in un periodo:
|
||||
|
||||
- filtri **Dal** e **Al**, **Centro di costo** (tutti o uno), **Dettaglio** (*Mastri*, *Conti*, *Sottoconti*) e
|
||||
**Comprendi le bozze**;
|
||||
- per ogni conto **saldo iniziale**, **Dare**, **Avere**, **Saldo Dare** o **Saldo Avere**, con i totali di conti e
|
||||
mastri;
|
||||
- la striscia con i totali **Dare** e **Avere**, la **Quadratura** (*Dare e Avere quadrano* o no) e il **Risultato
|
||||
del periodo** (ricavi meno costi: *Utile* o *Perdita*).
|
||||
|
||||
Le stampe sono file PDF da scaricare:
|
||||
|
||||
| Pulsante | Contenuto |
|
||||
|---|---|
|
||||
| **Stampa bilancio** | il bilancio di verifica del periodo e del centro di costo scelti |
|
||||
| **Libro giornale di prova** | registrazioni registrate e definitive del periodo, in ordine di data, con le righe |
|
||||
| **Libro giornale definitivo** | solo le registrazioni definitive, con il numero di libro giornale e le pagine numerate dall'inizio dell'anno |
|
||||
|
||||
Il bilancio CEE (stato patrimoniale e conto economico civilistici), il riclassificato e gli indici arrivano con la
|
||||
chiusura dell'esercizio (M10).
|
||||
|
||||
## Dati demo
|
||||
|
||||
Con i dati di esempio (`scripts/seed.sh --demo`) la contabilità parte già popolata: i documenti demo sono
|
||||
contabilizzati, la fattura del professionista *Studio Rag. Neri Paola* è pagata e la sua ritenuta è da versare, il
|
||||
noleggio mensile della stampante (45 euro, conto `22.01.003` *Noleggi* contro la banca) è una registrazione
|
||||
ricorrente, le liquidazioni IVA dei mesi già finiti sono confermate e gli F24 già scaduti sono pagati. Vedi
|
||||
[Dati di base e di esempio](Dati-di-base-e-esempio).
|
||||
|
||||
## Permessi e licenza
|
||||
|
||||
Serve il modulo **ACCT**. Il permesso `ledger.entry.finalize` è necessario per rendere definitiva una registrazione;
|
||||
gli altri codici indicati in testa seguono la convenzione `modulo.entità.azione` (SPEC §7.2) e saranno fissati in
|
||||
sviluppo. Il ruolo predefinito **Contabilità** li comprende. Senza licenza ACCT le voci del menu non compaiono, ma i
|
||||
dati restano conservati.
|
||||
Serve il modulo **ACCT**: senza, il menu Contabilità non compare, i documenti non vengono contabilizzati (si
|
||||
recuperano dopo con **Contabilizza documenti**) e i dati già registrati restano conservati.
|
||||
|
||||
## Attenzione
|
||||
| Permesso | Cosa consente |
|
||||
|---|---|
|
||||
| `ledger.account.read` | vedere piano dei conti e causali |
|
||||
| `ledger.account.write` | creare, modificare ed eliminare conti e causali |
|
||||
| `ledger.entry.read` | prima nota, mastrini, partitari, bilancio e stampe del libro giornale |
|
||||
| `ledger.entry.write` | registrazioni manuali, storni, ricorrenti, contabilizzazione dei documenti |
|
||||
| `ledger.entry.finalize` | rendere definitive le registrazioni |
|
||||
|
||||
- Una registrazione **definitiva** non si modifica: va stornata. Usa lo stato provvisorio finché non hai controllato.
|
||||
- Confermare una liquidazione IVA blocca il periodo: correzioni successive richiedono la riapertura (permesso
|
||||
dedicato) e vanno ricalcolate.
|
||||
- I numeri del libro giornale definitivo sono continui; la procedura di chiusura verifica che non ci siano buchi.
|
||||
I permessi della parte IVA (`vat.register.read`, `vat.settlement.read`, `vat.settlement.confirm`) sono in [IVA](IVA).
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
- **Il pulsante Registra è spento.** Dare e Avere non quadrano: guarda lo *Sbilancio* nella striscia, correggi gli
|
||||
importi o usa **Chiudi lo sbilancio**. Intanto puoi usare **Salva bozza**.
|
||||
- **"Si registra solo sui sottoconti".** Hai scelto un mastro o un conto: scegli un sottoconto (codice a tre parti).
|
||||
- **"Le righe su clienti e fornitori indicano il soggetto".** Il conto ha il partitario: indica il cliente o il
|
||||
fornitore nella riga.
|
||||
- **Non riesco a modificare la registrazione di una fattura.** Viene dal documento: correggi la fattura e la
|
||||
registrazione si aggiorna. Se è già definitiva, la correzione del documento la storna e la riscrive.
|
||||
- **"Manca un conto per contabilizzare il documento".** Una causale o il piano dei conti non hanno il conto che
|
||||
serve (per esempio dopo aver cancellato un sottoconto): controlla la causale del documento e il conto dell'articolo.
|
||||
- **La data è rifiutata.** Il periodo è liquidato (solo per registrazioni con IVA), bloccato, l'esercizio è chiuso o
|
||||
c'è già una registrazione definitiva successiva.
|
||||
- **La ricorrente non ha generato nulla.** È sospesa, la data *Fino al* è passata o la prossima data è nel futuro;
|
||||
**Genera ora** mostra l'eventuale problema.
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
[IVA](IVA) · [Cespiti](Cespiti) · [Scadenzario](Scadenzario) · [Vendite](Vendite) · [Acquisti](Acquisti) ·
|
||||
[Magazzino](Magazzino) · [Tabelle azienda](Tabelle-azienda) · [Report](Report) · [Automazioni](Automazioni) ·
|
||||
[Import-Export](Import-Export) · [Fiscalità italiana](Fiscalita-italiana) · [Glossario](Glossario)
|
||||
[IVA](IVA) · [Fiscalità italiana](Fiscalita-italiana) · [Vendite](Vendite) · [Acquisti](Acquisti) ·
|
||||
[Scadenzario](Scadenzario) · [Cespiti](Cespiti) · [Tabelle azienda](Tabelle-azienda) ·
|
||||
[Attività programmate](Attivita-programmate) · [Dati di base e di esempio](Dati-di-base-e-esempio) ·
|
||||
[Glossario](Glossario)
|
||||
@@ -56,7 +56,7 @@ magazzino* M6, *CRM* M11), senza numeri finti.
|
||||
| **Attività CRM** | le attività del giorno (chiamate, riunioni, visite) | richiede il modulo CRM |
|
||||
| **Promemoria personali** | note libere, visibili solo a te | |
|
||||
| **Scorciatoie** | pulsanti configurabili verso maschere e azioni frequenti | |
|
||||
| **Sottoscorta** | articoli sotto la scorta minima | |
|
||||
| **Sottoscorta** | gli articoli più urgenti da riordinare (esauriti, sottoscorta, sotto il punto di riordino) con disponibile e scorta; un clic apre i movimenti dell'articolo, **Riordina** la proposta di riordino | dalla 0.6.0 |
|
||||
| **Pipeline CRM** | valore delle opportunità per fase | richiede il modulo CRM |
|
||||
| **Ultimi documenti** | ultimi documenti aperti o creati | |
|
||||
| **Stato del sistema** | versione, database, cache, licenza, aziende aperte, attività programmate di oggi, ognuno con un pallino verde, giallo o rosso | solo account di istanza |
|
||||
@@ -74,7 +74,10 @@ Nella versione 0.3.0 le righe vengono da:
|
||||
| Fatto oggi | attività programmate riuscite oggi, una riga per attività con il numero di esecuzioni e l'ora dell'ultima |
|
||||
| Scadenze 30 giorni | fine della prova o scadenza della licenza (account di istanza) |
|
||||
|
||||
I moduli delle prossime versioni aggiungono le loro righe (scarti SDI, liquidazioni, incassi, ordini da evadere…).
|
||||
Dalla 0.8 lo [Scadenzario](Scadenzario) aggiunge alle **Scadenze** gli incassi e i pagamenti dei prossimi giorni (al
|
||||
massimo 12, area *Tesoreria*) e a **Da fare oggi** il totale dei crediti scaduti, con il link ai solleciti; servono
|
||||
il modulo FIN e il permesso `finance.schedule.read`. I moduli delle prossime versioni aggiungono le loro righe
|
||||
(scarti SDI, ordini da evadere…).
|
||||
Se una fonte non risponde, il widget mostra le altre e l'errore finisce nel [log](Log).
|
||||
|
||||
I **promemoria** si scrivono nel campo in fondo al widget e si aggiungono con Invio (al massimo 20, di 300 caratteri
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Dati di base e di esempio
|
||||
|
||||
> **Stato:** completa per M4 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.4.0 (dati di esempio di documenti e contabilità con i moduli, completi in M9)
|
||||
> **Stato:** completa per la versione 0.9 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.9.0 (M9)
|
||||
> **Modulo di licenza:** CORE · **Livello richiesto:** amministratore (rimozione dati di esempio: super utente) · **Specifica:** SPEC §6, §12.11, §14
|
||||
|
||||
## A cosa serve
|
||||
@@ -115,7 +115,7 @@ reale. Contiene:
|
||||
| Articoli | 120 |
|
||||
| Documenti | 12 mesi coerenti: ordini → DDT → fatture differite, fatture immediate e accompagnatorie, note di credito, pro-forma, parcelle; ordini fornitore → carichi → fatture di acquisto; autofatture; inventario, movimenti, trasferimenti |
|
||||
| Contabilità | registrazioni dai documenti, incassi e pagamenti anche parziali, un insoluto RiBa, giroconti, liquidazioni IVA confermate fino al mese precedente, ritenute, 58 cespiti con ammortamenti, esercizio precedente chiuso con bilancio |
|
||||
| Fatturazione elettronica | XML SDI in stati diversi, con notifiche |
|
||||
| Fatturazione elettronica | file FatturaPA in stati diversi con le notifiche, canali e regole di instradamento, fatture ricevute da registrare |
|
||||
| Tesoreria | un estratto conto da riconciliare |
|
||||
| CRM | 23 lead, 18 opportunità, attività, 3 campagne, 2 ticket |
|
||||
| Servizi e canali | 2 contratti di assistenza con interventi, 1 canale e-commerce generico con ordini |
|
||||
@@ -133,7 +133,61 @@ i controlli; non si verificano sul VIES (ADR 0029). Gli agenti di esempio non so
|
||||
Ci sono poi **120 articoli** in dieci categorie con i listini *Pubblico* e *Rivenditori* derivati dal base, prezzi
|
||||
dell'anno precedente, fornitori abituali, UM e codici alternativi, sostitutivi e i prezzi netti e i codici di un
|
||||
cliente (ADR 0030, vedi [Articoli e listini](Articoli-e-listini)). I codici a barre di esempio iniziano con `200`,
|
||||
prefisso riservato all'uso interno. Il resto della tabella arriva con le milestone dei rispettivi moduli.
|
||||
prefisso riservato all'uso interno.
|
||||
|
||||
**Da M5** l'azienda di esempio ha anche il **profilo** compilato (indirizzo, partita IVA, REA, nota a piè di
|
||||
pagina delle stampe) e **un anno di vendite** costruite con il motore dei documenti, con date dal 1° gennaio a oggi:
|
||||
|
||||
| Documenti | Stati |
|
||||
|---|---|
|
||||
| 6 preventivi | 2 trasformati in ordine, 1 rifiutato, 1 con la validità scaduta, 1 in attesa di risposta, 1 in bozza |
|
||||
| 4 ordini clienti | 3 evasi (uno in due consegne), 1 ancora da consegnare |
|
||||
| 5 DDT | 2 già fatturati in differita, 3 da fatturare (prova la [fatturazione differita](Vendite#fatturazione-differita)) |
|
||||
| 8 fatture | 5 immediate (una in bozza), 2 differite, 1 pro forma |
|
||||
| 1 nota di credito | reso di un articolo difettoso, collegata alla fattura |
|
||||
|
||||
Le fatture e la nota condividono il numeratore (`1/2026` … `7/2026`), senza buchi e in ordine di data. Tutti i
|
||||
documenti sono marcati come dimostrativi e la stampa lo scrive in evidenza. Il caricamento non si ripete se
|
||||
l'azienda ha già documenti di vendita.
|
||||
|
||||
**Da M6** ci sono anche **acquisti e magazzino**, costruiti allo stesso modo:
|
||||
|
||||
| Documenti | Che cosa mostrano |
|
||||
|---|---|
|
||||
| 1 movimento di esistenze iniziali al 1° gennaio (`APE`) | la giacenza di partenza di ogni articolo; un articolo su cinque parte con poca merce, così le vendite lo portano sotto scorta e la [proposta di riordino](Magazzino#proposta-di-riordino) ha qualcosa da proporre |
|
||||
| 2 ordini fornitori | uno ricevuto per intero, uno ricevuto in parte (il resto è nell'*ordinato*) |
|
||||
| 2 ricevimenti merce | i carichi dei due ordini |
|
||||
| 3 fatture fornitore | una dal ricevimento con un prezzo più alto dell'ordine (vedi l'avviso sulle differenze), la parcella del commercialista, la fattura di un fornitore tedesco che aspetta la sua **integrazione AF18** |
|
||||
| 1 inventario aperto | 12 articoli già contati, due con una differenza |
|
||||
|
||||
Il caricamento non si ripete se l'azienda ha già documenti di acquisto o di magazzino.
|
||||
|
||||
**Da M7** documenti e fatture sono **contabilizzati** e ci sono un noleggio ricorrente, le liquidazioni IVA
|
||||
confermate fino al mese precedente, le ritenute e il bollo virtuale (vedi [Contabilità](Contabilita) e [IVA](IVA)).
|
||||
|
||||
**Da M8**, se la licenza comprende il modulo **FIN**, c'è anche la **tesoreria** (vedi [Scadenzario](Scadenzario)):
|
||||
|
||||
| Dati | Che cosa mostrano |
|
||||
|---|---|
|
||||
| La banca *Banca Popolare Dimostrativa* | conto predefinito con IBAN, SIA, CUC e identificativo creditore; i versamenti dei soci al 1° gennaio |
|
||||
| Incassi e pagamenti | i fornitori scaduti pagati con le spese, i clienti scaduti incassati (uno solo in parte), con il CRO |
|
||||
| Distinte RiBa | una distinta presentata e accreditata con l'ultimo effetto **insoluto** e le spese; una distinta *salvo buon fine* in bozza con le scadenze dei prossimi 45 giorni |
|
||||
| Mandato SDD | un mandato *Core* firmato da un cliente |
|
||||
| Estratto conto | un CSV di quattro movimenti da riconciliare: il saldo della fattura incassata in parte, un pagamento già registrato, le commissioni riconosciute dalla regola *Canone e commissioni* e una spesa da registrare su conto |
|
||||
| Solleciti | un primo sollecito già inviato al cliente con lo scaduto più vecchio |
|
||||
|
||||
**Da M9**, se la licenza comprende il modulo **EINV**, c'è anche la **fatturazione elettronica** (vedi
|
||||
[Fatturazione elettronica](Fatturazione-elettronica)):
|
||||
|
||||
| Dati | Che cosa mostrano |
|
||||
|---|---|
|
||||
| File FatturaPA | le fatture e le note già emesse hanno il loro file: la maggior parte **consegnata** (RC), una **scartata** (NS 00305) e poi corretta e consegnata, una con **mancata consegna** (MC), le ultime in attesa o ancora da inviare |
|
||||
| Notifiche | le ricevute di ogni file, scaricabili come sono arrivate |
|
||||
| Canali | la PEC configurata ma **in pausa** con credenziali finte, l'Intermediario A abbozzato e disattivato: nessun dato di esempio raggiunge lo SDI |
|
||||
| Instradamento | tre regole: PA su PEC, oltre 200 file al giorno sull'Intermediario A, sempre PEC con l'Intermediario A di riserva |
|
||||
| Fatture ricevute | tre fatture di fornitori da registrare |
|
||||
|
||||
Il resto della tabella arriva con le milestone dei rispettivi moduli.
|
||||
I dati sono costruiti con gli stessi motori del programma (documenti, contabilità): ogni quadratura torna, e lo
|
||||
stesso caricamento è usato come prova automatica di correttezza.
|
||||
|
||||
@@ -148,8 +202,13 @@ alternativa si caricano al primo avvio con `KHAEMHAT_SEED_DEMO=true` (solo se il
|
||||
### Rimuovi dati di esempio
|
||||
|
||||
1. Premi **Rimuovi dati di esempio** (solo **super utente**).
|
||||
2. Khaemhat elimina le righe dimostrative in ordine di dipendenza e **si rifiuta** se esistono dati reali collegati
|
||||
a righe dimostrative (ad esempio una fattura vera intestata a un cliente demo).
|
||||
2. Khaemhat elimina le righe dimostrative (`is_demo`) e quelle che appartengono loro (le righe di un documento demo,
|
||||
le giacenze di un articolo demo) in **una sola transazione**, e **si rifiuta** se esistono dati reali collegati a
|
||||
righe dimostrative (ad esempio una fattura vera intestata a un cliente demo): in quel caso elenca le tabelle
|
||||
coinvolte e non tocca nulla.
|
||||
|
||||
Le tabelle e i loro collegamenti si leggono dalle migrazioni, quindi la rimozione copre anche i moduli aggiunti in
|
||||
seguito. Da riga di comando: `scripts/seed.sh --remove-demo [--company CODICE]` (vedi sotto).
|
||||
|
||||
Usalo quando un'azienda nata come demo diventa l'azienda reale; per partire puliti è comunque preferibile creare
|
||||
un'azienda nuova (vedi [Istanza e database](Istanza-e-database)).
|
||||
@@ -176,6 +235,7 @@ docker compose run --rm --entrypoint /app/scripts/seed.sh khaemhat --base
|
||||
docker compose run --rm --entrypoint /app/scripts/seed.sh khaemhat --base --company DEMO
|
||||
docker compose run --rm --entrypoint /app/scripts/seed.sh khaemhat --demo --company DEMO
|
||||
docker compose run --rm --entrypoint /app/scripts/seed.sh khaemhat --demo --scale 10 --company PROVA
|
||||
docker compose run --rm --entrypoint /app/scripts/seed.sh khaemhat --remove-demo --company DEMO
|
||||
```
|
||||
|
||||
In sviluppo, dalla cartella del repository: `scripts/seed.sh --base|--demo [--scale N] [--company CODICE]`.
|
||||
@@ -185,8 +245,12 @@ In sviluppo, dalla cartella del repository: `scripts/seed.sh --base|--demo [--sc
|
||||
| `--base` | aggiunge i codici di base mancanti |
|
||||
| `--demo` | prima i dati di base, poi i dati di esempio; ogni gruppo (anagrafiche, articoli) si carica solo nell'azienda che non ne ha ancora |
|
||||
| `--scale N` | solo con `--demo`: ripete il catalogo articoli N volte (da 1 a 100), per le prove di prestazione |
|
||||
| `--remove-demo` | rimuove solo i dati di esempio (non si combina con le altre opzioni); stampa le righe rimosse per tabella o le tabelle che lo impediscono |
|
||||
| `--company CODICE` | lavora solo su quell'azienda invece che su tutte quelle attive |
|
||||
|
||||
Il caricamento completo dell'azienda di esempio richiede pochi secondi su SQLite (circa 2,5 s in sviluppo) e stampa
|
||||
il tempo impiegato per ogni azienda.
|
||||
|
||||
I dati di esempio si caricano anche al primo avvio con `KHAEMHAT_SEED_DEMO=true`.
|
||||
|
||||
## Migrazioni
|
||||
|
||||
@@ -1,200 +1,323 @@
|
||||
# Fatturazione elettronica e canali SDI
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-10 · **Versione software:** non ancora rilasciata (milestone M9)
|
||||
> **Modulo di licenza:** EINV · **Permessi principali:** `sales.invoice.issue`, `einvoice.document.send`, `einvoice.channel.manage`, `einvoice.inbox.import` · **Specifica:** SPEC §11.9, §11.3, §11.5, §9.4
|
||||
> **Stato:** completa per la versione 0.9 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.9.0 (M9)
|
||||
> **Modulo di licenza:** EINV · **Permessi principali:** `einvoice.document.read` (cruscotto, notifiche,
|
||||
> conservazione), `einvoice.document.send` (generare, inviare, importare notifiche), `einvoice.inbox.read` e
|
||||
> `einvoice.inbox.import` (fatture ricevute), `einvoice.channel.manage` (canali e instradamento) · **Specifica:**
|
||||
> SPEC §11.9, ADR 0039 e 0040
|
||||
|
||||
## A cosa serve
|
||||
Il modulo produce il **file FatturaPA** delle fatture emesse, lo **controlla** come farebbe il Sistema di
|
||||
Interscambio (SDI), lo **trasmette** attraverso il canale scelto dalle regole di instradamento e segue le
|
||||
**notifiche** che tornano indietro (consegna, scarto, mancata consegna, esito della pubblica amministrazione). Dalla
|
||||
stessa sezione arrivano le **fatture dei fornitori**, che si registrano come fatture di acquisto, e si prepara il
|
||||
**pacchetto per la conservazione**.
|
||||
|
||||
Il modulo genera l'**XML FatturaPA** delle fatture emesse, lo **valida**, lo **trasmette al Sistema di
|
||||
Interscambio (SDI)** attraverso uno dei canali configurati, importa le **notifiche** e le **fatture passive**,
|
||||
gestisce le **autofatture** da inviare e prepara il **pacchetto per la conservazione**. Il **cruscotto SDI** riunisce
|
||||
tutto in una schermata ordinata per priorità.
|
||||
Lo SDI è il sistema dell'Agenzia delle Entrate e non fa parte di Khaemhat. Per raggiungerlo Khaemhat offre quattro
|
||||
canali con lo stesso modo di lavorare: la **PEC dell'azienda** (nessun servizio esterno), il web service **SdICoop**
|
||||
e **due intermediari** accreditati.
|
||||
|
||||
Lo SDI è il sistema dell'Agenzia delle Entrate e non può essere "inglobato" in un gestionale. Khaemhat include però un
|
||||
**canale proprio via PEC** che non richiede alcun servizio esterno, e supporta con la stessa interfaccia **SdICoop**
|
||||
(web service dell'Agenzia) e **due intermediari**.
|
||||
> **In questa versione** ci sono il file FatturaPA (`FPR12`, `FPA12`, `FSM10`) con controllo prima dell'invio, i
|
||||
> quattro canali con prova di connessione, pausa e regole di instradamento con canale di riserva, la lettura
|
||||
> automatica dei canali ogni 15 minuti, la ricezione push di SdICoop, l'import manuale delle notifiche, la correzione
|
||||
> delle fatture scartate, la copia di cortesia in PDF con l'XML allegato, le fatture ricevute con registrazione in
|
||||
> blocco, l'elenco delle notifiche e i pacchetti per la conservazione. Arrivano più avanti: le **dichiarazioni
|
||||
> d'intento** e la **LIPE** ([IVA](IVA), M10), **Intrastat** ([Intrastat](Intrastat), M10) e il formato europeo
|
||||
> **EN 16931 / UBL** ([Roadmap](Roadmap)).
|
||||
|
||||
## Dove si trova
|
||||
|
||||
Menu laterale **Fatturazione elettronica**: **Cruscotto SDI**, **Fatture emesse**, **Fatture ricevute**,
|
||||
**Notifiche**, **Bollo virtuale**, **Intrastat**, **LIPE**; la configurazione dei canali è in **Fatturazione
|
||||
elettronica → Canali**. Il contatore accanto alla voce di menu indica i documenti che richiedono attenzione.
|
||||
Bollo virtuale, dichiarazioni d'intento e LIPE sono descritti nella pagina [IVA](IVA), Intrastat in [Intrastat](Intrastat).
|
||||
Menu laterale **Fatturazione elettronica** → *Cruscotto SDI*, *Fatture ricevute*, *Notifiche SDI*,
|
||||
*Conservazione*, *Canali di trasmissione* (e *Dichiarazioni d'intento*, ancora da sviluppare).
|
||||
|
||||
## Schermate
|
||||
Il menu compare solo se la licenza comprende il modulo **EINV** e l'utente ha i permessi (vedi
|
||||
[Licenze e moduli](Licenze-e-moduli) e [Utenti e permessi](Utenti-e-permessi)). Ogni voce chiede il suo permesso:
|
||||
chi non ha `einvoice.channel.manage`, per esempio, non vede i canali.
|
||||
|
||||

|
||||
*Mockup 058 — cruscotto con i contatori per stato (da generare, da inviare, inviate in attesa, consegnate, scartate, mancata consegna), azioni Genera + invia, Correggi, Importa notifiche e l'elenco dei documenti con TD, canale, stato SDI e ultima notifica o errore*
|
||||
Prima di iniziare servono:
|
||||
|
||||

|
||||
*Mockup 059 — i quattro canali (PEC integrata, SdICoop, Intermediario A, Intermediario B) con il loro stato, le regole di instradamento e le impostazioni della casella PEC*
|
||||
- il **profilo dell'azienda** completo in [Impostazioni](Impostazioni): partita IVA, codice fiscale, sede e
|
||||
**regime fiscale** (RF01…). Senza questi dati la generazione si ferma con un messaggio che dice cosa manca;
|
||||
- per ogni cliente il **codice destinatario** o la **PEC**, e per la pubblica amministrazione il **codice
|
||||
ufficio IPA** di sei caratteri ([Anagrafiche](Anagrafiche));
|
||||
- almeno un **canale attivo** (vedi [I canali di trasmissione](#i-canali-di-trasmissione)). Senza canali si può
|
||||
comunque generare il file, caricarlo dal portale *Fatture e Corrispettivi* e segnarlo come inviato.
|
||||
|
||||
## Il ciclo di una fattura
|
||||
|
||||
1. La fattura viene **confermata ed emessa** in [Vendite](Vendite) (numero definitivo, sola lettura).
|
||||
2. **Genera XML**: Khaemhat produce il file FatturaPA e lo allega al documento (bloccato dopo l'invio).
|
||||
3. **Valida**: il validatore controlla il file prima dell'invio.
|
||||
4. **Invia**: il canale scelto dalle regole di instradamento trasmette il file allo SDI.
|
||||
5. **Notifiche**: lo SDI risponde con ricevute e notifiche che aggiornano lo stato del documento.
|
||||
1. La fattura, la nota di credito, la parcella o l'autofattura viene **confermata** in [Vendite](Vendite) o in
|
||||
[Acquisti](Acquisti): da quel momento ha il numero definitivo e compare fra i *documenti da generare*.
|
||||
2. **Genera**: Khaemhat scrive il file FatturaPA e lo controlla. Il documento passa a *XML generato*.
|
||||
3. **Invia**: il canale scelto dalle regole di instradamento trasmette il file. Il documento passa a *Inviato*.
|
||||
4. **Notifiche**: lo SDI risponde e lo stato del file e del documento cambia da solo.
|
||||
|
||||
Il pulsante **Genera + invia** esegue i passi 2-4 sui documenti selezionati.
|
||||
Il pulsante **Genera + invia** fa i passi 2 e 3 in un colpo solo sui documenti selezionati.
|
||||
|
||||
| Stato del documento | Quando |
|
||||
|---|---|
|
||||
| **Bozza** | fattura in lavorazione |
|
||||
| **Emessa** | confermata, senza XML (*Da generare*) |
|
||||
| **XML generato** | XML prodotto e validato (*Da inviare*) |
|
||||
| **Inviata** | trasmessa allo SDI, in attesa di ricevuta |
|
||||
| **Consegnata** | ricevuta di consegna (RC) |
|
||||
| **Scartata** | notifica di scarto (NS): va corretta e rigenerata |
|
||||
| **Mancata consegna** | lo SDI non è riuscito a recapitarla (MC) |
|
||||
| Stato del file | Quando | Stato del documento |
|
||||
|---|---|---|
|
||||
| **Generata** | file scritto e controllato, non ancora trasmesso | XML generato |
|
||||
| **Inviata** | trasmessa allo SDI, in attesa della ricevuta | Inviato |
|
||||
| **Consegnata** | ricevuta di consegna (RC) | Consegnato |
|
||||
| **Scartata** | notifica di scarto (NS): la fattura **non è emessa** e va corretta | Scartato |
|
||||
| **Mancata consegna** | lo SDI non è riuscito a recapitarla (MC): è comunque emessa | Non consegnato |
|
||||
| **Accettata** / **Rifiutata** | esito del committente PA, EC01 o EC02 (NE) | |
|
||||
| **Decorrenza termini** | la PA non ha risposto entro 15 giorni (DT) | |
|
||||
| **Impossibile recapitare** | attestazione di trasmissione verso una PA (AT) | |
|
||||
|
||||
Una fattura emessa non si modifica: se l'XML **non è ancora stato inviato** si può annullare indicando il motivo;
|
||||
altrimenti si emette una nota di credito. Una fattura **scartata** non è emessa ai fini fiscali: con **Correggi** si
|
||||
corregge il dato e si rigenera l'XML (nuova versione dell'allegato).
|
||||
## Cruscotto SDI
|
||||
|
||||
## L'XML FatturaPA
|
||||

|
||||
*Khaemhat 0.9.0 — il cruscotto dell'azienda di esempio: i sei contatori, i documenti emessi senza file e i file
|
||||
trasmessi con stato SDI, canale, ultima notifica e azioni.*
|
||||
|
||||
In alto sei **contatori**: *Da generare* (documenti emessi senza XML), *Da inviare* (file generati e controllati),
|
||||
*Inviate in attesa*, *Consegnate* (RC, esito EC01, decorrenza termini), *Scartate* e *Mancata consegna*. Sopra, a
|
||||
destra, il collegamento alle **fatture ricevute da registrare**, **Importa notifiche** e, per chi gestisce i canali,
|
||||
**Leggi i canali ora**.
|
||||
|
||||
Il pannello ha tre viste:
|
||||
|
||||
- **Emesse**: fatture, note di credito e parcelle verso i clienti;
|
||||
- **Autofatture**: i documenti TD16-TD29 nati dagli [acquisti](Acquisti) (integrazioni del reverse charge,
|
||||
servizi e beni dall'estero, estrazione da deposito IVA, splafonamento…), che vanno trasmessi **entro il 15 del
|
||||
mese successivo**;
|
||||
- **Da fare**: solo ciò che chiede un intervento, cioè documenti da generare, file da inviare, scartati, non
|
||||
consegnati e rifiutati. Gli avvisi della Home su fatture scartate o da inviare portano qui.
|
||||
|
||||
Sotto la vista si filtrano **stato** e **periodo** e si cerca per numero, nome del file, identificativo SDI o
|
||||
controparte.
|
||||
|
||||
### Documenti da generare
|
||||
|
||||
La prima tabella elenca i documenti confermati che non hanno ancora un file. Si selezionano e si preme **Genera +
|
||||
invia**; **Controlla senza generare** (icona a forma di scudo) prova il file senza salvarlo e mostra gli errori,
|
||||
utile per sistemare i dati prima di trasmettere.
|
||||
|
||||

|
||||
*Khaemhat 0.9.0 — Controlla senza generare: il file supera i controlli dello SDI.*
|
||||
|
||||
### File trasmessi
|
||||
|
||||
La seconda tabella ha un file per riga: nome (`IT01234567890_0000A.xml`), documento, cliente, data, totale, tipo
|
||||
documento, **canale**, **stato SDI** e **ultima notifica o errore** con la data. I file *Generata* hanno la casella
|
||||
per **Invia (n)**. Le azioni della riga:
|
||||
|
||||
| Azione | Quando | Cosa fa |
|
||||
|---|---|---|
|
||||
| **Correggi** | file scartato | apre il documento, che torna modificabile; dopo la correzione si genera un **nuovo file** con un nuovo progressivo, il vecchio resta nello storico come *sostituito* |
|
||||
| **Segna come inviata** | file generato | per chi lo ha caricato dal portale *Fatture e Corrispettivi*: si può indicare l'identificativo SDI; le notifiche si importano poi a mano |
|
||||
| **XML** | sempre | scarica il file trasmesso |
|
||||
| **Copia di cortesia (PDF)** | sempre | il PDF del documento con il file FatturaPA **allegato dentro il PDF**, da mandare al cliente: non sostituisce l'invio allo SDI |
|
||||
| **Storico del file** | sempre | tutte le versioni del file con generazione, invio, identificativo SDI e notifiche |
|
||||
|
||||

|
||||
*Khaemhat 0.9.0 — lo storico SDI di una fattura: la prima versione scartata con l'errore dello SDI, sostituita da
|
||||
quella corretta e consegnata.*
|
||||
|
||||
Dopo **Invia** o **Genera + invia** una finestra riassume l'esito file per file: preso in carico da quale canale,
|
||||
oppure il motivo per cui non è partito.
|
||||
|
||||

|
||||
*Khaemhat 0.9.0 — esito della trasmissione di due file.*
|
||||
|
||||

|
||||
*Khaemhat 0.9.0 — la vista Da fare: documenti da generare e file scartati o non consegnati.*
|
||||
|
||||
## Il file FatturaPA
|
||||
|
||||
| Formato | Uso |
|
||||
|---|---|
|
||||
| `FPR12` | fatture verso privati (aziende e consumatori) |
|
||||
| `FPA12` | fatture verso la Pubblica Amministrazione |
|
||||
| `FPA12` | fatture verso la pubblica amministrazione |
|
||||
| `FSM10` | fattura semplificata |
|
||||
|
||||
Khaemhat segue le **specifiche tecniche dell'Agenzia delle Entrate**: alla stesura di questa pagina la **versione
|
||||
1.9, in vigore dal 1° aprile 2025** (con il tipo documento TD29 e il TD20 ridefinito). La versione supportata è
|
||||
indicata nel programma; prima di ogni rilascio va **sempre verificata l'ultima versione pubblicata** dall'Agenzia.
|
||||
Khaemhat segue le **specifiche tecniche 1.9.1** dell'Agenzia delle Entrate (tipi documento fino a TD29). La
|
||||
versione è scritta nel pacchetto fiscale italiano; prima di ogni rilascio va confrontata con l'ultima pubblicata
|
||||
dall'Agenzia.
|
||||
|
||||
L'XML contiene, fra l'altro: dati di trasmissione, cedente e cessionario, dati generali con tipo documento (TD),
|
||||
ritenuta, bollo, cassa previdenziale, sconti e causale; riferimenti a ordine d'acquisto, contratto, convenzione,
|
||||
ricezione e fatture collegate (con CIG e CUP per la PA); DDT, trasporto, righe di dettaglio, riepilogo IVA,
|
||||
pagamento e allegati.
|
||||
Il file contiene i dati di trasmissione, cedente e cessionario (con stabile organizzazione e rappresentante fiscale
|
||||
quando servono), i dati generali con tipo documento, ritenute, bollo virtuale, cassa previdenziale, sconti e
|
||||
causale, i riferimenti a ordine, contratto, convenzione, ricezione e fatture collegate (con CIG e CUP per la PA),
|
||||
DDT e trasporto, le righe, il riepilogo IVA con nature ed esigibilità, i pagamenti e gli allegati.
|
||||
|
||||
**Nome del file**: `IT<identificativo fiscale del trasmittente>_<progressivo>.xml`, con progressivo alfanumerico
|
||||
univoco in base 36 (es. `IT01234567890_00A1Z.xml`).
|
||||
**Nome del file**: `IT` + identificativo fiscale del trasmittente + `_` + progressivo di cinque caratteri in base 36
|
||||
(per esempio `IT01234567890_0000A.xml`). Il progressivo non si ripete mai: un file rigenerato dopo uno scarto ne
|
||||
prende uno nuovo.
|
||||
|
||||
## Validazione e scarti noti
|
||||
### I controlli prima dell'invio
|
||||
|
||||
Prima dell'invio il validatore controlla:
|
||||
Il file viene controllato **prima** di partire, con gli stessi codici di errore dello SDI, così il messaggio è
|
||||
quello che si leggerebbe nello scarto:
|
||||
|
||||
- valori ammessi delle code list (TD, nature, modalità di pagamento, regime fiscale…) e lunghezze dei campi;
|
||||
- totali coerenti con tolleranza di ± 0,01;
|
||||
- **nature IVA** (`N1`…`N7` con sotto-codici) e relativi riferimenti normativi;
|
||||
- codice destinatario o PEC del cliente; per la **PA** codice IPA a 6 caratteri, CIG e CUP quando servono;
|
||||
- codice fiscale dei gruppi IVA;
|
||||
- bollo virtuale.
|
||||
- **struttura** del file contro lo schema del formato;
|
||||
- **totali**: `PrezzoTotale` e imposta con tolleranza di un centesimo, imponibile del riepilogo con tolleranza di un
|
||||
euro (00421, 00422, 00423);
|
||||
- **riepilogo IVA** presente per ogni aliquota e natura (00419);
|
||||
- **nature IVA** e aliquote su righe, cassa previdenziale e riepilogo (00400, 00401, 00413, 00414, 00429, 00430),
|
||||
con i sotto-codici obbligatori al posto delle nature generiche N2, N3 e N6 (00445);
|
||||
- **ritenute** (00411, 00415) e **sconti e maggiorazioni** (00437, 00438);
|
||||
- **cliente**: partita IVA o codice fiscale presenti e ben formati (00305, 00306, 00417), codice destinatario e PEC
|
||||
coerenti con il formato (00311, 00426, 00427);
|
||||
- **autofatture**: cedente e cessionario devono essere diversi o uguali secondo il tipo (00471, 00472, 00473).
|
||||
|
||||
Esempi di scarto dello SDI visti nel cruscotto e usati nei test: **00311** (CodiceDestinatario non valido),
|
||||
**00423** (PrezzoTotale non calcolato correttamente), **00327**. Il messaggio dell'errore compare nella colonna
|
||||
*Ultima notifica / errore*.
|
||||
Alcuni controlli richiedono i registri dell'Agenzia (partita IVA esistente, codice destinatario accreditato, codice
|
||||
IPA presente nell'indice delle PA): Khaemhat ne verifica solo la **forma**.
|
||||
|
||||
## I quattro canali di trasmissione
|
||||
> Lo schema usato per il controllo della struttura è scritto per Khaemhat sulle regole del formato 1.2: non è il file
|
||||
> XSD ufficiale dell'Agenzia, che non è incluso. Gli scarti più comuni sono comunque coperti dai controlli di
|
||||
> contenuto.
|
||||
|
||||
Tutti i canali hanno la stessa interfaccia (invia, stato, notifiche, scarica passive): cambiare canale non cambia il
|
||||
modo di lavorare.
|
||||
## Le notifiche dello SDI
|
||||
|
||||
| Canale | Come funziona | Pro | Contro |
|
||||
|---|---|---|---|
|
||||
| **PEC integrata** | l'XML parte come allegato dalla **PEC aziendale** (SMTP) verso la PEC dello SDI; notifiche e fatture passive si leggono dalla stessa casella con il client **IMAP** interno, filtrando per mittente e oggetto e archiviando in una cartella | nessun servizio esterno, nessun accreditamento, costo della sola casella PEC | più lento; i volumi elevati vanno distribuiti (regola di *throttling*); dipende dalla disponibilità della casella; non include la conservazione |
|
||||
| **SdICoop** | web service dell'Agenzia; richiede l'**accreditamento** e un **certificato** rilasciato all'azienda; Khaemhat costruisce la chiamata SOAP con certificato client | notifiche e fatture passive in tempo reale; adatto ai volumi alti | procedura di accreditamento; certificato da rinnovare (il mockup ne mostra la scadenza); per ricevere, lo SDI deve raggiungere un servizio dell'azienda: i requisiti di rete saranno verificati in sviluppo |
|
||||
| **Intermediario A** | connettore REST verso il servizio di un intermediario accreditato: upload dell'XML, stato, notifiche, download delle passive | semplice da attivare; la **conservazione a norma** può essere inclusa nel servizio | costo del servizio; dipendenza da un terzo; credenziali e token API con scadenza |
|
||||
| **Intermediario B** | secondo connettore REST, stessa interfaccia, con la propria mappatura di stati ed errori | alternativa o riserva al primo | come l'intermediario A |
|
||||

|
||||
*Khaemhat 0.9.0 — Notifiche SDI: ogni ricevuta con il file a cui si riferisce, scaricabile così come è arrivata.*
|
||||
|
||||
Gli intermediari A e B sono i due servizi scelti dal titolare del progetto; le credenziali sono conservate cifrate.
|
||||
| Sigla | Notifica | Effetto |
|
||||
|---|---|---|
|
||||
| **RC** | ricevuta di consegna | *Consegnata* |
|
||||
| **NS** | notifica di scarto, con codice e descrizione degli errori | *Scartata*: correggi e rigenera; l'Agenzia indica di ritrasmettere entro 5 giorni |
|
||||
| **MC** | mancata consegna | la fattura è emessa ma il cliente la trova nel suo cassetto fiscale: conviene mandargli la **copia di cortesia** |
|
||||
| **NE** | esito del committente PA: **EC01** accettazione, **EC02** rifiuto | *Accettata* o *Rifiutata*; un rifiuto richiede una nota di credito |
|
||||
| **DT** | decorrenza termini (PA) | *Decorrenza termini*: vale come consegna |
|
||||
| **AT** | attestazione di avvenuta trasmissione con impossibilità di recapito (PA) | *Impossibile recapitare* |
|
||||
| **SE** | scarto dell'esito inviato dal committente PA | conservata fra le notifiche |
|
||||
| **MT** | file metadati di una fattura ricevuta | tenuto con la fattura in *Fatture ricevute* |
|
||||
|
||||
### Configurare il canale PEC
|
||||
Le notifiche arrivano in tre modi:
|
||||
|
||||
1. **Fatturazione elettronica → Canali**, riquadro **PEC · impostazioni**.
|
||||
2. Inserisci **Casella PEC**, server **SMTP** (es. porta 465) e **IMAP** (es. porta 993), la frequenza del
|
||||
**Controllo notifiche** (es. ogni 15 minuti) e la **Cartella archivio**.
|
||||
3. Premi **Prova connessione**, poi **Salva**. Il riquadro del canale mostra casella, ultimo controllo e notifiche lette.
|
||||
- **dai canali**, con l'attività programmata *Lettura dei canali SDI* (`einvoice.poll`) **ogni 15 minuti**, o subito
|
||||
con **Leggi i canali ora**;
|
||||
- **in push da SdICoop**, appena lo SDI le consegna (vedi sotto);
|
||||
- **a mano** con **Importa notifiche** sul cruscotto: file XML, P7M o lo ZIP scaricato dal portale. La stessa
|
||||
notifica non viene importata due volte.
|
||||
|
||||
Il primo invio via PEC va all'indirizzo `sdi01@pec.fatturapa.it`; con la prima risposta lo SDI indica l'indirizzo
|
||||
PEC da usare per gli invii successivi. La gestione di questo indirizzo sarà verificata in sviluppo.
|
||||
Nella pagina **Notifiche SDI** si filtrano periodo (dal 1° gennaio a oggi in partenza) e tipo. Le righe evidenziate
|
||||
sono notifiche che non corrispondono a nessun file emesso.
|
||||
|
||||
## Fatture ricevute
|
||||
|
||||

|
||||
*Khaemhat 0.9.0 — Fatture ricevute: le fatture dei fornitori da registrare, con fornitore, numero, totale, tipo,
|
||||
canale e identificativo SDI.*
|
||||
|
||||
Le fatture dei fornitori arrivano dai canali o si caricano con **Carica file**: XML, **P7M** firmati CAdES (anche
|
||||
annidati o in base64; l'XML viene estratto dalla busta), il file metadati e lo ZIP del portale. Lo stesso file non
|
||||
entra due volte (impronta SHA-256).
|
||||
|
||||
| Stato | Significato |
|
||||
|---|---|
|
||||
| **Da registrare** | arrivata, da trasformare in fattura di acquisto |
|
||||
| **Registrata** | diventata una fattura o nota di credito di acquisto: **Apri** la porta al documento |
|
||||
| **Scartata** | messa da parte a mano (**Ripristina** la riporta indietro) |
|
||||
| **Illeggibile** | il file non è una FatturaPA leggibile: l'errore è scritto sotto lo stato |
|
||||
|
||||
Si selezionano le fatture e si preme **Registra (n)**, oppure **Registra come fattura di acquisto** sulla riga.
|
||||
La registrazione usa l'import del ciclo passivo ([Acquisti](Acquisti)): il fornitore si riconosce dalla partita
|
||||
IVA e, se manca, viene creato; righe, IVA e scadenze vengono dal file. Gli avvisi dell'import compaiono nel messaggio
|
||||
di esito.
|
||||
|
||||
## I canali di trasmissione
|
||||
|
||||

|
||||
*Khaemhat 0.9.0 — i quattro canali con il loro stato, le impostazioni del canale scelto e le regole di
|
||||
instradamento.*
|
||||
|
||||
Tutti i canali fanno le stesse cose (inviare, leggere notifiche e fatture ricevute, provare la connessione): cambiare
|
||||
canale non cambia il modo di lavorare. Ogni scheda mostra lo stato (*Attivo*, *Configurato · in pausa*, *Non
|
||||
configurato*), l'ultima prova e l'ultima lettura. Password, chiavi e certificati sono **cifrati** nel database; nel
|
||||
modulo un campo segreto lasciato vuoto mantiene il valore memorizzato.
|
||||
|
||||
| Canale | Come funziona | Impostazioni |
|
||||
|---|---|---|
|
||||
| **PEC** | il file parte come allegato dalla PEC dell'azienda (SMTP) verso lo SDI; ricevute e fatture si leggono dalla stessa casella (IMAP) e i messaggi letti vanno nella cartella di archivio | casella, server e porte SMTP e IMAP, TLS, utente, password, indirizzo PEC dello SDI, cartella di archivio |
|
||||
| **SdICoop** | web service dell'Agenzia con **certificato client**; lo SDI consegna notifiche e fatture al servizio di ricezione di Khaemhat | indirizzo del servizio, certificato PKCS#12 (`.p12`) con password, chiave di ricezione, ambiente di prova |
|
||||
| **Intermediario A** | API REST di un intermediario accreditato con **chiave API** | indirizzo del servizio, chiave API, ambiente di prova |
|
||||
| **Intermediario B** | API REST di un intermediario accreditato con **utente e password** | indirizzo del servizio, utente, password, ambiente di prova |
|
||||
|
||||
Per ogni canale: **Prova connessione**, **Metti in pausa** / **Riprendi** e **Salva**. Gli indirizzi dei servizi
|
||||
devono essere `https`.
|
||||
|
||||
**PEC.** Il primo invio va all'indirizzo `sdi01@pec.fatturapa.it`; con la prima risposta lo SDI comunica la casella
|
||||
da usare da lì in poi, che Khaemhat ricorda e mostra nel campo *Indirizzo PEC dello SDI*. La PEC non richiede
|
||||
accreditamento ma è il canale più lento: per volumi alti conviene una regola che sposti il traffico su un altro
|
||||
canale.
|
||||
|
||||
Della casella si leggono solo i messaggi dello SDI (mittente `fatturapa.it`); le ricevute di accettazione e consegna
|
||||
del gestore PEC restano dove sono. Imposta sempre la **cartella di archivio**: i messaggi elaborati vengono spostati
|
||||
lì. Senza cartella vengono solo segnati come letti, e un messaggio aperto dalla webmail prima della lettura di
|
||||
Khaemhat verrebbe saltato.
|
||||
|
||||
**SdICoop in ricezione.** Lo SDI chiama il servizio `POST /sdicoop/<codice azienda>` di Khaemhat. Il servizio
|
||||
accetta solo le chiamate con l'intestazione `X-Khaemhat-SdiCoop-Key` uguale alla **chiave di ricezione** del canale.
|
||||
Il certificato reciproco (mTLS) richiesto dall'Agenzia si configura sul **reverse proxy** davanti a Khaemhat, che
|
||||
aggiunge l'intestazione: vedi [Installazione con Docker](Installazione-Docker).
|
||||
|
||||
### Instradamento
|
||||
|
||||
Le **regole di instradamento** decidono quale canale usa ogni documento. Esempio del mockup:
|
||||
Le regole decidono quale canale usa ogni file. Vale **la prima regola attiva che si applica**, nell'ordine indicato;
|
||||
il **canale di riserva** si usa se il primo è in pausa, disattivato o non risponde. Senza regole si usa il primo
|
||||
canale attivo.
|
||||
|
||||
| Regola | Canale | Condizione |
|
||||
|---|---|---|
|
||||
| Predefinito | PEC | tutti i documenti |
|
||||
| Clienti PA | SdICoop | cessionario PA (codice IPA) |
|
||||
| Volumi > 50/giorno | SdICoop | throttling della PEC |
|
||||
| Conservazione | Intermediario A | pacchetti trimestrali |
|
||||
| Condizione | Si applica a |
|
||||
|---|---|
|
||||
| **Sempre** | tutti i file |
|
||||
| **Cliente pubblica amministrazione** | i clienti con codice IPA (formato `FPA12`) |
|
||||
| **Cliente specifico** | il cliente con il codice indicato |
|
||||
| **Tipo documento** | un tipo (TD01, TD17…) |
|
||||
| **Volume giornaliero** | i file oltre un numero di invii nella giornata |
|
||||
|
||||
Il canale usato è registrato su ogni documento (colonna *Canale* del cruscotto).
|
||||
|
||||
## Notifiche SDI
|
||||
|
||||
| Sigla | Notifica | Effetto in Khaemhat |
|
||||
|---|---|---|
|
||||
| **RC** | ricevuta di consegna | stato *Consegnata* |
|
||||
| **NS** | notifica di scarto | stato *Scartata*, con codice e descrizione dell'errore; la regola predefinita avvisa l'amministrazione ([Automazioni](Automazioni)) |
|
||||
| **MC** | mancata consegna | la fattura è emessa ma non recapitata: è messa a disposizione del cliente nella sua area riservata dell'Agenzia; conviene inviargli la **copia di cortesia** |
|
||||
| **NE** | notifica di esito del committente PA (**EC01** accettazione, **EC02** rifiuto) | stato *Accettata* o *Rifiutata* |
|
||||
| **DT** | decorrenza termini (PA) | nessun esito del committente nei termini previsti |
|
||||
| **AT** | attestazione di avvenuta trasmissione con impossibilità di recapito (PA) | come la mancata consegna |
|
||||
|
||||
Le notifiche si importano in automatico dal canale (procedura **Import inbox SDI**, pianificata) o con **Importa
|
||||
notifiche**; restano come allegati del documento ([Allegati e file](Allegati-e-file)). Sono letti anche i
|
||||
**metadati** che accompagnano le fatture ricevute.
|
||||
|
||||
## Fatture passive
|
||||
|
||||
Le fatture ricevute arrivano dal canale (PEC, SdICoop o intermediario) o si caricano a mano (anche come file
|
||||
**P7M** firmati CAdES: la firma viene verificata e l'XML estratto). Khaemhat le legge, riconosce il fornitore da
|
||||
P.IVA o codice fiscale e prepara la **fattura di acquisto in bozza** con mappatura delle righe e confronto con
|
||||
l'ordine: il dettaglio è nella pagina [Acquisti](Acquisti) (import XML). La vista **Ricevute** del cruscotto elenca
|
||||
le passive e il loro stato di importazione.
|
||||
|
||||
## Cruscotto SDI
|
||||
|
||||
- **Contatori**: *Da generare* (emesse senza XML), *Da inviare* (XML validati), *Inviate · in attesa*,
|
||||
*Consegnate* (nell'anno), *Scartate* (da correggere), *Mancata consegna*.
|
||||
- **Elenco prioritizzato**: prima le scartate, poi le da inviare, poi quelle in attesa.
|
||||
- **Viste**: **Emesse**, **Ricevute**, **Autofatture**.
|
||||
- **Azioni**: genera, valida, invia, scarica, **Correggi** e rigenera, **Importa notifiche** e passive.
|
||||
- In testa: canali attivi e ora dell'ultima sincronizzazione.
|
||||
|
||||
### Autofatture da inviare
|
||||
|
||||
Le autofatture e integrazioni (TD16 reverse charge interno, TD17 servizi dall'estero, TD18 beni intra-UE, TD19, TD20
|
||||
e TD29, TD21, TD22/TD23, TD28) nascono da [Acquisti](Acquisti) e compaiono nella vista **Autofatture** fino all'invio.
|
||||
L'XML va trasmesso **entro il 15 del mese successivo**; Khaemhat mostra un promemoria.
|
||||
|
||||
## Copia di cortesia
|
||||
|
||||
Da ogni fattura si può generare la **copia di cortesia** (PDF + XML in uno ZIP) da inviare al cliente via e-mail o
|
||||
PEC. Non sostituisce l'invio allo SDI.
|
||||
Le regole dell'azienda di esempio: PA → PEC; oltre 200 file al giorno → Intermediario A con PEC di riserva;
|
||||
sempre → PEC con Intermediario A di riserva. Il canale usato resta scritto su ogni file.
|
||||
|
||||
## Conservazione
|
||||
|
||||
Khaemhat **non è un sistema di conservazione a norma**. Prepara per ogni periodo un **pacchetto di esportazione**
|
||||
(XML, notifiche e indice) da affidare a un **conservatore** o al servizio messo a disposizione dall'Agenzia delle
|
||||
Entrate. Se l'intermediario scelto include la conservazione, la regola di instradamento *Conservazione* gli invia i
|
||||
pacchetti.
|
||||

|
||||
*Khaemhat 0.9.0 — la preparazione di un pacchetto e l'elenco di quelli già preparati con l'impronta.*
|
||||
|
||||
## Sviluppi futuri
|
||||
Khaemhat **non è un sistema di conservazione a norma**: prepara il materiale da consegnare al conservatore (o al
|
||||
servizio gratuito dell'Agenzia). Si sceglie il periodo (in partenza il mese precedente, al massimo due anni) e si
|
||||
preme **Prepara e scarica**: lo ZIP contiene le cartelle `emesse/`, `ricevute/` e `notifiche/`, l'indice
|
||||
`indice.csv` con l'impronta SHA-256 di ogni file e un `LEGGIMI.txt`. L'elenco dei pacchetti preparati ricorda
|
||||
periodo, numero di file, dimensione e impronta dello ZIP.
|
||||
|
||||
Il formato europeo **EN 16931 / UBL (Peppol)** è previsto come implementazione successiva della stessa interfaccia
|
||||
dei formati ([Roadmap](Roadmap)).
|
||||
## Dati di esempio
|
||||
|
||||
L'azienda di esempio ([Dati di base e di esempio](Dati-di-base-e-esempio)) ha i canali, le tre regole di
|
||||
instradamento sopra, alcune fatture già trasmesse con ricevute di consegna,
|
||||
uno scarto (00305) corretto e rigenerato, una mancata consegna e tre fatture di fornitori da registrare. Nessun
|
||||
dato di esempio raggiunge lo SDI: il canale PEC dell'esempio è configurato ma **in pausa**, con credenziali finte,
|
||||
e l'Intermediario A è solo abbozzato e disattivato.
|
||||
|
||||
## Permessi e licenza
|
||||
|
||||
Serve il modulo **EINV**. `sales.invoice.issue` è il permesso di emissione delle fatture (SPEC §7.2); gli altri
|
||||
codici in testa sono indicativi e saranno fissati in sviluppo. La configurazione dei canali e delle credenziali è
|
||||
riservata a chi gestisce le impostazioni dell'azienda.
|
||||
| Permesso | Cosa consente |
|
||||
|---|---|
|
||||
| `einvoice.document.read` | cruscotto, storico, download di XML e copia di cortesia, notifiche, conservazione |
|
||||
| `einvoice.document.send` | generare, inviare, segnare come inviata, importare le notifiche |
|
||||
| `einvoice.inbox.read` | vedere le fatture ricevute |
|
||||
| `einvoice.inbox.import` | caricare, registrare, scartare e ripristinare le fatture ricevute |
|
||||
| `einvoice.channel.manage` | canali, credenziali, regole di instradamento, *Leggi i canali ora* |
|
||||
|
||||
Serve il modulo **EINV**. Le modifiche ai canali e alle regole finiscono nel registro delle modifiche; invii,
|
||||
notifiche e letture dei canali sono scritti nel [log](Log) dell'applicazione.
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
**Una fattura è scartata per codice destinatario non valido (00311).** Correggi il codice destinatario o la PEC
|
||||
nella scheda fiscale del cliente ([Anagrafiche](Anagrafiche)), poi **Correggi** nel cruscotto e reinvia. Secondo le
|
||||
indicazioni dell'Agenzia la fattura corretta va ritrasmessa entro 5 giorni dallo scarto.
|
||||
nella scheda del cliente ([Anagrafiche](Anagrafiche)), poi **Correggi** nel cruscotto, salva il documento e genera
|
||||
di nuovo il file. Secondo l'Agenzia la fattura corretta va ritrasmessa entro 5 giorni dallo scarto, con lo stesso
|
||||
numero e la stessa data.
|
||||
|
||||
**Posso usare più canali insieme?** Sì: le regole di instradamento scelgono il canale per ogni documento.
|
||||
**Ho inviato la fattura dal portale dell'Agenzia.** Usa **Segna come inviata** con l'identificativo SDI e poi
|
||||
**Importa notifiche** con le ricevute scaricate dal portale.
|
||||
|
||||
**Dove trovo la ricevuta di consegna?** Fra gli allegati della fattura e nella voce **Notifiche**.
|
||||
**Posso usare più canali insieme?** Sì: le regole di instradamento scelgono il canale per ogni file e il canale di
|
||||
riserva interviene se il primo non risponde.
|
||||
|
||||
**Il cliente non ha ricevuto la fattura (MC).** È comunque emessa: la trova nel suo cassetto fiscale. Mandagli la
|
||||
**copia di cortesia** dal cruscotto.
|
||||
|
||||
**Una PA ha rifiutato la fattura (EC02).** La fattura resta emessa: va stornata con una nota di credito
|
||||
([Vendite](Vendite)).
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
|
||||
@@ -1,21 +1,30 @@
|
||||
# Fiscalità italiana
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-11 · **Versione software:** 0.4.0 (codici e regole di base; il resto con M5-M10)
|
||||
> **Modulo di licenza:** CORE, ACCT, EINV, INTRA · **Specifica:** SPEC §11.1, §11.3-§11.9, §14
|
||||
> **Stato:** completa per la versione 0.9 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.9.0 (M9)
|
||||
> **Modulo di licenza:** CORE, ACCT, EINV, INTRA · **Specifica:** SPEC §11.1, §11.3-§11.9, §14, ADR 0036, ADR 0037, ADR 0038, ADR 0039
|
||||
|
||||
Questa pagina raccoglie in un solo posto i **codici e le regole fiscali italiane** che Khaemhat usa: tipi documento
|
||||
SDI, nature IVA, modalità e condizioni di pagamento, regimi fiscali, codici tributo F24 e scadenze. Serve come
|
||||
riferimento rapido mentre si compilano anagrafiche, codici IVA e documenti.
|
||||
SDI, nature IVA, modalità e condizioni di pagamento, regimi fiscali, il **piano dei conti modello**, i **codici
|
||||
tributo F24** con le scadenze, la **LIPE**, le **ritenute d'acconto** e il **bollo virtuale**. Serve come riferimento
|
||||
rapido mentre si compilano anagrafiche, codici IVA e documenti e mentre si liquida l'IVA.
|
||||
|
||||
Tutte queste tabelle sono **caricate dai dati di base** (pacchetto dati, per esempio `IT 2026.3`) e si aggiornano da
|
||||
**Amministrazione → Dati di base e di esempio** con **Aggiorna tabelle di base**. Le descrizioni ufficiali complete
|
||||
sono quelle delle *specifiche tecniche della fattura elettronica* dell'Agenzia delle Entrate, caricate nel seed: in
|
||||
caso di dubbio fa fede il testo mostrato dal programma, non questa pagina.
|
||||
Tutto ciò che è italiano sta nel **pacchetto fiscale Italia** del programma: le tabelle sono **caricate dai dati di
|
||||
base** (pacchetto dati, per esempio `IT 2026.3`) e si aggiornano da **Amministrazione → Dati di base e di esempio**
|
||||
con **Aggiorna tabelle di base** (o con `scripts/seed.sh --base`). Le descrizioni ufficiali complete sono quelle
|
||||
delle *specifiche tecniche della fattura elettronica* dell'Agenzia delle Entrate, caricate nel seed: in caso di dubbio
|
||||
fa fede il testo mostrato dal programma, non questa pagina.
|
||||
|
||||
> **Attenzione.** Khaemhat calcola e prepara i dati (F24, LIPE, Intrastat, bollo) ma **non sostituisce il
|
||||
> commercialista** né invia F24 e LIPE: l'invio telematico avviene tramite intermediario o home banking, come
|
||||
> indicato nella maschera della liquidazione. Le norme cambiano: la versione delle specifiche SDI supportata è
|
||||
> indicata nel programma ed è verificata a ogni rilascio.
|
||||
> **In questa versione** sono in uso i codici dei documenti, delle nature, dei pagamenti e dei regimi (dalla 0.4),
|
||||
> e con la 0.7 il piano dei conti *PMI standard*, i registri IVA, le regole della liquidazione e dell'acconto, i
|
||||
> codici tributo e le scadenze dell'F24, il tracciato LIPE, le ritenute d'acconto e il bollo virtuale. Con la 0.9 il
|
||||
> file FatturaPA e le notifiche SDI sono in uso nella [Fatturazione elettronica](Fatturazione-elettronica). Le parti
|
||||
> su dichiarazioni d'intento, Intrastat e cespiti descrivono regole che il programma userà con [IVA](IVA),
|
||||
> [Cespiti](Cespiti) e [Intrastat](Intrastat) (M10).
|
||||
|
||||
> **Attenzione.** Khaemhat calcola e prepara i dati (F24, LIPE, Certificazione Unica, bollo) ma **non sostituisce il
|
||||
> commercialista** né invia F24, LIPE e CU: l'invio telematico avviene con i servizi dell'Agenzia delle Entrate,
|
||||
> l'home banking o l'intermediario, come ricordato nelle maschere. Le norme cambiano: la versione delle specifiche SDI
|
||||
> supportata (oggi la 1.9.1) è scritta nel pacchetto fiscale ed è verificata a ogni rilascio.
|
||||
|
||||
## Dove si trovano questi codici nel programma
|
||||
|
||||
@@ -25,10 +34,12 @@ caso di dubbio fa fede il testo mostrato dal programma, non questa pagina.
|
||||
| Nature IVA (N…) | **Tabelle azienda → Codici IVA** | [Tabelle-azienda](Tabelle-azienda), [IVA](IVA) |
|
||||
| Modalità di pagamento (MP) | **Tabelle azienda → Metodi di pagamento** | [Tabelle-azienda](Tabelle-azienda) |
|
||||
| Regime fiscale (RF) | **Tabelle azienda → Profilo azienda**, scheda fornitore | [Tabelle-azienda](Tabelle-azienda), [Anagrafiche](Anagrafiche) |
|
||||
| Codici tributo F24 | liquidazione IVA, ritenute, bollo virtuale | [IVA](IVA), [Contabilita](Contabilita) |
|
||||
| Piano dei conti, causali, registri IVA | **Contabilità → Piano dei conti**, *Causali*, *Registri IVA* | [Contabilita](Contabilita), [IVA](IVA) |
|
||||
| Codici tributo F24 | liquidazione IVA, acconto, ritenute, bollo virtuale | [IVA](IVA) |
|
||||
| Tipi di ritenuta (RT) e casse (TC) | scheda fiscale del fornitore e del cliente, parcelle, fatture dei professionisti | [Anagrafiche](Anagrafiche), [IVA](IVA#ritenute-dacconto) |
|
||||
|
||||

|
||||
*Mockup 076 — tabella dei codici IVA con aliquota, natura SDI, riferimento normativo ed esigibilità; sotto, il dettaglio del codice selezionato (anteprima ridotta).*
|
||||

|
||||
*La tabella dei codici IVA dell'azienda in Tabelle azienda: ogni codice porta aliquota o natura SDI.*
|
||||
|
||||
## Tipi documento SDI (TD)
|
||||
|
||||
@@ -168,72 +179,170 @@ fatture passive. Il codice RF03 non esiste più nelle specifiche correnti.
|
||||
| MC | Mancata consegna | fattura **non consegnata**: messa a disposizione nell'area riservata del cliente |
|
||||
| NE | Notifica di esito (PA: EC01 accettazione, EC02 rifiuto) | esito del committente pubblico |
|
||||
| DT | Decorrenza termini | la PA non ha risposto nei termini |
|
||||
| AT | Attestazione di avvenuta trasmissione con impossibilità di recapito (PA) | fattura **impossibile da recapitare** |
|
||||
|
||||
Il dettaglio di come Khaemhat usa ogni notifica è nella pagina [Fatturazione elettronica](Fatturazione-elettronica#le-notifiche-dello-sdi).
|
||||
| AT | Attestazione di avvenuta trasmissione con impossibilità di recapito | come mancata consegna, per la PA |
|
||||
|
||||
I dettagli operativi sono in [Fatturazione-elettronica](Fatturazione-elettronica).
|
||||
|
||||
|
||||
## Piano dei conti modello
|
||||
|
||||
Il pacchetto fiscale porta il piano dei conti **PMI standard**: **240 conti** in tre livelli con codice `MM.CC.SSS`
|
||||
(mastro, conto, sottoconto), ognuno con natura, tipo e voce dello schema di bilancio civilistico (art. 2424 e 2425
|
||||
c.c.). Si carica con le tabelle di base dell'azienda e si modifica liberamente da **Contabilità → Piano dei conti**
|
||||
(vedi [Contabilità](Contabilita#piano-dei-conti)).
|
||||
|
||||
| Mastri | Natura | Contenuto |
|
||||
|---|---|---|
|
||||
| `01`-`09` | Attività | immobilizzazioni immateriali, materiali e finanziarie, rimanenze, crediti verso clienti, altri crediti (IVA, tributi), disponibilità liquide, ratei e risconti attivi, fondi di ammortamento |
|
||||
| `10`-`17` | Passività | patrimonio netto, fondi rischi, TFR, debiti verso banche, fornitori, debiti tributari e previdenziali, altri debiti, ratei e risconti passivi |
|
||||
| `20`-`29` | Costi | acquisti, servizi, godimento di beni di terzi, personale, ammortamenti, variazioni delle rimanenze, accantonamenti, oneri diversi, oneri finanziari, imposte sul reddito |
|
||||
| `30`-`32` | Ricavi | vendite e prestazioni, altri ricavi e proventi, proventi finanziari |
|
||||
| `90` | Conti d'ordine | conti di apertura e chiusura |
|
||||
|
||||
I conti usati dalle registrazioni automatiche:
|
||||
|
||||
| Conto | Uso |
|
||||
|---|---|
|
||||
| `05.01.001` Clienti Italia | cliente delle fatture di vendita (se la scheda cliente non indica un altro conto) |
|
||||
| `14.01.001` Fornitori Italia | fornitore delle fatture di acquisto |
|
||||
| `30.01.001` Ricavi per vendita di merci, `30.02.001` Resi e sconti su vendite | ricavi delle fatture e delle note di credito senza conto sull'articolo |
|
||||
| `20.01.001` Merci c/acquisti, `20.02.001` Resi e sconti su acquisti | costi delle fatture e note di credito fornitore senza conto sull'articolo o sul fornitore |
|
||||
| `06.02.001` IVA su acquisti, `15.01.001` IVA su vendite | IVA dei registri acquisti e vendite |
|
||||
| `15.01.002` Erario c/liquidazione IVA | saldo della liquidazione periodica e suo versamento |
|
||||
| `15.02.001` Erario c/ritenute lavoro autonomo, `06.03.001` Erario c/ritenute subite | ritenute operate e subite |
|
||||
| `31.01.002` Rimborso spese di bollo, `27.01.002` Imposta di bollo | bollo addebitato al cliente (ricavo) e bollo a carico dell'azienda (costo) |
|
||||
| `31.01.003` Rivalsa contributi previdenziali | rivalsa della cassa previdenziale sulle parcelle |
|
||||
| `27.01.003` IVA indetraibile | IVA indetraibile delle autofatture e del pro rata |
|
||||
| `28.01.003` Interessi sulla liquidazione IVA trimestrale | interessi dei contribuenti IVA trimestrali |
|
||||
| `07.01.001` Banca c/c, `07.02.001` Cassa contanti | banca predefinita per i versamenti F24, cassa dei corrispettivi |
|
||||
|
||||
**Registri IVA di base:** `VEN1` fatture emesse, `ACQ1` fatture acquisti, `CORR` corrispettivi, `VEN-RC` e `ACQ-RC`
|
||||
per autofatture e integrazioni. **Causali di base:** FV, NCV, FA, NCA, AFRC, CORR, INC, PAG, RIT, RITS, LIQ, F24,
|
||||
GIRO, SPB, STO (vedi [Contabilità](Contabilita#causali-contabili)). Fatture, note di debito e parcelle si registrano
|
||||
con FV su VEN1, le note di credito con NCV, le fatture fornitore con FA su ACQ1, le note di credito fornitore con NCA,
|
||||
le autofatture AF16-AF29 con AFRC su VEN-RC e ACQ-RC.
|
||||
|
||||
## Codici tributo F24
|
||||
|
||||
Khaemhat propone il codice tributo e prepara i **dati F24** da passare a intermediario o home banking.
|
||||
Khaemhat propone il codice tributo e prepara i **dati F24** da passare all'home banking o all'intermediario (vedi
|
||||
[IVA](IVA#prospetto-f24-e-pagamento)).
|
||||
|
||||
| Codice | Uso | Maschera |
|
||||
| Codice | Uso | Dove nasce |
|
||||
|---|---|---|
|
||||
| 6001 … 6012 | IVA mensile, da gennaio (6001) a dicembre (6012) | Liquidazione IVA (046) |
|
||||
| 6031 … 6034 | IVA trimestrale, dal 1° (6031) al 4° trimestre (6034, contribuenti trimestrali "speciali") | Liquidazione IVA |
|
||||
| 6013 | Acconto IVA mensili | Liquidazione IVA (acconto di dicembre) |
|
||||
| 6035 | Acconto IVA trimestrali | Liquidazione IVA (acconto di dicembre) |
|
||||
| 6099 | IVA dovuta in base alla dichiarazione annuale | Liquidazione IVA |
|
||||
| 1040 | Ritenute su redditi di lavoro autonomo | Ritenute (047) |
|
||||
| 1038 | Ritenute su provvigioni | Ritenute (047) |
|
||||
| 2521 … 2524 | Imposta di bollo sulle fatture elettroniche, dal 1° (2521) al 4° trimestre (2524) | Bollo virtuale (060) |
|
||||
| 6001 … 6012 | IVA mensile, da gennaio (6001) a dicembre (6012) | Liquidazione IVA |
|
||||
| 6031, 6032, 6033 | IVA trimestrale del 1°, 2° e 3° trimestre | Liquidazione IVA |
|
||||
| 6099, rateazione `0101` | saldo IVA del 4° trimestre dei trimestrali, versato con la dichiarazione annuale | Liquidazione IVA |
|
||||
| 6013 | Acconto IVA mensili | Acconto IVA |
|
||||
| 6035 | Acconto IVA trimestrali | Acconto IVA |
|
||||
| 1040 | Ritenute su redditi di lavoro autonomo | Ritenute |
|
||||
| 1038 | Ritenute su provvigioni | Ritenute |
|
||||
| 1019 | Ritenute del 4% operate dal condominio | tabella dei codici |
|
||||
| 1001 | Ritenute su retribuzioni e pensioni | tabella dei codici |
|
||||
| 2521 … 2524 | Imposta di bollo sulle fatture elettroniche, dal 1° (2521) al 4° trimestre (2524) | Bollo virtuale |
|
||||
|
||||

|
||||
*Mockup 046 — liquidazione periodica: registri del periodo con controlli, calcolo dell'IVA da versare, riquadro Versamento con codice tributo, scadenza e termine della LIPE.*
|
||||
Il codice 6034 (4° trimestre dei trimestrali "speciali") non è usato: per i trimestrali ordinari il saldo del 4°
|
||||
trimestre si versa con il 6099. Il file **Dati F24** è un CSV con separatore `;`: una riga di intestazione (scadenza,
|
||||
codice fiscale e denominazione dell'azienda), poi una riga per codice della sezione Erario con rateazione o mese,
|
||||
anno di riferimento, importo a debito, importo a credito e descrizione, e in fondo il saldo. Il tracciato telematico
|
||||
degli intermediari non viene prodotto.
|
||||
|
||||

|
||||
*Mockup 047 — ritenute operate su parcelle e provvigioni con cassa previdenziale ed ENASARCO; in basso il prospetto F24 con i codici 1040, 1038 e IVA.*
|
||||
## Liquidazione e acconto IVA
|
||||
|
||||
| Regola | Valore in Khaemhat | Riferimento |
|
||||
|---|---|---|
|
||||
| Periodicità | mensile o trimestrale, dal profilo azienda | |
|
||||
| Versamento minimo | se il dovuto (con gli interessi) è sotto **25,82 euro** non si versa e passa al periodo dopo | art. 1 c. 4 DPR 100/1998 |
|
||||
| Interessi dei trimestrali | **1%** sul saldo a debito di ogni trimestre | |
|
||||
| Pro rata | percentuale di detraibilità del profilo azienda, applicata all'IVA detraibile degli acquisti | art. 19-bis DPR 633/72 |
|
||||
| Esigibilità differita e split payment | l'IVA resta fuori dal debito del periodo | |
|
||||
| Acconto di dicembre | **88%** della base con i metodi storico e previsionale, tutto l'importo con il metodo effettivo (operazioni fino al 20 dicembre); non dovuto sotto **103,29 euro**; versamento entro il **27 dicembre** | L. 405/1990 |
|
||||
|
||||
## Comunicazione LIPE
|
||||
|
||||
La **comunicazione delle liquidazioni periodiche IVA** (art. 21-bis DL 78/2010) si prepara come file XML nel
|
||||
tracciato **IVP18** dell'Agenzia delle Entrate: un file per trimestre, con un modulo per ogni mese (o uno per il
|
||||
trimestre). Ogni modulo riporta totale delle operazioni attive e passive, IVA esigibile e detratta, IVA dovuta o a
|
||||
credito, debito e credito del periodo precedente, interessi, acconto e importo da versare o a credito. Gli importi
|
||||
hanno la virgola e due decimali. Il file si chiama `IT<codice fiscale>_LI_<anno>_T<trimestre>.xml`; va firmato e
|
||||
inviato con i servizi dell'Agenzia o dall'intermediario.
|
||||
|
||||
| Trimestre | Scadenza della LIPE |
|
||||
|---|---|
|
||||
| 1° | 31 maggio |
|
||||
| 2° | 16 settembre |
|
||||
| 3° | 30 novembre |
|
||||
| 4° | fine febbraio dell'anno dopo |
|
||||
|
||||
## Ritenute d'acconto e casse previdenziali
|
||||
|
||||
| Tipo | Aliquota | Su | Codice F24 | Tipo e causale nell'XML |
|
||||
|---|---|---|---|---|
|
||||
| Lavoro autonomo professionale | 20% | tutto il compenso | 1040 | RT01, causale A |
|
||||
| Lavoro autonomo occasionale | 20% | tutto il compenso | 1040 | RT01, causale M |
|
||||
| Provvigioni ad agenti e rappresentanti | 23% | 50% della provvigione | 1038 | RT01, causale R |
|
||||
| Provvigioni ad agenti con dipendenti o terzi | 23% | 20% della provvigione | 1038 | RT01, causale R |
|
||||
|
||||
I tipi di ritenuta della fattura elettronica sono **RT01** (persone fisiche), **RT02** (persone giuridiche),
|
||||
**RT03**-**RT06** (contributi INPS, ENASARCO, ENPAM, altri); le casse previdenziali vanno da **TC01** (avvocati) a
|
||||
**TC22** (per esempio **TC04** ingegneri e architetti). La ritenuta operata diventa dovuta quando si **paga** la
|
||||
fattura del professionista (criterio di cassa) e si versa entro il **16 del mese successivo** al pagamento. I dati
|
||||
della **Certificazione Unica** (compenso lordo, somme non soggette, imponibile, ritenute per percipiente e causale)
|
||||
si esportano in CSV; la CU si invia con i servizi dell'Agenzia o dall'intermediario.
|
||||
|
||||
## Imposta di bollo
|
||||
|
||||
| Regola | Valore |
|
||||
|---|---|
|
||||
| Quando | fatture senza IVA (esenti, non imponibili, fuori campo) sopra **77,47 euro** |
|
||||
| Importo | **2,00 euro** per fattura |
|
||||
| Nature che contano | N1, N2.1, N2.2, N3.5, N3.6, N4, N5; non contano esportazioni (N3.1), cessioni intracomunitarie (N3.2), San Marino (N3.3), operazioni assimilate (N3.4), inversione contabile (N6.x) e N7 |
|
||||
| Versamento | per trimestre: 1° entro il **31 maggio** (2521), 2° entro il **30 settembre** (2522), 3° entro il **30 novembre** (2523), 4° entro **fine febbraio** dell'anno dopo (2524) |
|
||||
| Importi bassi | se il bollo del 1° trimestre non supera **5.000 euro** si versa con il 2°; se 1° e 2° insieme non superano 5.000 euro, con il 3° (DM 4/12/2023) |
|
||||
|
||||
## Scadenze e regole principali
|
||||
|
||||
| Adempimento | Regola | Note in Khaemhat |
|
||||
|---|---|---|
|
||||
| Liquidazione IVA mensile | versamento entro il **16 del mese successivo** | la conferma della liquidazione **blocca il periodo** |
|
||||
| Liquidazione IVA trimestrale | versamento entro il 16 del secondo mese successivo al trimestre (per il secondo trimestre vale la proroga estiva di agosto), con **interessi dell'1%**; il quarto trimestre si versa con il saldo annuale entro il 16 marzo | interessi calcolati in automatico |
|
||||
| Liquidazione IVA mensile | versamento entro il **16 del mese successivo** | la conferma della liquidazione segna il periodo come **liquidato** |
|
||||
| Liquidazione IVA trimestrale | 1°-3° trimestre entro il 16 del secondo mese successivo al trimestre, con **interessi dell'1%**; il 4° trimestre entro il **16 marzo** con il codice 6099 | interessi calcolati in automatico |
|
||||
| Scadenze in agosto e nei festivi | i versamenti fra il 1° e il 20 agosto slittano al **20 agosto**; una scadenza di sabato, domenica o festivo slitta al primo giorno lavorativo | festivi nazionali, Pasquetta e, dal 2026, il 4 ottobre |
|
||||
| Versamento minimo | importo fino a **€ 25,82** non versato e riportato al periodo successivo | valore della specifica; da verificare in sviluppo rispetto alla norma vigente |
|
||||
| Acconto IVA | entro il **27 dicembre**; metodo **storico**, **previsionale** o **analitico** | scelta del metodo nella liquidazione di dicembre |
|
||||
| LIPE | 1° trimestre entro 31 maggio, 2° entro 16 settembre, 3° entro 30 novembre, 4° entro fine febbraio (o nella dichiarazione annuale) | XML LIPE generato dalla liquidazione |
|
||||
| Ritenute d'acconto operate | versamento entro il **16 del mese successivo** al pagamento della parcella (1040/1038) | la ritenuta nasce al pagamento della fattura |
|
||||
| Imposta di bollo | **€ 2,00** se le operazioni esenti, non imponibili o fuori campo superano **€ 77,47** | contano le nature N1, N2.1, N2.2, N3.5, N3.6, N4, N5; non contano esportazioni (N3.1), cessioni intracomunitarie (N3.2), San Marino (N3.3), operazioni assimilate (N3.4), inversione contabile (N6.x) e N7 |
|
||||
| Bollo virtuale | versamento trimestrale: 1° trimestre entro 31 maggio, 2° entro 30 settembre, 3° entro 30 novembre, 4° entro fine febbraio; con importi bassi i primi trimestri possono slittare (soglia di € 5.000) | elenco da confrontare con quello proposto dall'Agenzia |
|
||||
| Autofatture e integrazioni (TD16-TD19) | XML da trasmettere **entro il 15 del mese successivo** | promemoria nella dashboard |
|
||||
| Versamento minimo IVA | importo sotto **25,82 euro** non versato e riportato al periodo successivo | *debito sotto la soglia* nella liquidazione |
|
||||
| Acconto IVA | entro il **27 dicembre**; metodo **storico**, **previsionale** o **effettivo**; non dovuto sotto 103,29 euro | riquadro *Acconto IVA* della liquidazione |
|
||||
| LIPE | 1° trimestre entro 31 maggio, 2° entro 16 settembre, 3° entro 30 novembre, 4° entro fine febbraio | file XML dalla liquidazione |
|
||||
| Ritenute d'acconto operate | versamento entro il **16 del mese successivo** al pagamento della fattura (1040/1038) | la ritenuta diventa dovuta con **Fattura pagata** |
|
||||
| Bollo virtuale | versamento trimestrale (vedi sopra), con la soglia dei 5.000 euro | elenco da confrontare con quello proposto dall'Agenzia |
|
||||
| Autofatture e integrazioni (TD16-TD19) | XML da trasmettere **entro il 15 del mese successivo** | promemoria nelle autofatture |
|
||||
| Fattura differita (TD24) | emissione entro il 15 del mese successivo a quello delle consegne documentate da DDT | procedura **Fatturazione differita** |
|
||||
| Interessi di mora | D.Lgs. 231/2002 per i ritardi nelle transazioni commerciali | calcolati nei solleciti |
|
||||
|
||||

|
||||
*Mockup 060 — imposta di bollo del trimestre: fatture con bollo, importo, codice tributo 2524 e scadenza; in fondo la regola dei € 77,47.*
|
||||
| Interessi di mora | D.Lgs. 231/2002 per i ritardi nelle transazioni commerciali: tasso BCE di riferimento del semestre + 8 punti (10,15% nel primo semestre 2026, 10,40% nel secondo) | nei solleciti e nell'estratto conto dello [Scadenzario](Scadenzario); la tabella dei tassi va aggiornata ogni semestre (ADR 0038) |
|
||||
|
||||
## Altri riferimenti usati dal programma
|
||||
|
||||
| Tema | Regola | Pagina |
|
||||
|---|---|---|
|
||||
| Split payment | IVA versata dalla PA cessionaria (esigibilità **S**) | [Vendite](Vendite) |
|
||||
| Split payment | IVA versata dalla PA cessionaria (esigibilità **S**): in contabilità l'IVA viene tolta subito al cliente | [Vendite](Vendite), [Contabilita](Contabilita) |
|
||||
| Reverse charge interno | IVA a carico del cessionario, registri RC vendite e acquisti (IVA neutra) | [Acquisti](Acquisti), [IVA](IVA) |
|
||||
| Dichiarazione d'intento | operazioni non imponibili N3.5 con controllo di plafond, utilizzato e residuo | [Fatturazione-elettronica](Fatturazione-elettronica) |
|
||||
| Ritenuta e cassa previdenza | parcelle TD06: cassa (ad esempio 4%) e ritenuta d'acconto; ENASARCO per gli agenti | [Contabilita](Contabilita) |
|
||||
| Cespiti | coefficienti del DM 31/12/1988, primo anno al 50%, limiti per le autovetture, beni sotto € 516,46 | [Cespiti](Cespiti) |
|
||||
| Intrastat | elenchi INTRA cessioni e acquisti, periodicità da soglie, nomenclatura NC8 | [Intrastat](Intrastat) |
|
||||
| Bilancio | schemi CEE art. 2424 (stato patrimoniale) e 2425 (conto economico), ordinario/abbreviato/micro | [Contabilita](Contabilita) |
|
||||
| Dichiarazione d'intento | operazioni non imponibili N3.5 con controllo di plafond, utilizzato e residuo (M10) | [Fatturazione-elettronica](Fatturazione-elettronica) |
|
||||
| Ritenuta e cassa previdenza | parcelle TD06: cassa (ad esempio 4%) e ritenuta d'acconto | [IVA](IVA#ritenute-dacconto) |
|
||||
| Cespiti | coefficienti del DM 31/12/1988, primo anno al 50%, limiti per le autovetture, beni sotto € 516,46 (M10) | [Cespiti](Cespiti) |
|
||||
| Intrastat | elenchi INTRA cessioni e acquisti, periodicità da soglie, nomenclatura NC8 (M10) | [Intrastat](Intrastat) |
|
||||
| Bilancio | schemi CEE art. 2424 (stato patrimoniale) e 2425 (conto economico): le voci sono già sui conti, gli schemi arrivano con M10 | [Contabilita](Contabilita) |
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
**Dove vedo la versione delle specifiche SDI supportata?** In **Amministrazione → Stato sistema** e nel cruscotto
|
||||
SDI: è registrata nel programma e aggiornata con i rilasci.
|
||||
**Quale versione delle specifiche SDI segue Khaemhat?** La 1.9.1 (in Khaemhat 0.9.0): è scritta nel pacchetto
|
||||
fiscale, riportata nelle note di ogni rilascio e aggiornata quando l'Agenzia pubblica una nuova versione. La pagina
|
||||
*Stato sistema* la mostrerà con le pagine di amministrazione (M12).
|
||||
|
||||
**Una natura o un codice non c'è nella tabella.** Lancia **Aggiorna tabelle di base**: il pacchetto dati porta i
|
||||
codici correnti. Se manca ancora, segnalalo: le code list sono parte del pacchetto fiscale italiano.
|
||||
|
||||
**Khaemhat invia l'F24?** No: prepara i dati e la stampa; l'invio passa da intermediario o home banking.
|
||||
**Posso usare un mio piano dei conti?** Sì: il modello *PMI standard* si modifica, si ampliano i sottoconti e si
|
||||
disattivano quelli che non servono. L'import di un piano dei conti da file non c'è ancora.
|
||||
|
||||
**Khaemhat invia l'F24?** No: prepara i dati e il file; l'invio passa da home banking o intermediario.
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
|
||||
@@ -0,0 +1,221 @@
|
||||
# Guida all'uso
|
||||
|
||||
> **Stato:** completa per la versione 0.9 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.9.0 (M9)
|
||||
|
||||
Questa pagina accompagna chi usa Khaemhat ogni giorno: dall'accesso alla fattura inviata al cliente, un passo per
|
||||
volta, con le schermate della versione attuale. Ogni passo rimanda alla pagina che lo spiega per intero. Chi deve
|
||||
**installare** Khaemhat parte invece da [Installazione con Docker](Installazione-Docker) o
|
||||
[Installazione su Unraid](Installazione-Unraid) e da [Primi passi](Primi-passi).
|
||||
|
||||
## Che cosa c'è in questa versione
|
||||
|
||||
| Area | In 0.9.0 | Arriva con |
|
||||
|---|---|---|
|
||||
| Accesso e sicurezza | password, verifica in due passaggi, codici di recupero, blocco dopo i tentativi sbagliati | — |
|
||||
| Interfaccia | menu, schede, ricerca globale, notifiche, aiuto F1, dashboard a widget, temi e colori | — |
|
||||
| Tabelle azienda | profilo azienda, esercizi, cambi, codici IVA, pagamenti, banche, depositi, tipi documento, numeratori e le altre tabelle di base | — |
|
||||
| Anagrafiche | clienti, fornitori, contatti, controlli di partita IVA e codice fiscale, VIES | CRM (lead, opportunità): M11 |
|
||||
| Articoli | articoli, categorie, listini con prezzi a validità, prezzi netti per cliente, costo medio e ultimo costo dai movimenti | — |
|
||||
| Vendite | preventivi, ordini, DDT, fatture, note, pro forma, fatturazione differita, stampa PDF, invio per e-mail, scarico del magazzino e impegno, registrazione contabile automatica, incassi dallo scadenzario, file FatturaPA e invio allo SDI | — |
|
||||
| Acquisti | ordini fornitori, ricevimenti, fatture e note di credito fornitore con protocollo, controllo dei prezzi, import delle fatture elettroniche XML/P7M/ZIP, autofatture e integrazioni in bozza con scadenza, registrazione contabile e registri IVA, pagamenti dallo scadenzario, file e invio delle autofatture | — |
|
||||
| Magazzino | giacenze per deposito, impegnato e ordinato, costo medio, movimenti e trasferimenti, inventario fisico, proposta di riordino, valorizzazione con classi ABC, ricostruzione | scritture delle rimanenze e libro inventari con la chiusura dell'esercizio M10 |
|
||||
| Contabilità | piano dei conti, causali, prima nota, contabilizzazione automatica dei documenti, registrazioni ricorrenti e definitive, partitari, mastrini, bilancio di verifica, libro giornale | chiusura dell'esercizio, bilancio CEE e cespiti M10 |
|
||||
| IVA | registri IVA, liquidazione con F24, acconto, file LIPE, ritenute d'acconto con prospetto F24 e dati CU, bollo virtuale | dichiarazioni d'intento M10 |
|
||||
| Scadenzario | partite aperte con aging, incassi e pagamenti, distinte RiBa/SDD/bonifici SEPA con insoluti, mandati SDD, riconciliazione bancaria CSV/CBI/CAMT.053, solleciti con interessi di mora, flusso di cassa | collegamento diretto con la banca e report di tesoreria M12 |
|
||||
| Fatturazione elettronica | file FatturaPA con controllo prima dell'invio, canali PEC, SdICoop e due intermediari con instradamento, notifiche, correzione degli scarti, copia di cortesia, fatture ricevute da registrare, pacchetti per la conservazione | dichiarazioni d'intento M10, formato europeo UBL più avanti |
|
||||
| Import ed export | clienti, fornitori, articoli, prezzi e giacenze iniziali da CSV, Excel e JSON; esportazione dai radar | import del piano dei conti: più avanti |
|
||||
| Amministrazione da interfaccia | utenti e licenze da variabili e riga di comando | pagine di amministrazione: M12 |
|
||||
|
||||
Le voci di menu delle aree non ancora pronte aprono una pagina che dice che cosa conterranno.
|
||||
|
||||
## 1. Entrare
|
||||
|
||||

|
||||
|
||||
Scegli l'**azienda**, scrivi **nome utente** e **password** e premi **Accedi**. Se il tuo account ha la verifica in
|
||||
due passaggi, Khaemhat chiede il codice a 6 cifre dell'app di autenticazione (o un codice di recupero). Al primo
|
||||
accesso può chiederti di cambiare la password. Vedi [Primi passi](Primi-passi) e
|
||||
[Utenti e permessi](Utenti-e-permessi).
|
||||
|
||||
## 2. Orientarsi
|
||||
|
||||

|
||||
|
||||
- **Barra superiore**: logo e versione, l'**azienda** su cui lavori (si cambia da qui), la **ricerca globale**
|
||||
(`Ctrl+K`), cronologia, **notifiche**, tema chiaro o scuro, **aiuto** (`F1`) e il menu del tuo profilo.
|
||||
- **Menu a sinistra**: le aree del gestionale; si comprime per avere più spazio.
|
||||
- **Schede**: ogni maschera si apre in una scheda; puoi tenerne aperte più insieme e passare dall'una all'altra.
|
||||
- **Barra di stato** in basso: azienda, esercizio, utente, stato della connessione e versione.
|
||||
|
||||
La **Home** è una dashboard a widget che ognuno personalizza. Le scorciatoie da tastiera sono elencate in
|
||||
[Interfaccia e scorciatoie](Interfaccia-e-scorciatoie#tabella-completa-delle-scorciatoie); la dashboard in
|
||||
[Dashboard](Dashboard).
|
||||
|
||||

|
||||
|
||||
## 3. Preparare l'azienda
|
||||
|
||||

|
||||
|
||||
Prima dei documenti controlla in **Tabelle azienda**:
|
||||
|
||||
1. **Profilo azienda**: ragione sociale, partita IVA, indirizzo, REA, contatti, logo e la nota a piè di pagina delle
|
||||
stampe. Questi dati compaiono su ogni documento stampato.
|
||||
2. **Esercizi e periodi**: l'esercizio dell'anno deve essere aperto, altrimenti i documenti non si confermano.
|
||||
3. **Pagamenti**, **banche**, **codici IVA**, **depositi**: le tabelle di base sono già caricate; aggiungi le tue.
|
||||
4. **Tipi documento** e **numeratori**: il formato dei numeri (`7/2026`, `OC-2026-0004`) e i sezionali.
|
||||
5. **Codici automatici**: come si numerano clienti, fornitori e articoli.
|
||||
|
||||
Dettagli in [Tabelle azienda](Tabelle-azienda) e [Dati di base e di esempio](Dati-di-base-e-esempio).
|
||||
|
||||
## 4. Clienti e fornitori
|
||||
|
||||

|
||||
|
||||
**Anagrafiche → Clienti** apre il **radar**, l'elenco con ricerca, filtri, colonne a scelta e viste salvate.
|
||||
`Ctrl+N` crea un cliente; un doppio clic apre la scheda.
|
||||
|
||||

|
||||
|
||||
Nella scheda compili i dati anagrafici e fiscali (partita IVA e codice fiscale sono controllati; la partita IVA UE si
|
||||
verifica sul VIES), gli indirizzi di consegna, i contatti e le **condizioni commerciali**: pagamento, listino,
|
||||
agente, banca. I documenti di vendita le propongono da soli. Vedi [Anagrafiche](Anagrafiche).
|
||||
|
||||
## 5. Articoli e prezzi
|
||||
|
||||

|
||||
|
||||
**Anagrafiche → Articoli**: codice, descrizione, categoria, unità di misura, codice IVA, prezzo, codici a barre,
|
||||
fornitori abituali. **Listini** gestisce i prezzi per listino con date di validità; nella scheda del cliente puoi
|
||||
fissare prezzi netti. Vedi [Articoli e listini](Articoli-e-listini).
|
||||
|
||||

|
||||
|
||||
## 6. Vendere
|
||||
|
||||

|
||||
|
||||
Il menu **Vendite** raccoglie preventivi, ordini, DDT, fatture e note di credito. Il percorso tipico:
|
||||
|
||||
1. **Preventivo** → **Crea Ordine cliente** quando il cliente accetta.
|
||||
2. **Ordine** → **Crea DDT** a ogni consegna (anche parziale) oppure **Crea Fattura immediata**.
|
||||
3. **Fatturazione differita** a fine mese: tutti i DDT del periodo diventano fatture, una per cliente.
|
||||
4. **Nota di credito** dalla fattura per un reso o una correzione.
|
||||
|
||||

|
||||
|
||||
Nella maschera del documento scegli il cliente, inserisci le righe (`F4` cerca l'articolo) e controlla castelletto
|
||||
IVA, scadenze e totali; **Conferma** (o **Emetti** per le fatture) assegna il numero. I documenti restano collegati
|
||||
riga per riga, così Khaemhat sa che cosa resta da consegnare o da fatturare.
|
||||
|
||||

|
||||
|
||||
Tutto il ciclo è spiegato in [Vendite](Vendite).
|
||||
|
||||
## 7. Stampare e inviare
|
||||
|
||||

|
||||
|
||||
La **stampante** della toolbar (`Ctrl+P`) apre l'anteprima: **Stampa** con la stampante del computer, **Apri PDF** o
|
||||
**Scarica PDF**, **Salva come allegato** per conservarne una copia.
|
||||
|
||||

|
||||
|
||||
Dal menu **⋯** del documento, **Invia per e-mail** propone destinatario, oggetto e testo; il PDF parte in allegato e
|
||||
l'esito finisce nel log. Vedi [Vendite](Vendite#invio-per-e-mail).
|
||||
|
||||
## 8. Comprare
|
||||
|
||||

|
||||
|
||||
Il ciclo passivo usa le stesse maschere delle vendite. In **Acquisti → Ordini fornitori** prepari l'ordine (il prezzo
|
||||
è quello del fornitore nella scheda articolo); quando arriva la merce **Crea DDT fornitore (carico)** registra il
|
||||
ricevimento, anche in più volte, e alla conferma carica il magazzino. **Crea Fattura fornitore** prepara la fattura:
|
||||
alla conferma prende il **protocollo** IVA. Se il prezzo fatturato è diverso da quello dell'ordine o del ricevimento,
|
||||
un avviso sopra le righe lo segnala.
|
||||
|
||||

|
||||
|
||||
Le fatture elettroniche ricevute si caricano da **Acquisti → Importa fatture**: XML, P7M o ZIP, anche molti file
|
||||
insieme. Khaemhat trova o crea il fornitore, abbina gli articoli, scarta i doppioni e registra le fatture in bozza con
|
||||
il file allegato. Per le fatture di fornitori esteri o in inversione contabile indica quale **autofattura** serve ed
|
||||
entro quando; **Acquisti → Autofatture** le elenca tutte. Vedi [Acquisti](Acquisti).
|
||||
|
||||
## 9. Il magazzino
|
||||
|
||||

|
||||
|
||||
**Magazzino → Giacenze** mostra per ogni articolo giacenza, impegnato, ordinato, disponibile, costo medio e valore,
|
||||
con lo stato rispetto a scorta minima e punto di riordino; apri una riga per vedere i movimenti. I documenti
|
||||
confermati muovono il magazzino da soli: non serve registrare a parte carichi e scarichi.
|
||||
|
||||

|
||||
|
||||
**Proposte di riordino** calcola che cosa ordinare e a quale fornitore e crea gli ordini in bozza, uno per fornitore.
|
||||
**Inventario** guida il conteggio fisico (anche dal file del lettore di codici a barre) e registra le rettifiche;
|
||||
**Valorizzazione** calcola il valore del magazzino a una data con le classi ABC. Vedi [Magazzino](Magazzino).
|
||||
|
||||
## 10. La contabilità
|
||||
|
||||

|
||||
|
||||
Con il modulo contabile ogni fattura, nota e autofattura confermata scrive da sola la sua **registrazione** in
|
||||
partita doppia, con le righe IVA nel registro giusto e le **partite** da incassare o pagare. **Contabilità → Prima
|
||||
nota** elenca le registrazioni e serve per quelle manuali (giroconti, spese, versamenti); **Liquidazione IVA** calcola
|
||||
l'IVA del periodo e prepara l'F24; **Bilancio** dà il bilancio di verifica. Vedi [Contabilità](Contabilita) e
|
||||
[IVA](IVA).
|
||||
|
||||
## 11. Incassare, pagare e la banca
|
||||
|
||||

|
||||
|
||||
**Scadenzario → Partite aperte** mostra che cosa devono pagarti i clienti e che cosa devi ai fornitori, con lo scaduto
|
||||
per anzianità. Quando un cliente paga, seleziona le sue partite e premi **Registra incasso**: indichi data, banca e
|
||||
importo (anche parziale, o con un abbuono) e Khaemhat chiude le partite e scrive la registrazione. Per i fornitori
|
||||
passa a **Fornitori** e usa **Registra pagamento**.
|
||||
|
||||

|
||||
|
||||
Le **Distinte RiBa/SDD** raccolgono gli effetti in scadenza e generano il file da caricare nell'home banking (anche i
|
||||
bonifici ai fornitori); **Riconciliazione bancaria** importa l'estratto conto e propone per ogni movimento la partita
|
||||
o la spesa corrispondente; **Solleciti** prepara i promemoria ai clienti in ritardo con gli interessi di mora;
|
||||
**Flusso di cassa** mostra quanto ci sarà in banca nelle prossime settimane. Vedi [Scadenzario](Scadenzario).
|
||||
|
||||
## 12. Allegati
|
||||
|
||||

|
||||
|
||||
Ogni anagrafica e ogni documento ha la scheda **Allegati**: carichi file dal computer, li vedi in anteprima, scarichi tutto in un archivio ZIP. I PDF che Khaemhat genera sono **versionati**: ogni stampa salvata o
|
||||
e-mail inviata aggiunge una versione e le precedenti restano. Vedi [Allegati e file](Allegati-e-file).
|
||||
|
||||
## 13. Importare ed esportare
|
||||
|
||||

|
||||
|
||||
**Amministrazione → Import/Export** porta in Khaemhat clienti, fornitori, articoli, prezzi di listino e giacenze iniziali da un file
|
||||
CSV, Excel o JSON: scegli il file, abbini le colonne, guarda l'anteprima con gli errori riga per riga e conferma. Ogni radar
|
||||
esporta le righe visibili. Vedi [Import/Export](Import-Export).
|
||||
|
||||
## 14. Personalizzare
|
||||
|
||||

|
||||
|
||||
Dal menu del tuo nome, **Il mio profilo**: tema chiaro, scuro o automatico, colore d'accento, densità e carattere,
|
||||
dati personali, password e verifica in due passaggi, sessioni aperte e pagina iniziale. Le preferenze dell'azienda (ad esempio i decimali dei
|
||||
prezzi) sono in **Tabelle azienda → Preferenze**. Vedi [Preferenze utente](Preferenze-utente).
|
||||
|
||||

|
||||
|
||||
## Se qualcosa non va
|
||||
|
||||
- **`F1`** apre l'aiuto della pagina in cui sei: la pagina di questa wiki, anche senza connessione a Gitea.
|
||||
- La pagina di errore riporta un **codice di traccia**: comunicalo all'amministratore, che lo ritrova nel
|
||||
[Log](Log).
|
||||
- Le domande più comuni sono in [FAQ](FAQ); i termini del gestionale nel [Glossario](Glossario).
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
[Primi passi](Primi-passi) · [Interfaccia e scorciatoie](Interfaccia-e-scorciatoie) · [Anagrafiche](Anagrafiche) ·
|
||||
[Articoli e listini](Articoli-e-listini) · [Tabelle azienda](Tabelle-azienda) · [Vendite](Vendite) ·
|
||||
[Acquisti](Acquisti) · [Magazzino](Magazzino) · [Contabilità](Contabilita) · [IVA](IVA) ·
|
||||
[Allegati e file](Allegati-e-file) · [Import/Export](Import-Export) · [Preferenze utente](Preferenze-utente)
|
||||
@@ -1,6 +1,6 @@
|
||||
# Khaemhat
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.4.0 (M4; sviluppo in corso)
|
||||
> **Stato:** completa per 0.9.0 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.9.0 (M9; sviluppo in corso)
|
||||
|
||||

|
||||
|
||||
@@ -18,8 +18,12 @@ Il nome viene da uno scriba dell'antico Egitto che sovrintendeva ai granai del r
|
||||
|
||||
## Per iniziare
|
||||
|
||||
> **Usi Khaemhat?** Parti dalla **[Guida all'uso](Guida-utente)**: dall'accesso alla fattura inviata al cliente, con
|
||||
> le schermate della versione attuale e che cosa c'è e che cosa arriva.
|
||||
|
||||
| Se vuoi… | Leggi |
|
||||
|---|---|
|
||||
| Imparare a usare il gestionale | [Guida all'uso](Guida-utente) |
|
||||
| Installare Khaemhat su Unraid | [Installazione-Unraid](Installazione-Unraid) |
|
||||
| Installarlo con Docker Compose | [Installazione-Docker](Installazione-Docker) |
|
||||
| Fare il primo accesso e configurare l'azienda | [Primi-passi](Primi-passi) |
|
||||
|
||||
@@ -1,199 +1,288 @@
|
||||
# IVA
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-10 · **Versione software:** non ancora rilasciata (milestone M7; dichiarazioni d'intento in M10)
|
||||
> **Modulo di licenza:** ACCT (bollo virtuale e dichiarazioni d'intento anche con EINV) · **Permessi principali:** `vat.settlement.confirm`, `vat.register.print`, `vat.withholding.write`, `vat.intent.write` · **Specifica:** SPEC §11.7, §11.9, §11.3, §14
|
||||
> **Stato:** completa per la versione 0.7 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.7.0 (M7)
|
||||
> **Modulo di licenza:** ACCT · **Permessi principali:** `vat.register.read` (registri IVA), `vat.settlement.read` (liquidazione, ritenute, bollo, F24), `vat.settlement.confirm` (conferme, versamenti, stampe definitive) · **Specifica:** SPEC §11.7, §11.9, §14, ADR 0037
|
||||
|
||||
## A cosa serve
|
||||
Questa pagina descrive l'IVA e i versamenti collegati, tutti nel menu **Contabilità**:
|
||||
|
||||
Questa pagina descrive tutto ciò che riguarda l'IVA e i versamenti collegati:
|
||||
- **registri IVA** con protocollo, stampa di prova e stampa definitiva;
|
||||
- **liquidazione periodica** mensile o trimestrale, con credito e debito riportati, pro rata, interessi trimestrali e
|
||||
minimo di versamento; **acconto di dicembre**; file della **comunicazione LIPE** e dati del modello **F24**;
|
||||
- **ritenute d'acconto** operate e subite, **prospetto F24** con il suo pagamento e dati per la **Certificazione
|
||||
Unica**;
|
||||
- **imposta di bollo virtuale** sulle fatture elettroniche, per trimestre.
|
||||
|
||||
- **registri IVA** con protocollo e stampe definitive;
|
||||
- **liquidazione periodica** con esigibilità differita, IVA per cassa, pro-rata, acconto di dicembre, interessi,
|
||||
minimo di versamento, **dati F24** e **LIPE**;
|
||||
- **ritenute d'acconto** e **casse previdenziali**, con prospetto F24 e dati per la **CU**;
|
||||
- **imposta di bollo virtuale** sulle fatture elettroniche;
|
||||
- **dichiarazioni d'intento** ricevute ed emesse, con plafond.
|
||||
> **Khaemhat non trasmette nulla.** Prepara i file della LIPE, i dati dell'F24 e i dati della Certificazione Unica;
|
||||
> l'invio telematico si fa con i servizi dell'Agenzia delle Entrate, con l'home banking o tramite l'intermediario.
|
||||
|
||||
Khaemhat **non trasmette** F24, LIPE e CU: prepara i dati, i file e le stampe; l'invio telematico avviene tramite
|
||||
intermediario o home banking (avviso presente nel mockup 046).
|
||||
> **In questa versione** ci sono i cinque registri IVA con stampe di prova e definitive, la liquidazione con la sua
|
||||
> registrazione e il versamento F24, l'acconto IVA, il file LIPE, le ritenute con il prospetto F24 e il pagamento, i
|
||||
> dati della CU e il bollo virtuale. Dalla 0.8 il pagamento di una parcella dallo
|
||||
> [Scadenzario](Scadenzario) rende dovuta la ritenuta da solo. Arrivano più avanti: le **dichiarazioni d'intento** e il plafond e l'**Intrastat** (M10),
|
||||
> l'**IVA per cassa** completa (fase 2). Non ci sono ancora la **dichiarazione IVA annuale** e l'**invio
|
||||
> telematico** di F24, LIPE e CU.
|
||||
|
||||
## Dove si trova
|
||||
|
||||
- **Contabilità → Registri IVA**, **Contabilità → Liquidazione IVA**, **Contabilità → Ritenute**.
|
||||
- **Fatturazione elettronica → Bollo virtuale**, **→ Dichiarazioni d'intento**, **→ LIPE**.
|
||||
Menu **Contabilità** → *Registri IVA*, *Liquidazione IVA*, *Ritenute e F24*, *Bollo virtuale*. La **periodicità**
|
||||
IVA (mensile o trimestrale) e la **percentuale di pro rata** si impostano nel **profilo azienda** (vedi
|
||||
[Tabelle azienda](Tabelle-azienda)). Le registrazioni che queste pagine scrivono sono in **Prima nota** (vedi
|
||||
[Contabilità](Contabilita)).
|
||||
|
||||
## Schermate
|
||||
|
||||

|
||||
*Mockup 045 — registro Vendite 1 del mese con protocolli, imponibile, aliquota o natura, imposta ed esigibilità; in alto l'ultima stampa definitiva (anteprima ridotta)*
|
||||
|
||||

|
||||
*Mockup 046 — liquidazione mensile provvisoria: parametri, registri del periodo con i controlli superati, calcolo dell'IVA da versare e riquadro del versamento (codice tributo, scadenza, export F24, scadenza LIPE)*
|
||||
|
||||

|
||||
*Mockup 047 — ritenute operate e subite con cassa previdenziale, periodo e stato del versamento; sotto, il prospetto F24 del 16 del mese con i tributi 1040, 1038 e 6009*
|
||||
|
||||

|
||||
*Mockup 060 — fatture del trimestre soggette a bollo con natura, importo esente e addebito; riquadri con importo, codice tributo, scadenza e trimestre precedente*
|
||||
|
||||

|
||||
*Mockup 061 — dichiarazioni d'intento ricevute con protocollo AdE, plafond, utilizzato, residuo e stato (attiva, avviso al 97 %, esaurita)*
|
||||
```
|
||||
Documenti confermati ──► Registri IVA ──Calcola──► Liquidazione ──Conferma──► registrazione LIQ + riga F24
|
||||
Fattura del professionista ──Fattura pagata──► Ritenuta da versare ──► riga F24 (1040)
|
||||
Fatture con bollo del trimestre ──Metti in F24──► riga F24 (2521-2524)
|
||||
Righe F24 della scadenza ──► Prospetto F24 ──Registra pagamento──► registrazione F24
|
||||
```
|
||||
|
||||
## Registri IVA
|
||||
|
||||
Registri previsti: **vendite**, **acquisti**, **corrispettivi**, **vendite reverse charge**, **acquisti reverse
|
||||
charge** e i **sezionali** che servono (es. `VEN1`, `ACQ1`, `VEN-RC`, `ACQ-RC`, `ACQ-SP` per lo split payment,
|
||||
`CORR`). Ogni documento registrato riceve un **protocollo** progressivo nel suo registro.
|
||||

|
||||
*Il registro VEN1 di ottobre: una scheda per registro, la striscia con tipo, imponibile, imposta, ultima stampa
|
||||
definitiva e ultima pagina, le righe con protocollo e il riepilogo per aliquota.*
|
||||
|
||||
La griglia mostra protocollo, data di registrazione, documento, data del documento, controparte, P.IVA o codice
|
||||
fiscale, imponibile, aliquota o natura, imposta, totale ed **esigibilità** (`I` immediata, `D` differita, `S`
|
||||
scissione dei pagamenti).
|
||||
**Contabilità → Registri IVA** ha una scheda per registro:
|
||||
|
||||
**Stampe**
|
||||
|
||||
| Stampa | Effetto |
|
||||
| Registro | Contenuto |
|
||||
|---|---|
|
||||
| **Provvisoria** | in qualunque momento, senza effetti |
|
||||
| **Stampa definitiva** del periodo | pagine numerate, totali per aliquota e natura; aggiorna "ultima stampa definitiva" |
|
||||
| **Riepilogo aliquote** | totali del periodo per codice IVA e natura |
|
||||
| **VEN1** Registro fatture emesse | fatture, note di debito, parcelle e note di credito di vendita |
|
||||
| **VEN-RC** Registro fatture emesse - autofatture e integrazioni | il lato *vendite* delle autofatture e integrazioni (TD16-TD29) |
|
||||
| **ACQ1** Registro fatture acquisti | fatture e note di credito dei fornitori |
|
||||
| **ACQ-RC** Registro fatture acquisti - autofatture e integrazioni | il lato *acquisti* delle stesse autofatture |
|
||||
| **CORR** Registro dei corrispettivi | le registrazioni dei corrispettivi (causale `CORR`) |
|
||||
|
||||
Le autofatture reverse charge (TD16-TD19) sono annotate sia nel registro vendite RC sia nel registro acquisti RC,
|
||||
Scegli il periodo con **Dal** e **Al**. Ogni riga mostra **protocollo** (il link apre la registrazione), **data di
|
||||
registrazione IVA**, documento e data, cliente o fornitore, **aliquota** o natura, **imponibile**, **imposta**,
|
||||
**indetraibile** ed **esigibilità** (*Immediata*, *Differita*, *Scissione dei pagamenti*). Sotto, il **riepilogo per
|
||||
aliquota** e il totale del registro.
|
||||
|
||||
Le autofatture e integrazioni compaiono in **VEN-RC** e in **ACQ-RC** con la stessa imposta: a debito e a credito,
|
||||
con effetto neutro sulla liquidazione.
|
||||
|
||||
## Liquidazione IVA periodica
|
||||
### Stampe
|
||||
|
||||
| Stampa | Effetto | Permesso |
|
||||
|---|---|---|
|
||||
| **Stampa di prova** | PDF del registro nel periodo scelto, in qualunque momento, senza effetti | `vat.register.read` |
|
||||
| **Stampa definitiva** | PDF dal giorno dopo l'ultima stampa definitiva fino al giorno scelto, con le pagine numerate di seguito all'ultima pagina dell'anno | `vat.settlement.confirm` |
|
||||
|
||||
La stampa definitiva non si annulla: la striscia mostra la data dell'**ultima stampa definitiva** e l'**ultima
|
||||
pagina**, e la stampa successiva riparte da lì (la prima dell'anno parte dal 1° gennaio e dalla pagina 1). La stampa
|
||||
definitiva **non blocca** le registrazioni: a bloccare il periodo è la conferma della liquidazione (vedi sotto).
|
||||
|
||||
## Liquidazione IVA
|
||||
|
||||

|
||||
*La liquidazione mensile di ottobre 2026 confermata: registri del periodo, calcolo con il credito di settembre,
|
||||
riquadro del versamento (codice 6010, scadenza 16/11/2026, trimestre LIPE) e l'elenco delle liquidazioni dell'anno.*
|
||||
|
||||
### Come si fa
|
||||
|
||||
1. **Contabilità → Liquidazione IVA**. Controlla i parametri: **Periodicità** (mensile o trimestrale, dal profilo
|
||||
azienda), **Periodo**, **Data liquidazione**, **Credito precedente**, **Pro-rata**.
|
||||
2. Premi **Calcola**. Khaemhat esegue i **controlli preliminari** (mostrati con il segno di spunta sopra i registri):
|
||||
numerazione continua, nessuna bozza, date coerenti, periodo precedente confermato.
|
||||
3. Controlla la tabella **Registri del periodo** (documenti, imponibile, IVA, indetraibile, note come *neutra* per il
|
||||
reverse charge) e il riquadro **Calcolo**.
|
||||
4. Premi **Conferma**: la liquidazione diventa definitiva e il **periodo viene bloccato** (vedi
|
||||
[Contabilità](Contabilita), esercizi e periodi). Serve il permesso `vat.settlement.confirm`.
|
||||
5. Premi **Dati F24** per esportare i dati del versamento e **LIPE XML** per il file della comunicazione.
|
||||
1. **Contabilità → Liquidazione IVA**. La **periodicità** viene dal profilo azienda; scegli **Anno** e **Periodo**
|
||||
(mese o trimestre).
|
||||
2. Premi **Calcola** (serve `vat.settlement.read`). Khaemhat legge i registri del periodo e mostra la tabella
|
||||
**Registri del periodo** (documenti, imponibile, imposta, indetraibile, esigibilità differita), il riquadro
|
||||
**Calcolo** e il riquadro **Versamento** con codice tributo, anno, importo, scadenza e trimestre LIPE. Puoi
|
||||
ricalcolare quante volte vuoi finché la liquidazione non è confermata.
|
||||
3. Premi **Conferma liquidazione** (serve `vat.settlement.confirm`). Le liquidazioni si confermano in ordine: se un
|
||||
periodo precedente è calcolato ma non confermato, va confermato prima. Alla conferma Khaemhat:
|
||||
- scrive in prima nota la registrazione **LIQ**: *IVA su vendite* in Dare, *IVA su acquisti* in Avere, gli
|
||||
interessi trimestrali in Dare, l'eventuale IVA resa indetraibile dal pro rata a costo, e la differenza su
|
||||
*Erario c/liquidazione IVA*;
|
||||
- segna i periodi dell'esercizio come **liquidati**;
|
||||
- se c'è da versare, aggiunge la riga del modello **F24** con codice tributo e scadenza (vedi
|
||||
[Prospetto F24](#prospetto-f24-e-pagamento)).
|
||||
4. **Dati F24** scarica i dati del modello F24 della scadenza; **Comunicazione LIPE** scarica il file del trimestre
|
||||
(vedi [sotto](#comunicazione-lipe)).
|
||||
|
||||
**Riapri** annulla la conferma: la registrazione LIQ viene eliminata (o stornata, se è già definitiva), la riga F24
|
||||
viene tolta e i periodi tornano aperti. Non si riapre se l'F24 della liquidazione è già **pagato** (annulla prima il
|
||||
pagamento) né se una liquidazione **successiva** è confermata (riapri prima quella).
|
||||
|
||||
**Periodi liquidati.** Dopo la conferma, documenti e registrazioni **con IVA** datati nei periodi liquidati sono
|
||||
rifiutati: per correggere bisogna riaprire la liquidazione. Le registrazioni senza IVA restano libere.
|
||||
|
||||
### Le voci del calcolo
|
||||
|
||||
| Voce | Regola |
|
||||
| Voce | Regola in Khaemhat |
|
||||
|---|---|
|
||||
| IVA a debito | dai registri vendite e corrispettivi del periodo (esigibilità immediata) |
|
||||
| IVA a credito | dai registri acquisti, al netto dell'**indetraibile** e del **pro-rata** |
|
||||
| Esigibilità differita | l'IVA delle fatture a esigibilità differita entra quando si incassa (o alla scadenza di legge) |
|
||||
| IVA per cassa | con il regime dell'IVA per cassa attivo nel profilo azienda, debito e credito seguono incassi e pagamenti; il regime completo è previsto in fase 2 ([Roadmap](Roadmap)) |
|
||||
| Credito del periodo precedente | riportato automaticamente |
|
||||
| Acconto versato | sottratto nella liquidazione di dicembre (o del 4° trimestre) |
|
||||
| Interessi 1 % | maggiorazione dell'1 % per i contribuenti **trimestrali** |
|
||||
| Minimo di versamento | se l'IVA dovuta non supera **€ 25,82** non si versa e si **riporta** al periodo successivo |
|
||||
| **IVA a debito sulle vendite** | imposta dei registri vendite e corrispettivi del periodo, tolta quella a esigibilità differita e in scissione dei pagamenti |
|
||||
| **IVA a credito sugli acquisti** | imposta dei registri acquisti, tolta la parte **indetraibile** dei codici IVA, poi ridotta dal **pro rata** del profilo azienda |
|
||||
| **IVA indetraibile** | indetraibile per codice IVA più la parte tolta dal pro rata |
|
||||
| **IVA a esigibilità differita** | mostrata a parte: non entra nel debito del periodo |
|
||||
| **Credito / debito periodo precedente** | riportati dalla liquidazione confermata precedente |
|
||||
| **Acconto versato** | l'acconto di dicembre registrato, tolto nell'ultima liquidazione dell'anno (dicembre o 4° trimestre) |
|
||||
| **Interessi trimestrali 1%** | per i contribuenti trimestrali, sul saldo a debito |
|
||||
| **Da versare** | se il totale (con gli interessi) è sotto **25,82 euro** non si versa: diventa *debito sotto la soglia* e passa al periodo dopo; se il saldo è a credito diventa *credito da riportare* |
|
||||
|
||||
### Acconto di dicembre
|
||||
### Codici tributo e scadenze
|
||||
|
||||
L'acconto si calcola con uno dei tre metodi: **storico**, **previsionale**, **analitico**. Khaemhat propone gli
|
||||
importi di tutti e tre e l'utente sceglie. Percentuali e scadenza seguono le regole in vigore (al momento della
|
||||
stesura: 88 % per storico e previsionale, liquidazione al 20 dicembre per l'analitico, versamento entro il 27
|
||||
dicembre) e sono aggiornate con il pacchetto fiscale. Codici tributo: **6013** (mensili) e **6035** (trimestrali).
|
||||
| Periodo | Codice | Scadenza |
|
||||
|---|---|---|
|
||||
| Mese (gennaio-dicembre) | **6001**-**6012** | 16 del mese dopo |
|
||||
| 1°, 2°, 3° trimestre | **6031**, **6032**, **6033** | 16 del secondo mese dopo il trimestre (16/5, 20/8, 16/11) |
|
||||
| 4° trimestre | **6099**, rateazione **0101** | 16 marzo dell'anno dopo, con il saldo annuale |
|
||||
|
||||
### Codici tributo F24
|
||||
Le scadenze di sabato, domenica o festivo passano al primo giorno lavorativo; i versamenti dal 1° al 20 agosto
|
||||
passano al **20 agosto**. Codici e calendario sono in [Fiscalità italiana](Fiscalita-italiana#codici-tributo-f24).
|
||||
|
||||
| Codice | Versamento |
|
||||
### Acconto IVA di dicembre
|
||||
|
||||
Il riquadro **Acconto IVA** (sotto l'elenco delle liquidazioni, con `vat.settlement.confirm`) calcola l'acconto da
|
||||
versare entro il **27 dicembre** (primo giorno lavorativo successivo se festivo) con il codice **6013** (mensili) o
|
||||
**6035** (trimestrali).
|
||||
|
||||
| Metodo | Base di calcolo | Acconto |
|
||||
|---|---|---|
|
||||
| **Storico** | l'IVA dell'ultimo periodo dell'anno prima (dicembre o 4° trimestre), al lordo dell'acconto di allora e senza interessi | 88% della base |
|
||||
| **Previsionale** | l'IVA che prevedi per l'ultimo periodo dell'anno: la scrivi tu | 88% della base |
|
||||
| **Effettivo** | l'IVA dall'inizio dell'ultimo periodo al **20 dicembre** | tutta la base |
|
||||
|
||||
1. Scegli il **metodo**: la **base di calcolo** si compila con il valore che Khaemhat conosce (il riquadro *Basi di
|
||||
calcolo* mostra storico ed effettivo; **Ricalcola le basi** le rilegge). Per il previsionale scrivila tu.
|
||||
2. **Registra acconto** aggiunge la riga F24 dell'acconto. Sotto **103,29 euro** l'acconto non è dovuto e non viene
|
||||
registrato. Finché non è pagato puoi registrarlo di nuovo con un altro metodo: la riga si aggiorna.
|
||||
|
||||
L'acconto registrato viene tolto nella liquidazione di dicembre o del 4° trimestre.
|
||||
|
||||
### Comunicazione LIPE
|
||||
|
||||
**Comunicazione LIPE** scarica il file XML della **comunicazione delle liquidazioni periodiche IVA** di un trimestre,
|
||||
nel tracciato **IVP18** dell'Agenzia delle Entrate: un modulo per ogni mese (o per il trimestre), con operazioni
|
||||
attive e passive, IVA esigibile e detratta, debiti e crediti riportati, interessi, acconto e importo da versare o a
|
||||
credito. Il pulsante si accende quando è confermata la liquidazione dell'ultimo mese del trimestre (o del trimestre).
|
||||
Il file si chiama `IT<codice fiscale>_LI_<anno>_T<trimestre>.xml` e va firmato e inviato con i servizi dell'Agenzia
|
||||
o dall'intermediario. Le scadenze sono in [Fiscalità italiana](Fiscalita-italiana#comunicazione-lipe).
|
||||
|
||||
## Ritenute d'acconto
|
||||
|
||||

|
||||
*La ritenuta operata sulla fattura dello Studio Rag. Neri Paola (RT01, causale A, cassa TC04, 20% di 450 euro) già
|
||||
pagata e da versare; sotto, il prospetto F24 della scadenza del 16/11/2026 con l'IVA di ottobre.*
|
||||
|
||||
**Contabilità → Ritenute e F24** elenca le ritenute dei documenti di un **anno**, nelle schede **Operate**, **Subite**
|
||||
e **Tutte**:
|
||||
|
||||
- **operate**: quelle che l'azienda trattiene sulle **fatture dei professionisti** e degli agenti (fatture fornitore
|
||||
con ritenuta);
|
||||
- **subite**: quelle che i clienti trattengono sulle **parcelle** e fatture emesse dall'azienda con ritenuta.
|
||||
|
||||
Le ritenute nascono da sole quando il documento viene contabilizzato. Per ognuna: documento (il link apre la
|
||||
registrazione), data, cliente o fornitore, **tipo** e causale di pagamento (per esempio `RT01 · A`), imponibile,
|
||||
**cassa** previdenziale e contributo, **aliquota** (con la quota dell'imponibile, per esempio *20% su 50%* per gli
|
||||
agenti), importo, data di pagamento della fattura e **stato**:
|
||||
|
||||
| Stato | Significato |
|
||||
|---|---|
|
||||
| 6001 … 6012 | IVA mensile, da gennaio (6001) a dicembre (6012) |
|
||||
| 6031 … 6034 | IVA trimestrale, dal 1° (6031) al 4° trimestre (6034); il 6034 riguarda i trimestrali "speciali", per gli altri il saldo del 4° trimestre si versa con la dichiarazione annuale (6099) |
|
||||
| 6013 / 6035 | acconto IVA mensili / trimestrali |
|
||||
| 6099 | IVA da dichiarazione annuale |
|
||||
| 1040 | ritenute su redditi di lavoro autonomo |
|
||||
| 1038 | ritenute su provvigioni (agenti e rappresentanti) |
|
||||
| *In attesa del pagamento* | ritenuta operata su una fattura non ancora pagata |
|
||||
| *Da versare* | la fattura è pagata: la ritenuta va versata con l'F24 |
|
||||
| *Versata* | l'F24 che la contiene è pagato |
|
||||
| *Subita* | ritenuta trattenuta dal cliente su una fattura dell'azienda |
|
||||
|
||||
I codici sono caricati con i dati di base ([Dati di base e di esempio](Dati-di-base-e-esempio)) e riepilogati in
|
||||
[Fiscalità italiana](Fiscalita-italiana).
|
||||
### Registrare il pagamento della fattura
|
||||
|
||||
### LIPE
|
||||
La ritenuta operata diventa dovuta **quando paghi la fattura** del professionista (criterio di cassa). Se paghi la
|
||||
fattura dallo [Scadenzario](Scadenzario) succede da solo, quando la fattura è saldata del tutto. Se l'hai pagata
|
||||
fuori da Khaemhat, registralo a mano:
|
||||
|
||||
La **Comunicazione delle liquidazioni periodiche IVA** si genera come file XML nel tracciato dell'Agenzia delle
|
||||
Entrate dalle liquidazioni confermate del trimestre (voce di menu **Fatturazione elettronica → LIPE** o pulsante
|
||||
**LIPE XML**). Il riquadro **Versamento** mostra il trimestre di riferimento e la scadenza.
|
||||
1. Sulla riga della ritenuta premi **Fattura pagata** e indica la data di pagamento.
|
||||
2. Khaemhat scrive la registrazione **RIT** (*fornitore* in Dare, *Erario c/ritenute lavoro autonomo* in Avere) e
|
||||
aggiunge la ritenuta alla riga F24 del suo codice tributo (**1040** lavoro autonomo, **1038** provvigioni) e del
|
||||
mese di pagamento, con scadenza il **16 del mese dopo**. Le ritenute dello stesso codice e mese si sommano.
|
||||
3. Per una ritenuta **subita**, **Fattura pagata** chiede la data in cui il cliente ha pagato e scrive la registrazione
|
||||
**RITS** (*Erario c/ritenute subite* in Dare, *cliente* in Avere): è un credito d'imposta.
|
||||
|
||||
## Ritenute d'acconto e casse previdenziali
|
||||
Il pulsante con la freccia annulla il pagamento della fattura (e la sua registrazione) finché l'F24 non è pagato.
|
||||
|
||||
**Contabilità → Ritenute** (mockup 047) elenca le ritenute **operate** (sulle parcelle e provvigioni che paghiamo) e
|
||||
quelle **subite** (sulle nostre fatture, ad esempio verso la PA), con i filtri **Operate / Subite / Tutte**.
|
||||
### Dati per la Certificazione Unica
|
||||
|
||||
| Colonna | Significato |
|
||||
|---|---|
|
||||
| Tipo | professionista TD06, agente ENASARCO, ritenuta subita… |
|
||||
| Imponibile, Cassa, Importo cassa | contributo previdenziale (es. 4 % INPS di rivalsa, 4 % cassa professionale) |
|
||||
| Ritenuta | aliquota (es. 20 %; per gli agenti l'aliquota si applica a una quota della provvigione) |
|
||||
| Periodo → F24 | mese di pagamento della fattura e data del modello F24 in cui confluisce |
|
||||
| Stato | *Da versare*, *In F24*, *Versata*, *Subita* |
|
||||
**Dati Certificazione Unica** scarica un file CSV con i **percipienti** dell'anno: una riga per professionista e
|
||||
causale con codice fiscale, denominazione, causale, anno, compenso lordo, somme non soggette, imponibile, ritenute,
|
||||
codice tributo e documenti. Contiene le ritenute operate sulle fatture pagate nell'anno. La CU si compila e si invia
|
||||
con i servizi dell'Agenzia delle Entrate o dall'intermediario.
|
||||
|
||||
Regole:
|
||||
## Prospetto F24 e pagamento
|
||||
|
||||
- La ritenuta nasce come **debito verso l'Erario al pagamento** della fattura (criterio di cassa) e confluisce nel
|
||||
prospetto F24 del mese successivo (tributi **1040** e **1038**).
|
||||
- Sulle **parcelle (TD06)** cassa previdenziale, ritenuta e netto a pagare sono calcolati in automatico; **ENASARCO**
|
||||
si applica agli agenti con i relativi massimali.
|
||||
- **Registra versamento** registra il pagamento del modello F24 e chiude le ritenute versate.
|
||||
- **CU export** produce i dati della Certificazione Unica da consegnare all'intermediario.
|
||||
Il riquadro **Prospetto F24** (nella pagina *Ritenute e F24*) raccoglie tutto ciò che va versato con l'F24: IVA della
|
||||
liquidazione, acconto IVA, ritenute operate, bollo virtuale.
|
||||
|
||||
Il **Prospetto F24** del giorno di scadenza riepiloga tributi, periodi e importi (ritenute e IVA) con il totale.
|
||||
1. Scegli la **scadenza** nell'elenco (si apre sulla prima non pagata).
|
||||
2. Il prospetto mostra una riga per **codice tributo** e periodo con descrizione, periodo di riferimento, importo a
|
||||
debito e a credito, e il **saldo** dell'F24.
|
||||
3. **Dati F24** scarica un file CSV (separatore `;`, sezione Erario) con intestazione, una riga per codice tributo e il
|
||||
saldo, da passare all'home banking o all'intermediario.
|
||||
4. Pagato l'F24, **Registra pagamento** chiede la data: Khaemhat scrive la registrazione **F24** (*Erario
|
||||
c/liquidazione IVA*, *Erario c/ritenute* e *imposta di bollo* in Dare secondo le righe, la **banca** in Avere) e
|
||||
segna versate le righe e le ritenute. La banca è quella predefinita dell'azienda (il suo *conto contabile*), o
|
||||
`07.01.001` *Banca c/c*.
|
||||
|
||||
**Annulla pagamento** toglie la registrazione del pagamento (o la storna, se è definitiva) e riporta le righe da
|
||||
versare.
|
||||
|
||||
## Imposta di bollo virtuale
|
||||
|
||||
Sulle fatture con operazioni **esenti, non imponibili o fuori campo IVA** di importo **superiore a € 77,47** si
|
||||
applica il bollo di **€ 2,00**, calcolato in automatico sul documento e indicato nell'XML (`DatiBollo`).
|
||||
Sulle fatture elettroniche **senza IVA** (operazioni esenti, non imponibili o fuori campo) di importo **superiore a
|
||||
77,47 euro** si applica il bollo di **2 euro**. Khaemhat lo calcola già sul documento di vendita (vedi
|
||||
[Vendite](Vendite)), che dice anche se è **addebitato al cliente** o **a carico dell'azienda**.
|
||||
|
||||
**Fatturazione elettronica → Bollo virtuale** (mockup 060) mostra le fatture del trimestre con il bollo, la natura
|
||||
IVA, l'importo esente e l'**addebito** (*addebitato al cliente*, *a carico azienda*; per le fatture ricevute *a
|
||||
carico fornitore*). I riquadri riportano numero di fatture, importo, codice tributo del trimestre (**2521-2524**),
|
||||
scadenza e stato del trimestre precedente.
|
||||
**Contabilità → Bollo virtuale** riepiloga il bollo per **anno** e **trimestre**:
|
||||
|
||||
1. A fine trimestre controlla l'elenco e confrontalo con quello messo a disposizione dall'Agenzia delle Entrate.
|
||||
2. **Esporta per F24** produce i dati del versamento.
|
||||
3. A pagamento avvenuto premi **Segna versato**.
|
||||
- la striscia del trimestre: numero di **fatture**, **importo**, **codice tributo**, **scadenza** e lo stato del
|
||||
**trimestre precedente**;
|
||||
- l'elenco delle fatture del trimestre con il bollo: documento (il link lo apre), data, cliente, imponibile, bollo e
|
||||
**addebito**;
|
||||
- il riepilogo dei quattro trimestri dell'anno con fatture, importo, scadenza e stato (*Da mettere in F24*, *In F24*,
|
||||
*pagato il*).
|
||||
|
||||
> **Attenzione:** alcune operazioni non imponibili sono escluse dal bollo per legge (per esempio le cessioni
|
||||
> intracomunitarie e le esportazioni). L'esclusione sarà gestita sul codice IVA; la regola precisa sarà verificata in
|
||||
> sviluppo con la normativa vigente.
|
||||
| Trimestre | Codice | Scadenza |
|
||||
|---|---|---|
|
||||
| 1° | **2521** | 31 maggio |
|
||||
| 2° | **2522** | 30 settembre |
|
||||
| 3° | **2523** | 30 novembre |
|
||||
| 4° | **2524** | fine febbraio dell'anno dopo |
|
||||
|
||||
## Dichiarazioni d'intento e plafond
|
||||
Se il bollo del **1° trimestre** non supera **5.000 euro** si versa con il 2° (30 settembre); se quello del 1° e del
|
||||
2° insieme non supera 5.000 euro si versa con il 3° (30 novembre). Le scadenze festive passano al primo giorno
|
||||
lavorativo.
|
||||
|
||||
**Fatturazione elettronica → Dichiarazioni d'intento** (mockup 061) gestisce:
|
||||
|
||||
- **Ricevute**: dichiarazioni degli esportatori abituali nostri clienti (numero, data, cliente, **protocollo AdE**,
|
||||
plafond, utilizzato, residuo, anno, stato);
|
||||
- **Emesse (plafond nostro)**: dichiarazioni che l'azienda presenta ai propri fornitori.
|
||||
|
||||
Regole:
|
||||
|
||||
- Il plafond si aggiorna a ogni fattura con codice IVA **N3.5** (non imponibile a seguito di dichiarazione d'intento).
|
||||
- Al **90 %** di utilizzo compare un avviso (e la regola di automazione predefinita *Avviso plafond* avvisa
|
||||
l'amministrazione, vedi [Automazioni](Automazioni)); al **100 %** la fattura è bloccata.
|
||||
- Il protocollo della dichiarazione è riportato nell'XML della fattura (blocco `AltriDatiGestionali`).
|
||||
- **Registro cronologico** stampa il registro delle dichiarazioni.
|
||||
|
||||
La dichiarazione è collegata alla scheda fiscale del cliente ([Anagrafiche](Anagrafiche)).
|
||||
1. Scegli il trimestre e confronta l'elenco con quello che l'Agenzia delle Entrate mette a disposizione nell'area
|
||||
riservata.
|
||||
2. **Metti in F24** (serve `vat.settlement.confirm`) aggiunge la riga del bollo al prospetto F24 della scadenza. Se
|
||||
il bollo del trimestre cambia (una fattura in più), premilo di nuovo: finché non è pagata la riga si aggiorna.
|
||||
3. **Dati F24** scarica i dati dell'F24 di quella scadenza; il pagamento si registra dal
|
||||
[Prospetto F24](#prospetto-f24-e-pagamento).
|
||||
|
||||
## Permessi e licenza
|
||||
|
||||
- Registri, liquidazione, F24, LIPE, ritenute: modulo **ACCT**.
|
||||
- Bollo virtuale e dichiarazioni d'intento: compaiono nel menu Fatturazione elettronica e la specifica li elenca sia
|
||||
in ACCT sia in EINV; l'abbinamento definitivo sarà fissato in sviluppo.
|
||||
- `vat.settlement.confirm` è richiesto per confermare la liquidazione; gli altri codici in testa sono indicativi
|
||||
(convenzione `modulo.entità.azione`, SPEC §7.2).
|
||||
Tutto è nel modulo **ACCT**.
|
||||
|
||||
| Permesso | Cosa consente |
|
||||
|---|---|
|
||||
| `vat.register.read` | vedere i registri IVA e farne la stampa di prova |
|
||||
| `vat.settlement.read` | calcolare e vedere le liquidazioni, ritenute, bollo, prospetto F24; scaricare LIPE, dati F24 e CU |
|
||||
| `vat.settlement.confirm` | confermare e riaprire le liquidazioni, registrare acconto, pagamenti delle fatture, pagamenti F24, bollo in F24, stampa definitiva dei registri |
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
**Ho trovato un errore in un periodo già liquidato.** Il periodo è bloccato: un utente con il permesso di
|
||||
riapertura sblocca il periodo, si corregge, si ricalcola e si conferma di nuovo. Se l'F24 è già stato versato, la
|
||||
differenza va gestita nella liquidazione successiva o con ravvedimento (fuori da Khaemhat).
|
||||
|
||||
**Khaemhat invia l'F24?** No. Prepara dati e stampe; l'invio è dell'intermediario o dell'home banking.
|
||||
|
||||
**Dove imposto la periodicità IVA e il pro-rata?** Nel profilo azienda ([Tabelle azienda](Tabelle-azienda)).
|
||||
- **"Conferma prima la liquidazione del periodo precedente".** Un mese (o trimestre) precedente è calcolato ma non
|
||||
confermato: confermalo prima. Il credito e il debito si riportano solo da una liquidazione confermata.
|
||||
- **Ho trovato un errore in un periodo già liquidato.** Riapri la liquidazione (e prima quelle successive, se
|
||||
confermate), correggi il documento, ricalcola e conferma di nuovo. Se l'F24 è già pagato, annulla prima il
|
||||
pagamento; se l'hai davvero versato, la differenza va gestita nella liquidazione successiva o con il ravvedimento,
|
||||
fuori da Khaemhat.
|
||||
- **Il pulsante Comunicazione LIPE è spento.** Il trimestre non è finito o la liquidazione del suo ultimo mese non è
|
||||
confermata.
|
||||
- **La ritenuta non compare nel prospetto F24.** È *In attesa del pagamento*: registra **Fattura pagata**. La ritenuta
|
||||
va nella scadenza del 16 del mese dopo il pagamento.
|
||||
- **La stampa definitiva del registro è rifiutata.** Deve partire dal giorno dopo l'ultima stampa definitiva: la
|
||||
striscia del registro mostra quale.
|
||||
- **Khaemhat invia F24, LIPE o CU?** No: prepara i dati e i file; l'invio è dell'home banking, dei servizi
|
||||
dell'Agenzia delle Entrate o dell'intermediario.
|
||||
- **Dove imposto periodicità e pro rata?** Nel profilo azienda, in [Tabelle azienda](Tabelle-azienda).
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
[Contabilità](Contabilita) · [Fatturazione elettronica](Fatturazione-elettronica) · [Vendite](Vendite) ·
|
||||
[Acquisti](Acquisti) · [Intrastat](Intrastat) · [Scadenzario](Scadenzario) · [Fiscalità italiana](Fiscalita-italiana) ·
|
||||
[Automazioni](Automazioni) · [Report](Report)
|
||||
[Contabilità](Contabilita) · [Fiscalità italiana](Fiscalita-italiana) · [Vendite](Vendite) · [Acquisti](Acquisti) ·
|
||||
[Scadenzario](Scadenzario) · [Fatturazione elettronica](Fatturazione-elettronica) · [Tabelle azienda](Tabelle-azienda) ·
|
||||
[Glossario](Glossario)
|
||||
@@ -1,6 +1,6 @@
|
||||
# Import/Export
|
||||
|
||||
> **Stato:** completa per M4 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.4.0 (scrittura di giacenze iniziali in M6, piano dei conti in M7; saldi e partite di apertura in M7 e M9)
|
||||
> **Stato:** completa per M4 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.4.0 (giacenze iniziali dalla 0.6.0, piano dei conti dalla 0.7.0; saldi e partite di apertura più avanti)
|
||||
> **Modulo di licenza:** CORE (piano dei conti: ACCT) · **Livello richiesto:** amministratore, oppure permesso di scrittura o di export dell'entità · **Specifica:** SPEC §11.7, §12.12 · **Decisione:** ADR 0031
|
||||
|
||||
## A cosa serve
|
||||
@@ -94,13 +94,16 @@ obbligatoria. Unità alternative, codici alternativi, fornitori e sostitutivi re
|
||||
netto), non entrambi. Stesso articolo, listino o cliente e data: il prezzo si sostituisce; una data nuova aggiunge
|
||||
un prezzo che vale da quel giorno, come nella griglia dei listini. Le righe senza errori si scrivono tutte insieme.
|
||||
|
||||
### Giacenze iniziali (solo verifica fino a M6)
|
||||
### Giacenze iniziali
|
||||
|
||||
`articolo`\*, `deposito` (vuoto: il deposito dell'articolo), `quantita`\* (maggiore di zero), `costo_unitario`.
|
||||
L'articolo deve essere merce gestita a magazzino. Il controllo serve a preparare il file: la scrittura del movimento
|
||||
di apertura arriva con il [Magazzino](Magazzino).
|
||||
`articolo`\*, `deposito` (vuoto: il deposito dell'articolo, poi quello predefinito), `quantita`\* (maggiore di zero),
|
||||
`costo_unitario` (vuoto: costo medio, standard o ultimo costo dell'articolo). L'articolo deve essere merce gestita a
|
||||
magazzino e non può comparire due volte nello stesso deposito. Dalla 0.6.0 l'import scrive **un movimento di
|
||||
magazzino per deposito** con la causale `APE` (esistenza iniziale) alla data dell'import e lo conferma: giacenze e
|
||||
costo medio partono da lì (vedi [Magazzino](Magazzino#esistenze-iniziali)). Se la causale `APE` manca, le righe sono
|
||||
saltate con un messaggio: aggiungila con *Aggiorna da tabelle base*.
|
||||
|
||||
### Piano dei conti (solo verifica fino a M7)
|
||||
### Piano dei conti
|
||||
|
||||
Vedi il tracciato più sotto.
|
||||
|
||||
@@ -113,7 +116,7 @@ Vedi il tracciato più sotto.
|
||||
|
||||
| Opzione | Valori | Entità |
|
||||
|---|---|---|
|
||||
| **Se il codice esiste** | *Aggiorna* (le celle piene cambiano il record, le vuote lasciano ciò che c'è) oppure *Salta la riga* (avviso) | clienti, fornitori, articoli, prezzi |
|
||||
| **Se il codice esiste** | *Aggiorna* (le celle piene cambiano il record, le vuote lasciano ciò che c'è) oppure *Salta la riga* (avviso) | clienti, fornitori, articoli, prezzi, piano dei conti |
|
||||
| **Codice mancante** | *Genera automatico* con le regole dei codici automatici (vedi [Tabelle azienda](Tabelle-azienda)) oppure *Errore sulla riga* | clienti, fornitori, articoli |
|
||||
| **Verifica P.IVA su VIES (UE)** | controlla su VIES le partite IVA dei soggetti UE durante l'import (più lento) | clienti, fornitori |
|
||||
| **Completa comune da CAP** | completa comune e provincia da un CAP con un solo comune, o il CAP da un comune con un solo CAP (avviso) | clienti, fornitori |
|
||||
@@ -158,8 +161,10 @@ farla sull'azienda reale.
|
||||
## Tracciato del piano dei conti
|
||||
|
||||
In Italia non esiste uno standard per lo scambio del piano dei conti, perciò Khaemhat definisce il proprio
|
||||
tracciato. Il piano standard per PMI sarà **precaricato** con la contabilità (M7); l'importazione serve a chi vuole
|
||||
usare il piano del proprio commercialista o del gestionale precedente. Fino a M7 il file si **verifica** soltanto.
|
||||
tracciato. Il piano standard per PMI è **precaricato** con la contabilità (dalla 0.7, vedi [Contabilità](Contabilita));
|
||||
l'importazione serve a chi vuole usare il piano del proprio commercialista o del gestionale precedente. I conti nuovi
|
||||
si aggiungono; quelli che esistono si aggiornano se l'opzione **Se il codice esiste** è *Aggiorna*, altrimenti si
|
||||
saltano. Lo stesso tracciato si usa per esportare il piano dell'azienda.
|
||||
|
||||
### CSV e XLSX
|
||||
|
||||
@@ -210,7 +215,8 @@ Per lo scambio **completo** fra installazioni Khaemhat:
|
||||
```
|
||||
|
||||
`accounts` ha le stesse colonne del CSV. Voci di bilancio (`statementLines`), causali (`journalTemplates`) e
|
||||
mappature (`mappings`) si contano già nella mappatura e si importano con la contabilità (M7).
|
||||
mappature (`mappings`) si contano nella mappatura ma non si importano ancora: le causali si gestiscono in
|
||||
*Contabilità → Causali*.
|
||||
|
||||
### Controlli
|
||||
|
||||
@@ -231,8 +237,8 @@ Il riquadro **Esporta e modelli** usa l'entità scelta in alto:
|
||||
(nome `clienti-2026-11-12.csv`). I codici delle tabelle sono esportati come codici.
|
||||
|
||||
L'export richiede il flag utente **Può esportare dati** e il permesso di export dell'entità (per le anagrafiche
|
||||
*Esportare anagrafiche*) (vedi [Utenti e permessi](Utenti-e-permessi)). Giacenze e piano dei conti hanno per ora solo
|
||||
il modello. Le griglie esportano anche dal proprio menu (CSV/XLSX).
|
||||
*Esportare anagrafiche*) (vedi [Utenti e permessi](Utenti-e-permessi)). Le giacenze hanno per ora solo il
|
||||
modello; il piano dei conti si esporta per intero. Le griglie esportano anche dal proprio menu (CSV/XLSX).
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
|
||||
@@ -55,6 +55,20 @@ Khaemhat invia e-mail (inviti, recupero password, documenti, report, avvisi) tra
|
||||
I valori iniziali possono arrivare dalle variabili `KHAEMHAT_SMTP_HOST`, `_PORT`, `_USER`, `_PASSWORD`, `_FROM`,
|
||||
`_SECURITY`; quelli salvati qui li sovrascrivono.
|
||||
|
||||
> **In 0.5.0** la pagina *Impostazioni* non c'è ancora (arriva con M12): il server SMTP si configura **solo con le
|
||||
> variabili d'ambiente** e serve all'invio dei documenti per e-mail (vedi [Vendite](Vendite#invio-per-e-mail)).
|
||||
>
|
||||
> | Variabile | Valore |
|
||||
> |---|---|
|
||||
> | `KHAEMHAT_SMTP_HOST` | nome del server; senza, l'invio è spento |
|
||||
> | `KHAEMHAT_SMTP_FROM` | indirizzo del mittente (solo l'indirizzo, ad esempio `ufficio@azienda.it`); obbligatorio insieme all'host |
|
||||
> | `KHAEMHAT_SMTP_SECURITY` | `STARTTLS` (predefinito), `SSL` (o `TLS`, connessione cifrata dall'inizio) oppure `NONE` (solo su reti fidate) |
|
||||
> | `KHAEMHAT_SMTP_PORT` | predefinita 587, oppure 465 con `SSL` |
|
||||
> | `KHAEMHAT_SMTP_USER`, `KHAEMHAT_SMTP_PASSWORD` | credenziali, se il server le chiede (AUTH PLAIN o LOGIN); la password anche come `KHAEMHAT_SMTP_PASSWORD_FILE` |
|
||||
>
|
||||
> Il client SMTP è scritto in Khaemhat, senza librerie esterne: un messaggio per connessione, tre tentativi, l'esito
|
||||
> nel [Log](Log), sezione *E-mail / PEC*.
|
||||
|
||||
**Prova:** premi **Invia e-mail di prova** dopo aver salvato: arriva un messaggio all'indirizzo indicato. L'esito
|
||||
compare anche in [Stato sistema](Stato-sistema) (controllo *SMTP*) e nel [Log](Log), sezione *E-mail / PEC*.
|
||||
|
||||
|
||||
@@ -59,7 +59,7 @@ Ogni modulo scrive nella **propria sezione**. Il pannello a sinistra le elenca c
|
||||
| **Autenticazione** | accessi, errori di password, blocchi, 2FA, nuovi dispositivi |
|
||||
| **Database** | connessioni, manutenzione |
|
||||
| **Migrazioni** | migrazioni applicate e loro esito |
|
||||
| **Documenti** | creazione, emissione, annullamento di documenti |
|
||||
| **Documenti** | conferma ed emissione con il numero assegnato, chiusura, riapertura, annullamento, eliminazione delle bozze (da 0.5.0) |
|
||||
| **Contabilità** | registrazioni, liquidazioni, chiusure |
|
||||
| **Magazzino** | movimenti, ricostruzioni |
|
||||
| **SDI / e-invoicing** | generazione XML, invii, notifiche, scarti |
|
||||
@@ -68,7 +68,7 @@ Ogni modulo scrive nella **propria sezione**. Il pannello a sinistra le elenca c
|
||||
| **Attività programmate** | inizio, fine, durata, esito di ogni esecuzione |
|
||||
| **Backup** | backup, copie remote, verifiche, ripristini |
|
||||
| **API / MCP** | chiamate API e strumenti MCP |
|
||||
| **E-mail / PEC** | invii e letture di posta |
|
||||
| **E-mail / PEC** | invii e letture di posta: da 0.5.0 ogni messaggio messo in coda, inviato, ritentato o fallito, con la risposta del server SMTP |
|
||||
| **Integrazioni** | VIES, cambi BCE, intermediari SDI |
|
||||
| **UI / circuiti** | errori dell'interfaccia con lo stack completo |
|
||||
| **Prestazioni** | query oltre 500 ms, richieste lente, garbage collection |
|
||||
|
||||
@@ -1,148 +1,194 @@
|
||||
# Magazzino
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-10 · **Versione software:** non ancora rilasciata (milestone M6)
|
||||
> **Modulo di licenza:** CORE · **Permessi principali:** `inventory.entry.post`, `items.cost.read`, famiglia `inventory.*` · **Specifica:** SPEC §11.6, §22
|
||||
> **Stato:** completa per la versione 0.6 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.6.0 (M6)
|
||||
> **Modulo di licenza:** CORE · **Permessi principali:** `inventory.stock.read` (giacenze), `inventory.entry.*` (movimenti, inventario), `inventory.entry.post` (conferma, rettifiche, ricostruzione), `items.cost.read` (costi e valori) · **Specifica:** SPEC §11.6, ADR 0035
|
||||
|
||||
Il **magazzino** tiene la quantità e il valore di ogni articolo in ogni **deposito**. Le giacenze si aggiornano da
|
||||
sole con i documenti (DDT, fatture accompagnatorie, carichi, resi) e con i movimenti manuali; da qui si fanno
|
||||
trasferimenti tra depositi, inventari fisici, la proposta di riordino e la valorizzazione.
|
||||
sole quando confermi un documento che muove la merce (DDT, fatture accompagnatorie, carichi dai fornitori, resi,
|
||||
movimenti manuali); da qui consulti giacenze e movimenti, fai l'**inventario fisico**, generi la **proposta di
|
||||
riordino** e calcoli la **valorizzazione** a una data.
|
||||
|
||||
> **In questa versione** ci sono giacenze per deposito, impegnato e ordinato, costo medio ponderato, movimenti per
|
||||
> articolo, movimenti manuali e trasferimenti, inventario fisico con import dei conteggi, proposta di riordino,
|
||||
> valorizzazione con analisi ABC e ricostruzione. Arrivano più avanti: le **scritture contabili** delle rimanenze e il
|
||||
> **libro inventari** con la chiusura dell'esercizio (M10), i report di magazzino stampabili (M13), FIFO e LIFO a lotti (dopo la 1.0).
|
||||
|
||||
## Dove si trova
|
||||
|
||||
Menu **Magazzino** → *Giacenze*, *Movimenti*, *Inventario fisico*, *Sottoscorta* (proposta di riordino),
|
||||
*Trasferimenti*. I depositi e le causali di magazzino sono in [Tabelle azienda](Tabelle-azienda).
|
||||
Menu **Magazzino** → *Giacenze*, *Movimenti*, *Inventario*, *Proposte di riordino*. I **depositi** e le **causali
|
||||
di magazzino** sono in [Tabelle azienda](Tabelle-azienda); scorta minima, punto e lotto di riordino e fornitori
|
||||
abituali sono nella scheda dell'articolo (vedi [Articoli e listini](Articoli-e-listini)).
|
||||
|
||||
## Le quattro quantità
|
||||
## Le quantità
|
||||
|
||||
| Quantità | Significato | Da dove nasce |
|
||||
|---|---|---|
|
||||
| **Giacenza** | merce fisicamente presente nel deposito | carichi e scarichi confermati |
|
||||
| **Impegnato** | merce riservata a ordini clienti confermati e non ancora evasi | ordini clienti, trasferimenti in bozza |
|
||||
| **Ordinato** | merce in arrivo dai fornitori | ordini fornitore confermati e non ancora ricevuti |
|
||||
| **Disponibile** | **giacenza - impegnato** | calcolata |
|
||||
| **Giacenza** | merce presente nel deposito | movimenti dei documenti confermati |
|
||||
| **Impegnato** | merce riservata a ordini clienti confermati e non ancora evasi | residuo degli ordini clienti |
|
||||
| **Ordinato** | merce in arrivo dai fornitori | residuo degli ordini fornitore confermati |
|
||||
| **Disponibile** | giacenza meno impegnato | calcolata |
|
||||
|
||||
Il sistema registra anche la merce **in transito** e il **valore medio** per articolo e deposito. Tutte queste
|
||||
quantità sono aggiornate **nella stessa transazione** del documento che le muove: non c'è mai un momento in cui il
|
||||
documento è confermato e la giacenza no.
|
||||
Tutte si aggiornano **nella stessa operazione** che conferma il documento: non c'è mai un momento in cui il documento
|
||||
è confermato e la giacenza no. Se annulli il documento, i suoi movimenti spariscono e le quantità tornano come prima.
|
||||
|
||||
## Quali documenti muovono il magazzino
|
||||
|
||||
Ogni tipo documento ha una **causale di magazzino** (in *Tabelle azienda → Tipi documento*) che decide se carica,
|
||||
scarica o trasferisce. Con i tipi di base:
|
||||
|
||||
| Documento | Causale | Effetto |
|
||||
|---|---|---|
|
||||
| DDT, fattura immediata, fattura accompagnatoria | `SCA` scarico per vendita | scarica al costo medio |
|
||||
| DDT fornitore (carico), fattura fornitore | `CAR` carico da acquisto | carica e aggiorna il costo medio |
|
||||
| Nota di credito fornitore | `RESF` reso a fornitore | scarica |
|
||||
| Movimento di magazzino (`MM`) | quella scelta nel movimento | carico, scarico o trasferimento |
|
||||
| Ordini clienti e fornitori, preventivi, fatture differite | nessuna | solo impegnato e ordinato |
|
||||
|
||||
Una fattura nata da un DDT **non muove di nuovo** la merce: le sue righe trovano il carico o lo scarico già fatto
|
||||
dal DDT. Il prezzo della fattura fornitore però **corregge il costo** del carico: se il fornitore fattura a un prezzo
|
||||
diverso da quello del DDT, il costo medio viene ricalcolato con il prezzo fatturato.
|
||||
|
||||
Le causali di base sono: `CAR` carico da acquisto, `SCA` scarico per vendita, `RESC` reso da cliente, `RESF` reso a
|
||||
fornitore, `TRA` trasferimento tra depositi, `INVP` e `INVN` rettifiche inventariali, `CVU` e `CVR` uscita e rientro
|
||||
in conto visione (solo quantità), `OMA` omaggio, `AUTO` autoconsumo, `APE` esistenza iniziale. Per un'azienda creata
|
||||
con una versione precedente le causali e i tipi documento mancanti si aggiungono con **Aggiorna da tabelle base** nel
|
||||
menu `…` della tabella (vedi [Tabelle azienda](Tabelle-azienda)) o, per tutte le tabelle, con `scripts/seed.sh --base`.
|
||||
|
||||
## Giacenze e disponibilità
|
||||
|
||||

|
||||
*Mockup 036 — striscia di indicatori (valore magazzino, articoli gestiti, sottoscorta, sotto riordino, in arrivo) e griglia giacenze con stato (anteprima ridotta).*
|
||||

|
||||
|
||||
In alto una **striscia di indicatori**: valore del magazzino, articoli gestiti, articoli **sottoscorta**, articoli
|
||||
**sotto il punto di riordino**, valore **in arrivo** (ordinato).
|
||||
In alto la striscia degli indicatori: **articoli in giacenza**, **sottoscorta**, **esauriti**, **articoli in
|
||||
arrivo** (con ordini fornitore aperti) e **valore di magazzino** (visibile solo con `items.cost.read`).
|
||||
|
||||
La griglia mostra per ogni articolo: categoria, UM, **giacenza**, **impegnato**, **ordinato**, **disponibile**,
|
||||
**scorta minima**, **punto di riordino**, **costo medio**, **valore** e uno **stato**:
|
||||
Sotto, il filtro **Deposito** (tutti o uno solo) e la casella **Anche gli articoli senza giacenza**; poi il radar
|
||||
con ricerca per codice o descrizione e i filtri rapidi **Categoria** e **Stato**. Per ogni articolo: categoria, unità,
|
||||
giacenza, impegnato, ordinato, disponibile, scorta minima, costo medio, valore e uno **stato**:
|
||||
|
||||
| Stato | Quando |
|
||||
|---|---|
|
||||
| *OK* | disponibilità sopra il punto di riordino |
|
||||
| *Sotto riordino* | disponibilità sotto il punto di riordino |
|
||||
| *Sottoscorta* | disponibilità sotto la scorta minima (riga evidenziata) |
|
||||
| *Esaurito · in arrivo* | giacenza a zero con ordini fornitore aperti |
|
||||
| *Disponibile* | il disponibile più l'ordinato supera il punto di riordino |
|
||||
| *Da riordinare* | disponibile più ordinato pari o sotto il punto di riordino |
|
||||
| *Sottoscorta* | disponibile sotto la scorta minima |
|
||||
| *Esaurito* | disponibile sotto zero, o a zero per un articolo con scorta minima o punto di riordino |
|
||||
|
||||
Filtri: ricerca (articolo, EAN, descrizione), **Deposito**, **Categoria**, **Mostra** (*Solo gestiti a magazzino*),
|
||||
chip *Evidenzia sottoscorta*. Azioni: **Proposta di riordino**, **Inventario**. Il dettaglio per deposito di un
|
||||
singolo articolo è anche nella scheda articolo (vedi [Articoli e listini](Articoli-e-listini)).
|
||||
Le colonne *Ultimo carico* e *Ultimo scarico* si aggiungono dal selettore delle colonne del radar. I pulsanti
|
||||
portano alla **proposta di riordino** e all'**inventario**, aprono la **valorizzazione** e la **ricostruzione**.
|
||||
|
||||
## Movimenti e trasferimenti
|
||||
## Movimenti di un articolo
|
||||
|
||||

|
||||
*Mockup 037 — trasferimento in bozza dal deposito SEDE al deposito furgone, con disponibilità all'origine e valore (anteprima ridotta).*
|
||||

|
||||
|
||||
I **movimenti manuali** servono per tutto ciò che non passa da un documento di vendita o acquisto: carichi e scarichi
|
||||
rettificativi, omaggi interni, consumi, **trasferimenti** tra depositi. Ogni movimento ha una **causale di
|
||||
magazzino** che ne stabilisce l'effetto (carico, scarico, trasferimento).
|
||||
Apri una riga delle giacenze (doppio clic o **Invio**) per vedere i movimenti dell'articolo in ordine di data: il
|
||||
documento che li ha generati (il link lo apre), la causale, il cliente o fornitore, il deposito, la quantità, il
|
||||
costo unitario e il **saldo progressivo**. **Apri l'articolo** porta alla scheda. Il widget *Sottoscorta* della
|
||||
[Dashboard](Dashboard) apre direttamente questa finestra sull'articolo scelto.
|
||||
|
||||
Per un trasferimento:
|
||||
## Movimenti manuali e trasferimenti
|
||||
|
||||
1. **Magazzino → Trasferimenti** (o *Movimenti*), **Nuovo**.
|
||||
2. Scegli la causale di trasferimento, il **deposito di origine** e quello di **destinazione**.
|
||||
3. Inserisci le righe: la colonna *Disp. origine* mostra quanto è disponibile nel deposito di partenza.
|
||||
4. Se serve, **Stampa lista prelievo** per chi prepara la merce.
|
||||
5. **Conferma**.
|
||||
Per tutto ciò che non passa da un documento di vendita o acquisto (rettifiche, omaggi, autoconsumi, conto visione,
|
||||
trasferimenti) usa **Magazzino → Movimenti** e crea un **Movimento di magazzino**: è un documento come gli altri
|
||||
(vedi [Vendite](Vendite) per la maschera), con in più la **causale** e il **deposito**.
|
||||
|
||||
Un trasferimento genera **due movimenti collegati** (scarico dall'origine e carico nella destinazione) nella stessa
|
||||
transazione. Finché il movimento è in bozza la merce dell'origine risulta **impegnata**.
|
||||
1. Scegli la **causale**: decide se il movimento carica, scarica o trasferisce.
|
||||
2. Indica il **deposito**; per un trasferimento anche il **deposito di destinazione**, diverso dall'origine.
|
||||
3. Inserisci le righe con articolo e quantità; nei carichi il prezzo è il costo unitario.
|
||||
4. **Conferma**: il magazzino si aggiorna. Un trasferimento scarica l'origine e carica la destinazione al costo medio,
|
||||
senza cambiare il valore complessivo.
|
||||
|
||||
Un movimento confermato si può annullare: i suoi movimenti vengono tolti e le giacenze ricalcolate.
|
||||
|
||||
## Inventario fisico
|
||||
|
||||

|
||||
*Mockup 038 — inventario guidato in cinque passi, griglia con giacenza teorica, contato, differenza, valore e rettifica (anteprima ridotta).*
|
||||

|
||||
|
||||
L'inventario è una procedura guidata:
|
||||
L'inventario confronta la merce contata con la **giacenza contabile** e trasforma le differenze in rettifiche.
|
||||
|
||||
1. **Preparazione**: scegli il **deposito**, la **data** e il criterio di **valorizzazione** (es. costo medio);
|
||||
l'opzione **Blocca movimenti durante il conteggio** congela le giacenze del deposito.
|
||||
2. **Conteggio**: **Stampa liste di conteggio** (anche per ubicazione e squadra) e inserisci i quantitativi contati
|
||||
nella griglia oppure **Importa conteggi CSV**.
|
||||
3. **Verifica differenze**: la griglia confronta **giacenza teorica** e **contato** e mostra differenza e valore;
|
||||
il filtro *Solo differenze e da contare* aiuta a chiudere il lavoro.
|
||||
4. **Rettifiche**: **Genera rettifiche** crea i movimenti di carico o scarico per allineare la giacenza al contato.
|
||||
5. **Chiusura**: sblocca il deposito.
|
||||
1. **Apertura**: in **Magazzino → Inventario** scegli il **deposito**, la **data del conteggio**, se vuoi una
|
||||
**categoria** e una descrizione, poi **Apri inventario**. Khaemhat fotografa la giacenza contabile di ogni articolo
|
||||
gestito a magazzino a quella data.
|
||||
2. **Conteggio**: scrivi le quantità contate nella colonna *Contato* e premi **Salva conteggi**, oppure **Importa
|
||||
conteggi** da un file CSV o di testo del lettore di codici a barre: una riga per articolo con *codice articolo* e
|
||||
*quantità*, separati da punto e virgola, tabulazione o virgola (con la virgola la quantità usa il punto decimale).
|
||||
Una riga di intestazione viene saltata; i codici non in lista sono segnalati.
|
||||
3. **Verifica differenze**: il filtro **Mostra** (*Tutti*, *Da contare*, *Con differenze*) aiuta a chiudere il
|
||||
lavoro; le righe con differenza sono evidenziate e la striscia in alto riassume articoli contati, differenze e
|
||||
valore delle differenze.
|
||||
4. **Registrazione**: **Registra rettifiche** crea alla data del conteggio un movimento `INVP` per le eccedenze e uno
|
||||
`INVN` per gli ammanchi, e chiude l'inventario. Gli articoli **non contati restano come sono**.
|
||||
|
||||
**Annulla inventario** lo chiude senza muovere il magazzino; i conteggi restano consultabili. I movimenti successivi
|
||||
alla data del conteggio non disturbano: le rettifiche sono alla data del conteggio e la giacenza di oggi tiene conto
|
||||
di entrambi.
|
||||
|
||||
## Proposta di riordino
|
||||
|
||||

|
||||
*Mockup 039 — proposta di riordino: indicatori, criterio di calcolo, quantità proposta modificabile e fornitore per riga (anteprima ridotta).*
|
||||

|
||||
|
||||
La proposta elenca gli articoli sotto il punto di riordino con giacenza, impegnato, ordinato, disponibile, scorta
|
||||
minima, punto e **lotto** di riordino, **quantità proposta** (modificabile), **fornitore** abituale, lead time,
|
||||
prezzo e valore. In alto gli indicatori: articoli sotto riordino, proposte, valore, fornitori coinvolti, articoli
|
||||
già coperti da ordini.
|
||||
La proposta elenca gli articoli il cui **disponibile più ordinato** non copre più il **punto di riordino** (o, se manca,
|
||||
la **scorta minima**). Per ogni articolo propone:
|
||||
|
||||
1. Scegli **deposito**, **fornitore** (o tutti) e il **criterio di calcolo** (es. *disponibile + ordinato < punto
|
||||
di riordino*, con o senza l'impegnato).
|
||||
2. **Ricalcola**, controlla e correggi le quantità proposte, togli la spunta alle righe da non ordinare.
|
||||
3. **Genera ordini fornitore**: Khaemhat crea **un ordine in bozza per fornitore** (vedi [Acquisti](Acquisti)).
|
||||
- la **quantità**: il **lotto di riordino** dell'articolo se c'è, altrimenti quanto riporta al punto di riordino (o
|
||||
alla scorta minima); mai meno del **minimo d'ordine** del fornitore;
|
||||
- il **fornitore abituale** (il preferito nella scheda articolo, *Fornitori*) con il suo prezzo e la **data di arrivo
|
||||
prevista** dal lead time.
|
||||
|
||||
Il mockup indica come fabbisogno il maggiore tra il lotto e la differenza fra punto di riordino e disponibile più
|
||||
ordinato; la formula definitiva (compresi gli arrotondamenti al lotto) sarà fissata in sviluppo. La proposta può
|
||||
anche essere eseguita da una procedura pianificata o alimentata da una regola di automazione (evento *articolo sotto
|
||||
il punto di riordino*, vedi [Automazioni](Automazioni)).
|
||||
Correggi le quantità, cambia il fornitore di una riga o togli la spunta alle righe da non ordinare; **Ricalcola**
|
||||
rilegge le giacenze. **Genera ordini fornitore** crea **un ordine in bozza per fornitore** con prezzi e condizioni del
|
||||
fornitore: controllali e confermali da **Acquisti → Ordini fornitori** (vedi [Acquisti](Acquisti)). Le righe senza
|
||||
fornitore non vengono ordinate.
|
||||
|
||||
## Costo medio e valorizzazione
|
||||
|
||||
- Il criterio di valorizzazione è il **costo medio ponderato**: a ogni carico il nuovo costo medio è
|
||||
(valore della giacenza esistente + valore del carico) / (giacenza esistente + quantità caricata). FIFO e LIFO sono
|
||||
predisposti ma non attivi.
|
||||
- Il **valore** di una giacenza è quantità x costo medio.
|
||||
- La **valorizzazione a data** ricostruisce quantità e valore a una data passata (ad esempio al 31 dicembre).
|
||||
- Le **rimanenze finali** valorizzate alimentano la chiusura dell'esercizio e il **libro inventari** (vedi
|
||||
[Contabilità](Contabilita)); sono disponibili le **scritture ausiliarie di magazzino** e l'**analisi ABC**.
|
||||

|
||||
|
||||
- Il criterio è il **costo medio ponderato** per articolo, su tutti i depositi: a ogni carico con valore il nuovo
|
||||
costo medio è (valore della giacenza + valore del carico) / (giacenza + quantità caricata). Scarichi, trasferimenti
|
||||
e conto visione escono al costo medio del momento e non lo cambiano.
|
||||
- La scheda articolo mostra **costo medio** e **ultimo costo** calcolati dai movimenti.
|
||||
- La **valorizzazione** (pulsante nelle giacenze) calcola quantità e valore **a una data** qualsiasi, anche passata,
|
||||
con il criterio scelto: *costo medio ponderato*, *ultimo costo* o *costo standard*. Divide gli articoli in **classi
|
||||
ABC**: A gli articoli che fanno l'80% del valore, B fino al 95%, C il resto.
|
||||
- FIFO e LIFO sono previsti con la gestione a lotti; le rimanenze alimenteranno la chiusura dell'esercizio e il libro
|
||||
inventari con la chiusura dell'esercizio (M10).
|
||||
|
||||
## Ricostruzione
|
||||
|
||||
Se le giacenze risultassero non allineate (ad esempio dopo un ripristino o un import), la **ricostruzione** ricalcola
|
||||
giacenze, impegnato, ordinato e costi medi ripercorrendo tutti i movimenti. È una procedura eseguibile a mano o da
|
||||
attività programmata e non modifica i documenti. Vedi [Automazioni](Automazioni) e
|
||||
[Attività programmate](Attivita-programmate).
|
||||
Se le giacenze sembrano non tornare (dopo un ripristino, un import diretto nel database, un cambio di causale su un
|
||||
tipo documento), **Ricostruisci** nelle giacenze riscrive tutti i movimenti dai documenti in vigore, dal più vecchio,
|
||||
e ricalcola giacenze, impegnato, ordinato e costi. I documenti non cambiano e i dati restano consultabili durante il
|
||||
lavoro, che mostra l'avanzamento. Richiede `inventory.entry.post`.
|
||||
|
||||
## Stati dei movimenti
|
||||
La stessa ricostruzione gira ogni **domenica alle 2:15** come attività di sistema *Ricostruzione del magazzino* (vedi
|
||||
[Attività programmate](Attivita-programmate)), su tutte le aziende attive.
|
||||
|
||||
| Stato | Effetto |
|
||||
|---|---|
|
||||
| **Bozza** | nessun effetto sulla giacenza (nei trasferimenti l'origine è impegnata) |
|
||||
| **Confermato** | giacenze aggiornate; righe non più modificabili |
|
||||
| **Annullato** | movimenti stornati |
|
||||
## Esistenze iniziali
|
||||
|
||||
Per partire con le giacenze di un altro gestionale importa il tracciato **Giacenze iniziali** da
|
||||
[Import ed export](Import-Export): articolo, deposito, quantità e costo unitario. Khaemhat crea e conferma un
|
||||
movimento con causale `APE` per deposito, alla data dell'import.
|
||||
|
||||
## Permessi e licenza
|
||||
|
||||
Il magazzino è nel modulo **CORE**. Confermare un movimento richiede `inventory.entry.post`; vedere costi e valori
|
||||
richiede `items.cost.read`.
|
||||
Il magazzino è nel modulo **CORE**. Vedere giacenze e movimenti richiede `inventory.stock.read`; scrivere movimenti
|
||||
e conteggi `inventory.entry.write`; confermare i movimenti, registrare le rettifiche e ricostruire
|
||||
`inventory.entry.post`. Costi, valori e valorizzazione sono visibili solo con `items.cost.read`.
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
- **Il disponibile è negativo.** Gli ordini clienti confermati impegnano più merce di quella in giacenza: ordina al
|
||||
fornitore o rivedi le consegne.
|
||||
- **Il costo medio è cambiato dopo un carico.** È il comportamento previsto del costo medio ponderato; il messaggio
|
||||
sul DDT di carico indica il vecchio e il nuovo valore.
|
||||
- **Durante l'inventario non riesco a scaricare merce dal deposito.** È attivo il blocco dei movimenti: termina la
|
||||
procedura o disattiva il blocco.
|
||||
- **La giacenza è negativa.** È stato confermato uno scarico senza merce a sufficienza (Khaemhat non lo blocca, per
|
||||
non fermare le consegne): registra il carico mancante o fai un inventario.
|
||||
- **Il costo medio è cambiato dopo una fattura fornitore.** Il prezzo fatturato era diverso da quello del DDT di
|
||||
carico: il costo del carico viene corretto con il prezzo della fattura.
|
||||
- **Un articolo non compare nelle giacenze.** Non ha movimenti: spunta *Anche gli articoli senza giacenza*. Se non
|
||||
compare comunque, nella scheda non è *gestito a magazzino* o non è un bene.
|
||||
- **L'articolo non è nella proposta di riordino.** Non ha punto di riordino né scorta minima, oppure l'ordinato già
|
||||
lo copre.
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
[Articoli e listini](Articoli-e-listini) · [Acquisti](Acquisti) · [Vendite](Vendite) ·
|
||||
[Tabelle azienda](Tabelle-azienda) · [Report](Report) · [Contabilità](Contabilita) · [Automazioni](Automazioni)
|
||||
[Tabelle azienda](Tabelle-azienda) · [Import ed export](Import-Export) · [Dashboard](Dashboard) ·
|
||||
[Attività programmate](Attivita-programmate)
|
||||
@@ -30,7 +30,7 @@ volume `/data/files/<azienda>`; nel database c'è la loro scheda (nome, tipo, di
|
||||
| Documenti | `sale_quotations`, `sale_orders`, `sale_documents`, `purchase_orders`, `purchase_documents`, ciascuno con righe, castelletto IVA e rate; `document_links` per l'evasione | [Vendite](Vendite), [Acquisti](Acquisti) |
|
||||
| Magazzino | `inventory_entries` e righe, `item_balances` (giacenza, impegnato, ordinato per articolo e deposito) | [Magazzino](Magazzino) |
|
||||
| Contabilità e IVA | `gl_accounts`, `gl_entries` e righe, `vat_registers`, `vat_settlements` | [Contabilita](Contabilita), [IVA](IVA) |
|
||||
| Scadenzario | `open_items` (partite), `payments` | [Scadenzario](Scadenzario) |
|
||||
| Scadenzario | `gl_open_items` (partite), `payments` e righe, `remittances` e righe, `sdd_mandates`, `bank_statements` e righe, `bank_match_rules`, `dunning_levels`, `dunning_letters` | [Scadenzario](Scadenzario) |
|
||||
| CRM | `crm_leads`, `crm_opportunities`, `crm_activities`, `crm_campaigns`, `crm_tickets` | [CRM](CRM) |
|
||||
| Canali | `sales_channels`, `channel_orders` | [Canali-e-commerce](Canali-e-commerce) |
|
||||
| Utenti e sicurezza | `users`, `roles`, `role_permissions`, `user_sessions`, `api_keys` | [Utenti-e-permessi](Utenti-e-permessi) |
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Primi passi
|
||||
|
||||
> **Stato:** parziale (passi 1-4 completi) · **Ultima revisione:** 2026-11-11 · **Versione software:** 0.2.0 (passi 1-4), passi successivi M3-M5
|
||||
> **Stato:** parziale (passi 1-4, 7, 10 e 12 completi; amministrazione da interfaccia con M12) · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.5.0
|
||||
> **Modulo di licenza:** CORE · **Livello richiesto:** super utente, poi amministratore · **Specifica:** SPEC §5.4, §7, §8, §12, §14
|
||||
|
||||
Questa pagina accompagna chi ha appena installato Khaemhat dal primo avvio del container fino alla prima fattura
|
||||
@@ -57,6 +57,10 @@ disattivata al primo cambio password.
|
||||
*Mockup 001 — pagina di accesso: a sinistra marca e funzioni principali, a destra il modulo con azienda, nome utente,
|
||||
password e l'avviso della modalità Trial (anteprima ridotta).*
|
||||
|
||||

|
||||
|
||||
*La pagina di accesso di Khaemhat 0.5.0.*
|
||||
|
||||
1. Nel campo **Azienda** lascia la prima azienda, già proposta (quella creata dal container, ad esempio
|
||||
*Khaemhat Demo S.r.l.*). Il super utente e gli amministratori possono anche scegliere **Nessuna (account di
|
||||
istanza)** per lavorare solo sulle pagine di amministrazione dell'istanza.
|
||||
@@ -111,6 +115,10 @@ telefono. Non c'è un codice QR, perché generarlo richiederebbe una libreria es
|
||||
*Mockup 002 — verifica in due passaggi: sei caselle per il codice, pulsante Verifica e nota sul codice che cambia
|
||||
ogni 30 secondi (anteprima ridotta).*
|
||||
|
||||

|
||||
|
||||
*La verifica in due passaggi di Khaemhat 0.5.0: il codice dell'app oppure un codice di recupero.*
|
||||
|
||||
Agli accessi successivi, dopo la password, compare la schermata **Verifica in due passaggi**: scrivi le 6 cifre
|
||||
mostrate dall'app e premi **Verifica**. Il codice cambia ogni 30 secondi.
|
||||
|
||||
@@ -275,12 +283,14 @@ Con l'azienda configurata puoi emettere la prima fattura:
|
||||
4. Scegli il cliente: pagamento, listino e agente vengono proposti dalla sua scheda.
|
||||
5. Nella scheda **Righe** aggiungi l'articolo (`F4` apre la ricerca), la quantità e controlla prezzo e IVA.
|
||||
6. Premi **Salva** (`Ctrl+S`): la fattura è in *bozza*.
|
||||
7. Premi **Conferma ed emetti**: la fattura riceve il numero, diventa immutabile e, con il modulo ACCT attivo,
|
||||
viene contabilizzata.
|
||||
8. Dalla toolbar genera il PDF o l'XML FatturaPA: ogni file generato diventa un allegato della fattura.
|
||||
7. Premi **Emetti**: la fattura riceve il numero e diventa immutabile.
|
||||
8. Premi la **stampante** (`Ctrl+P`): l'anteprima di stampa offre il PDF e **Salva come allegato**; dal menu **⋯**
|
||||
**Invia per e-mail** manda il PDF al cliente (serve il server SMTP, vedi [Impostazioni](Impostazioni#e-mail-smtp)).
|
||||
|
||||
La guida completa è in [Vendite](Vendite); l'invio allo SDI richiede il modulo EINV (vedi
|
||||
[Fatturazione elettronica](Fatturazione-elettronica)).
|
||||

|
||||
|
||||
La guida completa è in [Vendite](Vendite). Dalla 0.7 la fattura confermata è già in [Contabilità](Contabilita); l'XML FatturaPA per lo SDI con M9
|
||||
(modulo EINV, vedi [Fatturazione elettronica](Fatturazione-elettronica)).
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@ Il lavoro di dettaglio è nelle issue di Gitea, raggruppate per
|
||||
Finché il prodotto è in sviluppo le versioni restano **0.x**, anche dopo M13: la **1.0.0** sarà pubblicata solo
|
||||
quando verrà deciso esplicitamente.
|
||||
|
||||
**Completate:** M0 (0.0.1), M1 (0.1.0), M2 (0.2.0), M3 (0.3.0), M4 (0.4.0). **In corso:** M5.
|
||||
**Completate:** M0 (0.0.1), M1 (0.1.0), M2 (0.2.0), M3 (0.3.0), M4 (0.4.0), M5 (0.5.0), M6 (0.6.0), M7 (0.7.0), M8 (0.8.0), M9 (0.9.0). **Prossima:** M10.
|
||||
|
||||
| # | Milestone | Contenuto principale | Versione |
|
||||
|---|---|---|---|
|
||||
|
||||
@@ -1,165 +1,312 @@
|
||||
# Scadenzario e tesoreria
|
||||
|
||||
> **Stato:** bozza · **Ultima revisione:** 2026-11-10 · **Versione software:** non ancora rilasciata (milestone M8)
|
||||
> **Modulo di licenza:** FIN · **Permessi principali:** `finance.openitem.read`, `finance.payment.post`, `finance.remittance.write`, `finance.bank.reconcile`, `finance.dunning.send` · **Specifica:** SPEC §11.8
|
||||
> **Stato:** completa per la versione 0.8 · **Ultima revisione:** 2026-11-13 · **Versione software:** 0.8.0 (M8)
|
||||
> **Modulo di licenza:** FIN (con ACCT per le registrazioni) · **Permessi principali:** `finance.schedule.read`/`write`
|
||||
> (scadenzario, distinte, mandati, solleciti, flusso di cassa), `finance.payment.read`/`write` (incassi e pagamenti),
|
||||
> `finance.bank.reconcile` (riconciliazione bancaria) · **Specifica:** SPEC §11.8, ADR 0038
|
||||
|
||||
## A cosa serve
|
||||
Lo **scadenzario** tiene le **partite aperte** di clienti e fornitori, cioè le rate dei documenti ancora da incassare
|
||||
o da pagare. Da qui si registrano **incassi e pagamenti** (con abbuoni, spese e differenze cambio), si preparano le
|
||||
**distinte RiBa, SDD e bonifici SEPA** con il file per l'home banking, si gestiscono gli **insoluti**, si
|
||||
**riconcilia** l'estratto conto della banca, si inviano i **solleciti** con gli interessi di mora e si guarda il
|
||||
**flusso di cassa** dei prossimi mesi. Ogni operazione scrive da sola la sua registrazione in
|
||||
[Contabilità](Contabilita): non serve passare dalla prima nota.
|
||||
|
||||
Lo scadenzario tiene le **partite aperte** di clienti e fornitori (le rate generate dai documenti), registra
|
||||
**incassi e pagamenti** con abbuoni e spese, prepara le **distinte RiBa, SDD e bonifici SEPA**, gestisce gli
|
||||
**insoluti**, **riconcilia** l'estratto conto della banca, invia i **solleciti** e mostra il **flusso di cassa**.
|
||||
Ogni movimento genera da solo la registrazione contabile ([Contabilità](Contabilita)).
|
||||
> **In questa versione** ci sono partite aperte con aging, incassi e pagamenti multipli e parziali, abbuoni, spese e
|
||||
> differenze cambio, storno di un incasso, estratto conto del cliente con gli interessi di mora, distinte RiBa (CBI), SDD core e B2B
|
||||
> (`pain.008`) e bonifici SEPA (`pain.001`) con presentazione, accredito e insoluti, mandati SDD, import
|
||||
> dell'estratto conto CSV, CBI e CAMT.053 con abbinamento automatico e regole, solleciti su tre livelli con
|
||||
> interessi di mora e invio automatico, flusso di cassa a 30-365 giorni e le scadenze sulla Home. Arrivano più
|
||||
> avanti: il **blocco per fido** su ordini e documenti (con le vendite avanzate), il collegamento diretto con la
|
||||
> banca (CBI online, PSD2) e le **stampe** dei report di tesoreria nella sezione [Report](Report) (M12).
|
||||
|
||||
## Dove si trova
|
||||
|
||||
Menu laterale **Scadenzario**: **Partite aperte**, **Incassi**, **Pagamenti**, **Solleciti**, **Distinte RiBa/SDD**,
|
||||
**Riconciliazione bancaria**.
|
||||
Menu laterale **Scadenzario** → *Partite aperte*, *Incassi*, *Pagamenti*, *Solleciti*, *Distinte RiBa/SDD*,
|
||||
*Mandati SDD*, *Riconciliazione bancaria*, *Flusso di cassa*.
|
||||
|
||||
## Schermate
|
||||
Il menu compare solo se la licenza comprende il modulo **FIN** e l'utente ha i permessi (vedi
|
||||
[Licenze e moduli](Licenze-e-moduli) e [Utenti e permessi](Utenti-e-permessi)). Senza ACCT le partite esistono
|
||||
comunque, ma le operazioni che scrivono in contabilità chiedono il modulo.
|
||||
|
||||

|
||||
*Mockup 053 — partite aperte dei clienti con riquadri di aging (non scaduto, 1-30, 31-60, 61-90, oltre 90 giorni), selezione multipla e azioni Registra incasso, Sollecito, Distinta RiBa (anteprima ridotta)*
|
||||
Prima di iniziare servono:
|
||||
|
||||

|
||||
*Mockup 054 — dialogo Registra incasso su due partite: cliente, data, metodo, importo, banca, riferimento CRO, causale INC; abbuono di € 10,00 sulla seconda rata e anteprima della registrazione che verrà generata*
|
||||
- almeno un **conto bancario dell'azienda** in **Tabelle azienda → Banche aziendali** con IBAN, conto contabile e, per le
|
||||
distinte, **codice SIA** (RiBa), **CUC** e **identificativo creditore SEPA** (SDD) — vedi
|
||||
[Tabelle azienda](Tabelle-azienda);
|
||||
- i **metodi di pagamento** con il codice MP della fattura elettronica (MP05 bonifico, MP12 RiBa, MP19-MP21 SDD…);
|
||||
- per RiBa e SDD, le **coordinate bancarie del cliente** nella sua anagrafica ([Anagrafiche](Anagrafiche)).
|
||||
|
||||

|
||||
*Mockup 055 — distinta RiBa con banca di presentazione, date, importo, salvo buon fine e passi guidati; a destra gli effetti con il controllo (OK, IBAN mancante, scaduta da escludere)*
|
||||
## Partite aperte
|
||||
|
||||

|
||||
*Mockup 056 — proposta di invio dei solleciti per cliente con livello, canale e interessi di mora; sotto, la tabella dei tre livelli con giorni, modello, canale e azione*
|
||||

|
||||
*Khaemhat 0.8.0 — partite aperte dei clienti di esempio: i riquadri di aging, i filtri, la selezione per registrare
|
||||
l'incasso e gli stati (parziale, insoluta, scaduta, in distinta con il numero della distinta).*
|
||||
|
||||

|
||||
*Mockup 057 — movimenti dell'estratto conto con stato (abbinato, suggerito, insoluto, da abbinare), abbinamento proposto e confidenza; riquadri con saldo banca, saldo contabile e differenza*
|
||||
Una **partita** è una rata di un documento: controparte, documento, numero della rata, scadenza, metodo, importo,
|
||||
già incassato o pagato, residuo e stato. Le partite nascono dalla registrazione contabile delle fatture e delle note
|
||||
di credito ([Vendite](Vendite), [Acquisti](Acquisti), [Contabilità](Contabilita)) secondo le condizioni di
|
||||
pagamento; si vedono anche nei **partitari**.
|
||||
|
||||
## Partite e stati
|
||||
|
||||
Una **partita** è una rata di un documento: controparte, documento, numero rata, scadenza, importo, pagato, residuo,
|
||||
metodo di pagamento, banca, stato e registrazione collegata. Le partite nascono dalle condizioni di pagamento dei
|
||||
documenti ([Vendite](Vendite), [Acquisti](Acquisti)) o dall'import delle partite di apertura
|
||||
([Import-Export](Import-Export)).
|
||||
In alto cinque **riquadri di aging** sommano il residuo per anzianità: *non scaduto*, *1-30*, *31-60*, *61-90* e
|
||||
*oltre 90 giorni*. I badge accanto al titolo danno il totale aperto e il totale scaduto.
|
||||
|
||||
| Stato | Significato |
|
||||
|---|---|
|
||||
| **Aperta** | non ancora incassata/pagata, non scaduta |
|
||||
| **Parziale** | incassata in parte |
|
||||
| **Aperta** | non ancora incassata o pagata |
|
||||
| **Parziale** | incassata o pagata in parte |
|
||||
| **Chiusa** | saldata |
|
||||
| **Insoluta** | effetto tornato insoluto, riaperta con le spese |
|
||||
| **In distinta** | inserita in una distinta RiBa/SDD presentata |
|
||||
| **Contestata** | esclusa dai solleciti e dalle distinte finché non si risolve |
|
||||
| **Insoluta** | effetto o addebito tornato indietro: la partita è di nuovo da incassare |
|
||||
| **In distinta** | inserita in una distinta RiBa, SDD o bonifici: non si incassa a mano finché resta lì |
|
||||
|
||||
La griglia mostra anche i **giorni** rispetto alla scadenza (positivi se scaduta) e le etichette *Scaduta*,
|
||||
*In scadenza*, *Aperta · split* (fatture in split payment). Il selettore **Clienti / Fornitori** cambia lato.
|
||||
Oltre allo stato la griglia segnala **Scaduta** (in rosso), **In scadenza** entro 7 giorni e **Contestata** (una
|
||||
partita contestata resta fuori da distinte e solleciti). La colonna **Gg** conta i giorni dalla scadenza: positivi
|
||||
se scaduta, negativi se manca ancora tempo.
|
||||
|
||||
**Filtri.** Ricerca per controparte o documento; **Mostra** (*Aperte*, *Scadute*, *Insolute*, *In distinta*,
|
||||
*Contestate*, *Chiuse*, *Tutte*); **Metodo** di pagamento; il selettore **Clienti / Fornitori** cambia lato (dal
|
||||
menu *Pagamenti → Registra pagamento* si arriva direttamente ai fornitori). **Esporta** scarica la griglia in CSV.
|
||||
|
||||

|
||||
*Khaemhat 0.8.0 — Lo stesso elenco sul lato fornitori, con il pulsante Registra pagamento.*
|
||||
|
||||
**Modificare una partita.** La matita apre la scheda della rata: si cambiano **scadenza**, **metodo**, **banca** e
|
||||
**contestazione** (con una nota). L'importo no: si corregge il documento.
|
||||
|
||||
**Estratto conto.** Selezionata una partita, **Estratto conto** mostra per quella controparte le partite aperte con
|
||||
lo scaduto, gli interessi di mora maturati a oggi e gli incassi o pagamenti registrati.
|
||||
|
||||
## Registrare un incasso o un pagamento
|
||||
|
||||
1. In **Partite aperte** seleziona una o più partite dello stesso cliente e premi **Registra incasso**.
|
||||
2. Compila **Data**, **Metodo** (es. bonifico MP05), **Importo**, **Banca azienda**, **Riferimento** (CRO) e
|
||||
**Causale** (INC per gli incassi, PAG per i pagamenti).
|
||||
3. Nella tabella *Partite da chiudere* distribuisci l'importo: per ogni rata **Incassato**, **Abbuono** e
|
||||
**Residuo dopo**.
|
||||
4. Leggi l'anteprima della prima nota che verrà generata (banca in dare, cliente in avere, abbuono sul suo conto).
|
||||

|
||||
*Khaemhat 0.8.0 — Registra incasso su una partita del cliente: data, metodo, banca, riferimento, spese, la tabella
|
||||
delle partite da chiudere e l'anteprima della registrazione.*
|
||||
|
||||
1. In **Partite aperte** seleziona una o più partite della **stessa controparte** (le partite in distinta non si
|
||||
selezionano) e premi **Registra incasso** (o **Registra pagamento** sul lato fornitori).
|
||||
2. Compila **Data**, **Metodo**, **Banca** dell'azienda (o la cassa), **Riferimento** (CRO o TRN), eventuali
|
||||
**Spese** bancarie e **Note**.
|
||||
3. Nella tabella *Partite da chiudere* ogni rata propone tutto il residuo: abbassa l'importo per un incasso
|
||||
**parziale** oppure indica un **abbuono** per chiudere la differenza (es. il cliente arrotonda per difetto).
|
||||
*Residuo dopo* mostra cosa resta aperto.
|
||||
4. Leggi l'anteprima: *Banca (D) / Clienti (A)* per un incasso, *Fornitori (D) / Banca (A)* per un pagamento,
|
||||
con gli abbuoni sul loro conto.
|
||||
5. Premi **Registra e chiudi partite**.
|
||||
|
||||
Regole:
|
||||
Cosa succede:
|
||||
|
||||
- **Abbuoni**: piccola differenza fra dovuto e incassato chiusa come abbuono attivo o passivo.
|
||||
- **Differenze cambio** per le partite in valuta, **spese** bancarie e **storno** dell'incasso sono gestiti nello
|
||||
stesso movimento.
|
||||
- Un pagamento a un professionista rileva la **ritenuta d'acconto** da versare ([IVA](IVA)).
|
||||
- viene scritta la registrazione con causale **INC** (incassi) o **PAG** (pagamenti), collegata al movimento;
|
||||
- gli **abbuoni** vanno su *abbuoni passivi* (concessi al cliente) o *abbuoni attivi* (ottenuti dal fornitore);
|
||||
- le **spese** vanno su *spese bancarie*; per le partite in valuta la **differenza cambio** fra il cambio della
|
||||
fattura e quello dell'incasso va su *utili* o *perdite su cambi*;
|
||||
- le **note di credito** aperte della stessa controparte si possono selezionare insieme alle fatture: riducono
|
||||
l'importo da incassare;
|
||||
- per una fattura di un **professionista** con ritenuta d'acconto, quando la fattura è pagata del tutto la ritenuta
|
||||
diventa **da versare** e compare in *Ritenute e F24* ([IVA](IVA)).
|
||||
|
||||
**Incassi** e **Pagamenti** elencano i movimenti del periodo con controparte, documenti saldati, riferimento, banca,
|
||||
origine (*Manuale*, *Distinta*, *Estratto conto*), importo, abbuoni, spese e la registrazione. La freccia
|
||||
**Annulla** storna il movimento: la registrazione viene annullata e le partite tornano aperte com'erano.
|
||||
|
||||

|
||||
*Khaemhat 0.8.0 — Incassi del periodo con documento saldato, riferimento CRO, banca e registrazione contabile.*
|
||||
|
||||

|
||||
*Khaemhat 0.8.0 — Pagamenti ai fornitori con le spese bancarie e la freccia per annullarli.*
|
||||
|
||||
## Distinte RiBa, SDD e bonifici SEPA
|
||||
|
||||
| Tipo | Uso | File prodotto |
|
||||
|---|---|---|
|
||||
| **RiBa** | incasso di ricevute bancarie dai clienti | file CBI (tracciato standard RiBa) |
|
||||
| **SDD core / B2B** | addebito diretto sul conto del cliente, con **mandati** | `pain.008` |
|
||||
| **Bonifici SEPA** | pagamento dei fornitori | `pain.001` |
|
||||
| MAV / RAV | gestiti come semplici scadenze | — |
|
||||
| **RiBa (CBI)** | incasso delle ricevute bancarie dei clienti | file CBI RiBa a record di 120 caratteri |
|
||||
| **SDD Core** | addebito diretto sul conto di un privato, con mandato | XML SEPA `pain.008.001.08` |
|
||||
| **SDD B2B** | addebito diretto sul conto di un'impresa, con mandato B2B | XML SEPA `pain.008.001.08` |
|
||||
| **Bonifici SEPA** | pagamento dei fornitori | XML SEPA `pain.001.001.09` |
|
||||
|
||||
1. **Distinte RiBa/SDD**, scegli **Tipo**, **Banca di presentazione**, **Data presentazione** e **Scadenze fino al**.
|
||||
2. **Selezione effetti**: Khaemhat propone gli effetti; la colonna **Controllo** segnala *IBAN mancante* o
|
||||
*Scaduta: escludere?*.
|
||||
3. **Controlli**: IBAN, CIN, scadenze.
|
||||
4. **Genera file CBI** (o il file SEPA): il file resta come allegato della distinta.
|
||||
5. **Contabilizza distinta**: effetti attivi presentati in banca, con l'opzione **Salvo buon fine (anticipo)** per gli
|
||||
anticipi s.b.f.
|
||||
6. **Presentazione**: carica il file nell'home banking.
|
||||

|
||||
*Khaemhat 0.8.0 — Nuova distinta: tipo, banca, date, salvo buon fine e i passi; a destra gli effetti candidati con il
|
||||
controllo (qui due effetti scaduti da valutare).*
|
||||
|
||||
**Storico distinte** mostra le distinte precedenti.
|
||||
### Creare una distinta
|
||||
|
||||
### Insoluti
|
||||
1. **Distinte RiBa/SDD → Nuova distinta**: scegli **Tipo**, **Banca di presentazione**, **Data presentazione** e
|
||||
**Scadenze fino al**. Per le RiBa puoi spuntare **Salvo buon fine (anticipo)** se la banca anticipa gli importi.
|
||||
2. A destra compaiono gli effetti candidati (partite con metodo RiBa, SDD o bonifico, non contestate, non già in
|
||||
distinta). La colonna **Controllo** segnala cosa non va: *IBAN mancante* (o ABI/CAB per le RiBa), *mandato mancante* (SDD),
|
||||
*Scaduta: escludere?*. Spunta gli effetti da includere: totale e numero si aggiornano.
|
||||
3. **Crea distinta**: la distinta nasce in **Bozza** con il numero dell'anno (es. 2026/002) e le partite passano
|
||||
*In distinta*.
|
||||
|
||||
Quando un effetto torna insoluto (anche dalla riconciliazione bancaria), la partita viene **riaperta** con le
|
||||
**spese** addebitate e la registrazione con causale **INS**; lo stato diventa *Insoluta*.
|
||||
### Dalla bozza alla chiusura
|
||||
|
||||

|
||||
*Khaemhat 0.8.0 — Storico distinte e dettaglio di una distinta s.b.f. in bozza, con gli effetti e le azioni.*
|
||||
|
||||
Da **Storico distinte** si apre una distinta e si procede:
|
||||
|
||||
| Passo | Azione | Effetto |
|
||||
|---|---|---|
|
||||
| 1 | **Genera file** | crea il file CBI o XML (scaricabile e conservato come allegato); stato *File generato* |
|
||||
| 2 | **Contabilizza presentazione** | RiBa e SDD: i crediti passano da *Clienti* a *Effetti all'incasso* (con anticipo s.b.f. la banca accredita subito su *Banche c/anticipi*); bonifici: i fornitori sono pagati e la distinta si chiude |
|
||||
| 3 | **Accredito** | alla scadenza la banca accredita: *Banca* in dare, *Effetti all'incasso* (o *Banche c/anticipi*) in avere; la distinta si chiude |
|
||||
| — | **Insoluto** su una riga | l'effetto torna indietro: la partita torna *Insoluta*, la banca riprende l'importo e le **spese** dell'insoluto diventano una nuova partita del cliente |
|
||||
|
||||
Finché la distinta è in bozza si può togliere una riga (la ✕) o **eliminarla** del tutto: le partite tornano
|
||||
aperte. Il file va poi caricato nell'home banking: Khaemhat non lo invia alla banca.
|
||||
|
||||
### Mandati SDD
|
||||
|
||||

|
||||
*Khaemhat 0.8.0 — Mandati SDD con riferimento univoco (UMR), data di firma, schema, IBAN, ultimo incasso e stato.*
|
||||
|
||||
Ogni cliente che paga con addebito diretto deve aver firmato un **mandato**. In **Mandati SDD → Nuovo mandato**
|
||||
indica cliente, **riferimento del mandato** (UMR, unico per creditore), data di firma, **schema** (*Core* per i
|
||||
privati, *B2B* per le imprese), IBAN e BIC del debitore. Il primo addebito esce come **FRST**, i successivi come
|
||||
**RCUR**. Un mandato **revocato** (o un mandato *una tantum* già usato) non vale più: la distinta segnala il cliente
|
||||
come *mandato mancante*.
|
||||
|
||||
## Riconciliazione bancaria
|
||||
|
||||
1. **Riconciliazione bancaria**, scegli il conto e premi **Importa estratto conto**: formati **CSV**, **CBI** e
|
||||
**CAMT.053**.
|
||||
2. **Abbina automatico**: Khaemhat cerca l'abbinamento per importo, data, CRO/riferimento e nome, e indica una
|
||||
**confidenza** in percentuale.
|
||||
3. **Conferma suggeriti ≥ 90 %** conferma in blocco gli abbinamenti più sicuri; gli altri si confermano o si
|
||||
correggono riga per riga.
|
||||
4. Le righe senza documento (commissioni, F24, addebiti) si registrano direttamente; con una **regola salvata**
|
||||
(es. "COMMISSIONI" → spese bancarie) i movimenti ricorrenti vengono riconosciuti in automatico.
|
||||
5. I riquadri **Saldo banca**, **Saldo contabile** e **Differenza** mostrano cosa resta da abbinare.
|
||||

|
||||
*Khaemhat 0.8.0 — Movimenti dell'estratto conto con stato, abbinamento proposto e confidenza; in alto saldo banca,
|
||||
saldo contabile e differenza.*
|
||||
|
||||
| Stato riga | Significato |
|
||||
|---|---|
|
||||
| **Abbinato** | collegato a incasso/pagamento registrato |
|
||||
| **Suggerito** | abbinamento proposto, da confermare |
|
||||
| **Da abbinare** | più candidati o nessuno |
|
||||
| **Insoluto** | riapre la partita con le spese |
|
||||
1. Scegli la **Banca** e premi **Importa estratto conto**. Formati accettati:
|
||||
- **CSV** dell'home banking: Khaemhat riconosce da solo separatore e colonne dalla riga di intestazione
|
||||
(*Data contabile*, *Data valuta*, *Descrizione*, *Importo* oppure *Entrate*/*Uscite*, anche in inglese);
|
||||
- **CBI** (rendicontazione movimenti di conto corrente, record RH/61/62/63/64/EF);
|
||||
- **CAMT.053** (XML ISO 20022).
|
||||
I movimenti **già importati** vengono riconosciuti e saltati, anche se carichi due volte lo stesso file o due
|
||||
file che si sovrappongono.
|
||||
2. Khaemhat propone per ogni movimento cosa potrebbe essere, con una **confidenza** in percentuale:
|
||||
|
||||
| Abbinamento | Quando |
|
||||
|---|---|
|
||||
| **Partite** | importo uguale al residuo di una o più partite della stessa controparte |
|
||||
| **Movimento registrato** | un incasso o pagamento già registrato a mano |
|
||||
| **F24** | un versamento di imposte registrato in *Ritenute e F24* |
|
||||
| **Accredito distinta** / **Insoluto** | l'accredito di una distinta presentata o un effetto respinto |
|
||||
| **Regola** | una **regola salvata** riconosce il testo (es. *COMMISSIONI* → spese bancarie) |
|
||||
|
||||
La confidenza parte dall'importo (esatto o entro la tolleranza) e sale con il numero del documento o il CRO
|
||||
nella descrizione, l'IBAN e il nome della controparte e la vicinanza delle date; una regola vale 98%.
|
||||
3. **Conferma suggeriti ≥ 90%** conferma in blocco le proposte più sicure; le altre si confermano con ✓ o si
|
||||
correggono riga per riga:
|
||||
- ☰ **Abbina a partite** — scegli le partite: viene registrato l'incasso o il pagamento;
|
||||
- € **Abbina a incasso o pagamento registrato** — collega un movimento già registrato a mano;
|
||||
- 📖 **Registra su conto** — per le righe senza documento (commissioni, canoni, carburante) scegli il conto e,
|
||||
se vuoi, salva una **regola** per le prossime volte;
|
||||
- **Ignora** — il movimento non va riconciliato.
|
||||
La freccia **Annulla abbinamento** riporta la riga da riconciliare e annulla quello che aveva registrato.
|
||||
4. La striscia in alto mostra **saldo banca** (dall'ultimo estratto), **saldo contabile** del conto, **differenza** e
|
||||
movimenti ancora da riconciliare. Le schede **Regole** ed **Estratti importati** elencano le regole salvate (con
|
||||
quante volte sono state usate) e i file caricati.
|
||||
|
||||
## Solleciti
|
||||
|
||||
**Solleciti** (mockup 056) gestisce tre **livelli**, ciascuno con giorni di ritardo, modello, canale, interessi e
|
||||
azione. Esempio del mockup:
|
||||

|
||||
*Khaemhat 0.8.0 — Proposta di invio per cliente con prossimo livello, canale e interessi di mora; sotto i tre livelli.*
|
||||
|
||||
I solleciti seguono tre **livelli**, ciascuno con i giorni dopo la scadenza, il modello del messaggio, i **canali**
|
||||
(e-mail, PEC, lettera PDF), gli interessi di mora e un'**azione**:
|
||||
|
||||
| Livello | Dopo (gg) | Modello | Canale | Interessi | Azione |
|
||||
|---|---|---|---|---|---|
|
||||
| 1 | 7 | Promemoria cortese | e-mail | no | — |
|
||||
| 2 | 20 | Sollecito formale | PEC + e-mail | sì | notifica agente |
|
||||
| 3 | 45 | Messa in mora | PEC + lettera PDF | sì | blocco cliente, notifica amministrazione |
|
||||
| 2 | 20 | Sollecito | e-mail + PEC | sì | avvisa l'agente (in copia) |
|
||||
| 3 | 45 | Diffida e blocco forniture | PEC + lettera PDF | sì | blocca il cliente |
|
||||
|
||||
- La **proposta di invio** elenca per cliente partite, scaduto, giorni massimi, ultimo sollecito, prossimo livello,
|
||||
canale, interessi di mora e l'interruttore **Includi**. Sono esclusi per regola la PA e i clienti con partite
|
||||
contestate.
|
||||
- Gli **interessi di mora** seguono il D.Lgs. 231/2002 (transazioni commerciali); il tasso è un parametro aggiornato
|
||||
periodicamente.
|
||||
- **Anteprima** mostra i messaggi; **Invia N solleciti** li spedisce e li annota nel **registro invii**.
|
||||
- Il livello 3 può **bloccare il cliente** (ordini e documenti richiedono un override).
|
||||
- I solleciti si eseguono anche da **attività programmata** (riquadro *Prossima esecuzione*), vedi
|
||||
[Automazioni](Automazioni).
|
||||

|
||||
*Khaemhat 0.8.0 — Un livello si modifica con la matita: giorni, azione, canali, interessi, invio automatico, oggetto e
|
||||
testo con i segnaposto.*
|
||||
|
||||
## Flusso di cassa e report
|
||||
Nel testo si usano i **segnaposto** `{cliente}`, `{azienda}`, `{elenco}` (le partite scadute), `{totale}`,
|
||||
`{interessi}`, `{riferimento}` e `{giorni}`.
|
||||
|
||||
| Report | Contenuto |
|
||||
- La **Proposta di invio** elenca i clienti con partite scadute oltre i giorni del livello successivo a quello già
|
||||
inviato: partite, scaduto, giorni massimi, ultimo sollecito, prossimo livello, canale e interessi. Sono esclusi per
|
||||
regola la **pubblica amministrazione**, le partite **contestate** e quelle in distinta. L'interruttore
|
||||
**Includi** toglie un cliente dall'invio.
|
||||
- **Anteprima** scarica il PDF del sollecito del primo cliente incluso; **Invia N solleciti** mette in coda e-mail e
|
||||
PEC con il PDF allegato (vedi [Impostazioni](Impostazioni) per SMTP e PEC) e scarica in un unico PDF le **lettere**
|
||||
da stampare e spedire. Un cliente senza indirizzo e-mail o PEC viene saltato, con un avviso, se il livello non
|
||||
prevede la lettera.
|
||||
- Gli **interessi di mora** seguono il D.Lgs. 231/2002: tasso BCE di riferimento del semestre più 8 punti
|
||||
(10,15% nel primo semestre 2026, 10,40% nel secondo), calcolati giorno per giorno sul residuo di ogni partita.
|
||||
Gli interessi compaiono nel messaggio e nel PDF; non vengono addebitati in contabilità.
|
||||
- Il livello con azione **Blocca il cliente** imposta il blocco nelle condizioni di vendita dell'anagrafica.
|
||||
- Il **Registro invii** conserva ogni sollecito con data, livello, canale, destinatari, importo, interessi e stato
|
||||
dell'invio.
|
||||
- I livelli segnati **Automatico** partono da soli con l'attività programmata *Solleciti* (giorni feriali alle 7:00,
|
||||
vedi [Attività programmate](Attivita-programmate)); solo e-mail e PEC, mai la lettera.
|
||||
|
||||
## Flusso di cassa
|
||||
|
||||

|
||||
*Khaemhat 0.8.0 — Disponibilità di oggi, entrate e uscite previste per settimana con il saldo progressivo e i
|
||||
movimenti che lo compongono.*
|
||||
|
||||
Il **flusso di cassa** parte dalla disponibilità di oggi (saldo contabile di banche e cassa) e aggiunge, periodo per
|
||||
periodo, i movimenti attesi da sei **fonti** che si accendono e spengono con le caselle:
|
||||
|
||||
| Fonte | Da dove |
|
||||
|---|---|
|
||||
| Scadenzario | partite per scadenza, cliente/fornitore, metodo |
|
||||
| Aging | crediti per fasce di ritardo (come i riquadri del mockup 053) |
|
||||
| Estratto conto | per cliente/fornitore, anche in PDF da inviare |
|
||||
| **Flusso di cassa 90 giorni** | entrate e uscite previste da partite, distinte e saldi bancari |
|
||||
| Insoluti | effetti tornati insoluti con spese |
|
||||
| Posizione bancaria | saldi dei conti e effetti presentati |
|
||||
| Incassi da clienti | partite aperte dei clienti e gli effetti presentati senza anticipo, alla loro scadenza |
|
||||
| Pagamenti a fornitori | partite aperte dei fornitori |
|
||||
| Ordini clienti / fornitori | il residuo degli ordini non ancora fatturati, 30 giorni dopo la consegna prevista (o la data dell'ordine) |
|
||||
| Ricorrenti | le registrazioni ricorrenti della contabilità (affitti, noleggi…) che muovono la banca |
|
||||
| Imposte | i versamenti F24 non ancora pagati (IVA, acconto, ritenute) alla loro scadenza |
|
||||
|
||||
Vedi [Report](Report).
|
||||
L'**orizzonte** va da 30 a 365 giorni, il **periodo** è la settimana o il mese. Le partite già scadute cadono nel
|
||||
primo periodo. La striscia riassume disponibilità di oggi, entrate e uscite previste, saldo finale e **punto più
|
||||
basso** (in rosso se il conto andrebbe in negativo).
|
||||
|
||||
## Sulla Home
|
||||
|
||||
Con il permesso `finance.schedule.read` la [Dashboard](Dashboard) mostra:
|
||||
|
||||
- nelle **Scadenze** gli incassi e i pagamenti dei prossimi giorni (al massimo 12), con il link alla partita;
|
||||
- nelle **Cose da fare** il totale dei crediti scaduti, con il link ai solleciti.
|
||||
|
||||
## Dati di esempio
|
||||
|
||||
L'azienda demo (se la licenza comprende FIN) arriva con la banca *Banca Popolare Dimostrativa*, i versamenti dei
|
||||
soci, incassi e pagamenti già registrati (uno parziale), una distinta RiBa accreditata con un **insoluto**, una
|
||||
distinta s.b.f. in bozza, un mandato SDD, un estratto conto CSV da riconciliare con una regola per le commissioni e
|
||||
un primo sollecito già inviato. Vedi [Dati di base e di esempio](Dati-di-base-e-esempio).
|
||||
|
||||
## Permessi e licenza
|
||||
|
||||
Serve il modulo **FIN** (e ACCT per le registrazioni contabili automatiche). I codici dei permessi in testa sono
|
||||
indicativi (convenzione `modulo.entità.azione`, SPEC §7.2) e saranno fissati in sviluppo.
|
||||
| Permesso | Cosa consente |
|
||||
|---|---|
|
||||
| `finance.schedule.read` | vedere partite, distinte, mandati, solleciti, flusso di cassa e le scadenze sulla Home |
|
||||
| `finance.schedule.write` | modificare le partite, creare e presentare le distinte, gestire mandati e solleciti |
|
||||
| `finance.payment.read` | vedere incassi e pagamenti |
|
||||
| `finance.payment.write` | registrare e stornare incassi e pagamenti |
|
||||
| `finance.bank.reconcile` | importare gli estratti conto, riconciliare, gestire le regole |
|
||||
|
||||
Serve il modulo **FIN**; le registrazioni contabili chiedono anche **ACCT**.
|
||||
|
||||
## Domande frequenti
|
||||
|
||||
**Il cliente ha pagato due fatture con un bonifico solo.** Seleziona entrambe le partite e registra un unico incasso,
|
||||
distribuendo l'importo.
|
||||
**Il cliente ha pagato due fatture con un bonifico solo.** Seleziona entrambe le partite e registra un unico incasso:
|
||||
l'importo si distribuisce sulle rate, la più vecchia per prima. Se il bonifico arriva dall'estratto conto, *Abbina a
|
||||
partite* fa la stessa cosa.
|
||||
|
||||
**Ho caricato l'estratto conto due volte.** Il riconoscimento dei movimenti già importati non è ancora definito
|
||||
dalla specifica: sarà stabilito in sviluppo e descritto qui.
|
||||
**Ho caricato l'estratto conto due volte.** Nessun problema: i movimenti già presenti vengono riconosciuti
|
||||
dall'impronta (banca, data, importo, descrizione, riferimento) e saltati; il messaggio dice quanti.
|
||||
|
||||
**Ho registrato un incasso sbagliato.** In *Incassi* premi **Annulla** sulla riga: la registrazione viene stornata e
|
||||
le partite riaperte. Se l'incasso veniva dalla riconciliazione, la riga dell'estratto torna *Da abbinare*.
|
||||
|
||||
**Una RiBa è tornata insoluta.** Apri la distinta in *Storico distinte* e premi **Insoluto** sulla riga (o confermalo
|
||||
dalla riconciliazione): la partita torna aperta e le spese diventano una nuova partita da addebitare al cliente.
|
||||
|
||||
**Perché un cliente non compare tra i solleciti?** È una pubblica amministrazione, ha partite contestate o in
|
||||
distinta, oppure il prossimo livello non è ancora maturato.
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
[Contabilità](Contabilita) · [Vendite](Vendite) · [Acquisti](Acquisti) · [Anagrafiche](Anagrafiche) · [IVA](IVA) ·
|
||||
[Automazioni](Automazioni) · [Report](Report) · [Attività programmate](Attivita-programmate)
|
||||
[Contabilità](Contabilita) · [IVA](IVA) · [Vendite](Vendite) · [Acquisti](Acquisti) · [Anagrafiche](Anagrafiche) ·
|
||||
[Tabelle azienda](Tabelle-azienda) · [Dashboard](Dashboard) · [Attività programmate](Attivita-programmate) ·
|
||||
[Fiscalità italiana](Fiscalita-italiana) · [Report](Report)
|
||||
@@ -81,7 +81,7 @@ liquidazione IVA (*provvisoria*, *confermata*), registrazioni, interruttore **Bl
|
||||
|
||||
Indirizzo: `/tabelle/esercizi`. **Nuovo esercizio** crea l'anno successivo all'ultimo con i suoi dodici mesi. Il
|
||||
pulsante **Blocca** di un mese impedisce nuove registrazioni con date in quel mese; **Sblocca** chiede conferma. Un
|
||||
mese *liquidato* si sblocca solo annullando la liquidazione IVA (M7).
|
||||
mese *liquidato* si sblocca solo riaprendo la liquidazione IVA (vedi [IVA](IVA)).
|
||||
|
||||
Regola fondamentale: **si possono registrare documenti e movimenti contabili solo con data in un periodo aperto**. Un
|
||||
periodo bloccato rifiuta ogni registrazione con data al suo interno; la conferma della liquidazione IVA blocca il
|
||||
@@ -98,7 +98,7 @@ periodo (vedi [IVA](IVA)) e la chiusura dell'esercizio lo rende di sola lettura
|
||||
| **Codici IVA** | aliquota, natura SDI, riferimento normativo, esigibilità, tipo, indetraibilità, conti IVA, validità (vedi sotto) |
|
||||
| **Metodi di pagamento** | codici SDI `MP01`…`MP23` (es. MP01 contanti, MP02 assegno, MP05 bonifico, MP08 carta di pagamento, MP12 RiBa, MP19 SEPA Direct Debit) |
|
||||
| **Condizioni di pagamento** | con righe: rata, giorni, fine mese, giorno fisso, percentuale, IVA sulla prima rata; tipo SDI `TP01` (a rate), `TP02` (completo), `TP03` (anticipo) |
|
||||
| **Banche aziendali** | IBAN, BIC, conto contabile, codici SIA/CUC per RiBa e SDD |
|
||||
| **Banche aziendali** | IBAN, BIC, conto contabile, codice SIA (RiBa), CUC e identificativo creditore SEPA (SDD), banca predefinita; usate da incassi, distinte e riconciliazione dello [Scadenzario](Scadenzario) |
|
||||
| **Agenti** | provvigione, iscrizione ENASARCO |
|
||||
| **Vettori** | corrieri e trasportatori |
|
||||
| **Porti** (condizioni di spedizione) | franco, assegnato… |
|
||||
@@ -113,7 +113,7 @@ periodo (vedi [IVA](IVA)) e la chiusura dell'esercizio lo rende di sola lettura
|
||||
| **Categorie controparte** | classificazione di clienti e fornitori |
|
||||
| **Listini** | intestazioni dei listini: valuta, IVA inclusa, validità, **Listino base** (uno solo, in partenza `BASE`), **Derivato da** con ricarico % e arrotondamento (i prezzi sono in [Articoli e listini](Articoli-e-listini)) |
|
||||
| **Politiche di sconto** | sconti in cascata con un codice, come formula (`10+5`), da richiamare nelle condizioni |
|
||||
| **Tipi documento** | catalogo dei documenti con numeratore, causale di magazzino, causale contabile, registro IVA, codice TD, modello di stampa |
|
||||
| **Tipi documento** | catalogo dei documenti con **genere** (obbligatorio), numeratore, causale di magazzino, causale contabile, registro IVA, codice TD, modello di stampa |
|
||||
| **Centri di costo** | per l'analisi dei costi e dei ricavi |
|
||||
| **Commesse** | progetti o cantieri a cui imputare costi e ricavi |
|
||||
|
||||
@@ -156,7 +156,14 @@ clienti `OC-{year}-{number:D4}` (`OC-2026-0042`), autofatture `{number}/AF/{year
|
||||
|
||||
Il numero è assegnato in modo atomico **alla conferma** del documento (da M5); per fatture, note di credito,
|
||||
protocollo acquisti e registrazioni contabili **non sono ammessi buchi** nella numerazione (opzione *Ammessi buchi di numerazione*
|
||||
spenta). I numeratori sono per anno: il caricamento di base crea quelli dell'anno in corso.
|
||||
spenta) e la data di un documento non può precedere la **data dell'ultimo numero** del numeratore. I numeratori sono
|
||||
per anno: il caricamento di base crea quelli dell'anno in corso e il primo documento di un anno nuovo crea da solo il
|
||||
numeratore di quell'anno, con le stesse regole e dal numero 1.
|
||||
|
||||
Il **genere** di un tipo documento dice come si comportano i suoi documenti: famiglia, ciclo di vita, effetti, righe
|
||||
ammesse e documenti che può evadere (vedi [Vendite](Vendite#il-motore-dei-documenti-in-sintesi)). I tipi di base hanno
|
||||
già il genere; un tipo nuovo dell'azienda (ad esempio una seconda fattura immediata con un altro sezionale) sceglie uno
|
||||
dei generi esistenti e funziona senza altre impostazioni.
|
||||
|
||||
## Preferenze e codici automatici
|
||||
|
||||
|
||||
@@ -1,288 +1,352 @@
|
||||
# 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
|
||||
> **Stato:** completa per la versione 0.5 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.5.0 (M5)
|
||||
> **Modulo di licenza:** CORE (XML SDI con EINV, contabilizzazione con ACCT, partite con FIN) · **Permessi principali:** `sales.quote.*`, `sales.order.*`, `sales.delivery.*`, `sales.invoice.*` (emissione `sales.invoice.issue`) · **Specifica:** SPEC §9.4, §11.3, §11.4, §12.6
|
||||
|
||||
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.
|
||||
Il modulo **Vendite** gestisce il ciclo attivo: **preventivi**, **ordini clienti**, **DDT**, **fatture** (immediate,
|
||||
accompagnatorie, differite, di acconto, parcelle), **note di credito e di debito**, **pro forma** e la
|
||||
**fatturazione differita** dei DDT. Tutti i documenti usano lo stesso motore e la stessa maschera, si stampano in PDF
|
||||
e si inviano per e-mail.
|
||||
|
||||
> **In questa versione** i documenti hanno numeri, totali, castelletto IVA, bollo, ritenute, scadenze, collegamenti
|
||||
> riga per riga, stampa ed e-mail. Dalla 0.6 i documenti **muovono il magazzino** (DDT e fatture
|
||||
> accompagnatorie scaricano, gli ordini impegnano: vedi [Magazzino](Magazzino)). Dalla 0.7 fatture e note
|
||||
> **si contabilizzano** da sole (vedi [Contabilità](Contabilita)). Dalla 0.8 gli **incassi** si registrano dallo [Scadenzario](Scadenzario).
|
||||
> Dalla 0.9 le fatture emesse diventano **file FatturaPA** e si trasmettono allo SDI dalla
|
||||
> [Fatturazione elettronica](Fatturazione-elettronica). Arrivano più avanti: il controllo del fido e il collegamento alle opportunità del **CRM** (M11). I pulsanti di queste funzioni compaiono quando la
|
||||
> funzione c'è.
|
||||
|
||||
## Dove si trova
|
||||
|
||||
Menu **Vendite** → *Preventivi*, *Ordini clienti*, *DDT*, *Fatture*, *Note di credito*, *Fatturazione differita*.
|
||||
Le pro forma, le fatture di acconto e le parcelle stanno nell'elenco *Fatture*; le note di debito in *Note di credito*.
|
||||
|
||||
## Il motore dei documenti in sintesi
|
||||
## Un giro completo in cinque minuti
|
||||
|
||||
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.
|
||||
Con l'azienda di esempio (vedi [Dati di base e di esempio](Dati-di-base-e-esempio)) trovi già un anno di vendite in
|
||||
tutti gli stati. Per provare il ciclo da zero:
|
||||
|
||||
1. **Vendite → Preventivi → Nuovo preventivo** (`Ctrl+N`): scegli il cliente, aggiungi due righe, **Conferma**.
|
||||
2. Sul preventivo premi **Crea Ordine cliente**: le righe passano all'ordine, collegate al preventivo.
|
||||
3. Sull'ordine confermato premi **Crea DDT**: puoi consegnare solo una parte delle quantità.
|
||||
4. **Vendite → Fatturazione differita**: indica il mese, **Cerca i DDT**, **Genera fatture**.
|
||||
5. Apri la fattura, premi la **stampante** (`Ctrl+P`) per l'anteprima e il PDF, poi **⋯ → Invia per e-mail**.
|
||||
|
||||
## Gli elenchi (radar)
|
||||
|
||||

|
||||
*Le fatture dell'azienda di esempio: numero, data, tipo, cliente, riferimento, imponibile, totale e stato. Le bozze
|
||||
non hanno ancora un numero.*
|
||||
|
||||
Ogni voce del menu apre un **radar** (vedi [Interfaccia e scorciatoie](Interfaccia-e-scorciatoie#radar)): cerca per
|
||||
numero, riferimento o cliente, filtra per **tipo**, **stato** e **anno**, ordina, scegli le colonne e salva la vista.
|
||||
Un doppio clic (o `Invio`) apre il documento in una nuova scheda.
|
||||
|
||||

|
||||
*I preventivi: quelli evasi sono diventati ordini, uno è stato rifiutato, uno è in bozza.*
|
||||
|
||||
**Nuovo** chiede il tipo quando l'elenco ne raccoglie più d'uno (ad esempio fattura immediata, accompagnatoria,
|
||||
differita, di acconto, parcella o pro forma):
|
||||
|
||||

|
||||
|
||||
## La maschera del documento
|
||||
|
||||

|
||||
*Una fattura emessa: toolbar, intestazione con tipo, numero, stato, cliente e totale; righe; castelletto IVA,
|
||||
scadenze e totali.*
|
||||
|
||||
- **Toolbar**: nuovo, salva (`Ctrl+S`), annulla le modifiche, elimina (solo bozze), **stampa** (`Ctrl+P`),
|
||||
**allegati**, le azioni del documento (*Conferma*, *Emetti*, *Crea …*) e il menu **⋯** con *Duplica*, *Chiudi*,
|
||||
*Riapri*, *Annulla documento*, *Invia per e-mail*. A destra il **radar** e i pulsanti per il documento precedente e
|
||||
successivo.
|
||||
- **Intestazione**: tipo e numero (in bozza *Numero alla conferma*), data, stato, badge *Dato dimostrativo* per i dati
|
||||
di esempio; cliente con codice, località e partita IVA, condizioni proposte (pagamento, listino, agente); il totale
|
||||
del documento con imponibile e IVA.
|
||||
- **Schede**: *Righe* (si apre lì), *Testata*, *Trasporto* (DDT e fatture accompagnatorie), *Totali*, *Scadenze*,
|
||||
*Note*, *Allegati*, *Collegamenti*, *Storico*. Il numero accanto al nome della scheda conta righe, rate o
|
||||
collegamenti.
|
||||
|
||||
### Righe
|
||||
|
||||
Ogni riga ha articolo (`F4` per cercarlo), descrizione, unità di misura, quantità, prezzo, sconti a cascata (`10+3`),
|
||||
codice IVA e importo. Scegliendo l'articolo Khaemhat propone descrizione, unità, codice IVA e prezzo secondo l'ordine
|
||||
*prezzo netto del cliente → listino del cliente → listino base → prezzo dell'articolo* (vedi
|
||||
[Articoli e listini](Articoli-e-listini)). Oltre alle righe di merce ci sono le righe **descrittive** (solo testo),
|
||||
le righe di **spesa** (trasporto, incasso) e le righe di **sconto**; i DDT non accettano spese né sconti.
|
||||
|
||||
Sotto le righe: **castelletto IVA** (imponibile e imposta per codice IVA), **scadenze** (le rate della condizione di
|
||||
pagamento) e **totali**.
|
||||
|
||||
### Testata
|
||||
|
||||

|
||||
*La Testata con i gruppi Documento, Cliente, Condizioni e Dati fiscali.*
|
||||
|
||||
| Gruppo | Campi |
|
||||
|---|---|
|
||||
| **Documento** | tipo, numero (alla conferma), **data** *, validità (preventivi), data di consegna (ordini), revisione, riferimento e data del cliente, documento rettificato (note) |
|
||||
| **Cliente** | **cliente** *, agente, valuta, listino |
|
||||
| **Condizioni** | pagamento, modalità, banca, sconto di piede, prezzi IVA inclusa |
|
||||
| **Dati fiscali** | esigibilità IVA, split payment, bollo a carico del cliente, CIG e CUP per la PA |
|
||||
| **Ritenuta, cassa previdenza, ENASARCO** | per parcelle e provvigioni: aliquote, base, tipo e causale della ritenuta, cassa |
|
||||
| **Note** | note stampate sul documento |
|
||||
|
||||
Scegliendo il cliente Khaemhat propone destinazione, listino, pagamento, agente e banca dalle sue **condizioni
|
||||
commerciali** (vedi [Anagrafiche](Anagrafiche)). Per emettere una fattura ogni riga (tranne le descrittive) deve
|
||||
avere il codice IVA.
|
||||
|
||||
### Trasporto (DDT e fatture accompagnatorie)
|
||||
|
||||

|
||||
*Causale del trasporto, trasporto a cura del mittente, del destinatario o del vettore, porto, aspetto dei beni,
|
||||
colli, pesi, inizio del trasporto.*
|
||||
|
||||
I dati di trasporto finiscono nella stampa insieme agli spazi per le **firme** del conducente, del vettore e del
|
||||
destinatario.
|
||||
|
||||
### Collegamenti
|
||||
|
||||

|
||||
*Un ordine evaso: da quale preventivo nasce e quali DDT lo hanno evaso, con le quantità.*
|
||||
|
||||
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*).
|
||||
d'ordine e la quantità evasa. Così Khaemhat calcola i **residui** e lo stato (*Evaso in parte*, *Evaso*). Il
|
||||
collegamento vale dalla **conferma** del documento che evade: una bozza non toglie nulla al residuo, un documento
|
||||
annullato lo restituisce. Una nota di credito mostra qui la fattura che rettifica.
|
||||
|
||||
## Dal preventivo alla fattura: Crea …
|
||||
|
||||
```
|
||||
Preventivo ──trasforma──► Ordine cliente ──evadi──► DDT ──fattura differita──► Fattura TD24
|
||||
└────────────── evadi ──────────────► Fattura immediata TD01
|
||||
Preventivo ──Crea Ordine──► Ordine cliente ──Crea DDT──► DDT ──Fatturazione differita──► Fattura differita (TD24)
|
||||
└──────────── Crea Fattura immediata ─────────────► Fattura immediata (TD01)
|
||||
Fattura ──Crea Nota di credito──► Nota di credito (TD04)
|
||||
```
|
||||
|
||||
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.
|
||||

|
||||
*Crea Ordine cliente da un preventivo: si scelgono le righe; per un documento che evade, la quantità proposta è
|
||||
quella ancora da evadere.*
|
||||
|
||||
## La maschera di un documento di vendita
|
||||
I pulsanti **Crea …** della toolbar elencano i documenti che si possono generare da quello aperto. Se il nuovo tipo
|
||||
**evade** il vecchio (preventivo → ordine, ordine → DDT o fattura, DDT → fattura differita) le righe prendono solo le
|
||||
**quantità residue**, che puoi ridurre, e restano collegate; altrimenti (ad esempio fattura → nota di credito) le
|
||||
righe si **copiano**. Il nuovo documento nasce in **bozza** e si apre in una nuova scheda. **Duplica** crea invece un
|
||||
documento dello stesso tipo con la data di oggi.
|
||||
|
||||

|
||||
*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).*
|
||||
## Preventivi
|
||||
|
||||

|
||||
*Mockup 021 — scheda Testata con i gruppi Documento, Controparte, Condizioni, Magazzino e trasporto (anteprima ridotta).*
|
||||
Il preventivo ha una **validità** (giorni o data) che compare nella stampa. Quando il cliente accetta, **Crea Ordine
|
||||
cliente**; se rifiuta, **⋯ → Segna come rifiutato** (il preventivo passa a *Chiuso*). Un preventivo trasformato in
|
||||
ordine risulta *Evaso*.
|
||||
|
||||

|
||||
*Mockup 022 — la stessa fattura in tema scuro con accento Malachite (anteprima ridotta).*
|
||||
## Ordini clienti
|
||||
|
||||
La struttura è quella descritta in [Interfaccia e scorciatoie](Interfaccia-e-scorciatoie): toolbar, intestazione a
|
||||
tre blocchi, schede **Righe** (si apre lì), *Testata*, *Totali*, *Trasporto*, *Scadenze*, *Dati SDI/PA*, *Note*,
|
||||
*Allegati*, *Collegamenti*, *Storico*.
|
||||
L'ordine raccoglie gli impegni presi con il cliente. Da un ordine confermato si creano **DDT** o **fatture
|
||||
immediate**, anche più di uno, finché resta un residuo; la scheda *Collegamenti* mostra chi ha evaso cosa. **⋯ →
|
||||
Chiudi** chiude il residuo che non verrà consegnato, **Riapri** lo riporta aperto. Per la PA la Testata raccoglie CIG
|
||||
e CUP, riportati nella stampa.
|
||||
|
||||
| Gruppo della Testata | Campi |
|
||||
## DDT (documenti di trasporto)
|
||||
|
||||
Il DDT accompagna la merce: si compila la scheda *Trasporto* e si stampa con gli spazi per le firme. Un DDT confermato
|
||||
non ancora fatturato compare nella **fatturazione differita**; un DDT fatturato risulta *Evaso*. Finché non è
|
||||
fatturato le righe si possono ancora correggere; **Annulla documento** lo annulla con un motivo. Alla conferma il DDT
|
||||
**scarica il magazzino** (causale `SCA`); la fattura differita che lo fattura non scarica di nuovo.
|
||||
|
||||
## Fatture
|
||||
|
||||
1. **Vendite → Fatture → Nuova fattura**, scegli il tipo, oppure parti da un ordine con **Crea Fattura immediata**.
|
||||
2. Scegli il cliente: condizioni, listino, agente e destinazione vengono proposti.
|
||||
3. Inserisci le righe e controlla castelletto IVA, scadenze e totali.
|
||||
4. **Emetti** (permesso `sales.invoice.issue`): assegna il numero e blocca il documento.
|
||||
|
||||
Una fattura **emessa non si modifica**. Per correggerla si emette una **nota di credito**; finché il file XML non è
|
||||
stato inviato allo SDI si può **annullare** indicando il motivo (il numero resta usato).
|
||||
|
||||
## Note di credito (TD04) e di debito (TD05)
|
||||
|
||||

|
||||
*Una nota di credito che storna un articolo difettoso: l'intestazione indica la fattura rettificata.*
|
||||
|
||||
Si crea dalla fattura con **Crea Nota di credito** (le righe si copiano e si tolgono quelle che non vanno stornate) o
|
||||
da **Vendite → Note di credito → Nuova nota**. Usa lo stesso numeratore delle fatture.
|
||||
|
||||
## Pro forma e parcelle
|
||||
|
||||
La **pro forma** è un documento **non fiscale** (ad esempio per chiedere un anticipo): stessa maschera della fattura,
|
||||
numerazione propria (`PF-2026-0001`), nessun file XML e nessun effetto contabile; si trasforma in fattura quando
|
||||
serve. La **parcella** (TD06) calcola la **cassa previdenza** e la **ritenuta d'acconto** e mostra il **netto a
|
||||
pagare**; gli acconti su parcella usano TD03.
|
||||
|
||||
## Fatturazione differita
|
||||
|
||||

|
||||
*Ottobre: tre DDT da fatturare, uno per cliente; a destra la fattura in cui finirà ciascuno.*
|
||||
|
||||
1. **Periodo e cliente**: *DDT dal* e *DDT al*, un cliente (vuoto per tutti), la **data delle fatture** e il
|
||||
**raggruppamento** (*una fattura per cliente* o *una fattura per DDT*). Spunta *Emetti subito le fatture* per
|
||||
numerarle subito; altrimenti restano in bozza da controllare. Premi **Cerca i DDT**.
|
||||
2. **Scelta dei DDT**: l'elenco mostra i DDT confermati e non ancora fatturati con la fattura che verrà generata;
|
||||
togli la spunta a quelli da fatturare più avanti.
|
||||
3. **Genera fatture**: crea una fattura differita (TD24) per gruppo, con i riferimenti ai DDT nelle righe; i DDT
|
||||
diventano *Evasi*. Il riepilogo indica quante fatture sono state create; un clic le apre.
|
||||
|
||||
Con *una fattura per cliente* i DDT dello stesso cliente finiscono in una sola fattura, che prende pagamento,
|
||||
banca e condizioni dal primo DDT; se un cliente ha DDT con condizioni diverse scegli *una fattura per DDT*. La fattura differita va emessa entro il giorno 15 del mese successivo a quello delle consegne.
|
||||
|
||||
## Stampa e PDF
|
||||
|
||||

|
||||
*L'anteprima di stampa: intestazione dell'azienda, cliente, righe, riepilogo IVA, scadenze e totali.*
|
||||
|
||||
La **stampante** della toolbar (`Ctrl+P`) salva il documento se serve e apre l'**anteprima di stampa**:
|
||||
|
||||
| Pulsante | Che cosa fa |
|
||||
|---|---|
|
||||
| **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 |
|
||||
| **Stampa** | la stampa del browser (scegli la stampante o *Salva come PDF*) |
|
||||
| **Apri PDF** / **Scarica PDF** | il PDF disegnato da Khaemhat, identico all'anteprima |
|
||||
| **Salva come allegato** | conserva il PDF tra gli **allegati** del documento come nuova versione e segna il documento come *stampato* |
|
||||
| 75% · 100% · 125% | lo zoom dell'anteprima |
|
||||
|
||||
Scegliendo il cliente, Khaemhat propone destinazione, listino, pagamento, agente e banca dalle sue condizioni
|
||||
commerciali; dal tipo documento propone causale e deposito.
|
||||
La stampa riporta i dati dell'azienda dal **profilo azienda** (ragione sociale, indirizzo, partita IVA, REA, capitale
|
||||
sociale, contatti e la nota a piè di pagina; vedi [Tabelle azienda](Tabelle-azienda)), il logo (nel PDF se è un
|
||||
JPEG), il cliente, i campi utili (pagamento, banca, riferimento, validità, agente, CIG e CUP), le righe, il
|
||||
**riepilogo IVA**, le **scadenze**, i totali con bollo e ritenuta e le diciture previste (split payment, pro forma non
|
||||
valida ai fini fiscali, fattura differita con i DDT). Le bozze, i documenti annullati e i dati dimostrativi portano
|
||||
una scritta in evidenza. Il DDT ha in più il riquadro del trasporto e le firme:
|
||||
|
||||
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**.
|
||||

|
||||
|
||||
Ogni PDF salvato diventa un **allegato versionato** (vedi [Allegati e file](Allegati-e-file)): nella scheda
|
||||
*Allegati* si vedono tutte le versioni, con chi le ha create e quando. Il generatore si chiama *Stampa del documento
|
||||
in PDF*.
|
||||
|
||||
## Invio per e-mail
|
||||
|
||||

|
||||
*Destinatario dall'anagrafica del cliente, oggetto e testo dal modello; il PDF parte in allegato.*
|
||||
|
||||
**⋯ → Invia per e-mail** (su un documento salvato) propone:
|
||||
|
||||
- **Destinatari**: l'e-mail del cliente; più indirizzi separati da virgola o punto e virgola.
|
||||
- **Oggetto** e **Messaggio** dal modello, con i campi `{{Documento}}`, `{{Numero}}`, `{{Data}}`, `{{Cliente}}`,
|
||||
`{{Azienda}}` e `{{Totale}}` già compilati. Puoi cambiare tutto prima di inviare.
|
||||
|
||||
**Invia** salva il PDF tra gli allegati come nuova versione, lo allega al messaggio, mette il messaggio **in coda** e
|
||||
segna il documento come *inviato*. Il messaggio parte in background: tre tentativi a distanza crescente; l'esito (o
|
||||
l'errore del server) è nel [Log](Log), sezione **E-mail/PEC**. La coda vive in memoria: un messaggio ancora in attesa
|
||||
quando Khaemhat si ferma non parte, e il log lo dice.
|
||||
|
||||
L'invio richiede un **server SMTP** configurato dall'amministratore con le variabili `KHAEMHAT_SMTP_*` (vedi
|
||||
[Impostazioni](Impostazioni#e-mail-smtp)); senza, la finestra lo segnala e il pulsante *Invia* è spento.
|
||||
|
||||
## 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 accompagnatoria | **TD01** | fattura con i dati di trasporto, fa anche da documento di trasporto |
|
||||
| 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** | |
|
||||
| Nota di credito / di debito semplificata | **TD08** / **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 |
|
||||
| Cessione di beni ammortizzabili e passaggi interni | **TD26** | |
|
||||
| Autoconsumo o cessioni gratuite senza rivalsa (omaggi) | **TD27** | |
|
||||
| Pro-forma | — | non è un documento fiscale: niente numerazione fiscale né XML |
|
||||
| Pro forma | — | non è un documento fiscale: niente numerazione fiscale né XML |
|
||||
|
||||
Le autofatture e le integrazioni (TD16-TD29) sono negli [Acquisti](Acquisti). L'elenco completo dei codici è in
|
||||
[Fiscalità italiana](Fiscalita-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*).
|
||||
|
||||
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](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
|
||||
|
||||
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](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](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).*
|
||||
|
||||
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](Automazioni)).
|
||||
[Fiscalità italiana](Fiscalita-italiana). I tipi, i numeratori e i sezionali si configurano in *Tipi documento* (vedi
|
||||
[Tabelle azienda](Tabelle-azienda)).
|
||||
|
||||
## Stati
|
||||
|
||||
| Documenti (preventivi, ordini, DDT) | Significato |
|
||||
| Preventivi, ordini, DDT, pro forma | 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 |
|
||||
| **Bozza** | modificabile, senza numero, nessun effetto |
|
||||
| **Confermato** | numerato; le righe si possono ancora cambiare finché non sono evase |
|
||||
| **Evaso in parte** / **Evaso** | una parte o tutto è passato al documento successivo |
|
||||
| **Chiuso** | concluso, anche con residuo chiuso a mano (o preventivo rifiutato) |
|
||||
| **Annullato** | annullato con motivo; il numero resta usato |
|
||||
|
||||
| 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 |
|
||||
| **Emessa** | numerata e immutabile |
|
||||
| **XML generato**, **Inviata allo SdI**, **Consegnata**, **Scartata**, **Non consegnata** | gli stati della [fatturazione elettronica](Fatturazione-elettronica) |
|
||||
|
||||
Altri badge indicano lo stato contabile (*Non contabilizzata*), del magazzino (*Scaricato*) o della fatturazione
|
||||
(*Da fatturare*).
|
||||
Che cosa si può fare:
|
||||
|
||||
- Si **modifica** una bozza; di ordini, preventivi, DDT e pro forma confermati si possono ancora cambiare le righe
|
||||
finché non sono evasi del tutto, ma una quantità non scende sotto quella già evasa e una riga evasa non si toglie.
|
||||
- Si **elimina** solo una bozza, che non ha mai avuto un numero.
|
||||
- Si **annulla** un documento confermato non ancora evaso: il numero resta e le quantità che aveva evaso tornano ai
|
||||
documenti d'origine. Una fattura si annulla **con un motivo** finché il file non è stato inviato allo SDI; dopo, si
|
||||
fa una nota di credito.
|
||||
- Si **chiude** il residuo di un documento evaso in parte; **Riapri** lo riporta allo stato che dicono le sue righe.
|
||||
- Si **duplica** o si **crea** un altro documento da uno in qualunque stato.
|
||||
|
||||
## 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](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](Tabelle-azienda)).
|
||||
- Il formato è quello del numeratore del tipo documento, per **sezionale** e anno: ad esempio `{number}/{year}` per
|
||||
fatture, note e DDT (`7/2026`), `OC-{year}-{number:D4}` per gli ordini (`OC-2026-0004`), `PRE-{year}-{number:D4}`
|
||||
per i preventivi.
|
||||
- Il numero è assegnato **alla conferma**, in modo atomico: le bozze non consumano numeri, due conferme contemporanee
|
||||
non ricevono mai lo stesso numero e una conferma non riuscita restituisce il numero. Fatture, note di credito e note
|
||||
di debito condividono il numeratore delle fatture.
|
||||
- Per fatture e note **non sono ammessi buchi** e la data non può essere anteriore a quella dell'ultimo documento
|
||||
numerato nello stesso numeratore.
|
||||
- La data deve cadere in un **esercizio aperto** (vedi [Tabelle azienda](Tabelle-azienda)); con il primo documento
|
||||
di un anno nuovo la numerazione riparte da 1.
|
||||
|
||||
## 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) |
|
||||
| **Imponibile di riga** | quantità × prezzo × (1 − sconto 1) × (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 |
|
||||
| **Sconto di 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 suo carico |
|
||||
| **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**) |
|
||||
| **Split payment** | per PA e soggetti obbligati: l'IVA è esposta ma versata dal cliente all'Erario (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](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](Report)), DDT da fatturare,
|
||||
ordini aperti, provvigioni agenti, margini (con il modulo REPORT).
|
||||
prima rata); l'eventuale differenza di arrotondamento va sull'ultima rata.
|
||||
|
||||
## 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**.
|
||||
Le vendite sono nel modulo **CORE**. Ogni famiglia ha due permessi, lettura (`.read`) e scrittura (`.write`):
|
||||
`sales.quote`, `sales.order`, `sales.delivery`, `sales.invoice` (fatture, note e pro forma). La scrittura vale per
|
||||
creare, modificare, confermare, chiudere, riaprire e annullare; per le fatture e le note **emettere** e annullare
|
||||
richiede in più `sales.invoice.issue` ed eliminare una bozza `sales.invoice.delete`. Stampare richiede la sola
|
||||
lettura. Vedi [Utenti e permessi](Utenti-e-permessi).
|
||||
|
||||
## 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.
|
||||
- **"Indica il codice IVA" su una riga.** Fatture e note si emettono solo con il codice IVA su ogni riga di merce,
|
||||
spesa o sconto: sceglilo nella riga o nella scheda dell'articolo.
|
||||
- **Il bollo non viene calcolato.** È automatico solo se la parte esente, non imponibile o fuori campo supera 77,47
|
||||
euro; controlla i codici IVA delle righe.
|
||||
- **Un DDT non compare nella fatturazione differita.** Deve essere *Confermato*, non già fatturato e con data nel
|
||||
periodo; se hai indicato un cliente, deve essere suo.
|
||||
- **"Invia per e-mail" è spento.** Il documento ha modifiche non salvate: salvalo. Se la finestra dice che manca il
|
||||
server SMTP, chiedi all'amministratore di configurarlo.
|
||||
- **Ho inviato l'e-mail ma il cliente non l'ha ricevuta.** Guarda il [Log](Log), sezione *E-mail/PEC*: c'è la
|
||||
risposta del server per ogni tentativo.
|
||||
- **Devo correggere una fattura già inviata allo SDI.** Emetti una nota di credito (TD04) e una nuova fattura.
|
||||
|
||||
## Pagine correlate
|
||||
|
||||
[Anagrafiche](Anagrafiche) · [Articoli e listini](Articoli-e-listini) · [Magazzino](Magazzino) ·
|
||||
[Allegati e file](Allegati-e-file) · [Fatturazione elettronica](Fatturazione-elettronica) ·
|
||||
[Contabilità](Contabilita) · [Scadenzario](Scadenzario) · [CRM](CRM) · [Fiscalità italiana](Fiscalita-italiana)
|
||||
[Anagrafiche](Anagrafiche) · [Articoli e listini](Articoli-e-listini) · [Tabelle azienda](Tabelle-azienda) ·
|
||||
[Allegati e file](Allegati-e-file) · [Log](Log) · [Magazzino](Magazzino) ·
|
||||
[Fatturazione elettronica](Fatturazione-elettronica) · [Contabilità](Contabilita) · [Scadenzario](Scadenzario) ·
|
||||
[Fiscalità italiana](Fiscalita-italiana)
|
||||
@@ -1,5 +1,8 @@
|
||||
**[Khaemhat](Home)**
|
||||
|
||||
**Guida**
|
||||
- [Guida all'uso](Guida-utente)
|
||||
|
||||
**Installazione**
|
||||
- [Primi passi](Primi-passi)
|
||||
- [Unraid](Installazione-Unraid)
|
||||
|
||||
|
After Width: | Height: | Size: 188 KiB |
|
After Width: | Height: | Size: 182 KiB |
|
After Width: | Height: | Size: 74 KiB |
|
After Width: | Height: | Size: 113 KiB |
|
After Width: | Height: | Size: 121 KiB |
|
After Width: | Height: | Size: 69 KiB |
|
After Width: | Height: | Size: 119 KiB |
|
After Width: | Height: | Size: 165 KiB |
|
After Width: | Height: | Size: 118 KiB |
|
After Width: | Height: | Size: 174 KiB |
|
After Width: | Height: | Size: 115 KiB |
|
After Width: | Height: | Size: 149 KiB |
|
After Width: | Height: | Size: 190 KiB |
|
After Width: | Height: | Size: 100 KiB |
|
After Width: | Height: | Size: 97 KiB |
|
After Width: | Height: | Size: 73 KiB |
|
After Width: | Height: | Size: 97 KiB |
|
After Width: | Height: | Size: 133 KiB |
|
After Width: | Height: | Size: 65 KiB |
|
After Width: | Height: | Size: 130 KiB |
|
After Width: | Height: | Size: 172 KiB |
|
After Width: | Height: | Size: 130 KiB |
|
After Width: | Height: | Size: 136 KiB |
|
After Width: | Height: | Size: 75 KiB |
|
After Width: | Height: | Size: 93 KiB |
|
After Width: | Height: | Size: 178 KiB |
|
After Width: | Height: | Size: 177 KiB |
|
After Width: | Height: | Size: 178 KiB |
|
After Width: | Height: | Size: 199 KiB |
|
After Width: | Height: | Size: 166 KiB |
|
After Width: | Height: | Size: 220 KiB |
|
After Width: | Height: | Size: 100 KiB |
|
After Width: | Height: | Size: 117 KiB |
|
After Width: | Height: | Size: 168 KiB |
|
After Width: | Height: | Size: 98 KiB |
|
After Width: | Height: | Size: 62 KiB |
|
After Width: | Height: | Size: 147 KiB |
|
After Width: | Height: | Size: 66 KiB |
|
After Width: | Height: | Size: 69 KiB |
|
After Width: | Height: | Size: 142 KiB |
|
After Width: | Height: | Size: 113 KiB |
|
After Width: | Height: | Size: 108 KiB |
|
After Width: | Height: | Size: 119 KiB |
|
After Width: | Height: | Size: 90 KiB |
|
After Width: | Height: | Size: 99 KiB |
|
After Width: | Height: | Size: 145 KiB |
|
After Width: | Height: | Size: 118 KiB |
|
After Width: | Height: | Size: 102 KiB |
|
After Width: | Height: | Size: 92 KiB |
|
After Width: | Height: | Size: 99 KiB |
|
After Width: | Height: | Size: 105 KiB |
|
After Width: | Height: | Size: 109 KiB |
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 115 KiB |
|
After Width: | Height: | Size: 124 KiB |
|
After Width: | Height: | Size: 121 KiB |
@@ -3,7 +3,8 @@
|
||||
# Any KHAEMHAT_* variable already set in the shell wins over the defaults below.
|
||||
set -euo pipefail
|
||||
|
||||
root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
# Under Git Bash on Windows, pwd -W gives B:/... instead of /b/..., which .NET would read as a folder b on the drive.
|
||||
root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && (pwd -W 2>/dev/null || pwd))"
|
||||
cd "$root"
|
||||
|
||||
data_dir="$root/.data/dev"
|
||||
@@ -11,7 +12,10 @@ mkdir -p "$data_dir"
|
||||
|
||||
export ASPNETCORE_ENVIRONMENT="${ASPNETCORE_ENVIRONMENT:-Development}"
|
||||
export KHAEMHAT_DATA_DIR="${KHAEMHAT_DATA_DIR:-$data_dir}"
|
||||
export KHAEMHAT_SYSTEM_DB="${KHAEMHAT_SYSTEM_DB:-sqlite://$data_dir/system.db}"
|
||||
# sqlite:///home/... on Linux and macOS, sqlite:///B:/... on Windows.
|
||||
db_path="$data_dir"
|
||||
[[ "$db_path" == /* ]] || db_path="/$db_path"
|
||||
export KHAEMHAT_SYSTEM_DB="${KHAEMHAT_SYSTEM_DB:-sqlite://$db_path/system.db}"
|
||||
# Development-only key: never use it outside this script.
|
||||
export KHAEMHAT_SECRET_KEY="${KHAEMHAT_SECRET_KEY:-a2hhZW1oYXQtZGV2ZWxvcG1lbnQtb25seS1ub3QtYS1zZWNyZXQ=}"
|
||||
export KHAEMHAT_SUPERUSER="${KHAEMHAT_SUPERUSER:-root}"
|
||||
|
||||
@@ -3,6 +3,7 @@
|
||||
# tables still empty (--scale N repeats the demo catalogues N times). Rows already there are never changed.
|
||||
# scripts/seed.sh --base [--company CODE]
|
||||
# scripts/seed.sh --demo [--scale N] [--company CODE]
|
||||
# scripts/seed.sh --remove-demo [--company CODE] removes only the rows marked demo (and what belongs to them)
|
||||
# In the container (shipped as /app/scripts/seed.sh, same KHAEMHAT_* variables as the service):
|
||||
# docker compose run --rm --entrypoint /app/scripts/seed.sh khaemhat --base
|
||||
# On a development machine it runs the project with the variables already set in the shell (see scripts/run-dev.sh).
|
||||
|
||||
@@ -33,6 +33,7 @@ public sealed class AuditTrail(TimeProvider clock)
|
||||
{
|
||||
nameof(IAuditable.CreatedAt), nameof(IAuditable.CreatedBy), nameof(IAuditable.UpdatedAt), nameof(IAuditable.UpdatedBy), "RowVersion",
|
||||
"PasswordHash", "PasswordHistory", "TotpSecret", "TotpRecoveryCodes", "RecoveryTokenHash", "TokenHash", "ConnectionString",
|
||||
"ProtectedPassword", "ProtectedCertificate", "ProtectedCertificatePassword", "ProtectedApiKey", "Content", "Metadata",
|
||||
};
|
||||
|
||||
/// <summary>Writes the history row of a change, inside the caller's unit of work.</summary>
|
||||
|
||||
@@ -105,7 +105,7 @@ public static class WidgetCatalog
|
||||
new(WidgetIds.CrmActivities, "Dashboard.Widgets.CrmActivities.Title", "target", 6, ModuleCodes.Crm, "crm.lead.read", Milestone: "M11"),
|
||||
new(WidgetIds.Notes, "Dashboard.Widgets.Notes.Title", "edit", 4, ModuleCodes.Core),
|
||||
new(WidgetIds.Shortcuts, "Dashboard.Widgets.Shortcuts.Title", "zap", 4, ModuleCodes.Core),
|
||||
new(WidgetIds.Understock, "Dashboard.Widgets.Understock.Title", "box", 6, ModuleCodes.Core, "inventory.stock.read", Milestone: "M6"),
|
||||
new(WidgetIds.Understock, "Dashboard.Widgets.Understock.Title", "box", 6, ModuleCodes.Core, "inventory.stock.read"),
|
||||
new(WidgetIds.Pipeline, "Dashboard.Widgets.Pipeline.Title", "target", 6, ModuleCodes.Crm, "crm.lead.read", Milestone: "M11"),
|
||||
new(WidgetIds.RecentDocuments, "Dashboard.Widgets.RecentDocuments.Title", "file", 6, ModuleCodes.Core, "sales.invoice.read", Milestone: "M5"),
|
||||
new(WidgetIds.SystemStatus, "Dashboard.Widgets.System.Title", "shield", 4, ModuleCodes.Core, InstanceOnly: true),
|
||||
|
||||
@@ -0,0 +1,201 @@
|
||||
using Khaemhat.Core.Documents;
|
||||
using Khaemhat.Core.Parties;
|
||||
using Khaemhat.Core.Tables;
|
||||
using Khaemhat.Data;
|
||||
using Khaemhat.Data.Querying;
|
||||
using Khaemhat.Fiscal.Abstractions;
|
||||
|
||||
namespace Khaemhat.Application.Documents;
|
||||
|
||||
/// <summary>The totals of a stored document: its tax summary and installments, as written by the last save.</summary>
|
||||
/// <param name="Summary">The tax summary.</param>
|
||||
/// <param name="Installments">The installments.</param>
|
||||
public sealed record DocumentFigures(IReadOnlyList<DocumentTaxSummary> Summary, IReadOnlyList<DocumentInstallment> Installments)
|
||||
{
|
||||
/// <summary>No figures.</summary>
|
||||
public static DocumentFigures Empty { get; } = new([], []);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Applies <see cref="DocumentTotalsCalculator"/> and <see cref="InstallmentGenerator"/> to a document being saved:
|
||||
/// writes the line amounts and header totals, then replaces its tax summary and installments (issue #48).
|
||||
/// </summary>
|
||||
internal static class DocumentCalculation
|
||||
{
|
||||
/// <summary>Computes the totals of a document in place.</summary>
|
||||
/// <param name="uow">The unit of work.</param>
|
||||
/// <param name="engine">The country's tax engine.</param>
|
||||
/// <param name="behavior">The behaviour of the document.</param>
|
||||
/// <param name="record">The document.</param>
|
||||
/// <param name="cancellationToken">Cancellation.</param>
|
||||
/// <returns>The tax summary and installments to write once the document has its id.</returns>
|
||||
public static async Task<DocumentFigures> ApplyAsync(IUnitOfWork uow, ITaxEngine engine, DocumentBehavior behavior, DocumentRecord record, CancellationToken cancellationToken)
|
||||
{
|
||||
var header = record.Header;
|
||||
var taxCodes = await TaxCodesAsync(uow, record, cancellationToken).ConfigureAwait(false);
|
||||
var options = new TotalsOptions
|
||||
{
|
||||
PricesIncludeTax = header.PricesIncludeTax,
|
||||
FooterDiscount = header.FooterDiscount,
|
||||
Exigibility = header.Exigibility,
|
||||
SplitPayment = header.SplitPayment,
|
||||
StampDutyApplies = behavior.Direction == DocumentDirection.Sale && behavior.Has(DocumentEffects.EInvoice),
|
||||
StampDutyCharged = header.StampDutyCharged,
|
||||
WithholdingRate = header.WithholdingRate,
|
||||
WithholdingBasePercent = header.WithholdingBasePercent <= 0m ? 100m : header.WithholdingBasePercent,
|
||||
SocialSecurityRate = header.SocialSecurityRate,
|
||||
SocialSecurityTax = header.SocialSecurityTaxCodeId is { } id && taxCodes.TryGetValue(id, out var own) ? own : null,
|
||||
SocialSecurityWithheld = header.SocialSecurityWithheld,
|
||||
EnasarcoRate = header.EnasarcoRate,
|
||||
};
|
||||
var lines = record.Lines
|
||||
.Select(l => new TotalsLine(l.Kind, l.Quantity, l.Price, l.DiscountFormula,
|
||||
l.TaxCodeId is { } t && taxCodes.TryGetValue(t, out var tax) ? tax : null, l.WithholdingExcluded))
|
||||
.ToList();
|
||||
var totals = DocumentTotalsCalculator.Compute(lines, options, engine);
|
||||
for (var i = 0; i < record.Lines.Count; i++)
|
||||
{
|
||||
record.Lines[i].TaxableAmount = totals.LineAmounts[i];
|
||||
}
|
||||
|
||||
header.TaxableAmount = totals.Taxable;
|
||||
header.TaxAmount = totals.Tax;
|
||||
header.TotalAmount = totals.Total;
|
||||
header.ExpensesAmount = totals.Expenses;
|
||||
header.FooterDiscountAmount = totals.FooterDiscountAmount;
|
||||
header.StampDuty = totals.StampDuty;
|
||||
header.WithholdingAmount = totals.Withholding;
|
||||
header.SocialSecurityAmount = totals.SocialSecurity;
|
||||
header.EnasarcoAmount = totals.Enasarco;
|
||||
header.NetAmount = totals.Net;
|
||||
|
||||
var summary = totals.Summary.Select(s => new DocumentTaxSummary
|
||||
{
|
||||
Family = record.Family,
|
||||
TaxCodeId = s.Tax.TaxCodeId,
|
||||
Rate = s.Tax.Rate,
|
||||
Nature = s.Tax.Nature,
|
||||
Exigibility = s.Tax.Exigibility,
|
||||
NonDeductiblePercent = s.Tax.NonDeductiblePercent,
|
||||
LegalReference = s.Tax.LegalReference,
|
||||
Taxable = s.Taxable,
|
||||
Tax = s.TaxAmount,
|
||||
NonDeductibleTax = s.NonDeductibleTax,
|
||||
}).ToList();
|
||||
|
||||
var installments = new List<DocumentInstallment>();
|
||||
if (behavior.Has(DocumentEffects.Installments) || behavior.Kind is DocumentKind.ProForma or DocumentKind.SalesOrder or DocumentKind.Quotation)
|
||||
{
|
||||
installments = await InstallmentsAsync(uow, engine, behavior, record, totals, cancellationToken).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
return new DocumentFigures(summary, installments);
|
||||
}
|
||||
|
||||
/// <summary>Replaces the tax summary and installments of a document.</summary>
|
||||
/// <param name="uow">The unit of work.</param>
|
||||
/// <param name="family">The family.</param>
|
||||
/// <param name="documentId">The document.</param>
|
||||
/// <param name="figures">The new rows.</param>
|
||||
/// <param name="cancellationToken">Cancellation.</param>
|
||||
/// <returns>A task.</returns>
|
||||
public static async Task WriteAsync(IUnitOfWork uow, DocumentFamily family, long documentId, DocumentFigures figures, CancellationToken cancellationToken)
|
||||
{
|
||||
var summaries = uow.Repository<DocumentTaxSummary, long>();
|
||||
var installments = uow.Repository<DocumentInstallment, long>();
|
||||
var where = SqlFragment.Of($"family = {family.ToString()} AND document_id = {documentId}");
|
||||
foreach (var old in (await summaries.ListAsync(Query.For<DocumentTaxSummary>().Where(where), cancellationToken).ConfigureAwait(false)).Items)
|
||||
{
|
||||
await summaries.DeleteAsync(old.Id, cancellationToken).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
foreach (var old in (await installments.ListAsync(Query.For<DocumentInstallment>().Where(where), cancellationToken).ConfigureAwait(false)).Items)
|
||||
{
|
||||
await installments.DeleteAsync(old.Id, cancellationToken).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
foreach (var row in figures.Summary)
|
||||
{
|
||||
row.Id = 0;
|
||||
row.Family = family;
|
||||
row.DocumentId = documentId;
|
||||
await summaries.InsertAsync(row, cancellationToken).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
foreach (var row in figures.Installments)
|
||||
{
|
||||
row.Id = 0;
|
||||
row.Family = family;
|
||||
row.DocumentId = documentId;
|
||||
await installments.InsertAsync(row, cancellationToken).ConfigureAwait(false);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>Reads the tax summary and installments of a document.</summary>
|
||||
/// <param name="uow">The unit of work.</param>
|
||||
/// <param name="family">The family.</param>
|
||||
/// <param name="documentId">The document.</param>
|
||||
/// <param name="cancellationToken">Cancellation.</param>
|
||||
/// <returns>The rows.</returns>
|
||||
public static async Task<DocumentFigures> ReadAsync(IUnitOfWork uow, DocumentFamily family, long documentId, CancellationToken cancellationToken)
|
||||
{
|
||||
var where = SqlFragment.Of($"family = {family.ToString()} AND document_id = {documentId}");
|
||||
var summary = await uow.Repository<DocumentTaxSummary, long>()
|
||||
.ListAsync(Query.For<DocumentTaxSummary>().Where(where).OrderByDescending(s => s.Rate), cancellationToken).ConfigureAwait(false);
|
||||
var installments = await uow.Repository<DocumentInstallment, long>()
|
||||
.ListAsync(Query.For<DocumentInstallment>().Where(where).OrderBy(s => s.Number), cancellationToken).ConfigureAwait(false);
|
||||
return new DocumentFigures(summary.Items, installments.Items);
|
||||
}
|
||||
|
||||
private static async Task<Dictionary<long, TotalsTax>> TaxCodesAsync(IUnitOfWork uow, DocumentRecord record, CancellationToken cancellationToken)
|
||||
{
|
||||
var ids = record.Lines.Where(l => l.TaxCodeId is not null).Select(l => l.TaxCodeId!.Value).ToHashSet();
|
||||
if (record.Header.SocialSecurityTaxCodeId is { } own)
|
||||
{
|
||||
ids.Add(own);
|
||||
}
|
||||
|
||||
if (ids.Count == 0)
|
||||
{
|
||||
return [];
|
||||
}
|
||||
|
||||
var list = ids.ToList();
|
||||
var codes = await uow.Repository<TaxCode, long>().ListAsync(Query.For<TaxCode>().Where(c => list.Contains(c.Id)), cancellationToken).ConfigureAwait(false);
|
||||
return codes.Items.ToDictionary(c => c.Id, c => new TotalsTax(c.Id, c.Rate, string.IsNullOrWhiteSpace(c.Nature) ? null : c.Nature,
|
||||
c.Exigibility, c.NonDeductiblePercent, c.LegalReference));
|
||||
}
|
||||
|
||||
private static async Task<List<DocumentInstallment>> InstallmentsAsync(
|
||||
IUnitOfWork uow, ITaxEngine engine, DocumentBehavior behavior, DocumentRecord record, DocumentTotals totals, CancellationToken cancellationToken)
|
||||
{
|
||||
var header = record.Header;
|
||||
PaymentTerm? term = null;
|
||||
IReadOnlyList<PaymentTermLine> termLines = [];
|
||||
if (header.PaymentTermId is { } termId)
|
||||
{
|
||||
term = await uow.Repository<PaymentTerm, long>().GetAsync(termId, cancellationToken).ConfigureAwait(false);
|
||||
termLines = (await uow.Repository<PaymentTermLine, long>()
|
||||
.ListAsync(Query.For<PaymentTermLine>().Where(l => l.PaymentTermId == termId).OrderBy(l => l.Number), cancellationToken).ConfigureAwait(false)).Items;
|
||||
}
|
||||
|
||||
ExcludedMonths? excluded = null;
|
||||
if (behavior.Direction == DocumentDirection.Sale && header.PartyId is { } partyId)
|
||||
{
|
||||
var terms = await uow.Repository<PartySalesTerms, long>()
|
||||
.FindAsync(Query.For<PartySalesTerms>().Where(t => t.PartyId == partyId), cancellationToken).ConfigureAwait(false);
|
||||
if (terms is { } t && (t.ExcludedMonth1 is not null || t.ExcludedMonth2 is not null))
|
||||
{
|
||||
excluded = new ExcludedMonths(t.ExcludedMonth1, t.ExcludedMonth2, t.ExcludedMonthsDay ?? 10);
|
||||
}
|
||||
}
|
||||
|
||||
var paidTax = totals.Tax - totals.SplitPaymentTax;
|
||||
var dues = InstallmentGenerator.Generate(
|
||||
header.DocumentDate, totals.Net, paidTax,
|
||||
[.. termLines.Select(l => new InstallmentRule(l.Days, l.EndOfMonth, l.FixedDay, l.Percent))],
|
||||
term?.VatOnFirstInstallment ?? false, excluded, engine.Round);
|
||||
var method = header.PaymentMethodId ?? term?.PaymentMethodId;
|
||||
return [.. dues.Select(d => new DocumentInstallment { Number = d.Number, DueDate = d.DueDate, Amount = d.Amount, PaymentMethodId = method })];
|
||||
}
|
||||
}
|
||||