CASHDATA - Documentazione Tecnica Completa

1. Panoramica del Sistema
2. Architettura e Struttura del Progetto
3. Configurazione e Nuova Installazione
4. Funzionalità Principali
5. Gestione Vendite
6. Chiusura Cassa
7. Inventario e Giacenze
8. Anagrafica Articoli
9. Gestione Operatori e Permessi
10. Sistema di Reportistica
11. Integrazione con ERP2
12. Integrazione con Bilancia
13. Schema Database
14. Troubleshooting

CASHDATA è un sistema POS (Point of Sale) desktop professionale sviluppato in C# con Windows Forms, destinato alla gestione di casse registratrici per il settore retail, in particolare per il fashion (abbigliamento con gestione taglie/colori).

CASHDATA.sln
├── CASHDATA (Applicazione principale - EXE)
│   ├── Program.cs (Entry point)
│   ├── Form1.cs (Form test)
│   ├── Login.cs (Form login)
│   └── Template XML per report
│
└── LIBAYCASH (Libreria principale - DLL)
    ├── Home.cs (Form principale)
    ├── Config.cs (Configurazione globale)
    ├── Utility.cs (Funzioni utility)
    ├── 143+ file C# (logica applicativa)
    └── Dipendenze: LIBAYCMN

D:\dev.net\CashData\
├── CASHDATA\                    # Progetto principale
│   ├── bin\Debug\              # Output compilato
│   ├── Resources\              # Icone e immagini
│   ├── *.xml                   # Template report
│   └── App.config              # Configurazione app
│
├── LIBAYCASH\                   # Libreria logica
│   ├── Properties\
│   │   └── Settings.settings   # Impostazioni DB
│   ├── Home.cs                 # Form principale
│   ├── Config.cs               # Configurazione
│   └── [143+ file .cs]         # Classi logica
│
├── CreateNewDb\                 # Utility creazione DB
├── Script_DB\                   # Script SQL
│   ├── per C#\                 # Script TCS
│   └── TTCS_ALL_INSTALLATION\
│
└── RELEASE\                     # File di release

// Program.cs
[STAThread]
static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    string assemblyVersion = Assembly.GetExecutingAssembly()
                                     .GetName().Version.ToString();
    Application.Run(new LIBAYCASH.Home(assemblyVersion));
}

CASHDATA.exe [UserShowLevel] [SkipLogTableCheck]

• UserShowLevel: Livello visualizzazione interfaccia (default: dalla config)
• SkipLogTableCheck: Se presente, salta il controllo tabella LOG

• Installare SQL Server (Express o Standard)
• Creare database vuoto (nome consigliato: TTCS o TTCS_LOCAL per sviluppo)
• Configurare account SQL (es. sa) con password
• Verificare che l'account SQL abbia permessi sufficienti sul database

Eseguire in ordine dalla cartella RELEASE\01\:

1. 00_DB_CREATION_CREATEDB.sql - Creazione struttura DB
2. 01_DB_CREATION_PROCEDURE.sql - Stored procedures
3. 02_DB_CREATION_TABLES.sql - Tabelle, dati iniziali, utenti e gruppi
4. 03_DB_CREATION_WITH_PROMO.sql - Dati promozioni

Nota: Lo script 02_DB_CREATION_TABLES.sql include automaticamente:

• Parametri di configurazione (CASSA_CONFIG_PARAMETER) per tutte e 3 le sezioni (10, 20, 30)
• Parametri runtime (CASSA_PARAMETER) inclusi RECEIPT_COUNTER_PWD, HOMEMENU_ENABLED
• Parametri per-PC (CASSA_PARAMETER_PC) inclusi NEW_DAYLY_CLOSURE, NEW_START_BILL
• Gruppi utente predefiniti (GSU, ADMINISTRATORS GROUP, MANAGER, USER)
• Utenti predefiniti (su, Administator, Manager, User) con password impostate al primo avvio
• Stampante predefinita “Microsoft Print to PDF” per tutti i tipi documento
• Valori LIC (licenza) vuoti per consentire la prima installazione

Modificare ed eseguire Cose da fare per nuova installazione\02 Reimposta dati.sql:

DECLARE @firma INT = 10;                    -- Codice azienda
DECLARE @currentshop VARCHAR(6) = '000002'; -- Codice negozio
DECLARE @shopnr INT = 84;                   -- Numero univoco negozio
DECLARE @releasefor INT = 84;               -- Numero PC (= shopnr per singola cassa)
DECLARE @ivadefault VARCHAR(5) = '22';      -- Aliquota IVA default
DECLARE @cashclosuredate VARCHAR(8) = '20240201'; -- Data prima chiusura

Questo script aggiorna automaticamente anche:

• I valori LIC (licenza) vengono azzerati per consentire la prima installazione
• Il parametro ACTIVATION viene impostato a '.'

• Aprire la solution CASHDATA.sln in Visual Studio
• Impostare la configurazione su Release e piattaforma x86
• Compilare la solution
• Copiare il contenuto della cartella di output nella cartella di installazione (es. C:\APP - LOCAL\CASHDATA)

Prima di avviare l'applicazione, configurare il file CashData.xml nella cartella di installazione:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <appSettings>
    <add key="cnn_server" value="localhost\SQLEXPRESS" />
    <add key="cnn_database" value="TTCS_LOCAL" />
    <add key="cnn_user" value="sa" />
    <add key="cnn_password" value="la_tua_password" />
    <add key="ReleaseFor" value="84" />
    <add key="PCisSqlServer" value="false" />
  </appSettings>
</configuration>

Parametri importanti:

1. Avviare CASHDATA.exe dalla cartella di installazione
2. Cartella di installazione: Al primo avvio, l'app chiede di confermare la cartella. Selezionare il percorso dove e' stato copiato l'eseguibile (es. C:\APP - LOCAL\CASHDATA)
3. Creazione sottocartelle: L'applicazione crea automaticamente: DDT\, Received\, ToSend\, backup\, basic\, EXCEL\
4. Inizializzazione utenti: La funzione ChechForNewFunction() al primo avvio:
   • Popola automaticamente la tabella CASSA_USER_FUNCTIONGROUP con i permessi per ogni gruppo
   • Imposta le password predefinite per gli utenti
5. Login: Usare le credenziali predefinite:

Il sistema CASHDATA utilizza 3 tabelle distinte per i parametri, ognuna con uno scopo diverso:

Tabella principale di configurazione a 3 livelli (sezioni):

Lettura: ReadConfigParameter(name, releasedfor, section) oppure getParValueByKey(key) per le sezioni 10+30.

Parametri operativi condivisi da tutte le casse del negozio (contatori, percorsi, password).

Lettura: ReadParameter(name, increment) con cash_nr = 0 (default).

Parametri specifici per ogni cassa/PC, identificati dalla colonna CASH_NR.

Lettura: ReadParameter(name, increment, Config.CASHNUMBER) con cash_nr != 0.

Provider=SQLOLEDB.1;Data Source=SERVER\SQLEXPRESS;Initial Catalog=TTCS;User ID=sa;Password=xxx;

┌─────────────────────────────────────────────────────────────┐
│                      HOME (Form Principale)                  │
├──────────────────────┬──────────────────────────────────────┤
│  OPERAZIONI CASSA    │  GESTIONE                           │
│  ├─ Vendita          │  ├─ Anagrafica Articoli             │
│  ├─ Reso             │  ├─ Listini Prezzi                  │
│  ├─ Sconti           │  ├─ Clienti                         │
│  ├─ Buoni/Coupon     │  ├─ Fornitori                       │
│  └─ Sospensione      │  └─ Operatori                       │
├──────────────────────┼──────────────────────────────────────┤
│  CHIUSURA            │  REPORT                              │
│  ├─ Chiusura Cassa   │  ├─ Vendite                         │
│  ├─ Storico          │  ├─ Sell-Out                        │
│  └─ Differenze       │  ├─ Corrispettivi                   │
│                      │  └─ Giornale Cassa                  │
├──────────────────────┴──────────────────────────────────────┤
│  DOCUMENTI: DDT | MIV | Etichette                           │
└─────────────────────────────────────────────────────────────┘

1. SCANSIONE ARTICOLO (EAN)
   └─> ArticleCheck() verifica articolo e prezzo

2. AGGIUNTA AL CARRELLO
   └─> addArticoloCarrello() crea record SCONTRINO

3. MODIFICA (opzionale)
   ├─> Quantità: btnTastierinoSpec1_Click()
   ├─> Prezzo: LogicaPrezzo()
   └─> Sconto %: LogicaPercentuale()

4. PAGAMENTO
   └─> btnPaga_Click() apre dialog PAY
       └─> Selezione metodo pagamento
       └─> Stampa scontrino fiscale
       └─> Registrazione in CASSA_SALES

5. CHIUSURA TRANSAZIONE
   └─> Eliminazione record SCONTRINO temporanei

public enum Discount_Type
{
    Inserted,      // Sconto diretto
    Progressive,   // Cumula con sconti precedenti
    Sum            // Somma percentuali
}

• Stato articolo: Config.STATO_RESO = “R”
• Quantità diventa negativa (-1)
• Se AskReturnCause = true: richiede causale reso
• Tabella causali: CASSA_RETURN_CAUSE

• Massimo 4 transazioni contemporanee
• Ogni attesa ha colore distinto
• Struct ATTESA memorizza stato:

struct ATTESA {
    List<DataGridViewRow> dgSpesa;
    CASSA_CUSTOMER cliente;
    int pezziTot;
    double toto;
    int punti;
}

TAB 0: CONTEGGIO DENARO
├─ Inserimento per taglio (€50, €20, €10, €5, €2, €1, cent)
├─ Calcolo totale inserito
└─ Verifica differenza con sistema

TAB 1: VERIFICA PAGAMENTI
├─ Visualizzazione totali per metodo
├─ Inserimento importi verificati
├─ Spunta verifica completata
└─ Differenza totale deve essere = 0

TAB 2: CONFERMA FINALE
├─ Prelievo contante finale
├─ Calcolo nuovo fondo cassa
└─ Conferma chiusura

PROCESSO CHIUSURA (Utility.ChiusuraCassa)
├─ Comunicazione registratore telematico (rapporto Z)
├─ Stampa rapporto chiusura
├─ TRANSAZIONE DATABASE:
│   ├─ UPDATE CASSA_FUND (nuovo fondo)
│   ├─ UPDATE CASSA_SALES (stato 0→10)
│   ├─ UPDATE CASSA_SALES_PAYMODE (stato 0→10)
│   ├─ INSERT CASSA_DAILY_CLOSURE
│   ├─ EXEC PRC_SALES_CLOSURE_IVA
│   └─ CloseCashSession()
├─ Stampa rapporto differenze (opzionale)
└─ Esportazione dati (se configurato)

public enum SaleStatus
{
    NewSales = 0,              // Non ancora chiuso
    SalesSessionClosed = 10,   // Chiuso in sessione
    Exported = 20,             // Esportato
    SendedToCentral = 35,      // Inviato a centrale
    AcceptedFromCentral = 90   // Accettato
}

Giacenza Finale = Giacenza Iniziale - Quantità Venduta
Sell Out % = (Quantità Venduta / Quantità Iniziale) × 100

• Campo CODMAG in tutte le tabelle movimenti
• Parametro MODULE_MULTISHOP abilita gestione
• CURRENT_SHOP identifica magazzino corrente

Campi dinamici: CAA_ATTR_001, CAA_ATTR_002, … CAA_ATTR_999

Campi Listino:

• CPLN_NRLIS: Numero listino
• CPLN_SAISON: Stagione
• CPLN_VALIDFROM/TO: Date validità
• CPL_ENDUSERPRICE: Prezzo al pubblico
• CPL_ORIGINALPRICE: Prezzo originale
• CPL_PRICE: Prezzo costo

Esempio scala:

Scala_Nr=1, Scala_Bezeichnung="EU Size"
├─ Index=1: "XS"
├─ Index=2: "S"
├─ Index=3: "M"
├─ Index=4: "L"
└─ Index=5: "XL"

Query base:

SELECT ART_NAME_DESC, ART_COL_DESC, ART_SIZE, ART_EAN, ART_CODART
FROM CASSA_ARTICOLO
WHERE ART_NAME_DESC LIKE '%' + @ARTNAME + '%'
  AND ART_EAN LIKE '%' + @ARTEAN + '%'
  AND ART_FIRMA = @FIRMA
ORDER BY ART_NAME_DESC, ART_COL_DESC, ART_SIZE

• Algoritmo: TripleDES
• Chiave: MD5 di “castelletto28053”
• Modalità: ECB
• Padding: PKCS7
• Output: Base64

bool hasPermission = Utility.FunctionForUser(userCode, functionCode);

Se utente non ha permesso, viene richiesto cambio operatore.

• Campo Venditore in tabella SCONTRINO
• Trasferito a CSL_Seller in CASSA_SALES
• Report operatori: PRC_CASSA_USERREPORT_V001

D:\dev.net\CashData\CASHDATA\
├── BILLPic1.png              # Logo scontrino
├── BILL_CLOSUREPic1.png      # Logo chiusura
├── DDTPic1.jpg, DDTPic2.jpg  # Logo DDT
└── MIVPic1.jpg, MIVPic2.jpg  # Logo MIV

Questa sezione descrive come configurare l'integrazione tra CASHDATA e il gestionale ERP2 per la sincronizzazione bidirezionale di articoli, listini, chiusure cassa e DDT.

Script di riferimento: RELEASE\02 Integrazione con ERP2\

Nota: Le viste e stored procedure possono variare a seconda dell'installazione specifica del cliente. Gli script forniti sono template da adattare.

L'integrazione ERP2 permette di:

• Import da ERP: Caricare articoli e listini prezzi dal gestionale alla cassa
• Export verso ERP: Esportare automaticamente chiusure cassa, vendite, IVA e DDT
• Sincronizzare lo stato dei DDT tra i due sistemi

Flusso bidirezionale:

                    LINKED SERVER
                         │
    ┌────────────────────┼────────────────────┐
    │  DB CASHDATA       │      DB ERP2       │
    │                    │                    │
    │  ┌─── IMPORT ──────┤                    │
    │  │ AY_CARICA_DDT_  │  ARTICO, BARART   │
    │  │ DA_ERP          │  LOTSER, LISRIG   │
    │  │ (SP su CASHDATA) │  IVA, MARCHE...   │
    │  │                 │                    │
    │  │ Sinonimi ERP_*──┼──► Tabelle ERP     │
    │  └─────────────────┤                    │
    │                    │                    │
    │  ┌─── EXPORT ──────┤                    │
    │  │ PRC_EXPORT_ERP  │  AY_CASSA_*       │
    │  │ (SP su CASHDATA) │  EXT_ORDINI_*     │
    │  │                 │                    │
    │  │ Sinonimi ERP_*──┼──► Tabelle ERP     │
    │  └─────────────────┤                    │
    └────────────────────┴────────────────────┘

Parametri da configurare in CASSA_CONFIG_PARAMETER per abilitare l'integrazione:

Gli script si trovano in RELEASE\02 Integrazione con ERP2\ e vanno eseguiti in ordine:

Script: 00_Creare linked server.txt

Crea un linked server denominato ERPSERVER per connettere SQL Server di CASHDATA a quello del gestionale ERP2.

Valori da personalizzare:

-- Esempio (da 00_Creare linked server.txt)
EXEC master.dbo.sp_addlinkedserver
    @server = N'ERPSERVER',
    @srvproduct = N'',
    @provider = N'SQLNCLI',
    @datasrc = N'SERVER\GESTERP'  -- PERSONALIZZARE
 
EXEC master.dbo.sp_addlinkedsrvlogin
    @rmtsrvname = N'ERPSERVER',
    @useself = N'False',
    @locallogin = NULL,
    @rmtuser = N'sa',             -- PERSONALIZZARE
    @rmtpassword = '########'     -- PERSONALIZZARE

Le opzioni importanti impostate dallo script:

• data access = true (necessario per le query cross-server)
• connect timeout = 0 e query timeout = 0 (nessun timeout)
• use remote collation = true

Script: 01_Tabelle&Viste da creare su db ERP.txt

Eseguire sul database del gestionale ERP2. Lo script crea:

1. Login e utente texdatacash con permessi di lettura e scrittura
2. Tabelle per ricevere i dati delle chiusure cassa:
   • AY_CASSA_ELENCO_CHIUSURE - Registro chiusure esportate
   • AY_CASSA_CHIUSURE - Totali per metodo pagamento
   • AY_CASSA_CHIUSURE_IVA - Ripartizione IVA per chiusura
   • AY_CASSA_PAGAMENTI - Anagrafica metodi di pagamento
   • AY_CASSA_VENDITE - Dettaglio vendite per articolo
   • AY_CASSA_VENDITE_ECCESSO - Vendite oltre giacenza teorica
3. Tabelle per DDT (se Invio_DDT_to_ERP = 1):
   • EXT_ORDINI_TOCOMPANY - Testate ordini/DDT
   • EXT_ORDINI_DET_TOCOMPANY - Righe ordini/DDT
   • EXT_ORDINI_TOCOMPANY_STOR - Storico DDT
4. Sinonimi per accesso semplificato:
   • ORDINI_DET_TOCOMPANY → EXT_ORDINI_DET_TOCOMPANY
   • ORDINI_TOCOMPANY → EXT_ORDINI_TOCOMPANY
   • ORDINI_TOCOMPANY_STOR → EXT_ORDINI_TOCOMPANY_STOR
5. Vista V_AY_CASSA_ARTICOLI_LOTTI - Articoli con giacenze per lotto/magazzino

Valori da personalizzare:

Script: 02_Da fare su DB CashData.txt

Eseguire sul database CASHDATA. Lo script crea:

a) Sinonimi verso le tabelle ERP (via linked server)

Creare un sinonimo per ogni tabella ERP referenziata. Il pattern e':

CREATE SYNONYM [dbo].[ERP_ARTICO] FOR [ERPSERVER].[NOMEDB_ERP].[dbo].[ARTICO]

Sinonimi necessari (sostituire NOMEDB_ERP con il nome effettivo del database ERP2):

b) Vista V_ERP_ARTICOLO - Unisce articoli ERP con barcode, IVA, lotti e classificazione

c) Vista V_ERP_ARTICOLO_PREZZI - Estende V_ERP_ARTICOLO aggiungendo prezzi da listino, marca e categoria (puo' variare per installazione)

d) Stored Procedure AY_CARICA_DDT_DA_ERP - Importa articoli e aggiorna listini:

• Con parametro @LEGGILISTINI = 0: importa nuovi articoli da ERP in CASSA_READ_DELNOTE e CASSA_READ_DELNOTE_ART_ATTRIB
• Con parametro @LEGGILISTINI = 1: aggiorna prezzi, marca e categoria per articoli esistenti, e registra nuove aliquote IVA
• Puo' essere invocata dal bottone “Carica da ERP” nella sezione Controllo dell'UI, oppure schedulata come SQL Server Job

e) Stored Procedure PRC_EXPORT_ERP - Esporta chiusure cassa verso ERP:

• Esportazione incrementale basata su IDCHIUSURA
• Gestisce chiusure, vendite, IVA
• Se Invio_DDT_to_ERP = 1: esporta anche DDT con stato 45 (confermato) → 50 (trasmesso)

• Creare linked server ERPSERVER con 00_Creare linked server.txt
• Verificare connettivita con SELECT * FROM OPENQUERY(ERPSERVER, 'SELECT 1')

• Creare login/utente texdatacash con permessi read/write
• Creare le 6 tabelle AY_CASSA_*
• (Se DDT) Creare le 3 tabelle EXT_ORDINI_* e relativi sinonimi
• Creare/modificare la vista V_AY_CASSA_ARTICOLI_LOTTI con ID magazzini corretti
• Popolare AY_CASSA_PAGAMENTI con i codici pagamento corretti

• Creare tutti i sinonimi ERP_* verso le tabelle ERP (personalizzare nome DB)
• Creare la vista V_ERP_ARTICOLO
• Creare la vista V_ERP_ARTICOLO_PREZZI (personalizzare per installazione)
• Creare/aggiornare la SP AY_CARICA_DDT_DA_ERP
• Creare/aggiornare la SP PRC_EXPORT_ERP
• Configurare parametro EXPORT_ERP = true in CASSA_CONFIG_PARAMETER
• Configurare parametro ExportDataForTrasmission = 0
• Configurare parametro ERP_CODMAG con il codice magazzino corretto
• (Opzionale) Configurare Invio_DDT_to_ERP = 1 per export DDT
• Verificare esistenza viste V_CASSA_CHIUSURE e V_CASSA_VENDITE_ARTICOLI (create dallo script 01_DB_CREATION_PROCEDURE.sql)
• Testare import articoli: EXEC AY_CARICA_DDT_DA_ERP @LEGGILISTINI = 0
• Testare export chiusura: EXEC PRC_EXPORT_ERP

Questa sezione descrive come configurare l'export del listino prezzi verso bilance elettroniche collegate al sistema.

Script di riferimento: RELEASE\03 Integrazione con Bilancia\

L'integrazione bilancia permette di:

• Esportare il listino articoli verso bilance elettroniche
• Supportare il formato BENCHCOMM (standard per bilance da banco)
• Generare file in formato testo a posizione fissa (100 caratteri per riga)

Flusso di esportazione:

UI: Bottone "Esporta Listino Bilance" (sezione Controllo)
         │
         ▼
   FunctionsForm.cs
         │  (verifica Config.SCALE_EXPORT_PROTOCOL)
         ▼
   ScaleExport_Benchcomm.EsportaListinoBilance()
         │
         ├──► EXEC AY_EXPORT_FILE_BILANCIA @FIRMA, @BANCO, @SOLO_MODIFICATI
         │    (SP da creare nel DB CASHDATA)
         │
         └──► Genera file IM00VARP.txt nella directory EXPORT_BILANCIA_DIR
              (Formato BENCHCOMM, encoding ISO-8859-1)

Parametri da configurare in CASSA_CONFIG_PARAMETER:

Inserire/aggiornare i 3 parametri nella tabella CASSA_CONFIG_PARAMETER:

-- Abilitare export bilancia
UPDATE CASSA_CONFIG_PARAMETER SET CP_VALUE = 'true'
WHERE CP_NAME = 'SCALE_EXPORT_ENABLED' AND CP_SECTION = 10
 
-- Impostare protocollo BENCHCOMM
UPDATE CASSA_CONFIG_PARAMETER SET CP_VALUE = 'BENCHCOMM'
WHERE CP_NAME = 'SCALE_EXPORT_PROTOCOL' AND CP_SECTION = 10
 
-- Impostare directory di export
UPDATE CASSA_CONFIG_PARAMETER SET CP_VALUE = 'C:\Export\Bilance'
WHERE CP_NAME = 'EXPORT_BILANCIA_DIR' AND CP_SECTION = 10

Script: 03 Integrazione con Bilancia\00_Creare SP per estrarre dati da inviare alla bilancia.txt

Nota: Lo script nella cartella contiene attualmente la SP PRC_EXPORT_ERP (export chiusure). La SP effettiva per la bilancia e' AY_EXPORT_FILE_BILANCIA, che va creata in base alle specifiche della bilancia utilizzata.

La SP AY_EXPORT_FILE_BILANCIA deve accettare questi parametri:

CREATE PROCEDURE [dbo].[AY_EXPORT_FILE_BILANCIA]
    @FIRMA INT,
    @BANCO INT,
    @SOLO_MODIFICATI BIT
AS
BEGIN
    -- Restituisce un DataTable con i campi necessari al formato BENCHCOMM:
    -- Banco, CodicePLU, AliquotaIVA, Prezzo, CodiceEAN,
    -- DescrizioneRiga1, DescrizioneRiga2, GiorniConservazione, Tara, ecc.
    -- L'implementazione varia in base alla bilancia
END

Creare la cartella specificata nel parametro EXPORT_BILANCIA_DIR e verificare che l'utente Windows che esegue CASHDATA abbia permessi di scrittura.

Configurare la bilancia per leggere il file IM00VARP.txt dalla directory di export. Il formato e':

• Protocollo: BENCHCOMM
• Encoding: ISO-8859-1
• Lunghezza riga: 100 caratteri + CR+LF
• Campi a posizione fissa (pos 1-99 con dati per banco, PLU, IVA, prezzo, EAN, descrizione, ecc.)

• Configurare parametro SCALE_EXPORT_ENABLED = true
• Configurare parametro SCALE_EXPORT_PROTOCOL = BENCHCOMM
• Configurare parametro EXPORT_BILANCIA_DIR con il percorso corretto
• Creare la SP AY_EXPORT_FILE_BILANCIA nel DB CASHDATA (personalizzare per tipo bilancia)
• Creare la directory di export con permessi di scrittura
• Configurare la bilancia per leggere da EXPORT_BILANCIA_DIR\IM00VARP.txt
• Testare l'export dal bottone “Esporta Listino Bilance” nella sezione Controllo
• Verificare che il file generato sia corretto (100 char/riga, encoding ISO-8859-1)

CASSA_SALES              # Vendite registrate
CASSA_SALES_PAYMODE      # Dettaglio pagamenti
CASSA_DAILY_CLOSURE      # Chiusure giornaliere
SCONTRINO                # Carrello temporaneo

CASSA_ARTICOLO           # Anagrafica articoli
CASSA_LISTINO            # Prezzi
CASSA_LISTINO_NAME       # Anagrafica listini
CASSA_ART_ATTRIB         # Attributi articoli
CASSA_STOCK              # Giacenze

CASSA_USER               # Utenti
CASSA_USER_GROUP         # Gruppi
CASSA_USER_FUNCTIONGROUP # Funzioni
CASSA_USER_OP            # Log accessi

CASSA_CONFIG_PARAMETER   # Parametri configurazione
CASSA_CONFIG_SECTION     # Sezioni configurazione
CASSA_PARAMETER_PC       # Parametri per PC

CASSA_DDT                # Documenti di trasporto
CASSA_MIV                # Merce in visione

CASSA_USER.USR_GROUP_CODE → CASSA_USER_GROUP.UGR_CODE
CASSA_SALES.CSL_FIRMA → Config.FIRMA
CASSA_ARTICOLO.ART_EAN → CASSA_LISTINO.CPL_BARCODE
CASSA_DAILY_CLOSURE.CDC_CLOSURE_ID → CASSA_SALES.CSL_CLOSURE_ID

Questi errori si verificano tipicamente al primo avvio dopo una nuova installazione. La sequenza di avvio dell'app (HomeLogic.cs) verifica molti parametri e tabelle in ordine.

1. BackupAndVerifyDataBase()    -- Solo in Release, richiede PCisSqlServer
2. ReadConfigParameter("LanguageCode")
3. ReadConfigParameter("INSTALLFOLDER")  -- Prima installazione se vuoto
4. CheckLic()                    -- Verifica licenza
5. ReadDefaultPrinter()          -- Verifica stampante
6. ReadParameter("HOMEMENU_ENABLED")
7. PulisciScontrino()            -- Usa CCO_CASH_NR su CASSA_COUPON
8. LoadParametri()               -- Carica tutti i getParValueByKey()
9. LoadScontrinoDefaultsValues() -- Contatori (NEW_DAYLY_CLOSURE, RECEIPT_COUNTER_PWD, ecc.)
10. Login()                      -- Richiede utenti e gruppi

Quando si incontra un errore “Errore lettura parametro”, e' fondamentale capire quale tabella deve contenere il parametro:

• Log accessi: Tabella CASSA_USER_OP
• Log operazioni: Consultare con report CASHPROTOCOL
• Errori applicazione: Verificare file di log in cartella installazione
• Debug SQL: Controllare i parametri direttamente nel DB con:

-- Verificare parametri di configurazione
SELECT * FROM CASSA_CONFIG_PARAMETER WHERE CP_NAME = 'NOME_PARAMETRO'
-- Verificare parametri runtime
SELECT * FROM CASSA_PARAMETER WHERE CP_NAME = 'NOME_PARAMETRO'
-- Verificare parametri per-PC
SELECT * FROM CASSA_PARAMETER_PC WHERE CP_NAME = 'NOME_PARAMETRO'

public enum Customer {
    First_Installation_ITALIAN = 0,
    First_Installation_GERMAN = 1,
    Develop = 2,
    Demo_Server = 3,
    // ... altri 80+ clienti
}

public enum ConfigSection {
    SHOP_10 = 10,      // Configurazione negozio
    FUNCTION_20 = 20,  // Configurazione funzioni
    CASH_30 = 30       // Configurazione cassa
}

public enum ECR_Type_Code {
    Olivetti_Nettuna_300,
    // altri tipi supportati
}

public enum DocPrinter {
    SCONTRINO = 1,
    ETICHETTE = 2,
    DDT = 3,
    MIV = 4,
    DIFF_CASSA = 5,
    GIORNALE = 6
}

Documento generato automaticamente dall'analisi del codice sorgente CASHDATA.
Ultimo aggiornamento: Febbraio 2026
Versione: 1.2 - Aggiunta integrazione ERP2 e bilancia