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 ERP
12. Schema Database
13. 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)
• Configurare account SA con password

Eseguire in ordine:

1. 00_DB_CREATION_CREATEDB.sql
2. 01_DB_CREATION_PROCEDURE.sql
3. 02_DB_CREATION_TABLES.sql
4. 03_DB_CREATION_WITH_PROMO.sql

Modificare ed eseguire 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

Al primo avvio, inserire:

• Server DB: SERVER\SQLEXPRESS o IP
• Database: TTCS
• ReleaseFor: Numero univoco PC
• PCisSqlServer: false (se server remoto)

<Setting Name="cnn_server" Type="System.String">SERVER\SQLEXPRESS</Setting>
<Setting Name="cnn_database" Type="System.String">TTCS</Setting>
<Setting Name="cnn_provider" Type="System.String">SQLOLEDB.1</Setting>
<Setting Name="ReleaseFor" Type="System.Int32">84</Setting>
<Setting Name="PCisSqlServer" Type="System.Boolean">False</Setting>

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 un sistema ERP esterno per l'esportazione automatica dei dati di chiusura cassa e DDT.

L'integrazione ERP permette di:

• Esportare automaticamente i dati delle chiusure cassa (vendite, pagamenti, IVA)
• Esportare i DDT confermati verso il gestionale
• Sincronizzare lo stato dei DDT tra i due sistemi

Flusso di esportazione:

CHIUSURA CASSA COMPLETATA
         │
         ▼
   ExchangeData()
         │
         ▼
   PRC_EXPORT_ERP (Stored Procedure)
         │
         ├──► ERP_CASSA_CHIUSURE (totali per metodo pagamento)
         ├──► ERP_CASSA_VENDITE (dettaglio articoli venduti)
         ├──► ERP_CASSA_CHIUSURE_IVA (ripartizione IVA)
         ├──► ERP_CASSA_ELENCO_CHIUSURE (registro chiusure)
         │
         └──► [Se Invio_DDT_to_ERP = 1]
              ├──► ORDINI_TOCOMPANY (testate DDT)
              └──► ORDINI_DET_TOCOMPANY (righe DDT)

Configurare i seguenti parametri in CASSA_CONFIG_PARAMETER:

Inserire il parametro ERP_CODMAG che identifica il magazzino/negozio nel sistema ERP:

-- Modificare i valori secondo l'installazione specifica
DECLARE @firma INT = 10;
DECLARE @shopnr INT = 84;
DECLARE @releasefor INT = 84;
DECLARE @codmag VARCHAR(50) = 'NEGCU';  -- Codice magazzino nel sistema ERP
 
IF NOT EXISTS (SELECT 1 FROM CASSA_CONFIG_PARAMETER WHERE CP_NAME = 'ERP_CODMAG' AND CP_FIRMA = @firma)
BEGIN
    INSERT INTO CASSA_CONFIG_PARAMETER
    (SHOP_NR, RELEASEFOR, CP_SECTION, CP_SECTION_PROGR, CP_FIRMA, CP_DATATYPE, CP_NAME, CP_VALUE, CP_TEXT)
    VALUES
    (@shopnr, @releasefor, 20, 100, @firma, 'string', 'ERP_CODMAG', @codmag, 'Codice magazzino per export ERP')
 
    PRINT 'Parametro ERP_CODMAG inserito con valore: ' + @codmag
END

Nel database CASHDATA, creare o aggiornare la stored procedure:

ALTER PROCEDURE [dbo].[PRC_EXPORT_ERP]
AS
BEGIN
    DECLARE @CASSULTCHIU AS INT
    DECLARE @ERPULTCHIU AS INT
    DECLARE @CODMAG AS VARCHAR(50)
    DECLARE @Ordprexix AS VARCHAR(10)
 
    -- Lettura CODMAG da parametro di configurazione
    SELECT @CODMAG = CP_VALUE
    FROM CASSA_CONFIG_PARAMETER
    WHERE CP_NAME = 'ERP_CODMAG'
 
    IF @CODMAG IS NULL OR LTRIM(RTRIM(@CODMAG)) = ''
    BEGIN
        RAISERROR('Parametro ERP_CODMAG non configurato. Contattare la software house.', 16, 1)
        RETURN
    END
 
    -- Ordprexix deriva da CODMAG (usato come prefisso per i DDT)
    SET @Ordprexix = @CODMAG
 
    -- Determina range chiusure da esportare
    SET @ERPULTCHIU = ISNULL((SELECT MAX(IDCHIUSURA) FROM [ERP_CASSA_ELENCO_CHIUSURE] WHERE CODMAG = @CODMAG), 0)
    SET @CASSULTCHIU = ISNULL((SELECT MAX(IDCHIUSURA) FROM V_CASSA_CHIUSURE), 0)
 
    -- Pulizia e inserimento dati chiusure
    DELETE FROM ERP_CASSA_CHIUSURE WHERE IDCHIUSURA > @ERPULTCHIU AND IDCHIUSURA <= @CASSULTCHIU AND CODMAG = @CODMAG
    INSERT INTO ERP_CASSA_CHIUSURE (IDCHIUSURA, DATA, CODPAG, VALCHIUSURA, CODMAG)
    SELECT IDCHIUSURA, DATASCONTRINO, CODPAG, VALCHIUSURA, @CODMAG
    FROM V_CASSA_CHIUSURE WHERE IDCHIUSURA > @ERPULTCHIU AND IDCHIUSURA <= @CASSULTCHIU
 
    -- ... continua con altre operazioni ...
END

Nel database del gestionale ERP è necessario creare le tabelle di destinazione per ricevere i dati esportati da CASHDATA.

File script: D:\dev.net\CashData\CASHDATA\ERP2Tabelle.sql

-- Chiusure per metodo di pagamento
CREATE TABLE [dbo].[AY_CASSA_CHIUSURE](
    [ID] [INT] IDENTITY(1,1) NOT NULL,
    [IDCHIUSURA] [INT] NOT NULL,
    [DATA] [smalldatetime] NULL,
    [CODPAG] [VARCHAR](50) NULL,
    [VALCHIUSURA] [DECIMAL](12, 2) NULL,
    [CODMAG] [VARCHAR](50) NULL
)
 
-- Ripartizione IVA per chiusura
CREATE TABLE [dbo].[AY_CASSA_CHIUSURE_IVA](
    [ID] [INT] IDENTITY(1,1) NOT NULL,
    [IDCHIUSURA] [INT] NOT NULL,
    [Aliquota] [DECIMAL](12, 2) NULL,
    [Tot_senza_Iva] [DECIMAL](12, 2) NULL,
    [Tot_Iva] [DECIMAL](12, 2) NULL,
    [ID_IVA] [INT] NULL,
    [CODMAG] [VARCHAR](50) NULL
)
 
-- Elenco chiusure esportate
CREATE TABLE [dbo].[AY_CASSA_ELENCO_CHIUSURE](
    [ID] [INT] IDENTITY(1,1) NOT NULL,
    [IDCHIUSURA] [INT] NOT NULL,
    [STATO] [SMALLINT] NOT NULL DEFAULT(0),
    [DATCHIU] [smalldatetime] NULL,
    [DATCRE] [smalldatetime] NULL,
    [DATMOD] [smalldatetime] NULL,
    [NOTE] [VARCHAR](500) NULL,
    [CODMAG] [VARCHAR](50) NULL
)
 
-- Anagrafica metodi di pagamento
CREATE TABLE [dbo].[AY_CASSA_PAGAMENTI](
    [CODPAG] [INT] NOT NULL,
    [DESPAG] [VARCHAR](200) NULL,
    [CODCON] [VARCHAR](50) NULL,
    [CODCAUINC] [VARCHAR](50) NULL
)

-- Dettaglio vendite per articolo
CREATE TABLE [dbo].[AY_CASSA_VENDITE](
    [ID] [INT] IDENTITY(1,1) NOT NULL,
    [DATVEN] [smalldatetime] NULL,
    [CODART] [VARCHAR](100) NOT NULL,
    [QUANTITA] [INT] NOT NULL,
    [PREZZOVENDITA] [DECIMAL](12, 2) NOT NULL,
    [IDCHIUSURA] [INT] NOT NULL,
    [CODMAG] [VARCHAR](50) NULL
)
 
-- Vendite in eccesso rispetto a giacenza teorica
CREATE TABLE [dbo].[AY_CASSA_VENDITE_ECCESSO](
    [ID_RIF] [INT] NOT NULL,
    [DATVEN] [smalldatetime] NULL,
    [CODART] [VARCHAR](100) NOT NULL,
    [QUANTITA] [INT] NOT NULL,
    [PREZZOVENDITA] [DECIMAL](12, 2) NOT NULL,
    [IDCHIUSURA] [INT] NOT NULL,
    [CODMAG] [VARCHAR](50) NULL
)

• Inserire parametro EXPORT_ERP = true
• Inserire parametro ExportDataForTrasmission = 0
• Inserire parametro ERP_CODMAG con il codice magazzino corretto
• (Opzionale) Inserire parametro Invio_DDT_to_ERP = 1 se serve export DDT
• Creare/aggiornare la stored procedure PRC_EXPORT_ERP
• Verificare esistenza viste V_CASSA_CHIUSURE e V_CASSA_VENDITE_ARTICOLI

• Creare tabella AY_CASSA_CHIUSURE
• Creare tabella AY_CASSA_CHIUSURE_IVA
• Creare tabella AY_CASSA_ELENCO_CHIUSURE
• Creare tabella AY_CASSA_PAGAMENTI
• Creare tabella AY_CASSA_VENDITE
• Creare tabella AY_CASSA_VENDITE_ECCESSO
• (Se DDT) Creare tabelle EXT_ORDINI_TOCOMPANY, EXT_ORDINI_DET_TOCOMPANY
• Configurare linked server o replica per comunicazione tra i database

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

• Log accessi: Tabella CASSA_USER_OP
• Log operazioni: Consultare con report CASHPROTOCOL
• Errori applicazione: Verificare file di log in cartella installazione

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.
Data generazione: Gennaio 2026
Versione: 1.0