XLite - Scambio Importo - Istruzioni all'uso
La procedura di scambio importo integrata in XLite consente di rendere più sicure e affidabili le operazioni di pagamento con Bancomat o carte di credito, velocizzando le operazioni e riducendo il rischio di errori manuali.
Inoltre, la presenza di questo modulo consente inviare al Registratore Telematico, in corrispondenza della registrazione di un pagamento elettronico, anche le informazioni sullo STAN (System Trace Audit. Number) e sulla data/ora ufficiale del pagamento, in linea con gli adempimenti, introdotti dalla Legge di Bilancio 2025, in vigore dal 1° gennaio 2026.
L'utilizzo del modulo, come vedremo di seguito, è molto semplice, e consente di operare in diversi scenari.
Nel seguito del documento verranno presentati:
Emissione di documenti commerciali (scontrini)
Il modo più semplice di operare, una volta abilitata la licenza del modulo, è quello di accedere alla form dei pagamenti misti.
Una volta cliccato sul pulsante "Carte di credito", appare la form mostrata in figura e l'importo da pagare viene inviato automaticamente al dispositivo POS.
Da notare nella parte bassa della form "Pagamento in corso", la visualizzazione del messaggio di stato, che descrive l'andamento delle operazioni in corso. Si ricorda a questo proposito che non tutti i dispositivi sono in grado di inviare alla procedura questa informazione.
Al completamento del pagamento, la form mostrata sopra si chiude in automatico, e il documento commerciale viene salvato e stampato automaticamente.
In alternativa all'uso della form dei pagamenti, lo Scambio Importo può essere attivato anche tramite un pagamento rapido con Carte di Credito.
Emissione di fatture
Come descritto nel paragrafo precedente, dopo l'esecuzione della procedura di Scambio Importo, il documento commerciale viene stampato in modo automatico.
Nel caso in cui si abbia la necessità di produrre una fattura, è necessario cliccare sul pulsante "Fattura" PRIMA di inviare la richiesta di pagamento al POS.
Da notare che l'elenco dei pagamenti in alto a sinistra deve risultare normalmente vuoto.
A questo riguardo si ricorda che:
se appare un pagamento "CONTANTI", contattare l'assistenza per procedere con la modifica della configurazione (rif. parametro "Registra automaticamente pagamento su selezione fattura");
se compare un pagamento di tipo "CREDITO" significa che sulla anagrafica del cliente è stata impostata una forma di pagamento e quindi il documento, correttamente, viene chiuso di default come un non pagato; se si desidera chiudere comunque direttamente un pagamento per questo specifico documento, eliminare il pagamento e procedere come mostrato nel seguito.
Alla selezione del pagamento con "Carte di Credito" la procedura si completa come mostrato nel caso precedente e la fattura viene salvata e stampata in modo automatico.
Stampa ricevuta
A seconda di come la procedura è stata configurata, la stampa delle ricevute di pagamento può avvenire:
direttamente sul POS;
in coda al documento commerciale, nel corpo del documento;
in automatico o su richiesta su Registratore Telematico come documento gestionale.
In merito alla stampa diretta su POS, si ricorda che alcuni modelli presentano al cliente l'opzione di stampa o meno della ricevuta. Il problema di questo comportamento è legato al fatto che l'intera esecuzione del comando di pagamento risulta bloccata fino al momento della selezione della opzione, anche se il pagamento è già stato in effetti completato e registrato dal circuito bancario.
Questo comportamento può risultare non solo poco chiaro, ma soprattutto pericoloso in quando:
finchè la selezione non è stata completata, l'applicazione appare "bloccata", anche se il pagamento si è in effetti già completato;
se il cliente non è particolarmente rapido, la procedura rischia di andare in timeout, segnalando un inesistente errore nel pagamento.
In presenza di dispositivi che presentano questa problematica, si suggerisce quindi di disattivare sempre la stampa della ricevuta da POS, preferendo invece la stampa in una delle altre modalità descritte in precedenza.
In alternativa, potrebbe risultare preferibile non stampare nessuna ricevuta e aggiungere sulla interfaccia il pulsante con apposita action "ECR17: Ristampa ricevuta da printer non fiscale":
Infine, si ricorda che la stampa della ricevuta può in ogni momento essere fatta, anche su vecchi documenti, tramite l'apposito comando presente in archivio:
Annullamento di un pagamento in corso
In condizioni di normalità, l'interruzione di un pagamento in corso andrebbe fatta sempre operando sul dispositivo POS e non dalla interfaccia applicativa.
A fronte dell'annullamento sul dispositivo, sulla applicazione appare un messaggio analogo al seguente, e la procedura di pagamento viene a tutti gli effetti interrotta:
Uscendo invece dalla form tramite il comando "Cancel", di fatto non viene interrotta la richiesta attiva sul POS e appare invece il seguente messaggio,
seguito subito dalla ulteriore segnalazione, che ricorda e suggerisce di interrompere il processo in corso sul dispositivo.
Va invece utilizzata con molta attenzione l'utilizzo della funzione "Considera Pagato". La funzione interrompe il processo di pagamento con il POS, considerandolo chiuso con esito positivo, senza aspettare il messaggio di ritorno dal POS.
La procedura mostra infatti un messaggio con il quale si ricorda di interrompere eventuali processi di pagamento che fossero ancora attivi sul dispositivo.
L'effetto di questo comando è quello di chiudere comunque il pagamento su RT come pagamento elettronico, senza passare dal processo di Scambio Importo (e quindi per evidenti ragioni senza registrare l'informazione dello STAN su RT).
Si sconsiglia comunque di NON utilizzare MAI questa funzione, se non in casi di emergenza, preferendo in alternativa altre funzionalità, quali ad esempio la gestione delle carte di credito speedy, che verranno meglio illustrate di seguito.
Pagamenti elettronici non da scambio importo (SatisPay / SumUp)
Talvolta è necessario memorizzare dei pagamenti che devono a tutti gli effetti essere registrati come pagamenti elettronici sul Registratore Telematico, ma che non vengono generati attraverso la procedura dello Scambio Importo tramite Ecr17. E' questo il caso ad esempio della registrazione dei pagamenti avvenuti tramite i servizi Satispay o SumUp.
Per venire incontro a questa esigenza è stata sviluppata la funzionalità di gestione delle Carte di Credito Speedy. Informazioni dettagliate sulla configurazione di queste carte possono essere trovate in XLite - Configurazione applicativa modulo di Scambio Importo
In presenza di questa configurazione, entrando nella form dei pagamenti appare un nuovo pulsante, che consente di registrare, in modo tradizionale e senza passare dalla procedura di Scambio Importo, un pagamento tramite la carta appena creata.
In caso di presenza di carte speedy multiple, la form dei pagamenti ed il suo funzionamento verranno modificati di conseguenza, come mostrato nella seguente immagine.
Si ricorda infine che il pagamento tramite Carte di Credito Speedy è disponibile, oltre che attraverso la form dei pagamenti appena mostrata, anche tramite un apposito pulsante di pagamento rapido, configurabile come pulsante action collegato al comando "Pagamento rapido Carte di Credito Speedy".
Gestione multi-POS
La procedura di scambio importo consente di gestire anche la presenza di POS multipli. Per dettagli sulla configurazione fare sempre riferimento alla documentazione riportata in XLite - Configurazione applicativa modulo di Scambio Importo
La scelta del POS da utilizzare avviene al momento della richiesta di pagamento tramite carta di credito, come mostrato nella seguente immagine:
Dopo la selezione di uno dei due (o più) terminali POS presenti, la richiesta di pagamento verrà indirizzata verso il terminale prescelto, ed il pagamento avverrà secondo le modalità descritte in precedenza;
Il processo descritto risulta del tutto analogo anche nel caso di pagamenti avvenuti attraverso la form dei pagamenti multipli.
Gestione errori
Al momento della richiesta di esecuzione di un pagamento tramite scambio importo appare la solita form di attesa:
Quando l'operazione non si completa con esito positivo, possono venire segnalati diversi messaggi di errore, tra cui i più comuni vengono descritti di seguito, unitamente alla modalità suggerita per la loro corretta gestione.
Errori di connessione al POS
Tipicamente riconoscibili da messaggi di errore come il seguente:
Soluzione suggerita:
provare come prima soluzione a riavviare il POS;
se il problema si presenta nuovamente, o comunque se si ripresenta con una certa frequenza, contattare l'assistenza per approfondimenti tecnici.
Pagamento in corso
Riconoscibile dal seguente messaggio:
Questa segnalazione appare quando il POS, al momento dell'invio della richiesta di pagamento, risulta già impegnato con un precedente pagamento, non ancora completato.
Spesso questo errore si presenza a causa di un utilizzo improprio della funzione "Considera Pagato".
Soluzione suggerita:
annullare il pagamento in corso sul dispositivo POS.
Errore di timeout
Riconoscibile ad esempio da uno dei seguenti messaggi:
Questa segnalazione appare quando il dispositivo POS non completa nei tempi attesi la richiesta di pagamento.
Soluzione suggerita:
verificare se sul POS risulta ancora effettivamente in esecuzione una richiesta di pagamento, ed eventualmente annullarla prima di generare una nuova richiesta.
provare come seconda soluzione a riavviare il POS;
se il problema si presenta nuovamente, o comunque se si ripresenta con una certa frequenza, contattare l'assistenza per i necessari approfondimenti.