COGKA0 -- Gestione Date Competenza Documenti¶

Sorgente: cbl/cogka0.cbl | Tipo: Programma con griglia avanzata (grid-det) | Program-ID: COGKA0

Menu: Contabilita' > Bilancio > Ratei/Risconti > Utility > Gestione date competenza documenti

Scopo¶

Permette di visualizzare e gestire le date di competenza (att-pc-da / att-pc-a e pno-pc-da / pno-pc-a) dei documenti contabili, sia contabilizzati (COGCOATT) sia di prima nota non contabilizzata (COGPNONC). Le date di competenza servono per il calcolo di ratei e risconti.

Il programma puo' essere chiamato direttamente da menu o in modalita' chiamata (w-dc-called = "S").

Interfaccia utente¶

Maschera filtri¶

Campo	Tipo	Descrizione
`tm-ese`	x(01)	Esercizio precedente (S/N)
`tm-prima-nota`	x(09)	Esercizio contabile (anno1/anno2)
`tm-pc-mas` / `tm-pc-con` / `tm-pc-sot`		Filtro piano conti (mastro/conto/sottoconto)
`tm-data-da`	9(08)	Data documento da
`tm-data-a`	9(08)	Data documento a
`tm-aggio`	x(01)	Flag: modalita' assegnazione date (S = F6 attivo)

Griglia (grid-det)¶

La griglia utilizza il pattern avanzato con file di transito (t-grid-det), ordinamento e spaginamento.

Colonne principali (definite in cogka0.imppredf-wrk):

Colonna	Campo transito	Descrizione
Data documento	`t-gor-r-data-doc`	Data del movimento
Numero documento	`t-gor-r-docum`	Numero progressivo
Progressivo	`t-gor-r-pro-doc`	Progressivo riga
Conto	`t-gor-r-pc-*`	Mastro/conto/sottoconto
Descrizione	`t-gor-r-des`	Descrizione movimento
Importo	`t-gor-r-importo`	Importo
Data competenza da	`t-gor-r-data-comp-da`	Inizio competenza
Data competenza a	`t-gor-r-data-comp-a`	Fine competenza
Flag archivio	`t-gor-r-flag-arc`	"C" = contabilizzato, " " = prima nota
Anno documento	`t-gor-r-anno-doc`	Anno esercizio

Tasti funzione¶

Tasto	Funzione
F3	Conferma e aggiorna le date di competenza (`b-aggiorna`)
F6	Assegnazione massiva date a zero (`richiesta-date` + `a-modifica`)
F8	Aiuto: esercizio (WIN157), piano conti (COGS67W), calendario (COGS52W)
F9	Ricerca avanzata (COGS99)
Shift+F4	Gestione griglia (GRIDADMN)
Shift+F5	Esportazione Excel (`z-esporta-grid-det`)
ESC	Uscita (con controllo modifiche non salvate)

File e Tabelle¶

File/Tabella	Copybook	Uso
COGCOATT	cogcoatt.cpy, .fd	Attributi documenti contabilizzati (date competenza `att-pc-da`, `att-pc-a`)
COGPNONC	(da cogka0.fd)	Prima nota non contabilizzata (date competenza `pno-pc-da`, `pno-pc-a`)
COGTABEL (tipo 66)	cogfiles.cpy	Tabella esercizio contabile
COGTABEL (tipo AF)	cogfiles.cpy	Configurazione specifica del programma
t-grid-det	(generato)	File temporaneo di transito per la griglia avanzata

Programmi chiamati¶

Programma	Scopo
COGS67W	Selezione piano conti
COGS52W	Gestione date
COGS99	Ricerca avanzata
WIN157	Selezione esercizio contabile
COGU10W	Utility valute
COGU20	Utility varie
GRIDADMN	Gestione griglia
RNEWCONF	Lettura configurazioni
DIALOGS	Finestra di dialogo

Copybook principali¶

cogka0.select, cogka0.fd, cogka0.wrk, cogka0.tm, cogka0.decla, cogka0-01.scr -- Definizioni generate da Screens
cogka0.imppredf-wrk -- Definizione colonne griglia avanzata
cogcoatt.cpy -- Struttura attributi documenti contabili
cogconta.cpy -- Struttura tabella esercizio contabile
utilimppredf.cpy -- Utility impostazioni predefinite griglia
utilncnf.cpy -- Interfaccia configurazioni RNEWCONF
utilgesdebug.cpy -- Interfaccia debug
k-personal.cpy -- Costanti personalizzazione
cogazien.cpy -- Dati azienda

Logica di Elaborazione¶

Caricamento dati (`z-grid-det-crea-transito`)¶

Il caricamento e' gestito dalla logica della griglia avanzata (pattern grid-det con file di transito). I documenti vengono letti da COGCOATT e COGPNONC in base ai filtri impostati (esercizio, piano conti, intervallo date) e scritti nel file di transito con le informazioni necessarie per la visualizzazione e l'aggiornamento.

Aggiornamento date (`b-aggiorna`)¶

Scorre il file di transito e per ogni record:

Se t-gor-r-flag-arc = "C" (contabilizzato): legge COGCOATT e aggiorna att-pc-da / att-pc-a
Se non contabilizzato: legge COGPNONC e aggiorna pno-pc-da / pno-pc-a

Assegnazione massiva (F6, `a-modifica`)¶

Attivata dal tasto F6:

Richiede le date di competenza "da" e "a" tramite richiesta-date
Scorre tutto il file di transito
Per ogni record con t-gor-r-data-comp-da = 0, imposta la data "da"
Per ogni record con t-gor-r-data-comp-a = 0, imposta la data "a"
Riscrive il record aggiornato nel file di transito

Successivamente l'utente puo' confermare con F3 per scrivere le date sui file definitivi.

Ordinamento¶

L'ordinamento predefinito e' per data documento ascendente (gcn-r-data-doc). L'utente puo' modificarlo tramite la griglia.

Configurazioni¶

Gruppo	Parametro	Note
(RNEWCONF)	Configurazioni specifiche	Letti tramite `x99-confi` all'avvio

Note tecniche¶

Il programma implementa il pattern grid-det con file di transito indicizzato, ordinamento dinamico e spaginamento.
I pulsanti custom (bitmap "labodonto", posizione 22) visualizzano il pulsante F6 per l'assegnazione date.
Il programma include utilgesdebug.cpy per il supporto debug.
Il menu contestuale sulla griglia (build-main-popup-grid-det) consente operazioni aggiuntive.
In uscita con modifiche pendenti, il programma invoca test-wesc per chiedere conferma.

Documentazione tecnica -- 2026-04-16