diff --git a/CHANGELOG.md b/CHANGELOG.md index 75133c9..b291c48 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,61 @@ un'immagine `gitea.encke-hake.ts.net/balbosoft/khaemhat:X.Y.Z`. ## [Unreleased] +## [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 diff --git a/docs/STATUS.md b/docs/STATUS.md index ab96acd..f149cd4 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -3,18 +3,21 @@ > Punto di ripresa per ogni sessione. Aggiornare a fine sessione. **Ultimo aggiornamento:** 2026-11-12 -**Milestone corrente:** M6 — Acquisti e Magazzino (issue #55-#61), **non ancora iniziata**: si parte quando il -titolare lo dice. M5 chiusa: PR #124 in `main`, tag `v0.5.0`, immagine e release. -**Prossimo passo:** M6 dall'issue #55. #35 (PNG ad alta risoluzione) resta aperta e non blocca; #45 resta aperta solo +**Milestone corrente:** M6 — Acquisti e Magazzino (issue #55-#61), **completata sul ramo** +`feat/55-acquisti-magazzino`, in attesa del via del titolare per il merge in `main`, il tag `v0.6.0`, l'immagine e la +release. M5 chiusa: PR #124 in `main`, tag `v0.5.0`. +**Prossimo passo:** dopo il merge di M6, M7 (Contabilità generale) dall'issue #62 quando il titolare lo dice. #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). ## Fatto - Specifica normativa in `docs/SPEC.md`; `CLAUDE.md` con emendamenti E1-E7. -- ADR 0001-0034. +- ADR 0001-0035. - 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`, @@ -66,6 +69,15 @@ logo PNG nel PDF (oggi solo JPEG, ADR 0034); coda della posta persistente e mode 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 (completata sul ramo, PR verso `main` in attesa del via, `v0.6.0`):** 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). - 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, diff --git a/docs/adr/0035-magazzino-e-ciclo-passivo.md b/docs/adr/0035-magazzino-e-ciclo-passivo.md new file mode 100644 index 0000000..adb870e --- /dev/null +++ b/docs/adr/0035-magazzino-e-ciclo-passivo.md @@ -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). diff --git a/docs/wiki/Acquisti.md b/docs/wiki/Acquisti.md index 9622b67..c9ed07e 100644 --- a/docs/wiki/Acquisti.md +++ b/docs/wiki/Acquisti.md @@ -1,178 +1,179 @@ # 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. Arrivano più avanti: la **registrazione contabile** e i registri IVA (M7), +> i **pagamenti** e lo scadenzario (M8), 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 -![031 · Ordine fornitore generato dalla proposta di riordino](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/031-ordine-fornitore.png) -*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)). +![Khaemhat 0.6.0 · ricevimento della merce](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/acquisti-ricevimento.png) -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*). -![032 · DDT di carico con controllo quantità ricevute](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/032-ddt-di-carico.png) -*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. +![Khaemhat 0.6.0 · fattura fornitore con differenza di prezzo](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/acquisti-fattura-differenze.png) -## Fatture di acquisto - -![033 · Fattura di acquisto da XML con conti e centri di costo per riga](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/033-fattura-di-acquisto.png) -*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 +![Khaemhat 0.6.0 · import delle fatture passive](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/acquisti-importa-fatture.png) -![034 · Import fatture passive XML/P7M](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/034-import-xml-sdi.png) -*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. -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) -![035 · Autofattura / integrazione reverse charge](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/035-autofattura-integrazione.png) -*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).* +![Khaemhat 0.6.0 · integrazione da emettere su una fattura intracomunitaria](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/acquisti-fattura-autofattura.png) -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): +![Khaemhat 0.6.0 · integrazioni da emettere](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/acquisti-autofatture-in-attesa.png) -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 +arrivano con la [Fatturazione elettronica](Fatturazione-elettronica) (M9); la doppia registrazione nei registri IVA +vendite e acquisti con la [Contabilità](Contabilita) (M7). 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 diff --git a/docs/wiki/Articoli-e-listini.md b/docs/wiki/Articoli-e-listini.md index 07585b6..ff3cc93 100644 --- a/docs/wiki/Articoli-e-listini.md +++ b/docs/wiki/Articoli-e-listini.md @@ -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 diff --git a/docs/wiki/Attivita-programmate.md b/docs/wiki/Attivita-programmate.md index faec5c4..1de2141 100644 --- a/docs/wiki/Attivita-programmate.md +++ b/docs/wiki/Attivita-programmate.md @@ -137,13 +137,16 @@ 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.6.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 | 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, diff --git a/docs/wiki/Changelog.md b/docs/wiki/Changelog.md index 7fa9a19..b30a694 100644 --- a/docs/wiki/Changelog.md +++ b/docs/wiki/Changelog.md @@ -1,6 +1,6 @@ # Changelog -> **Stato:** completa per 0.5.0 · **Ultima revisione:** 2026-11-12 +> **Stato:** completa per 0.6.0 · **Ultima revisione:** 2026-11-12 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,7 @@ Le novità di ogni versione sono nel file | Versione | Data | Contenuto | |---|---|---| +| 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). | diff --git a/docs/wiki/Dashboard.md b/docs/wiki/Dashboard.md index 5ca7fb5..1326c54 100644 --- a/docs/wiki/Dashboard.md +++ b/docs/wiki/Dashboard.md @@ -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 | diff --git a/docs/wiki/Dati-di-base-e-esempio.md b/docs/wiki/Dati-di-base-e-esempio.md index 85b07bf..7029ee1 100644 --- a/docs/wiki/Dati-di-base-e-esempio.md +++ b/docs/wiki/Dati-di-base-e-esempio.md @@ -1,6 +1,6 @@ # Dati di base e di esempio -> **Stato:** completa per M5 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.5.0 (dati di esempio di acquisti, magazzino e contabilità con i moduli, completi in M9) +> **Stato:** completa per M5 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.6.0 (dati di esempio di contabilità con il modulo, completi in M9) > **Modulo di licenza:** CORE · **Livello richiesto:** amministratore (rimozione dati di esempio: super utente) · **Specifica:** SPEC §6, §12.11, §14 ## A cosa serve @@ -148,7 +148,19 @@ pagina delle stampe) e **un anno di vendite** costruite con il motore dei docume 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. Il resto della tabella arriva con le milestone dei rispettivi moduli. +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. 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. diff --git a/docs/wiki/Guida-utente.md b/docs/wiki/Guida-utente.md index 979fd8c..e5b266e 100644 --- a/docs/wiki/Guida-utente.md +++ b/docs/wiki/Guida-utente.md @@ -1,6 +1,6 @@ # Guida all'uso -> **Stato:** completa per la versione 0.5 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.5.0 (M5) +> **Stato:** completa per la versione 0.6 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.6.0 (M6) 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 @@ -9,18 +9,19 @@ volta, con le schermate della versione attuale. Ogni passo rimanda alla pagina c ## Che cosa c'è in questa versione -| Area | In 0.5.0 | Arriva con | +| Area | In 0.6.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 | giacenze: M6 | -| Vendite | preventivi, ordini, DDT, fatture, note, pro forma, fatturazione differita, stampa PDF, invio per e-mail | magazzino M6, contabilità M7, partite M8, XML SDI M9 | -| Acquisti e magazzino | — | M6 | +| 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 | contabilità M7, partite M8, XML SDI M9 | +| 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 | registri IVA M7, pagamenti M8, XML delle autofatture M9 | +| Magazzino | giacenze per deposito, impegnato e ordinato, costo medio, movimenti e trasferimenti, inventario fisico, proposta di riordino, valorizzazione con classi ABC, ricostruzione | libro inventari M7 | | Contabilità, IVA, scadenzario | — | M7, M8 | | Fatturazione elettronica | — | M9 | -| Import ed export | clienti, fornitori, articoli e prezzi da CSV, Excel e JSON; esportazione dai radar | giacenze iniziali M6, piano dei conti M7 | +| Import ed export | clienti, fornitori, articoli, prezzi e giacenze iniziali da CSV, Excel e JSON; esportazione dai radar | piano dei conti M7 | | 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. @@ -121,22 +122,53 @@ La **stampante** della toolbar (`Ctrl+P`) apre l'anteprima: **Stampa** con la st 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. Allegati +## 8. Comprare + +![Fattura fornitore con differenza di prezzo](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/acquisti-fattura-differenze.png) + +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. + +![Import delle fatture passive](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/acquisti-importa-fatture.png) + +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 + +![Giacenze e disponibilità](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/magazzino-giacenze.png) + +**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. + +![Proposta di riordino](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/magazzino-riordino.png) + +**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. Allegati ![Pannello allegati](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/allegati-pannello.png) 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). -## 9. Importare ed esportare +## 11. Importare ed esportare ![Mappatura delle colonne](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/import-export-mappatura.png) -**Amministrazione → Import/Export** porta in Khaemhat clienti, fornitori, articoli e prezzi di listino da un file +**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). -## 10. Personalizzare +## 12. Personalizzare ![Il mio profilo](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/preferenze-profilo.png) @@ -157,4 +189,5 @@ prezzi) sono in **Tabelle azienda → Preferenze**. Vedi [Preferenze utente](Pre [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) · [Allegati e file](Allegati-e-file) · [Import/Export](Import-Export) · [Preferenze utente](Preferenze-utente) diff --git a/docs/wiki/Home.md b/docs/wiki/Home.md index 5ad5149..fb78f92 100644 --- a/docs/wiki/Home.md +++ b/docs/wiki/Home.md @@ -1,6 +1,6 @@ # Khaemhat -> **Stato:** completa per 0.5.0 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.5.0 (M5; sviluppo in corso) +> **Stato:** completa per 0.6.0 · **Ultima revisione:** 2026-11-12 · **Versione software:** 0.6.0 (M6; sviluppo in corso) ![Khaemhat](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/assets/icon-v1.0-128.png) diff --git a/docs/wiki/Import-Export.md b/docs/wiki/Import-Export.md index 385c906..af9ccc5 100644 --- a/docs/wiki/Import-Export.md +++ b/docs/wiki/Import-Export.md @@ -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 in M7; saldi e partite di apertura in M7 e M9) > **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,11 +94,14 @@ 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) diff --git a/docs/wiki/Magazzino.md b/docs/wiki/Magazzino.md index f00e295..b7cf4f7 100644 --- a/docs/wiki/Magazzino.md +++ b/docs/wiki/Magazzino.md @@ -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** (M7), 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à -![036 · Giacenze, disponibilità, sottoscorta](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/036-giacenze.png) -*Mockup 036 — striscia di indicatori (valore magazzino, articoli gestiti, sottoscorta, sotto riordino, in arrivo) e griglia giacenze con stato (anteprima ridotta).* +![Khaemhat 0.6.0 · giacenze e disponibilità](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/magazzino-giacenze.png) -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 -![037 · Movimento di magazzino manuale (trasferimento)](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/037-movimento-magazzino.png) -*Mockup 037 — trasferimento in bozza dal deposito SEDE al deposito furgone, con disponibilità all'origine e valore (anteprima ridotta).* +![Khaemhat 0.6.0 · movimenti di un articolo](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/magazzino-movimenti-articolo.png) -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 -![038 · Inventario fisico con conteggi e rettifiche](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/038-inventario-fisico.png) -*Mockup 038 — inventario guidato in cinque passi, griglia con giacenza teorica, contato, differenza, valore e rettifica (anteprima ridotta).* +![Khaemhat 0.6.0 · inventario fisico in conteggio](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/magazzino-inventario.png) -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 -![039 · Proposta di riordino fornitori dal sottoscorta](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/mockups/thumbs/039-proposta-di-riordino.png) -*Mockup 039 — proposta di riordino: indicatori, criterio di calcolo, quantità proposta modificabile e fornitore per riga (anteprima ridotta).* +![Khaemhat 0.6.0 · proposta di riordino](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/magazzino-riordino.png) -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**. +![Khaemhat 0.6.0 · valorizzazione con classi ABC](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/raw/branch/main/docs/wiki/img/magazzino-valorizzazione.png) + +- 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 [Contabilità](Contabilita) (M7). ## 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) diff --git a/docs/wiki/Roadmap.md b/docs/wiki/Roadmap.md index dc2906b..ee677f5 100644 --- a/docs/wiki/Roadmap.md +++ b/docs/wiki/Roadmap.md @@ -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), M5 (0.5.0). **Prossima:** M6. +**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). **Prossima:** M7. | # | Milestone | Contenuto principale | Versione | |---|---|---|---| diff --git a/docs/wiki/Vendite.md b/docs/wiki/Vendite.md index 2c65130..88c1a20 100644 --- a/docs/wiki/Vendite.md +++ b/docs/wiki/Vendite.md @@ -9,8 +9,9 @@ accompagnatorie, differite, di acconto, parcelle), **note di credito e di debito 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. Arrivano più avanti: lo **scarico di magazzino** e l'impegno (M6, con il -> magazzino), la **registrazione contabile** (M7), le **partite** e il controllo del fido (M8), il **file XML** per lo +> 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)). Arrivano più avanti: la +> **registrazione contabile** (M7), le **partite** e il controllo del fido (M8), il **file XML** per lo > SDI (M9) e il collegamento alle opportunità del **CRM** (M11). I pulsanti di queste funzioni compaiono quando la > funzione c'è. @@ -148,8 +149,8 @@ e CUP, riportati nella stampa. 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. Lo scarico del -magazzino arriva con M6. +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 diff --git a/docs/wiki/img/acquisti-autofatture-in-attesa.png b/docs/wiki/img/acquisti-autofatture-in-attesa.png new file mode 100644 index 0000000..fda7d79 Binary files /dev/null and b/docs/wiki/img/acquisti-autofatture-in-attesa.png differ diff --git a/docs/wiki/img/acquisti-fattura-autofattura.png b/docs/wiki/img/acquisti-fattura-autofattura.png new file mode 100644 index 0000000..0fd28a8 Binary files /dev/null and b/docs/wiki/img/acquisti-fattura-autofattura.png differ diff --git a/docs/wiki/img/acquisti-fattura-differenze.png b/docs/wiki/img/acquisti-fattura-differenze.png new file mode 100644 index 0000000..5b49225 Binary files /dev/null and b/docs/wiki/img/acquisti-fattura-differenze.png differ diff --git a/docs/wiki/img/acquisti-importa-fatture.png b/docs/wiki/img/acquisti-importa-fatture.png new file mode 100644 index 0000000..7aaf16e Binary files /dev/null and b/docs/wiki/img/acquisti-importa-fatture.png differ diff --git a/docs/wiki/img/acquisti-ricevimento.png b/docs/wiki/img/acquisti-ricevimento.png new file mode 100644 index 0000000..47a3f99 Binary files /dev/null and b/docs/wiki/img/acquisti-ricevimento.png differ diff --git a/docs/wiki/img/magazzino-giacenze.png b/docs/wiki/img/magazzino-giacenze.png new file mode 100644 index 0000000..b592ba2 Binary files /dev/null and b/docs/wiki/img/magazzino-giacenze.png differ diff --git a/docs/wiki/img/magazzino-inventario.png b/docs/wiki/img/magazzino-inventario.png new file mode 100644 index 0000000..3f3a1f8 Binary files /dev/null and b/docs/wiki/img/magazzino-inventario.png differ diff --git a/docs/wiki/img/magazzino-movimenti-articolo.png b/docs/wiki/img/magazzino-movimenti-articolo.png new file mode 100644 index 0000000..03e2cd3 Binary files /dev/null and b/docs/wiki/img/magazzino-movimenti-articolo.png differ diff --git a/docs/wiki/img/magazzino-riordino.png b/docs/wiki/img/magazzino-riordino.png new file mode 100644 index 0000000..43a10d3 Binary files /dev/null and b/docs/wiki/img/magazzino-riordino.png differ diff --git a/docs/wiki/img/magazzino-valorizzazione.png b/docs/wiki/img/magazzino-valorizzazione.png new file mode 100644 index 0000000..983c4ed Binary files /dev/null and b/docs/wiki/img/magazzino-valorizzazione.png differ