ImportCashData V5 - Guida Operativa

ImportCashData è un'applicazione console .NET che gestisce l'importazione di dati di cassa e contratti nel sistema ERP aziendale. L'applicazione supporta tre modalità operative principali:

ImportCashData.exe /s <username> <password> [operazione] [parametro]

Parametri riga di comando:

Esempi:

:: Importazione corrispettivi (modalità default)
ImportCashData.exe /s admin password123
 
:: Importazione contratti
ImportCashData.exe /s admin password123 /CONTRATTI
 
:: Riscrittura scadenze contratto #456
ImportCashData.exe /s admin password123 /SCADENZE 456

Il processo di inizializzazione segue questi passaggi:

1. Parsing argomenti - Verifica presenza /s, username, password
2. Creazione istanza Engine - Inizializzazione sistema di logging (file: importCashData.log)
3. Caricamento configurazione - Lettura file DBCFG_cassa.xml e connessione a IERPCFG_A03
4. Connessione all'impresa - Query ID azienda, connessione ERP tramite WrapperErp_5

Questa è la modalità principale che elabora le chiusure di cassa e genera i relativi movimenti contabili e di magazzino.

1. Recupero Magazzini

SELECT DISTINCT CODMAG FROM AY_CASSA_CHIUSURE

2. Per ogni Magazzino

• Recupero chiusure in stato 0 (da elaborare)
• Recupero dati pagamenti associati

3. Per ogni Chiusura

• a) StartTransaction() - Avvio transazione
• b) pScriviCorrispettivo() - Creazione movimento contabile
  • Recupero codici conto (CODCONCORR)
  • Recupero conto cassa (CODCONCASSACORR)
  • Creazione movimento MOVCON tipo 'R'
  • Gestione ripartizione IVA
  • Generazione movimento contabile
• c) pScriviIncasso() - Solo se conto pagamento diverso da cassa predefinita
  • Trasferimento da conto pagamento a conto cassa predefinito
  • Creazione movimento MOVCON tipo 'C'
• d) GeneraMovimentoMagazzino() - Per ogni vendita (AY_CASSA_VENDITE)
  • Creazione movimento magazzino
  • Scarico quantità da lotti
  • Se quantità > disponibile: INSERT in AY_CASSA_VENDITE_ECCESSO

4. Esito elaborazione

1. Recupero Contratti Attivi

SELECT * FROM V_CONMV_CONTRATTI_IMPORT WHERE CM_STATO = 'A'

2. Per ogni Contratto

• a) Recupero scadenze pagamento da CONTRATTI_WEB_SCADENZE
• b) Esecuzione PRG_IMPORTA_CONTRATTI_WEB
  • Importazione nel calcolo premi
  • Valore ritorno atteso: 1 (righe inserite)
• c) Se tipo pagamento > 0:
  • Calcolo importo (rate × num_rate)
  • pScriviPNContratto() - Creazione movimento contabile
  • Esecuzione AY_GENERA_SCAD_CONTRATTO
• d) Se CM_SWICHIUDISCAD = true:
  • pScriviPNChiusuraScad() - Chiusura scadenze esistenti
  • Esecuzione EXSP_PARTITE_CONTRATTI_nuovi

3. Invio Email Riepilogativa - “Importazione Contratti WEB”

1. Recupero Contratto

SELECT * FROM contratti_Web WHERE CM_KEY = @ID

2. Se contratto trovato e CM_SWICHIUDISCAD = true:

• Recupero scadenze da CONTRATTI_WEB_SCADENZE
• pScriviPNChiusuraScad() - Ricreazione movimenti di chiusura
• Esecuzione EXSP_PARTITE_CONTRATTI_nuovi - Riconciliazione pagamenti/fatture

<connectionStrings>
  <add name="DBConfig"
       connectionString="Server=192.168.10.200\GESTERP;
                        Database=IERPCFG_A03;
                        User Id=sa;
                        Password=********;" />
</connectionStrings>

AY_CASSA_ELENCO_CHIUSURE (1) ──────► (N) AY_CASSA_CHIUSURE
   │ - IDCHIUSURA (PK)                    │ - IDCHIUSURA (FK)
   │ - CODMAG                             │ - VALCHIUSURA
   │ - STATO                              │ - CODPAG
   │ - DATCHIU                            │
   │                                      │
   │                                      ▼
   │                              AY_CASSA_VENDITE (N)
   │                                 │ - IDCHIUSURA (FK)
   │                                 │ - CODART
   └─► AY_CASSA_PAGAMENTI            │ - QUANTITA
        │ - CODPAG                   │
        │ - CODCON                   ▼
        │ - CODCAUINC         AY_CASSA_ARTICOLI_LOTTI
                                 │ - CODART
                                 │ - CODLOTTO
                                 │ - DISPONIBILITA


CONTRATTI_WEB (1) ──────────────► (N) CONTRATTI_WEB_SCADENZE
   │ - CM_KEY (PK)                     │ - CMCS_RIFCON (FK)
   │ - CM_STATO                        │ - CMCS_NUMDOC
   │ - CM_IMPRATA                      │ - CMCS_DATDOC
   │ - CM_NUMRATE                      │ - CMCS_IMPORTO
   │ - CM_RIFTIPOPAG
   │ - CM_SWICHIUDISCAD

Il sistema utilizza la classe Messaggi per la gestione dei log con i seguenti livelli:

• Percorso: {AppPath}\importCashData.log
• Formato: Timestamp + messaggio
• Nota: Non è presente rotazione automatica dei log

try {
    pEngI24.StartTransaction()
 
    // Operazioni contabili e di magazzino
 
    if (successo) {
        pEngI24.Commit()
        // UPDATE stato = 2
    }
} catch {
    pEngI24.RollBack()
    InvioMail(esito: false, dettaglio errori)
}

Quando la quantità venduta supera la disponibilità a magazzino:

-- Inserimento automatico dell'eccesso
INSERT INTO AY_CASSA_VENDITE_ECCESSO
    (CODART, QUANTITA_ECCESSO, IDCHIUSURA, ...)
VALUES
    (@CodArt, @QtaEccesso, @IdChiusura, ...)

1. Transazioni atomiche: Ogni chiusura è elaborata in una transazione separata
2. Idempotenza: Lo stato = 2 previene rielaborazioni
3. Isolamento per magazzino: Errori in un magazzino non bloccano gli altri
4. Notifica immediata: Email inviata al primo errore critico

Server:     smtp.gmail.com
Porta:      587
Sicurezza:  TLS/SSL abilitato
Mittente:   Configurato in smtp_User

• Al completamento di ogni chiusura cassa elaborata correttamente
• Al termine dell'importazione contratti (se senza errori)

• Al verificarsi di un errore durante l'elaborazione di una chiusura
• Al termine dell'importazione contratti con errori

Il corpo dell'email contiene un'intestazione e una tabella con tutti i messaggi registrati durante l'elaborazione:

<H3>Log Importazione Corrispettivo in Contabilità : n° 1234 del 20-01-2026 per Negozio MAG01</H3>
 
<table>
  <tr>
    <td>[Info]</td>
    <td>Inizio elaborazione chiusura 1234</td>
  </tr>
  <tr>
    <td>[Info]</td>
    <td>Creazione movimento contabile corrispettivo</td>
  </tr>
  <tr>
    <td>[Errore]</td>
    <td>Codice conto 500400099 non trovato nel piano dei conti</td>
  </tr>
  <tr>
    <td>[Errore]</td>
    <td>Impossibile completare la registrazione contabile</td>
  </tr>
</table>

Dopo l'invio dell'email (sia successo che errore), la lista messaggi viene svuotata:

pMessaggi.Items.Clear()

Questo assicura che le email successive contengano solo i messaggi relativi all'elaborazione corrente.

Per l'esecuzione automatica tramite Task Scheduler di Windows:

@echo off
cd /d "C:\Program Files\ImportCashData\V5"
ImportCashData.exe /s username password

Configurazione consigliata:

• Esecuzione giornaliera post-chiusura cassa
• Account di servizio con privilegi minimi necessari
• Monitoraggio file log per anomalie
• Verifica periodica casella email per notifiche errore

Documento generato automaticamente - ImportCashData V5