COGM50 - Estrazione Mensile Statistiche di Vendita

Descrizione

Esegue l'estrazione mensile delle statistiche di vendita dall'archivio movimenti (COGSTATI). Legge i record del mese/tipo indicato, applica eventuali filtri per agente (da tabella TRAN-COGS96), e riporta i totali di quantita', importo netto, importo lordo e valore FIFO suddivisi per categoria (merci, no-merci, contanti, spese/bolli).

Il programma e' richiamabile sia manualmente dall'operatore che in modo automatico tramite la funzione di cancellazione/rielaborazione (COGM51, che lo richiama passando i parametri via linkage utilm51).

Tabelle utilizzate

Tabella	Accesso	Descrizione
COGSTATI	Lettura sequenziale con start	Archivio statistiche mensili di vendita (chiave: tipo + mese-fatturazione + movimento)
COGTABEL (tipo 68)	Lettura	Tabella tipi documento da elaborare (solo tipi con flag clienti attivo)
COGTABEL (tipo 57)	Lettura	Data ultima elaborazione statistica
COGTABEL (tipo 70 / STPARA)	Lettura/Scrittura	Parametro data mese precedente (STAT/STPARA)
TRAN-COGS96	Lettura (file transitorio)	Lista agenti selezionati (filtro opzionale)
FEURTAB	Lettura	Tabella valute/divise
COGM50.* (screen files)	Gestione maschera	Parametri di input e visualizzazione totali

Flusso di elaborazione

1. Inizializzazione: lettura dati azienda, configurazione (RNEWCONF), carico agenti da TRAN-COGS96 se attivo il filtro agente.
2. Maschera parametri (a-tm-data-prec, a-tm-data-acc, a-tm-scelta-costo, a-tm-data-costo): operatore inserisce mese precedente, mese di accumulazione, tipo valorizzazione costo, eventuale divisa.
3. Carico tipi documento (a10-loop): scansione COGTABEL tipo 68, vengono inclusi solo i tipi con flag euta-clifotiva(1:1) = "C" e non di tipo pre-fattura.
4. Elaborazione (elabora / ela-20): start su COGSTATI con chiave tipo + mese, lettura sequenziale. Per ogni record:
5. controlla corrispondenza tipo e mese
6. se attivo filtro agente, verifica presenza in TRAN-COGS96
7. accumula totali per categoria (merci, no-merci, contanti, spese)
8. Visualizzazione totali: i totali vengono formattati e mostrati nella maschera a fine elaborazione.
9. Aggiornamento COGTABEL: salva la data del mese elaborato come ultimo mese estratto (tipo 70 / STPARA).

Chiamate a sottoprogrammi

Programma	Scopo
COGS52W	Formattazione e validazione date
COGM51	Cancellazione preventiva (chiamata via linkage quando invocato in modalita' rielaborazione)
COGL61W (utilcogl61)	Utility di supporto elaborazione righe statistiche

Note implementative

• Il file transitorio TRAN-COGS96 viene aperto, usato per il filtro agenti, e al termine cancellato (delete file tran-cogs96).
• I tipi di pre-fattura (az-tipo-prf) vengono esclusi dall'elaborazione.
• La scelta del tipo di costo (tm-cfg-scelta-costo, tm-cfg-tipo-costo) influisce sulla valorizzazione FIFO riportata nei totali.
• Parametro configurazione RNEWCONF letto tramite utilrcnf/utilncnf per opzioni: ela, dat, na, nme, mag, imp, ord, fl-class, stat-ext, mesi-prima, mesi-dopo, scelta-costo, tipo-costo, gestione-clienti, cau-con-1, cau-con-2.