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