WMSW04 - Check giacenze per articolo¶

Funzione¶

Confronta i movimenti di magazzino tra il gestionale (COGMOMAG) e l'APP WMS (DFMOVIMENTILOC) per un dato articolo, visualizzando le differenze in tre griglie. Permette di individuare le cause di disallineamento nelle giacenze tra i due sistemi.

Magazzino > Giacenze & Sottoscorta > Locazioni > Check Giacenze per Articolo

Tabelle e file principali¶

Tabella/File	Descrizione	Accesso
COGMOMAG	Movimenti di magazzino (lato gestionale)	Lettura
DFMOVIMENTILOC	Movimenti locazioni (lato APP WMS, via DB frontiera)	Lettura
DFGIACENZELOC	Giacenze per locazione (lato APP WMS)	Lettura
COGTESAP	Testata documenti appendice (ora inserimento)	Lettura
t-tm-tab2	File di transito per movimenti gestionale	Lettura/Scrittura
t-tm-tab3	File di transito per movimenti APP	Lettura/Scrittura
exp-grid	File di esportazione (riutilizzato per export TSV)	Scrittura

Logica principale¶

L'utente seleziona un articolo e un periodo di analisi
Il programma carica i movimenti da COGMOMAG (griglia 2) e da DFMOVIMENTILOC (griglia 3)
Calcola le giacenze e le differenze tra i due sistemi (griglia 1)
Al termine del caricamento, esporta automaticamente i dati in formato TSV

Export automatico TSV¶

Al termine del caricamento dati (carica-dati), il programma esporta automaticamente i movimenti in due file TSV nella directory ext-log-dir:

File gestionale (`_gest.txt`)¶

Nome: wmsw04_{codice-merce}_{data}_gest.txt

Colonna	Contenuto
Documento	Chiave documento (testata)
Codice	Codice anagrafico
Ragione sociale	Nome anagrafico
Quantita	Quantita' con segno
Data	Data movimento (DD/MM/YYYY)
Causale	Codice causale magazzino
Descrizione causale	Descrizione della causale

File APP (`_app.txt`)¶

Nome: wmsw04_{codice-merce}_{data}_app.txt

Colonna	Contenuto
Classe locazione	Tipo locazione (P=Partenza, M=Magazzino)
Locazione	Codice locazione
Data movimento	DD/MM/YYYY
Ora movimento	HH:MI:SS:CC
Prog. movimento	Progressivo
Tipo movimento	P=Prelievo, M=Inventariale
Classe documento	Classe del documento
Chiave documento	Chiave del documento
Qta entrata	Quantita' in entrata (vuoto se zero)
Qta uscita	Quantita' in uscita (vuoto se zero)
Riga doc.	Numero riga documento
Tipo interlocutore	Tipo (C=Cliente, F=Fornitore)
Codice	Codice anagrafico
Ragione sociale	Nome
Segno	E=Entrata, U=Uscita
Documento originale	Chiave documento origine
Classe doc. originale	Classe documento origine
Orig. tipo	Tipo interlocutore origine
Orig. codice	Codice anagrafico origine
Orig. ragione sociale	Nome origine

Connessione DB¶

Il programma apre una connessione al database PostgreSQL di frontiera (x-apri-tabelle-db) per accedere alle tabelle DF*.

Note¶

I file TSV sono destinati all'analisi automatica delle differenze tramite agente dedicato
Il file exp-grid (definito da Screens) viene riutilizzato per evitare nuove dichiarazioni SELECT/FD
Il nome file viene convertito in minuscolo con function lower-case
Il codice merce nel nome file ha gli spazi sostituiti con underscore

Storico modifiche¶

Correzione calcolo quantita' area e export TSV (aprile 2026)¶

Fix calcolo quantita' area: il calcolo di tm-qta-area ora dipende dal flag euta-cb-con-gia della causale (se la causale prevede impatto giacenza), anziche' sommare/sottrarre incondizionatamente in base a entrata/uscita. L'ordine delle assegnazioni nella griglia 2 e' stato riorganizzato.
Export TSV con ora inserimento: per il file _gest.txt viene ora letto anche COGTESAP per ricavare l'ora di inserimento del documento, aggiungendo un'informazione temporale piu' precisa per la correlazione con i movimenti APP.

Allineamento calcolo quantita' area e colonna ora inserimento (aprile 2026)¶

Calcolo tm-qta-area corretto: il saldo dell'area gestionale ora include solo i movimenti la cui causale prevede impatto sulla giacenza (euta-cb-con-gia = "SI"). Le causali che non concorrono alla giacenza (es. IMPEGNO, causale 12) vengono ignorate. Il segno e' coerente con mag-entrusc (E = somma, U = sottrai). Il risultato e' che la differenza Area-APP nel totalizzatore rappresenta il delta giacenze reali nella finestra.
Export TSV con colonna ora inserimento: nel file _gest.txt, aggiunta la colonna "Ora inserimento" alimentata da COGTESAP (tsa-di-time). La chiave di accesso e' tsa-documento = t-gor-g2-2-testa. Se il record non esiste, la colonna resta vuota.