Chiusura commessa#
A cosa serve#
Gestisce la chiusura definitiva di una commessa: analizza i saldi di giacenza per ogni merce e cantiere, consente di creare i documenti di reso e fatturazione residua, e aggiorna lo stato della commessa a "C" (chiusa).
Il programma COGG4B produce fino a 4 tipi di documento per ogni cantiere coinvolto, gestendo in un'unica operazione resi, fatturazione e scarico della giacenza residua.
Come si accede#
Dal menu Vendite > Commesse > Funzioni documenti > Movimentazione e chiusura commessa oppure direttamente dalla gestione commesse (COGG52), programma COGG4B.
Il programma puo' anche essere richiamato in modalita' "called" da altri programmi, passando il codice commessa come parametro.
Operativita'#
Esempio: chiusura di un cantiere di installazione#
La commessa C-2024/101 (climatizzazione) e' terminata. Sul cantiere "Via Garibaldi 15" restano: 2 raccordi in rame (non usati), 5 metri di cavo (non usati) e 1 compressore (gia' installato e fatturato). L'operatore deve:
- I raccordi avanzati vanno restituiti al magazzino → li indica nella colonna "Reso NF" (reso senza fattura, perche' non erano stati fatturati al cliente)
- Il cavo avanzato va restituito al magazzino → lo indica anch'esso in "Reso NF"
- Il compressore era gia' stato fatturato e resta installato → non serve nessuna azione
Dopo F3, il sistema crea un DDT di reso che riporta raccordi e cavo dal cantiere al magazzino centrale. Premendo F6 (Chiudi), il sistema chiude definitivamente la commessa.
Inserimento dati iniziali#
All'apertura si presenta una maschera con i seguenti campi:
| Campo | Descrizione |
|---|---|
| Commessa | Codice commessa (obbligatorio). Deve essere una commessa in stato "A" (aperta) e agganciata a un cliente |
| Data analisi | Data di riferimento per il calcolo dei saldi (facoltativa) |
| Data creazione movimenti | Data che verra' assegnata ai documenti generati (obbligatoria, default: data odierna) |
Dopo aver confermato con F3, il sistema chiama COGR32 per ricalcolare le giacenze della commessa e presenta una griglia con il dettaglio per merce e cantiere.
Analisi saldi#
La griglia mostra una riga per ogni combinazione merce/cantiere con le seguenti colonne:
| Colonna | Descrizione |
|---|---|
| Cantiere | Codice cantiere di appartenenza |
| Merce | Codice merce (formato articolo avanzato se configurato) |
| Giacenza | Quantita' attualmente presente in commessa/cantiere |
| Qta fatturabile | Quantita' ancora da fatturare |
| Qta fatturata | Quantita' gia' fatturata (calcolata come Giacenza - Qta fatturabile) |
| Reso NF | Quantita' da restituire senza fattura (digitabile) |
| Reso FT | Quantita' da restituire con fattura (digitabile) |
| Da Fatturare | Quantita' da inserire nel documento di fatturazione (digitabile) |
| Giacenza residua | Quantita' che resta dopo resi e fatturazione (calcolata automaticamente) |
L'operatore compila le colonne Reso NF, Reso FT e Da Fatturare per le righe che intende movimentare.
Calcolo automatico (F2)#
Il pulsante "Tutto da fatturare" (F2) compila automaticamente le quantita' per tutte le righe che hanno merce da fatturare:
- Se la giacenza e' inferiore alla quantita' fatturabile:
Da Fatturare = Giacenza - Reso FT - Reso NF - Altrimenti:
Da Fatturare = Qta fatturabile - Reso NF
La giacenza residua viene ricalcolata di conseguenza come Giacenza - Reso NF - Reso FT - Da Fatturare.
Generazione documenti (F3)#
Premendo F3 (Aggiorna) si avvia la generazione dei documenti. Il sistema verifica che almeno una riga abbia quantita' compilate, poi chiede conferma.
Vengono generati fino a 4 tipi di documento per ogni cantiere (massimo 10 cantieri):
| Tipo documento | Classe documento | Descrizione |
|---|---|---|
| Reso NF | Configurazione CLASSE-RESO-NF | DDT di reso merce non fatturata: rientra in magazzino senza passare per fattura |
| Reso FT | Configurazione CLASSE-RESO-FT | DDT di reso merce gia' fatturata: genera nota di credito |
| Da Fatturare | Configurazione CLASSE-CHIUSURA-FT | DDT per la fatturazione della merce residua in commessa |
| Chiusura (giacenza residua) | Configurazione CLASSE-CHIUSURA-NF | DDT di scarico per la giacenza residua non fatturata (solo in fase di chiusura F6) |
I documenti vengono suddivisi per cantiere: ogni cantiere genera i propri DDT separati.
Per ogni documento generato, il programma: 1. Prepara le righe nel file transito (TRAN-G43) con merce, quantita', classe documento e cantiere 2. Chiama COGU30 per la creazione effettiva del documento di magazzino 3. Mostra a video il numero del documento creato con possibilita' di gestirlo (F3 sulla dialog)
I documenti di reso NF e reso FT vengono gestiti tramite COGV15 (bolle magazzino), mentre i documenti da fatturare e di chiusura vengono gestiti tramite COGV56 (fatturazione).
Chiusura definitiva (F6)#
Il pulsante "Chiudi" (F6) esegue la chiusura completa della commessa:
- Verifica prerequisiti: controlla classi documento configurate e, per commesse in economia, verifica che la data di estrazione sia maggiore o uguale alla data di creazione movimenti
- Chiede conferma: "Confermi l'esecuzione della chiusura commessa?"
- Genera documenti: esegue la stessa logica di F3 (resi e fatturazione) piu' il documento di chiusura per la giacenza residua
- Aggiorna distinta base impianto: se la configurazione
commessa-impianto = "S", chiama COGUA4 per aggiornare la distinta base della matricola impianto collegata alla commessa, riflettendo i materiali effettivamente presenti - Aggiorna stato commessa: imposta stato = "C" (chiusa) e scrive la data di chiusura sulla testata commessa
Tasti funzione#
| Tasto | Funzione |
|---|---|
| F1 | Configurazione: apre la maschera dei parametri commesse |
| F2 | Tutto da fatturare: calcola automaticamente le quantita' per tutte le righe |
| F3 | Conferma/Aggiorna: genera i documenti senza chiudere la commessa |
| F6 | Chiudi: genera documenti + chiude definitivamente la commessa |
| F8 | Dettaglio: mostra il dettaglio della merce selezionata (COGW54) |
| F8 | Aiuto/Ricerca (su campo commessa) |
| F8 | Calendario (su campi data) |
| F10 | Giornalieri: apre la visualizzazione giornalieri della commessa (COGX49) |
| Shift+F4 | Amministrazione griglia: personalizzazione colonne |
| ESC | Esci dal programma |
Regole di business#
Prerequisiti per la chiusura#
- La commessa deve essere in stato A (aperta). Se la commessa non e' aperta, il sistema mostra: "La Commessa deve essere Aperta!"
- La commessa deve essere agganciata a un cliente (
tsc-ana-tip = "C"). Senza cliente non e' possibile generare i documenti - Le 4 classi documento devono essere configurate: CLASSE-RESO-NF, CLASSE-RESO-FT, CLASSE-CHIUSURA-NF, CLASSE-CHIUSURA-FT. Se mancano, il sistema mostra: "Mancano le classi per creare i documenti"
Vincoli sulle quantita'#
Le quantita' digitate dall'operatore sono soggette ai seguenti controlli:
| Vincolo | Descrizione |
|---|---|
| Reso NF + Reso FT + Da Fatturare <= Giacenza | Il totale delle quantita' movimentate non puo' superare la giacenza disponibile |
| Reso NF <= Qta fatturabile | Il reso non fatturato non puo' superare la quantita' ancora fatturabile |
| Reso FT <= Qta fatturata | Il reso fatturato non puo' superare la quantita' gia' fatturata (Giacenza - Qta fatturabile) |
| Da Fatturare <= Qta fatturabile | La quantita' da fatturare non puo' superare la quantita' fatturabile residua |
Suddivisione per cantiere#
I documenti vengono raggruppati per cantiere (massimo 10 cantieri per elaborazione). Ogni cantiere genera i propri DDT separati. Il cantiere viene indicato nel documento tramite il campo magazzino periferico (tipo "C").
Commesse in economia#
Per le commesse con flag "in economia" attivo, la chiusura (F6) e' consentita solo se la data di estrazione della commessa e' maggiore o uguale alla data di creazione movimenti. In caso contrario il sistema mostra: "Commessa in economia: Operazione non permessa: Esistono ancora giornalieri da analizzare".
Questo vincolo garantisce che tutti i giornalieri siano stati elaborati prima della chiusura.
Aggiornamento distinta base impianto#
Se nella configurazione il parametro commessa-impianto = "S", alla chiusura (F6) il programma chiama COGUA4 con operazione "AGG-DA-GIACENZA" per aggiornare la distinta base della matricola impianto collegata alla commessa. Questo riflette i materiali effettivamente installati/presenti sull'impianto.
Messaggi di errore#
| Messaggio | Causa |
|---|---|
| Commessa Inesistente! | Il codice commessa digitato non esiste nell'archivio COGTESCM |
| La Commessa deve essere Aperta! | La commessa non ha stato "A". Solo commesse aperte possono essere chiuse |
| Commessa non agganciata a cliente! | La commessa non ha un'anagrafica di tipo "C" (cliente) associata. Serve per generare i documenti |
| Mancano le classi per creare i documenti | Una o piu' delle 4 classi documento necessarie non e' configurata (CLASSE-RESO-NF, CLASSE-RESO-FT, CLASSE-CHIUSURA-NF, CLASSE-CHIUSURA-FT) |
| Digitare almeno una quantita' | Si e' premuto F3 senza aver compilato nessuna riga con quantita' da movimentare |
| Totale: Reso NF + Reso FT + Da fatturare maggiore di giacenza | La somma delle quantita' digitate supera la giacenza disponibile |
| Reso NF maggiore di Qta fatturabile | La quantita' di reso NF supera la quantita' ancora fatturabile |
| Reso FT maggiore di Qta fatturata (Giacenza - Qta fatturabile) | La quantita' di reso FT supera la quantita' gia' fatturata |
| Quantita' da fatturare maggiore di fatturabile | La quantita' "Da fatturare" supera la quantita' fatturabile |
| Data obbligatoria | Il campo "Data creazione movimenti" non e' stato compilato |
| Commessa in economia: Operazione non permessa | Per commesse in economia, la data estrazione e' precedente alla data creazione movimenti |
| Funzione gia' in uso dall'operatore!! | I file transito temporanei sono gia' aperti da un'altra istanza del programma |
| Operazione ... NON ammessa | Il programma e' stato richiamato in modalita' called con un'operazione diversa da "GESTIONE" |
| Non sei abilitato ad inserire/modificare | L'operatore non ha i permessi per eseguire inserimenti o modifiche |
| Manca configurazione: COMMESSE / CLASSE-... | Avviso all'apertura: una classe documento non e' configurata nel file di configurazione |
Vedi anche#
- Calcolo costi FIFO — Valorizzazione dei costi con metodo FIFO (COGG57, COGG58)
- Analisi commessa — Report completo costi/ricavi (COGGA4)
- Configurazione commesse — Parametri classi documento e commessa-impianto