meta data for this page
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revision | |||
| cashdata [2026/01/20 11:48] – francesco | cashdata [2026/02/11 14:54] (current) – francesco | ||
|---|---|---|---|
| Line 13: | Line 13: | ||
| - [[# | - [[# | ||
| - [[# | - [[# | ||
| - | - [[#integrazione_con_erp|Integrazione con ERP]] | + | - [[#integrazione_con_erp2|Integrazione con ERP2]] |
| + | - [[# | ||
| - [[# | - [[# | ||
| - [[# | - [[# | ||
| Line 119: | Line 120: | ||
| === FASE 1: Preparazione Database === | === FASE 1: Preparazione Database === | ||
| * Installare SQL Server (Express o Standard) | * Installare SQL Server (Express o Standard) | ||
| - | * Creare database vuoto (nome consigliato: | + | * Creare database vuoto (nome consigliato: |
| - | * Configurare account | + | * Configurare account |
| + | * Verificare che l' | ||
| \\ | \\ | ||
| === FASE 2: Esecuzione Script SQL === | === FASE 2: Esecuzione Script SQL === | ||
| - | Eseguire in ordine: | + | Eseguire in ordine |
| - | - '' | + | - '' |
| - | - '' | + | - '' |
| - | - '' | + | - '' |
| - | - '' | + | - '' |
| + | |||
| + | **Nota:** Lo script '' | ||
| + | * Parametri di configurazione ('' | ||
| + | * Parametri runtime ('' | ||
| + | * Parametri per-PC ('' | ||
| + | * Gruppi utente predefiniti (GSU, ADMINISTRATORS GROUP, MANAGER, USER) | ||
| + | * Utenti predefiniti (su, Administator, | ||
| + | * Stampante predefinita " | ||
| + | * Valori LIC (licenza) vuoti per consentire la prima installazione | ||
| \\ | \\ | ||
| === FASE 3: Configurazione Iniziale === | === FASE 3: Configurazione Iniziale === | ||
| - | Modificare ed eseguire '' | + | Modificare ed eseguire '' |
| <code sql> | <code sql> | ||
| Line 142: | Line 153: | ||
| DECLARE @cashclosuredate VARCHAR(8) = ' | DECLARE @cashclosuredate VARCHAR(8) = ' | ||
| </ | </ | ||
| + | |||
| + | Questo script aggiorna automaticamente anche: | ||
| + | * I valori LIC (licenza) vengono azzerati per consentire la prima installazione | ||
| + | * Il parametro ACTIVATION viene impostato a ' | ||
| \\ | \\ | ||
| - | === FASE 4: Primo Avvio Applicazione === | + | === FASE 4: Compilazione |
| - | Al primo avvio, inserire: | + | * Aprire la solution |
| - | * **Server DB**: '' | + | * Impostare la configurazione su **Release** e piattaforma |
| - | * **Database**: '' | + | |
| - | | + | * Copiare il contenuto della cartella di output nella cartella di installazione (es. '' |
| - | * **PCisSqlServer**: | + | |
| \\ | \\ | ||
| - | ==== 3.2 Parametri di Configurazione | + | === FASE 5: Configurazione |
| + | Prima di avviare l' | ||
| - | === Parametri in CASSA_CONFIG_PARAMETER | + | <code xml> |
| + | <?xml version=" | ||
| + | < | ||
| + | < | ||
| + | <add key=" | ||
| + | <add key=" | ||
| + | <add key=" | ||
| + | <add key=" | ||
| + | <add key=" | ||
| + | <add key=" | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| - | ^ Parametro | + | **Parametri importanti: |
| - | | FIRMA_SHOP | + | |
| - | | CURRENT_SHOP | + | ^ Parametro ^ Descrizione |
| - | | VAT_DEFAULT | + | | '' |
| - | | VAT_BUONO | + | | '' |
| - | | BARCODELEN | + | | '' |
| - | | LanguageCode | + | | '' |
| - | | DecimalSeparator | , | Separatore decimali | | + | | '' |
| - | | GroupSeparator | + | | '' |
| - | | CurrencySymbol | EUR | Simbolo valuta | + | |
| \\ | \\ | ||
| - | === Parametri in Properties/ | + | === FASE 6: Primo Avvio Applicazione |
| + | - **Avviare '' | ||
| + | - **Cartella di installazione**: | ||
| + | - **Creazione sottocartelle**: | ||
| + | - **Inizializzazione utenti**: La funzione '' | ||
| + | * Popola automaticamente la tabella '' | ||
| + | * Imposta le password predefinite per gli utenti | ||
| + | - **Login**: Usare le credenziali predefinite: | ||
| - | <code xml> | + | ^ Utente ^ Password ^ Livello ^ |
| - | <Setting Name=" | + | | su | su28053 | SuperUser (99) | |
| - | <Setting Name=" | + | | Administator | admincash | Amministratore (30) | |
| - | <Setting Name=" | + | | Manager | manager1 | Manager (20) | |
| - | <Setting Name=" | + | | User | user | Utente base (10) | |
| - | <Setting Name=" | + | |
| - | </code> | + | \\ |
| + | ==== 3.2 Architettura dei Parametri ==== | ||
| + | |||
| + | Il sistema CASHDATA utilizza **3 tabelle distinte** per i parametri, ognuna con uno scopo diverso: | ||
| + | |||
| + | === 3.2.1 CASSA_CONFIG_PARAMETER (Configurazione) === | ||
| + | Tabella principale di configurazione a 3 livelli (sezioni): | ||
| + | |||
| + | ^ Sezione ^ RELEASEDFOR ^ Scopo ^ Caricamento ^ | ||
| + | | 10 | -1 | Parametri negozio (globali) | '' | ||
| + | | 20 | N (=ReleaseFor) | Flag funzioni UI (solo TRUE) | '' | ||
| + | | 30 | N (=ReleaseFor) | Parametri per-PC/hardware | '' | ||
| + | |||
| + | **Lettura: | ||
| + | |||
| + | === 3.2.2 CASSA_PARAMETER (Parametri Runtime Globali) === | ||
| + | Parametri operativi condivisi da tutte le casse del negozio (contatori, percorsi, password). | ||
| + | |||
| + | **Lettura: | ||
| + | |||
| + | ^ Parametro ^ Valore ^ Descrizione ^ | ||
| + | | NEW_CLOSUREID | 1 | Contatore ID chiusura | | ||
| + | | NEW_START_BILL | 1 | Contatore scontrini (se globale) | | ||
| + | | RECEIPT_COUNTER_PWD | tex01 | Password reset contatore scontrini | | ||
| + | | INVENTORY_PWD | tex01 | Password conferma inventario | | ||
| + | | HOMEMENU_ENABLED | 0 | Menu home abilitato (0/1) | | ||
| + | | LAST_TCS | 1 | Ultimo file TCS eseguito | | ||
| + | | DDT_FILE | c: | ||
| + | | SALES_EXCEL_FILE | ... | Percorso report vendite Excel | | ||
| + | | STOCK_EXCEL_FILE | ... | Percorso report giacenze Excel | | ||
| + | |||
| + | === 3.2.3 CASSA_PARAMETER_PC (Parametri Runtime per-PC) === | ||
| + | Parametri specifici per ogni cassa/PC, identificati dalla colonna '' | ||
| + | |||
| + | **Lettura: | ||
| + | |||
| + | ^ Parametro ^ Valore ^ Descrizione ^ | ||
| + | | NEW_DAYLY_CLOSURE | 1 | Contatore chiusura giornaliera per cassa | | ||
| + | | NEW_START_BILL | 1 | Contatore scontrini per cassa | | ||
| + | |||
| + | \\ | ||
| + | ==== 3.3 Parametri di Configurazione Essenziali ==== | ||
| + | |||
| + | === Parametri in CASSA_CONFIG_PARAMETER === | ||
| + | |||
| + | ^ Parametro ^ Sezione ^ Valore Esempio ^ Descrizione ^ | ||
| + | | FIRMA_SHOP | 10 | 10 | Codice azienda | | ||
| + | | CURRENT_SHOP | 10 | 000002 | Codice negozio DIAMOD | | ||
| + | | VAT_DEFAULT | 10 | 22 | Aliquota IVA % | | ||
| + | | VAT_BUONO | 10 | 22 | IVA per buoni | | ||
| + | | BARCODELEN | 10 | 13 | Lunghezza EAN | | ||
| + | | LanguageCode | 10 | 0 | 0=Italiano, 1=Tedesco | | ||
| + | | DecimalSeparator | 10 | , | Separatore decimali | | ||
| + | | GroupSeparator | 10 | . | Separatore migliaia | | ||
| + | | CurrencySymbol | 10 | EUR | Simbolo valuta | | ||
| + | | INSTALLFOLDER | 30 | C:\APP - LOCAL\CASHDATA | Cartella installazione | | ||
| + | | LIC_SOSerial | 30 | //(vuoto)// | Seriale licenza (vuoto per nuova installazione) | | ||
| + | | LIC_Volume | 30 | //(vuoto)// | Volume licenza (vuoto per nuova installazione) | | ||
| + | | LIC_ACTIVATE | 30 | //(vuoto)// | Stato attivazione (vuoto per nuova installazione) | | ||
| \\ | \\ | ||
| - | ==== 3.3 Connection String ==== | + | ==== 3.4 Connection String ==== |
| < | < | ||
| Line 186: | Line 277: | ||
| \\ | \\ | ||
| - | ==== 3.4 Configurazione Moduli ==== | + | ==== 3.5 Configurazione Moduli ==== |
| ^ Modulo ^ Parametro ^ Descrizione ^ | ^ Modulo ^ Parametro ^ Descrizione ^ | ||
| Line 601: | Line 692: | ||
| ---- | ---- | ||
| - | ===== 11. Integrazione con ERP ===== | + | ===== 11. Integrazione con ERP2 ===== |
| - | Questa sezione descrive come configurare l' | + | Questa sezione descrive come configurare l' |
| + | |||
| + | **Script di riferimento: | ||
| + | |||
| + | > **Nota:** Le viste e stored procedure possono variare a seconda dell' | ||
| \\ | \\ | ||
| ==== 11.1 Panoramica ==== | ==== 11.1 Panoramica ==== | ||
| - | L' | + | L' |
| - | * Esportare automaticamente | + | * **Import** da ERP: Caricare articoli e listini prezzi dal gestionale alla cassa |
| - | * Esportare i DDT confermati verso il gestionale | + | * **Export** verso ERP: Esportare automaticamente chiusure cassa, |
| * Sincronizzare lo stato dei DDT tra i due sistemi | * Sincronizzare lo stato dei DDT tra i due sistemi | ||
| - | \\ | + | **Flusso |
| - | **Flusso | + | |
| < | < | ||
| - | CHIUSURA CASSA COMPLETATA | + | LINKED SERVER |
| - | | + | |
| - | ▼ | + | |
| - | ExchangeData() | + | |
| - | | + | |
| - | ▼ | + | |
| - | PRC_EXPORT_ERP | + | |
| - | | + | │ │ DA_ERP |
| - | ├──► ERP_CASSA_CHIUSURE (totali per metodo pagamento) | + | │ │ (SP su CASHDATA) │ IVA, MARCHE... |
| - | ├──► | + | |
| - | ├──► ERP_CASSA_CHIUSURE_IVA (ripartizione IVA) | + | |
| - | ├──► ERP_CASSA_ELENCO_CHIUSURE | + | |
| - | | + | |
| - | └──► | + | │ ┌─── EXPORT ──────┤ |
| - | ├──► ORDINI_TOCOMPANY (testate DDT) | + | │ │ PRC_EXPORT_ERP |
| - | └──► ORDINI_DET_TOCOMPANY (righe DDT) | + | │ │ (SP su CASHDATA) │ EXT_ORDINI_* |
| + | | ||
| + | | ||
| + | | ||
| + | └────────────────────┴────────────────────┘ | ||
| </ | </ | ||
| \\ | \\ | ||
| - | ==== 11.2 Configurazione | + | ==== 11.2 Parametri di Configurazione ==== |
| - | === STEP 1: Abilitare | + | Parametri da configurare in '' |
| - | Configurare i seguenti parametri in '' | + | ^ Parametro |
| - | + | | **EXPORT_ERP** | 10 | '' | |
| - | ^ Parametro ^ Valore ^ Descrizione ^ | + | | **ExportDataForTrasmission** | 10 | '' |
| - | | EXPORT_ERP | true | Abilita l' | + | | **ERP_CODMAG** | 20 | //(es. NEGCU)// | **Obbligatorio.** Codice magazzino nel sistema ERP. Usato anche come prefisso per chiavi DDT | |
| - | | ExportDataForTrasmission | 0 | 0 = export | + | | **Invio_DDT_to_ERP** | 10 | '' |
| - | | Invio_DDT_to_ERP | 1 | 1 = esporta anche i DDT (opzionale) | | + | | **ExportDataType** | 10 | '' |
| + | | **Carico_Ordini** | 10 | '' | ||
| \\ | \\ | ||
| - | === STEP 2: Configurare il codice magazzino ERP === | + | ==== 11.3 Procedura di Installazione ==== |
| - | Inserire il parametro | + | Gli script si trovano in '' |
| - | <code sql> | + | === STEP 0: Creare il Linked Server |
| - | -- Modificare i valori secondo l' | + | |
| - | DECLARE @firma INT = 10; | + | |
| - | DECLARE @shopnr INT = 84; | + | |
| - | DECLARE @releasefor INT = 84; | + | |
| - | DECLARE @codmag VARCHAR(50) = ' | + | |
| - | IF NOT EXISTS (SELECT 1 FROM CASSA_CONFIG_PARAMETER WHERE CP_NAME = 'ERP_CODMAG' | + | **Script: |
| - | BEGIN | + | |
| - | INSERT INTO CASSA_CONFIG_PARAMETER | + | |
| - | (SHOP_NR, RELEASEFOR, CP_SECTION, CP_SECTION_PROGR, | + | |
| - | VALUES | + | |
| - | (@shopnr, @releasefor, | + | |
| - | PRINT 'Parametro ERP_CODMAG inserito con valore: | + | Crea un linked server denominato |
| - | END | + | |
| - | </ | + | |
| - | \\ | + | **Valori da personalizzare:** |
| - | === STEP 3: Creare/ | + | |
| - | Nel database CASHDATA, creare o aggiornare la stored procedure: | + | ^ Parametro ^ Valore di esempio ^ Descrizione ^ |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| <code sql> | <code sql> | ||
| - | ALTER PROCEDURE [dbo].[PRC_EXPORT_ERP] | + | -- Esempio (da 00_Creare linked server.txt) |
| - | AS | + | EXEC master.dbo.sp_addlinkedserver |
| - | BEGIN | + | @server = N' |
| - | | + | @srvproduct = N'', |
| - | | + | @provider = N' |
| - | | + | @datasrc = N' |
| - | | + | |
| - | -- Lettura CODMAG da parametro di configurazione | + | EXEC master.dbo.sp_addlinkedsrvlogin |
| - | | + | @rmtsrvname |
| - | | + | |
| - | | + | |
| + | @rmtuser | ||
| + | @rmtpassword = '########' | ||
| + | </ | ||
| - | IF @CODMAG IS NULL OR LTRIM(RTRIM(@CODMAG)) = '' | + | Le opzioni importanti impostate dallo script: |
| - | BEGIN | + | * '' |
| - | RAISERROR('Parametro ERP_CODMAG non configurato. Contattare la software house.', 16, 1) | + | * '' |
| - | | + | * '' |
| - | END | + | |
| - | -- Ordprexix deriva da CODMAG (usato come prefisso per i DDT) | + | \\ |
| - | SET @Ordprexix | + | === STEP 1: Creare tabelle e viste nel DB ERP2 === |
| - | -- Determina range chiusure | + | **Script:** '' |
| - | 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), | + | |
| - | -- Pulizia e inserimento dati chiusure | + | Eseguire sul **database del gestionale ERP2**. Lo script crea: |
| - | DELETE FROM ERP_CASSA_CHIUSURE WHERE IDCHIUSURA > @ERPULTCHIU AND IDCHIUSURA <= @CASSULTCHIU AND CODMAG = @CODMAG | + | |
| - | INSERT INTO ERP_CASSA_CHIUSURE (IDCHIUSURA, | + | |
| - | SELECT IDCHIUSURA, DATASCONTRINO, | + | |
| - | FROM V_CASSA_CHIUSURE WHERE IDCHIUSURA > @ERPULTCHIU AND IDCHIUSURA <= @CASSULTCHIU | + | |
| - | | + | |
| - | END | + | |
| - | </ | + | * '' |
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | - **Tabelle per DDT** (se '' | ||
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | - **Sinonimi** per accesso semplificato: | ||
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | - **Vista** '' | ||
| + | |||
| + | **Valori da personalizzare: | ||
| + | |||
| + | ^ Parametro ^ Valore di esempio ^ Descrizione ^ | ||
| + | | Password '' | ||
| + | | '' | ||
| \\ | \\ | ||
| - | ==== 11.3 Configurazione | + | === STEP 2: Creare sinonimi, viste e SP nel DB CASHDATA |
| - | Nel database del gestionale ERP è necessario creare le tabelle di destinazione per ricevere i dati esportati da CASHDATA. | + | **Script:** '' |
| - | **File script:** '' | + | Eseguire sul **database CASHDATA**. Lo script crea: |
| - | \\ | + | **a) Sinonimi verso le tabelle ERP (via linked server)** |
| - | === Tabelle | + | |
| + | Creare un sinonimo | ||
| <code sql> | <code sql> | ||
| - | -- Chiusure per metodo di pagamento | + | CREATE |
| - | CREATE | + | </ |
| - | | + | |
| - | | + | |
| - | [DATA] [smalldatetime] NULL, | + | |
| - | [CODPAG] [varchar](50) NULL, | + | |
| - | [VALCHIUSURA] [decimal](12, | + | |
| - | [CODMAG] [varchar](50) NULL | + | |
| - | ) | + | |
| - | -- Ripartizione IVA per chiusura | + | Sinonimi necessari |
| - | CREATE TABLE [dbo].[AY_CASSA_CHIUSURE_IVA]( | + | |
| - | [ID] [int] IDENTITY(1, | + | |
| - | [IDCHIUSURA] [int] NOT NULL, | + | |
| - | [Aliquota] [decimal](12, | + | |
| - | [Tot_senza_Iva] [decimal](12, | + | |
| - | [Tot_Iva] [decimal](12, | + | |
| - | [ID_IVA] [int] NULL, | + | |
| - | [CODMAG] [varchar](50) NULL | + | |
| - | ) | + | |
| - | -- Elenco chiusure esportate | + | ^ Sinonimo nel DB CASHDATA ^ Tabella nel DB ERP ^ |
| - | CREATE TABLE [dbo].[AY_CASSA_ELENCO_CHIUSURE]( | + | | '' |
| - | [ID] [int] IDENTITY(1, | + | | '' |
| - | | + | | '' |
| - | | + | | '' |
| - | | + | | '' |
| - | | + | | '' |
| - | | + | | '' |
| - | | + | | '' |
| - | | + | | '' |
| - | ) | + | | '' |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| - | -- Anagrafica metodi di pagamento | + | **b) Vista '' |
| - | CREATE TABLE [dbo].[AY_CASSA_PAGAMENTI]( | + | |
| - | [CODPAG] [int] NOT NULL, | + | |
| - | [DESPAG] [varchar](200) NULL, | + | |
| - | [CODCON] [varchar](50) NULL, | + | |
| - | [CODCAUINC] [varchar](50) NULL | + | |
| - | ) | + | |
| - | </ | + | |
| - | \\ | + | **c) Vista '' |
| - | === Tabelle | + | |
| - | <code sql> | + | **d) Stored Procedure '' |
| - | -- Dettaglio vendite per articolo | + | * Con parametro '' |
| - | CREATE TABLE [dbo].[AY_CASSA_VENDITE]( | + | * Con parametro '' |
| - | [ID] [int] IDENTITY(1,1) NOT NULL, | + | * Puo' essere invocata dal bottone " |
| - | | + | |
| - | [CODART] [varchar](100) NOT NULL, | + | |
| - | [QUANTITA] [int] NOT NULL, | + | |
| - | [PREZZOVENDITA] [decimal](12, | + | |
| - | [IDCHIUSURA] [int] NOT NULL, | + | |
| - | [CODMAG] [varchar](50) NULL | + | |
| - | ) | + | |
| - | -- Vendite in eccesso rispetto a giacenza teorica | + | **e) Stored Procedure '' |
| - | CREATE TABLE [dbo].[AY_CASSA_VENDITE_ECCESSO]( | + | * Esportazione incrementale basata su IDCHIUSURA |
| - | | + | * Gestisce chiusure, vendite, IVA |
| - | [DATVEN] [smalldatetime] NULL, | + | * Se '' |
| - | | + | |
| - | [QUANTITA] [int] NOT NULL, | + | |
| - | [PREZZOVENDITA] [decimal](12, 2) NOT NULL, | + | |
| - | [IDCHIUSURA] [int] NOT NULL, | + | |
| - | [CODMAG] [varchar](50) NULL | + | |
| - | ) | + | |
| - | </ | + | |
| \\ | \\ | ||
| - | ==== 11.4 Checklist Integrazione | + | ==== 11.4 Checklist Integrazione |
| - | === Nel Database CASHDATA: === | + | === Sul server SQL Server (master): === |
| - | * Inserire parametro | + | * Creare linked server |
| - | * Inserire parametro | + | * Verificare connettivita con '' |
| - | * Inserire parametro | + | |
| - | | + | |
| - | * Creare/ | + | |
| - | * Verificare esistenza viste '' | + | |
| - | \\ | + | === Sul database ERP2: === |
| - | === Nel Database ERP: === | + | * Creare |
| - | * Creare | + | * Creare |
| - | * Creare | + | * (Se DDT) Creare |
| - | * Creare | + | * Creare/modificare la vista '' |
| - | * Creare | + | * Popolare |
| - | * Creare | + | |
| - | * Creare | + | === Sul database CASHDATA: === |
| - | * (Se DDT) Creare | + | * Creare |
| - | * Configurare | + | * Creare |
| + | * Creare la vista '' | ||
| + | * Creare/aggiornare la SP '' | ||
| + | * Creare/ | ||
| + | * Configurare | ||
| + | * Configurare parametro '' | ||
| + | * Configurare parametro '' | ||
| + | * (Opzionale) Configurare '' | ||
| + | * Verificare esistenza viste '' | ||
| + | * Testare import articoli: '' | ||
| + | * Testare export chiusura: '' | ||
| \\ | \\ | ||
| Line 819: | Line 903: | ||
| ^ Stato ^ Descrizione ^ Origine ^ | ^ Stato ^ Descrizione ^ Origine ^ | ||
| | 45 | Confermato | CASHDATA | | | 45 | Confermato | CASHDATA | | ||
| - | | 50 | Trasmesso | CASHDATA (dopo export) | | + | | 50 | Trasmesso | CASHDATA (dopo export |
| | 70 | Importato | ERP (elaborazione OK) | | | 70 | Importato | ERP (elaborazione OK) | | ||
| | 80 | Non importato | ERP (errore elaborazione) | | | 80 | Non importato | ERP (errore elaborazione) | | ||
| Line 827: | Line 911: | ||
| ^ Errore ^ Causa ^ Soluzione ^ | ^ Errore ^ Causa ^ Soluzione ^ | ||
| - | | " | + | | " |
| - | | " | + | | " |
| - | | DDT non esportati | Invio_DDT_to_ERP = 0 | Impostare parametro a 1 | | + | | Linked server non raggiungibile | Rete o credenziali | Testare con '' |
| + | | Errore collation nei JOIN | Collation diversa tra DB | Le viste usano '' | ||
| + | | DDT non esportati | '' | ||
| | Dati duplicati in ERP | Chiusure riesportate | Verificare IDCHIUSURA in ERP_CASSA_ELENCO_CHIUSURE | | | Dati duplicati in ERP | Chiusure riesportate | Verificare IDCHIUSURA in ERP_CASSA_ELENCO_CHIUSURE | | ||
| + | | Articoli non importati | Barcode gia' presente in CASSA_READ_DELNOTE_PROTOCOL | L' | ||
| + | | Bottone " | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 11b. Integrazione con Bilancia ===== | ||
| + | |||
| + | Questa sezione descrive come configurare l' | ||
| + | |||
| + | **Script di riferimento: | ||
| + | |||
| + | \\ | ||
| + | ==== 11b.1 Panoramica ==== | ||
| + | |||
| + | L' | ||
| + | * 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 " | ||
| + | │ | ||
| + | ▼ | ||
| + | | ||
| + | | ||
| + | ▼ | ||
| + | | ||
| + | │ | ||
| + | | ||
| + | | ||
| + | │ | ||
| + | | ||
| + | (Formato BENCHCOMM, encoding ISO-8859-1) | ||
| + | </ | ||
| + | |||
| + | \\ | ||
| + | ==== 11b.2 Parametri di Configurazione ==== | ||
| + | |||
| + | Parametri da configurare in '' | ||
| + | |||
| + | ^ Parametro ^ Sezione ^ Valore ^ Descrizione ^ | ||
| + | | **SCALE_EXPORT_ENABLED** | 10 | '' | ||
| + | | **SCALE_EXPORT_PROTOCOL** | 10 | '' | ||
| + | | **EXPORT_BILANCIA_DIR** | 10 | //(es. C: | ||
| + | |||
| + | \\ | ||
| + | ==== 11b.3 Procedura di Installazione ==== | ||
| + | |||
| + | === STEP 1: Configurare i parametri === | ||
| + | |||
| + | Inserire/ | ||
| + | |||
| + | <code sql> | ||
| + | -- Abilitare export bilancia | ||
| + | UPDATE CASSA_CONFIG_PARAMETER SET CP_VALUE = ' | ||
| + | WHERE CP_NAME = ' | ||
| + | |||
| + | -- Impostare protocollo BENCHCOMM | ||
| + | UPDATE CASSA_CONFIG_PARAMETER SET CP_VALUE = ' | ||
| + | WHERE CP_NAME = ' | ||
| + | |||
| + | -- Impostare directory di export | ||
| + | UPDATE CASSA_CONFIG_PARAMETER SET CP_VALUE = ' | ||
| + | WHERE CP_NAME = ' | ||
| + | </ | ||
| + | |||
| + | \\ | ||
| + | === STEP 2: Creare la Stored Procedure nel DB CASHDATA === | ||
| + | |||
| + | **Script:** '' | ||
| + | |||
| + | > **Nota:** Lo script nella cartella contiene attualmente la SP '' | ||
| + | |||
| + | La SP '' | ||
| + | |||
| + | <code sql> | ||
| + | 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, | ||
| + | -- DescrizioneRiga1, | ||
| + | -- L' | ||
| + | END | ||
| + | </ | ||
| + | |||
| + | \\ | ||
| + | === STEP 3: Creare la directory di export === | ||
| + | |||
| + | Creare la cartella specificata nel parametro '' | ||
| + | |||
| + | \\ | ||
| + | === STEP 4: Configurare la bilancia === | ||
| + | |||
| + | Configurare la bilancia per leggere il file '' | ||
| + | * **Protocollo: | ||
| + | * **Encoding: | ||
| + | * **Lunghezza riga:** 100 caratteri + CR+LF | ||
| + | * **Campi a posizione fissa** (pos 1-99 con dati per banco, PLU, IVA, prezzo, EAN, descrizione, | ||
| + | |||
| + | \\ | ||
| + | ==== 11b.4 Checklist Integrazione Bilancia ==== | ||
| + | |||
| + | * Configurare parametro '' | ||
| + | * Configurare parametro '' | ||
| + | * Configurare parametro '' | ||
| + | * Creare la SP '' | ||
| + | * Creare la directory di export con permessi di scrittura | ||
| + | * Configurare la bilancia per leggere da '' | ||
| + | * Testare l' | ||
| + | * Verificare che il file generato sia corretto (100 char/riga, encoding ISO-8859-1) | ||
| + | |||
| + | \\ | ||
| + | ==== 11b.5 Troubleshooting Integrazione Bilancia ==== | ||
| + | |||
| + | ^ Errore ^ Causa ^ Soluzione ^ | ||
| + | | Bottone " | ||
| + | | " | ||
| + | | Errore durante export | SP '' | ||
| + | | File non generato | Directory non esistente o senza permessi | Verificare che '' | ||
| + | | Bilancia non legge i dati | Formato file errato | Verificare encoding ISO-8859-1 e lunghezza righe (100 + CRLF) | | ||
| ---- | ---- | ||
| Line 902: | Line 1114: | ||
| ^ Errore ^ Causa ^ Soluzione ^ | ^ Errore ^ Causa ^ Soluzione ^ | ||
| - | | " | + | | " |
| - | | "Login failed" | + | | "Login failed" |
| - | | " | + | | " |
| \\ | \\ | ||
| - | ==== 13.2 Errori di Configurazione ==== | + | ==== 13.2 Errori di Prima Installazione ==== |
| + | |||
| + | Questi errori si verificano tipicamente al primo avvio dopo una nuova installazione. La sequenza di avvio dell' | ||
| + | |||
| + | === Flusso di avvio (ordine di verifica) === | ||
| + | |||
| + | < | ||
| + | 1. BackupAndVerifyDataBase() | ||
| + | 2. ReadConfigParameter(" | ||
| + | 3. ReadConfigParameter(" | ||
| + | 4. CheckLic() | ||
| + | 5. ReadDefaultPrinter() | ||
| + | 6. ReadParameter(" | ||
| + | 7. PulisciScontrino() | ||
| + | 8. LoadParametri() | ||
| + | 9. LoadScontrinoDefaultsValues() -- Contatori (NEW_DAYLY_CLOSURE, | ||
| + | 10. Login() | ||
| + | </ | ||
| + | |||
| + | \\ | ||
| + | === Tabella errori e soluzioni === | ||
| + | |||
| + | ^ Errore ^ Causa Radice ^ Soluzione ^ | ||
| + | | **" | ||
| + | | **" | ||
| + | | **" | ||
| + | | **"La stampante non e' installata" | ||
| + | | **" | ||
| + | | **" | ||
| + | | **"Il nome colonna CCO_CASH_NR" | ||
| + | | **" | ||
| + | | **" | ||
| + | | **" | ||
| + | |||
| + | \\ | ||
| + | ==== 13.3 Come Distinguere le Tabelle dei Parametri ==== | ||
| + | |||
| + | Quando si incontra un errore " | ||
| + | |||
| + | ^ Metodo di lettura nel codice ^ Tabella DB ^ Identificato da ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | \\ | ||
| + | ==== 13.4 Errori di Configurazione ==== | ||
| ^ Errore ^ Causa ^ Soluzione ^ | ^ Errore ^ Causa ^ Soluzione ^ | ||
| - | | " | + | | " |
| - | | " | + | | " |
| + | | Parametri con valore vuoto | Alcuni parametri (es. RECEIPT_COUNTER_PWD) richiedono un valore non vuoto | Verificare che CP_VALUE non sia vuoto per i parametri che lo richiedono | ||
| \\ | \\ | ||
| - | ==== 13.3 Errori Operativi ==== | + | ==== 13.5 Errori Operativi ==== |
| ^ Errore ^ Causa ^ Soluzione ^ | ^ Errore ^ Causa ^ Soluzione ^ | ||
| Line 922: | Line 1181: | ||
| \\ | \\ | ||
| - | ==== 13.4 Log e Diagnostica ==== | + | ==== 13.6 Log e Diagnostica ==== |
| * **Log accessi**: Tabella '' | * **Log accessi**: Tabella '' | ||
| * **Log operazioni**: | * **Log operazioni**: | ||
| * **Errori applicazione**: | * **Errori applicazione**: | ||
| + | * **Debug SQL**: Controllare i parametri direttamente nel DB con: | ||
| + | |||
| + | <code sql> | ||
| + | -- Verificare parametri di configurazione | ||
| + | SELECT * FROM CASSA_CONFIG_PARAMETER WHERE CP_NAME = ' | ||
| + | -- Verificare parametri runtime | ||
| + | SELECT * FROM CASSA_PARAMETER WHERE CP_NAME = ' | ||
| + | -- Verificare parametri per-PC | ||
| + | SELECT * FROM CASSA_PARAMETER_PC WHERE CP_NAME = ' | ||
| + | </ | ||
| ---- | ---- | ||
| Line 992: | Line 1261: | ||
| | Form1.cs | ~2700 | Form vendite | | | Form1.cs | ~2700 | Form vendite | | ||
| | PAY.cs | ~2500 | Dialog pagamento | | | PAY.cs | ~2500 | Dialog pagamento | | ||
| - | | CashChiusura.cs | ~800 | Form chiusura cassa | | + | | CashChiusura.cs | ~800 | Form chiusura cassa + validazione DDT per ERP | |
| | UpdateUtility.cs | ~1600 | Importazione dati | | | UpdateUtility.cs | ~1600 | Importazione dati | | ||
| + | | FunctionsForm.cs | ~1800 | Sezione Controllo (export ERP, bilancia) | | ||
| + | | ScaleExport_Benchcomm.cs | ~100 | Export listino bilance formato BENCHCOMM | | ||
| + | |||
| + | \\ | ||
| + | ==== B.2 Script Database - Installazione Base ==== | ||
| + | |||
| + | ^ File ^ Cartella ^ Descrizione ^ | ||
| + | | 00_DB_CREATION_CREATEDB.sql | RELEASE\01\ | Creazione database | | ||
| + | | 01_DB_CREATION_PROCEDURE.sql | RELEASE\01\ | Stored procedures e viste (V_CASSA_CHIUSURE, | ||
| + | | 02_DB_CREATION_TABLES.sql | RELEASE\01\ | Tabelle, dati iniziali, utenti, gruppi, stampanti | | ||
| + | | 03_DB_CREATION_WITH_PROMO.sql | RELEASE\01\ | Dati promozioni | | ||
| + | | 02 Reimposta dati.sql | Cose da fare...\ | Configurazione iniziale (personalizzare prima dell' | ||
| + | | 03_FIX_PARAMETRI_MANCANTI.sql | Cose da fare...\ | Fix parametri mancanti per DB esistenti | | ||
| + | |||
| + | \\ | ||
| + | ==== B.3 Script Integrazione ERP2 ==== | ||
| + | |||
| + | ^ File ^ Cartella ^ Target DB ^ Descrizione ^ | ||
| + | | 00_Creare linked server.txt | RELEASE\02...\ | master | Linked server verso DB ERP2 | | ||
| + | | 01_Tabelle& | ||
| + | | 02_Da fare su DB CashData.txt | RELEASE\02...\ | DB CASHDATA | Sinonimi ERP_*, viste V_ERP_*, SP AY_CARICA_DDT_DA_ERP, | ||
| \\ | \\ | ||
| - | ==== B.2 Script | + | ==== B.4 Script |
| - | ^ File ^ Descrizione ^ | + | ^ File ^ Cartella ^ Target DB ^ Descrizione ^ |
| - | | 00_DB_CREATION_CREATEDB.sql | Creazione database | | + | | 00_Creare SP per estrarre dati.txt | RELEASE\03...\ | DB CASHDATA |
| - | | 01_DB_CREATION_PROCEDURE.sql | Stored procedures | | + | |
| - | | 02_DB_CREATION_TABLES.sql | Tabelle | | + | |
| - | | 02 Reimposta dati.sql | + | |
| ---- | ---- | ||
| //Documento generato automaticamente dall' | //Documento generato automaticamente dall' | ||
| - | //Data generazione: Gennaio | + | //Ultimo aggiornamento: Febbraio |
| - | //Versione: 1.0// | + | //Versione: 1.2 - Aggiunta integrazione ERP2 e bilancia// |