Beta tecnica: È disponibile un connettore ODBC in sola lettura per una prima convalida controllata su un’installazione reale di Open POS NG. Non deve essere abilitato per operazioni di cassa reali finché la matrice di test non è stata completata.
Prerequisiti
ImaCash deve essere eseguito su Windows e raggiungere il server locale di Open POS NG. Creare un DSN di sistema ODBC a 32 bit con il driver del database utilizzato dall’installazione e un account in sola lettura con autorizzazione SELECT su una tabella o vista transazionale preparata da Avalon o dal manutentore del POS.
Configurazione in ImaCash
- Dalla finestra principale, apri Configurazione > Integrazione > POS e seleziona Open POS NG (Avalon) - Beta. Utilizza l’identificazione autorizzata richiesta da ImaCash.
- In ODBC name, inserisci il nome esatto del DSN di sistema a 32 bit predisposto dal responsabile. Deve funzionare con l’account Windows che esegue ImaCash, senza un’ulteriore finestra di accesso. Utente e Password sono dati privati: compilali solo quando la configurazione del DSN lo richiede.
- In Tabella o vista vendite indicare la sorgente esatta autorizzata, con una riga per operazione o metodo di pagamento; mai una tabella di articoli che ripeta il totale dello scontrino. Usare schema.tabella quando necessario. ImaCash non cerca né seleziona altre sorgenti.
Mappatura esplicita e vincolante
Inserisci in Mappatura colonne il contratto confermato dal responsabile. I nomi e i valori dell’esempio seguente illustrano la sintassi; non descrivono lo schema di tutte le installazioni di Open POS NG. Non incollare una stringa di connessione, una password o dati di vendita in questo campo.
Definire sempre la mappatura delle colonne con coppie separate da punto e virgola; ImaCash la usa come contratto vincolante e non tenta di indovinare le colonne. Deve includere dateonly=true|false: true indica che date è una colonna DATE senza ora e consente di usare time con dateonly=true; false indica che date contiene già data e ora. Ad esempio: id=ID;date=DATA;dateonly=true;time=ORA;cash=IMPORTO_CONTANTI;operator=OPERATORE;terminal=CASSA. Il contratto cash accetta un solo importo coerente per ID e si blocca in sicurezza se lo stesso ID si ripete con valori diversi. Per le righe di pagamento usare amount=IMPORTO_PAGAMENTO;payment=METODO_PAGAMENTO;cashvalue=CONTANTI|CASH. Se gli identificatori richiedono delimitatori, aggiungere quote=none|double|bracket|backtick; none è il valore predefinito.
Contratto di completamento obbligatorio
Configurare una di queste due opzioni: una vista che contenga esclusivamente vendite finali insieme a finalonly=true; oppure status=STATO;closedvalue=CHIUSA|PAGATA;modified=MODIFICATA_IL per filtrare gli stati chiusi e recuperare le chiusure tardive. Nel contratto amount+payment con status+modified, modified identifica la modifica della vendita: ImaCash ottiene prima gli ID modificati e poi recupera tutte le relative righe prima di sommare i contanti, evitando l’acquisizione parziale di un pagamento misto. Senza uno di questi contratti l’integrazione si blocca in sicurezza.
Ambito della beta
L’integrazione legge le operazioni recenti e passa a ImaCash soltanto i contanti, includendo solo la componente in contanti dei pagamenti misti e i rimborsi con segno negativo. È rigorosamente di sola lettura: non modifica mai Open POS NG e non scrive conferme, stati, pagamenti o annullamenti in Avalon.
Salvare e verificare la configurazione
Chiudendo Configurazione con modifiche, puoi salvare, continuare a modificare o uscire senza salvare le modifiche in sospeso. Il salvataggio avviene per fasi: un errore successivo non annulla le fasi già salvate. Aprire il DSN e verificare origine e mappatura dimostra soltanto quell’accesso in lettura; non conferma un’acquisizione completa, un pagamento o il funzionamento del dispositivo.
Filtri, storico e verifica iniziale
I filtri per postazione e operatore richiedono rispettivamente le colonne terminal e operator nella mappatura. Controlla selezione e attivazione in Impostazioni > Filtri. La consultazione usa una finestra recente di massimo due ore; la risincronizzazione non garantisce il recupero dell’intero storico. Questa beta non importa articoli, scorte, turni o un totale separato delle carte.
Prima dell’uso commerciale, il responsabile deve verificare su un’installazione reale una vendita in contanti, un pagamento misto, un rimborso, una chiusura tardiva e la continuità dopo il riavvio, compresa l’assenza di duplicati. Un test con dati fittizi o una connessione riuscita non completa questa verifica. Se l’esito è incerto, controlla lo scontrino e il contante effettivo prima di ripetere, risincronizzare o riavviare.
Consultare configurazione, salvataggio e uscita nel manuale di ImaCash