Configurare Ágora Retail in ImaCash
Questa guida riguarda POS > AgoraRetail e la lettura SQL Server. Ágora POS e Ágora API sono modalità diverse. I nomi precedenti AgoraRetail V2 e V3 indicano lo stesso connettore; non attestano versioni commerciali o compatibilità aggiuntiva.
Prima di iniziare
Il fornitore deve confermare versione e struttura compatibili, server e database attivi e un account autorizzato con i permessi di lettura necessari. Verifica l’accesso con l’identità che esegue ImaCash e conserva una configurazione funzionante. Non copiare esempi dai manuali e non presumere che ogni installazione Ágora sia compatibile.
Passaggi di configurazione
- Apri Configurazione > Integrazione e seleziona POS > AgoraRetail. Conferma con il fornitore la modalità predisposta prima di modificare un’installazione esistente.
- Controlla questi campi con il tecnico usando esclusivamente i dati privati forniti dall’amministratore:
- IP del server e Porta identificano la destinazione SQL Server dell’installazione. La porta viene usata se la destinazione non include già un’istanza o una porta; questa guida non indica una porta universale.
- Nome del database è il nome esatto del database vendite compatibile, non un file o un elenco di postazioni.
- Nome istanza identifica l’istanza SQL Server, se necessaria. L’istanza ha priorità sul campo Porta; non aggiungerla due volte e non combinare dati di altre installazioni.
- Compila Utente e password con l’account SQL privato autorizzato e inserisci il segreto solo in ImaCash. Questa modalità non mostra una casella per l’autenticazione Windows. Se una configurazione precedente la usa già, conserva la sua identità Windows valida e richiedi una verifica tecnica; non modificare file per attivarla.
Salva la connessione e scegli i metodi reali dell’installazione quando compaiono gli elenchi. Conserva la configurazione funzionante e verifica quanto salvato prima dell’uso. Se non compaiono metodi, non presumere che la connessione abbia validato i pagamenti. Completa un nuovo avvio normale di ImaCash, senza operazioni in corso, per applicare e verificare i metodi salvati.
Contanti, carte e movimenti di cassa
Seleziona il metodo contanti con il nome reale. Per le carte scegli un metodo diverso e attiva Accetta carte nelle impostazioni. Con l’opzione disattivata viene interrogato solo il metodo contanti; attivandola si aggiunge quello carta selezionato. Non usare identificatori di esempio e non presumere che un elenco vuoto o una selezione annullata garantiscano la classificazione. Credito, buoni e altri metodi non sono inclusi automaticamente.
Ogni pagamento viene letto come importo pagato meno resto, conservando il segno. Un documento misto può generare movimenti separati delle componenti selezionate; il totale non viene ripetuto per metodo. Un importo negativo non attesta un rimborso eseguito o un’autorizzazione bancaria. Questa modalità non include una lettura indipendente dei movimenti di cassa/fornitori.
Postazioni, operatori e filtri
Verifica postazioni e operatori con documenti noti prima di applicare filtri. L’elenco delle postazioni può fornire identificatori mentre i movimenti mostrano nomi: verificane la corrispondenza. In alcuni schemi la postazione è quella di apertura del ticket, non quella del pagamento. L’operatore è quello di apertura del documento. I filtri locali di ImaCash possono escludere pagamenti già letti da SQL; un riferimento generico al negozio non identifica un negozio fisico.
Verificare i risultati
Confronta pagamenti esistenti in contanti, con carta e misti, resto, importi negativi, date e collegamento al documento. Rivedi con il fornitore pagamenti senza documento associato, duplicati, omissioni e filtri. Non effettuare pagamenti o rimborsi reali per provare la configurazione. Una connessione SQL riuscita non attesta lettura completa o chiusura del documento. I pagamenti senza documento associato possono non avere postazione o operatore; non completare questi dati per supposizione.
Il collegamento legge pagamenti; non importa prodotti e non scrive conferme, rifiuti o annullamenti in Ágora. Elenchi dei metodi, connessione e varianti di schema previste non attestano compatibilità con tutte le versioni o validazione fisica. Conferma l’ambito dell’installazione prima dell’uso automatico.