Archivi del mese: Aprile 2026

Integrazione POS – Registratore Telematico – Gestionale

Obbligo normativo dal 2026

Dal 2026, secondo le disposizioni dell’Agenzia delle Entrate relative alla trasmissione telematica dei corrispettivi e all’integrazione dei sistemi di pagamento elettronico, diventa obbligatorio per gli esercenti:

  • associare il pagamento elettronico allo scontrino fiscale
  • garantire lo scambio dati tra POS ed ECR
  • riportare su scontrino esito, codice autorizzativo e numero transazione
  • assicurare la tracciabilità dell’operazione

Questo comporta che il POS non può più essere utilizzato solo in modalità stand‑alone: deve essere configurato in modalità ECR / PC‑POS / ERC17, 3CXML o altro protocollo certificato.

Aggiornamenti introdotti nel gestionale

Per adeguarsi alla normativa, nella maschera “Trasmetti dati scontrino” del gestionale sono stati aggiunti i seguenti controlli:

  • Campo “Terminal ID POS”: identifica univocamente il terminale POS in uso associato alla postazione di lavoro su cui si sta operando
  • Icona ingranaggio accanto al Terminal ID POS: apre la maschera di configurazione della comunicazione POS/ECR (protocollo, IP, porta, parametri, log) specifico per la postazione di lavoro su cui si sta operando

Funzionamento della maschera “Trasmetti dati scontrino”

La maschera Trasmetti dati scontrino consente di gestire:

  • importo
  • modalità di pagamento
  • Terminal ID POS
  • invio dei dati al POS

Quando viene selezionato un pagamento elettronico, il gestionale:

  1. prepara i dati dello scontrino
  2. invia la richiesta al POS
  3. attende la risposta
  4. registra esito, codice autorizzativo e numero transazione
  5. se la transazione ha esito positivo invia la richiesta di stampa dello scontrino a cui aggiunge Terminal ID POS, codice di autorizzazione e numero di transazione
  6. se la transazione ha esito negativo chiede all’operatore se vuole continuare con la stampa dello scontrino oppure se vuole ritentare di trasmettere la richiesta al POS

Come configurare i parametri per la comunicazione con il POS

Premendo il pulsante con l’icona ingranaggio presente nella maschera “Trasmissione dati scontrino” è possibile configurare i parametri di comunicazione con il POS, il gestionale prevede le seguenti modalità di comunicazione:

  • Nessuna trasmissione al POS
  • Protocollo 17 (Generico)
  • Protocollo 17 (Ingenico)
  • Protocollo 3CXML

Nessuna trasmissione al POS

Cosa impostare sul POS

Nulla. Il POS lavora in modalità stand‑alone.

Cosa impostare sul PC gestionale

Tipo comunicazione POS: Nessuna trasmissione al POS

Comportamento

  • Lo step POS viene saltato
  • Il pagamento carta viene registrato internamente
  • Nessuna connessione TCP viene aperta

Log

Nessun log generato

Protocollo 17 (Generico)

Questa modalità è pensata per POS bancari che utilizzano varianti personalizzate del protocollo ERC17.

Cosa impostare sul POS

Il tecnico bancario deve configurare:

  • IP statico del POS (es. 192.168.20.50)
  • Porta TCP (es. 8000)
  • Modalità: ECR / PC‑POS / ERC17
  • Separatore dei campi (| ; ^ , …)
  • Formato importo (es. 0000001234 = 12,34)
  • Ordine dei campi nella risposta
  • Timeout consigliato ≥ 30 secondi

Ogni banca può usare un dialetto diverso del Protocollo 17.

Cosa impostare sul PC gestionale

  • Tipo comunicazione POS: Protocollo 17 (Generico)
  • IP POS
  • Porta POS
  • Separatore (da log)
  • Indice campo importo
  • Indice campo esito
  • Indice campo codice autorizzativo
  • Indice campo numero transazione
  • Formato importo coerente con il POS
  • Timeout 30–60 secondi

Test di rete

  • Ping IP
  • telnet IP PORTA → deve dire “Connesso”

Test funzionale

  1. Eseguire un pagamento
  2. Aprire il log
  3. Identificare separatore e campi
  4. Inserire i valori nella configurazione
  5. Ripetere finché i campi vengono interpretati correttamente

Esempio di log

TX ASCII: 1000|000|PAY RX ASCII: OK|646918|957783

Protocollo 17 (Ingenico)

Per POS Ingenico, PAX, Nexi, Axerve, Iccrea, CooperSystem configurati in ERC17 standard.

Cosa impostare sul POS

  • IP statico
  • Porta ECR: 8000
  • Modalità: ECR / PC‑POS / ERC17 standard
  • Separatore: FS (0x1C)
  • Frame STX / FS / ETX / LRC

Se il POS non risponde → non è in modalità ERC17 standard.

Cosa impostare sul PC gestionale

  • Tipo comunicazione POS: Protocollo 17 (Ingenico)
  • IP POS
  • Porta POS

Test di rete

  • ping IP → deve rispondere
  • telnet IP 8000 → Connesso

Test funzionale

Verificare nel log:

  • STX
  • FS
  • ETX
  • LRC
  • esito OK/KO

Esempio di log

TX ASCII: 1000|000|PAY RX ASCII: OK|646918|957783

Protocollo 3CXML

Per POS o gateway che espongono un servizio XML via TCP/HTTPS.

Cosa impostare sul POS / gateway

  • IP statico (es. 192.168.20.60)
  • Porta XML (es. 9000)
  • Servizio XML attivo
  • Formato XML standard
  • Timeout ≥ 30 secondi

Cosa impostare sul PC gestionale

  • Tipo comunicazione POS: Protocollo 3CXML
  • IP server 3CXML
  • Porta

Test di rete

telnet IP 9000 → Connesso

Test funzionale

Verificare nel log:

  • XML inviato
  • XML ricevuto
  • esito
  • codice autorizzativo
  • numero transazione

Esempio di log

TX XML: <PAYMENT amount=”3450″ /> RX XML: <RESPONSE esito=”OK” auth=”646918″ trans=”957783″ />

Log POS – struttura e utilizzo

Il log è lo strumento principale per:

  • verificare che il POS risponda
  • identificare separatore e struttura dei campi
  • configurare il Protocollo 17 Generico
  • diagnosticare problemi di rete o configurazione

Posizione del log

Sottocartella del gestionale \LOG_POS\

Struttura del log

Ogni operazione genera:

[TX] byte esadecimali [TX ASCII] traduzione ASCII [RX] byte esadecimali [RX ASCII] traduzione ASCII

La parte ASCII è fondamentale per interpretare correttamente i campi.