Gestione Economica del Cliente

Il testo illustra le procedure tecniche per la sincronizzazione dei dati tra il software gestionale Sigea (CGTB) e il sistema EVO, utilizzato per il controllo dei punti vendita. La configurazione richiede la mappatura dei depositi, l’associazione dei centri di costo e la creazione di anagrafiche clienti specifiche che permettano l'identificazione univoca delle sedi. Un elemento cruciale è la gestione della sincronia tramite una tabella semaforo, che regola i flussi di scrittura e lettura per evitare sovrapposizioni o errori durante il trasferimento delle informazioni. Il documento descrive inoltre le diverse modalità di esportazione, distinguendo tra prima installazione e aggiornamenti ordinari di articoli, listini e movimenti di magazzino. Infine, viene sottolineata l'importanza della priorità dei fornitori e della corretta gestione dei codici EAN per garantire il corretto funzionamento delle etichette elettroniche e dei flussi logistici.

Manuale Operativo: Attivazione e Integrazione Nuovi Punti Vendita (PDV)

1. Introduzione e Architettura di Sistema

L'integrazione di un nuovo Punto Vendita (PDV) nell'ecosistema ERP rappresenta una transizione critica che richiede il perfetto allineamento tra il core gestionale (Sigea/CGTB) e il front-end di negozio (EVO). In qualità di Master System, Sigea governa l'anagrafica centralizzata, i listini e la logistica, mentre EVO opera come terminale esecutivo per le vendite e la chiusura fiscale.

Una configurazione iniziale errata compromette non solo la tracciabilità logistica, ma invalida l'integrità dei flussi verso l'Agenzia delle Entrate e la contabilità analitica. È mandatorio seguire le fasi operative in ordine sequenziale per garantire che i trigger di sistema e le tabelle di trascodifica si attivino correttamente.

---

2. Fase 1: Configurazione Anagrafica Depositi (Tabella DEPOST)

Tecnicamente, ogni PDV è censito in Sigea come magazzino logistico. La configurazione avviene nel modulo Magazzino, tabella DEPOST.

Requisiti Tecnici e Parametri Obbligatori:

• Convenzione di Codifica: Utilizzare rigorosamente il range numerico a partire da 501.
• Codice Filiale: Parametro essenziale per la segregazione dei dati. Per la realtà "La Prima", il valore deve essere impostato a 1.
• Natura Deposito: Impostazione obbligatoria del codice "50" (Punto Vendita). Questo flag è il trigger che abilita il deposito nei filtri di esportazione verso EVO.
• Contabilità Analitica: Definizione del Centro di Costo e del Centro di Ricavo per la quadratura dei margini per singolo punto vendita.
• Logistica:
  • Attivazione opzione 1 (Articoli Inventariati) per la gestione del dettaglio inventariale.
  • Configurazione della Causale Automatica (es. 62) per la conferma degli allestimenti, riducendo l'errore umano in fase di ricezione merce.

Nota dell'Architetto: La Natura "50" non è un semplice attributo descrittivo, ma la chiave logica che permette ai motori di export di isolare i dati periferici dai flussi del Cedi centrale.

---

3. Fase 2: Associazione Obbligatoria Anagrafica Clienti

Il PDV deve esistere come "Soggetto Cliente" per permettere la generazione di DDT, ordini e statistiche di fatturato. La mappatura deve essere rigorosamente bi-direzionale.

Configurazione Bi-direzionale:

1. Lato Deposito: Nell'anagrafica deposito (Fase 1), indicare il Codice Cliente associato.
2. Lato Cliente: Nel tab Dati Tecnici dell'anagrafica cliente, indicare il Codice Deposito corrispondente.

Parametri Critici di Fatturazione e Sincronia:

• Metodo RT: All'interno del tab "Dati Fatturazione" dell'anagrafica cliente, è fondamentale configurare il corretto Metodo RT. Questo parametro governa la modalità con cui il database genera il flusso di consegna dei documenti.
• Posizione Fornitore (Tab "Altro Rapporto"):
  • Per La Prima: Impostare come fornitore principale il Magazzino Centrale (Cedi).
  • Per MAC: Impostare il fornitore CDC (Centro Distribuzione Conad), poiché MAC non possiede un magazzino proprio e opera in regime di fornitura diretta dal partner.

---

4. Fase 3: Trascodifica Parametri EVO (Modulo 3.9)

Il ponte tra la codifica Sigea e il sistema di cassa si configura nel modulo Amministrazione > 3.9 (Corrispettivi Parametri Punti Vendita).

Parametro	Descrizione	Scopo Tecnico
Codice EVO	Es. 100.001	ID univoco assegnato dal sistema di cassa.
Codice Deposito	Es. 501	ID interno Sigea associato.
Flusso XML	Chiusura Fiscale	Elaborazione del file per contabilità IVA e invio AdE.

Importanza del flusso XML: Il file generato a fine giornata è l'unica fonte di verità per la contabilità interna e la conformità fiscale. Sigea lo elabora per aggiornare i saldi IVA e registrare i corrispettivi in modo armonizzato con quanto trasmesso telematicamente all'Agenzia delle Entrate.

---

5. Fase 4: Infrastruttura e Abilitazione Eventi (XRTB)

Il servizio di manutenzione XRTB è il motore di sincronizzazione. Qualsiasi modifica ai trigger deve essere eseguita "a bocce ferme" (senza utenti connessi): lo schema modification via XRTB richiede l'accesso esclusivo al database per prevenire deadlock durante la scrittura fisica dei trigger sul server SQL.

Gestione dei Trigger e Tabella di Frontiera (MC)

Il sistema monitora le modifiche alle tabelle candidate (Articoli, Listini, EAN) e scrive i log nella tabella di frontiera MC utilizzando i seguenti codici di aggiornamento:

Action Box: Logica Aggiornamento MC

• Tipo 5: Inserimento (Insert) - Nuovo record creato in Sigea.
• Tipo 6: Modifica (Update) - Variazione di un record esistente (es. cambio prezzo).
• Tipo 8: Configurazione Iniziale (Refresh) - Popolamento massivo per attivazione PDV.

Configurazione Connessione:

• Gruppo Database: Parametri SQL Server (IP, User, Pwd) per la scrittura diretta sulle tavole EVO.
• Portale SFTP: Necessario per lo scambio dei file d'ordine.
  • Nota per MAC: Gli ordini non passano dal portale SFTP standard ma direttamente dal portale CDC (Intercompany).

---

6. Fase 5: Operazioni di Sincronizzazione (Export/Import)

Le operazioni avvengono nel percorso: 31.09.2.2.2 (Aggiornamento Sistemi Periferici).

Dipendenze e Regole d'Oro (Refresh Massivo):

In fase di prima installazione, l'ordine di esportazione non è facoltativo:

1. Export EAN: Richiede simultaneamente Anagrafica Articoli (BR_ART) e Assortimento (BR_LISTINI).
2. Export Assortimento: Richiede Anagrafica Articoli.
3. Priorità 0: Ogni articolo deve avere un solo fornitore con Priorità 0. Se questo parametro è assente o duplicato, l'aggiornamento automatico dei prezzi sulle etichette elettroniche fallirà.

Warning: Logica Unità di Misura (Colli vs Pezzi)

Verificare preventivamente la logica di ricezione ordini:

• Standard (La Prima): Gli ordini arrivano in "Colli"; Sigea moltiplica per i pezzi per confezione.
• Nuova Logica (MAC/Transizione): È in corso lo spostamento verso la ricezione in "Quantità" (Unità). Verificare nel programma di importazione ordini quale logica sia attiva per evitare macro-errori di giacenza (es. caricare 24 colli invece di 24 pezzi).

Logica Sequenziale del Semaforo:

La sincronizzazione è regolata da una tabella di stato per prevenire conflitti di scrittura:

1. Stato 0/0 (Idle): Sigea e EVO sono in attesa.
2. Stato 1/0 (Sigea Scrive): Sigea imposta "Attività in corso". EVO è bloccato in lettura.
3. Stato 0/1 (Sigea Fine): Sigea spegne "Attività in corso" e accende "Esporta Dati". EVO riceve il via libera.
4. Stato 1/1 (EVO Legge): EVO imposta "Attività in corso" mentre processa i dati.
5. Stato 0/0 (Fine): EVO pulisce le tavole e spegne entrambi i flag.

---

7. Risoluzione dei Problemi e Manutenzione

Verifica Tabelle di Frontiera

Se la sincronizzazione fallisce, consultare manualmente le tabelle:

• BR_EAN, BR_ART, BR_LISTINI (Dati anagrafici).
• EVO_DOC_TEST e EVO_DOC_RIG (Documenti di trasporto).

Errori Bloccanti e GQM

EVO è un sistema rigido: se incontra un errore (es. un EAN duplicato), interrompe l'intero processo di import per tutte le entità successive.

• Best Practice: Prima di un Refresh, eseguire il GQM (Global Query Manager) per identificare e correggere EAN duplicati.
• Sblocco Manuale: Se il semaforo rimane appeso a causa di un crash, utilizzare la funzione "Ripristina Stato Esportazione" nel modulo di manutenzione, previa verifica che le tabelle di frontiera siano effettivamente vuote.

Monitoraggio Intercompany (MAC)

Per i PDV del gruppo MAC, il controllo deve estendersi ai flussi di Riepilogo Spedizioni Intercompany. Se un documento non appare in EVO, verificare che la bolla d'acquisto sia stata regolarmente generata su Sigea partendo dal flusso CDC e che la causale (es. 14) abbia il flag "Avviso Spedizioni" attivo.