Esplora E-book
Categorie
Esplora Audiolibri
Categorie
Esplora Riviste
Categorie
Esplora Documenti
Categorie
MANUALE PROTOCOLLO
XON-XOFF
Pag. 1/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
REVISION HISTORY
Andrea
1 Prima edizione 18 Marzo 2010
Invernizzi
Pag. 2/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Pag. 3/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Pag. 4/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
INDICE
1 INTRODUZIONE ........................................................................................................................ 7
2 SIGLE, ABBREVIAZIONI ED ACRONIMI .............................................................................. 8
3 STRUTTURA DATI .................................................................................................................... 9
3.1 Comandi ................................................................................................................................ 9
3.2 Separatori di Campo ............................................................................................................ 10
3.3 Terminatori di Campo ......................................................................................................... 11
3.4 Note sui campi “DESCRIZIONE” ...................................................................................... 16
3.5 Note sui Terminatori del Barcode ....................................................................................... 18
3.6 Opzione Footer .................................................................................................................... 19
3.7 Pagamento Light.................................................................................................................. 20
3.8 Documento di Reso – 104M ................................................................................................ 21
3.9 Documento di Annullo – 105M........................................................................................... 21
4 HANDSHAKING / FLOW CONTROL .................................................................................... 22
5 FINE CARTA ............................................................................................................................. 23
6 DESCRIZIONI DI DEFAULT ................................................................................................... 24
7 ESEMPI ...................................................................................................................................... 25
7.1 Scontrini Fiscali / Documenti Commerciali ........................................................................ 25
7.2 Scontrino Non-Fiscale / Documento Gestionale ................................................................. 29
7.3 Documento di Reso ............................................................................................................. 30
7.4 Documento di Annullo ........................................................................................................ 31
7.5 Fattura Diretta...................................................................................................................... 31
7.6 Fattura a Seguito Scontrino Fiscale / Documento Commerciale (solo dalle versioni del
firmware sopra indicate) ................................................................................................................ 32
7.7 Uscite Contante ................................................................................................................... 32
7.8 Recupero Credito Contante ................................................................................................. 32
7.9 Visualizzazione Messaggio a Display ................................................................................. 32
7.10 Rapporti X ....................................................................................................................... 33
7.11 Rapporti Z ........................................................................................................................ 33
7.12 Stampa MF / MPR ........................................................................................................... 34
7.13 Stampa DGFE / MPD ...................................................................................................... 34
7.14 Programmazioni ............................................................................................................... 35
Pag. 5/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Copyright
Pag. 6/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
1 INTRODUZIONE
Il protocollo XON-XOFF è stato concepito per uno scambio dati semplice tra un dispositivo
trasmettitore (MASTER, es. P.C.) ed un dispositivo ricevente (SLAVE, es. ECR).
L’handshaking è gestito sia a livello software tramite i caratteri XON (0x11) ed XOFF (0x13) che a
livello hardware con RTS/CTS.
Il protocollo prevede la trasmissione di pacchetti dati congruenti con quanto indicato nel presente
manuale sia da un punto di vista logico che sintattico.
Pag. 7/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
MF Memoria Fiscale
(due interpretazioni) Sui modelli “RT” è indicato come MPR
“Memoria permanente di riepilogo”
MF Misuratore Fiscale
RT Registratore Telematico
Pag. 8/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
3 STRUTTURA DATI
3.1 Comandi
dove
Tutti i caratteri del comando appartengono al set ASCII standard (20h - 7Fh). Le descrizioni
possono contenere i caratteri estesi fino a 9Fh. La stampante ignora eventuali CR/LF (Carriage
Return e Line Feed).
Pag. 9/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Nella seguente tabella sono elencati tutti i caratteri separatori per la costruzione dei comandi nel
protocollo XON-XOFF. La virgola non viene gestita. Non si mette un separatore con i prezzi unitari
e gli importi di pagamento. Il separatore "." viene utilizzato solo in caso delle quantità, gli sconti
percentuali e le maggiorazioni percentuali. Con tutti gli altri valori si devono sempre aggiungere
due decimali. Per esempio la stringa per rappresentare un Euro (€1,00) è 100.
Separatore Funzione
PREZZO / VALORE
H le cifre che lo precedono rappresentano un prezzo / valore (default 2 decimali).
Il prezzo unitario non può essere zero *
PUNTO DECIMALE
.
simbolo per identificare valori con decimali (Q.tà, Sconti…)
MOLTIPLICATORE
* le cifre che lo precedono rappresentano un valore moltiplicativo. Il valore zero
a sinistra viene interpretato come 1.
DESCRIZIONE
"…"
il testo interno ai separatori rappresenta una descrizione
* Per effettuare una vendita a zero, programmare un PLU interno con prezzo unitario a zero.
Esempi:
0* Moltiplicatore = 1
5* Moltiplicatore = 5
10* Moltiplicatore = 10
1.234* Moltiplicatore = 1,234
12.34* Moltiplicatore = 12,34
"ABCDFEGHIJKLMNOP" Descrizione
"Articolo 111" Descrizione
"~ABCDFEGHIJKLMNOP.. " Descrizione (in Doppia Altezza)
"~Arrivederci e .. " Descrizione (in Doppia Altezza)
Pag. 10/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Nella seguente tabella sono elencati tutti i caratteri terminatori per la costruzione dei comandi nel
protocollo XON-XOFF.
0M Storno
Non può essere la prima transazione.
1M Sconto % su transazione
I due decimali con separatore . (punto)
2M Sconto % su subtotale devono essere sempre presenti anche
se il percentuale è un numero intero.
3M Sconto a valore su transazione Non può essere la prima transazione.
4M Sconto a valore su subtotale Non può essere la prima transazione.
Non può essere la prima transazione.
5M Maggiorazione % su transazione
I due decimali con separatore . (punto)
devono essere sempre presenti anche
6M Maggiorazione % su subtotale
se il percentuale è un numero intero.
7M Maggiorazione a valore su transazione Non può essere la prima transazione.
8M Maggiorazione a valore su subtotale Non può essere la prima transazione.
Con gli RT in modalità RT, la
9M Reso transazione viene convertita
automaticamente in uno storno.
10M Entrate Contante
11M Uscite Contante
12M Pagamento con Credito Uguale a 4T
13M Recupero Credito Contante
Pag. 11/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Pag. 12/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Pag. 13/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Pag. 14/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Pag. 15/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
a) "abc.. "
DESCRIZIONE
Vendite resi storni ecc. e pagamenti (max. 38 caratteri)
b) "abc.."@
b1) DESCRIZIONE AGGIUNTIVA
Nel corpo dello scontrino fiscale / documento commerciale.
Deve essere <= 38 caratteri evitando le lunghezze 5, 8 , 11 e 16.
La nuova lunghezza di 8 da evitare è dovuta alla gestione del codice lotteria @39F.
b2) TEST
Nel corpo dello scontrino non-fiscale / documento gestionale. Max. 46 caratteri).
c) "Cliente …"@38F
Intestazione cliente per le fatture dirette e fatture a seguito scontrino. Max cinque righe.
La lunghezza deve essere fra 40 e 46 caratteri.
Altre lunghezze possono essere interpretate male.
Pag. 16/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
e) "abc.."@40F
RIGA PROMOZIONALE (Additional trailer)
Stampa dopo logotipo.
La lunghezza deve essere fra 39 e 46 caratteri. Altre lunghezze possono essere interpretate
male.
È possibile ripetere il comando per stampare più righe.
Il parametro “RESET RIGHE PROMO” (SET 14-38) cambia il comportamento come segue:
• Valore “SI” – Il comando viene trasmesso solo dopo l’apertura di uno scontrino fiscale /
documento commerciale altrimenti viene ignorato. Le righe non sono memorizzate e
vengono stampate solo sulla stampa in corso.
f) "abc.."@41F
RIGA AGGIUNTIVA (Trailer)
Stampa tra pagamenti e chiusura scontrino (MF) o dopo logotipo (RT).
La lunghezza deve essere fra 39 e 46 caratteri.
Altre lunghezze possono essere interpretate male.
È possibile ripetere il comando per stampare più righe.
Il comando viene trasmesso soltanto dopo l’apertura dello scontrino / documento.
È valido solo per gli scontrini fiscali / documenti commerciali.
Le righe sono memorizzate una volta sola per la stampa in corso.
g) Font
Il carattere / prefisso ‘~’, in prima posizione, per le tre DESCRIZIONI b2), e) e f) attiva
l’opzione DOPPIA ALTEZZA. Per esempio:
"~1234567890123456789012345678901234567890"@40F
Pag. 17/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Per quanto riguarda il tipo CODE39, il massimo numero di caratteri stampabili cambia a seconda
della larghezza della carta:
Carta 57/58 80
Caratteri 7 10
È stato aggiunto l’adeguamento automatico della larghezza del barcode del tipo CODE39 in
funzione del numero dei caratteri nel codice e la larghezza della carta. Iniziando da 3, la larghezza
di ogni barra riduce automaticamente al valore 2 e poi ad 1. Per cui, il massimo numero di caratteri
stampabili incrementa:
Carta 57/58 80
Caratteri 24 34
• FP-81 II, FP-81 II S, FP-81 II T ed FP-90 III – Con firmware versione >= 4.001.
• Modelli “RT” – Tutte le versioni del firmware.
Pag. 18/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Dove:
Solo in caso della gestione RTS/CTS abilitata, il PC deve alzare il segnale RTS (CTS in entrata)
altrimenti la stampante non risponde.
Pag. 19/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
A partire dalla versione 4.016 del firmware è stata aggiunta una nuova gestione dei pagamenti.
Segue le stesse regole dei pagamenti “light” del comando 1-084 del protocollo fiscale nativo Epson.
Con un prefisso di tre digit è possibile indicare il tipo (1 digit) e l’indice (2 digit). Per cui, è
possibile usufruire di tutti i metodi di pagamento e di avere un rapporto finanziario X-01 più
dettagliato. La gestione non deve essere attivata in quanto la stampante analizza automaticamente il
numero di digit prima della “T”. Gli altri comandi 1T, 2T ecc. ancora funzionano. Le nostre
stampanti fiscali supportano quattro tipi di pagamento:
• 0 = Contante
• 1 = Assegno
• 2 = Credito / Carta di credito / Bancomat
• 3 = Ticket / Corrispettivo non riscosso
La descrizione deve essere specificata altrimenti viene stampato soltanto l’importo. Per esempio:
• "BANCOMAT"1000H201T
• "BUONO PASTO"750H302T
Pag. 20/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
Ci sono due varianti – una senza matricola fiscale ed una con la matricola di un altro RT. Nel primo
caso la matricola desunta è quella della macchina stessa. I due formati sono come quelli indicati qui
sotto:
• "zzzz-nnnn-GG-MM-AA"104M
• "zzzz-nnnn-GG-MM-AA-MATRICOLA"104M
Dove:
• zzzz = Numero chiusura giornaliera (sempre quattro cifre con gli eventuali zeri)
• nnnn = Numero documento (sempre quattro cifre con gli eventuali zeri)
• GG-MM-AA = La data in cui è stato emesso il documento di riferimento. L’anno è due
digit.
• MATRICOLA = Stringa opzionale nel formato 99MEY123456
Il paio zzzz e nnnn corrisponde alla voce DOCUMENTO N. nel documento di riferimento.
Dopo aver aperto il documento di reso, bisogna inviare i comandi di vendite, gli eventuali
sconti/maggiorazioni ecc. ed un pagamento. Non è necessario indicare l’importo del pagamento ma
se viene specificato, deve essere sufficiente. Il comando di reso 9M non viene utilizzato a
prescindere dal settaggio del flag SET 14/58 RT RESO MERCE=NdC.
Ci sono due varianti – una senza matricola fiscale ed una con la matricola di un altro RT. Nel primo
caso la matricola desunta è quella della macchina stessa. I due formati sono come quelli indicati qui
sotto:
• "zzzz-nnnn-GG-MM-AA"105M
• "zzzz-nnnn-GG-MM-AA-MATRICOLA"105M
Nel caso in cui il documento di riferimento non venga trovato (altra macchina o emissione prima di
essere RT), bisogna inviare i comandi di vendite, gli eventuali sconti/maggiorazioni ecc. ed un
pagamento. Non è necessario indicare l’importo del pagamento ma se viene specificato, deve essere
sufficiente. Il comando di reso 9M non viene utilizzato a prescindere dal settaggio del flag SET
14/59 RT ANNULLAM.= NdC.
Pag. 21/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
La stampante fiscale ha due buffer. I dati arrivano innanzitutto al buffer seriale e poi al buffer
fiscale. Il buffer seriale utilizza i segnali RTS/CTS ed il buffer fiscale utilizza i caratteri XON
(DC3) ed XOFF (DC1). La stampante fiscale (dispositivo ricevente) abbassa il segnale RTS al
dispositivo trasmettitore al momento in cui il buffer seriale eccede la sua soglia di sicurezza. In
parallelo, la stampante fiscale trasmette XOFF (DC3 / 0x13h) al dispositivo trasmettitore al
momento in cui il buffer fiscale eccede la sua soglia di sicurezza passando il limite di 384 byte. La
lunghezza del buffer fiscale è 512 byte per cui la soglia viene raggiunta nel momento in cui il buffer
fiscale è pieno per tre quarti. Il PC dovrebbe terminare in tutti i due casi la trasmissione in corso.
Appena il buffer seriale torna sotto la sua soglia, alza il segnale RTS. In parallelo, appena il buffer
fiscale torna sotto la soglia di 384 byte, trasmette XON (DC1 / 0x11h) al dispositivo trasmettitore.
Solo se entrambi i buffer sono sotto le soglie può riavviare la trasmissione il dispositivo
trasmettitore.
FP-81 II, FP-81 II S, FP-81 II T ed FP-90 III con firmware >= 3.00D e tutti I modelli
successivi
La stampante ha due buffer. I dati arrivano innanzitutto al buffer seriale e poi al buffer fiscale. Il
comportamento del buffer seriale dipende dall’opzione CONTROLLO RTS/CTS nella
programmazione SET 17. Se viene impostata con il valore 1, comporta nello stesso modo del
firmware < 3.00D descritto di sopra. Se viene disattivata tramite il valore 0, il segnale è sempre
alzato. Il buffer fiscale però sempre utilizza i caratteri XON (DC3) ed XOFF (DC1). La stampante
fiscale trasmette XOFF (DC3 / 0x13h) al dispositivo trasmettitore al momento in cui il buffer
fiscale eccede la sua soglia di sicurezza passando il limite di 384 byte. La lunghezza del buffer
fiscale è 512 byte per cui la soglia viene raggiunta nel momento in cui il buffer fiscale è pieno per
tre quarti. Il PC conseguentemente dovrebbe terminare la trasmissione in corso. Appena il buffer
fiscale torna sotto la soglia di 384 byte, trasmette XON (DC1 / 0x11h) al dispositivo trasmettitore il
quale a questo punto può riavviare la trasmissione.
Comportamento Comune
Se la stampante va OFFLINE, trasmette XOFF però RTS rimane alzato. Nel momento in cui torna
ONLINE, trasmette XON. Gli eventuali dati ricevuti mentre la stampante è OFFLINE vengono
scartati.
Se la stampante fiscale riceve un “E” ed i buffer sono pieni, potrebbe inaspettatamente uscire dal
protocollo (a meno che è stato attivato il codice di sincronismo).
Pag. 22/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
5 FINE CARTA
Se finisce la carta ed il PC continua a trasmettere, lo scontrino / documento sarà incompleto in
quanto gli eventuali dati ricevuti mentre la stampante è OFFLINE vengono scartati. Inoltre, se la
stampante fiscale riceve il carattere “E” ed i buffer sono pieni, potrebbe inaspettatamente uscire dal
protocollo (a meno che è stato attivato il codice di sincronismo). Se finisce la carta, consigliamo
l’annullamento dello scontrino fiscale / documento commerciale o fattura diretta tramite il comando
“k”. L’annullamento in caso di fine carta è sempre automatico con i seguenti firmware:
• FP-81 II, FP-81 II S, FP-81 II T ed FP-90 III – Firmware versione >= 3.00A.
• Modelli “RT” – Tutte le versioni del firmware
.
Se finisce la carta con scontrino non-fiscale / documento gestionale aperto, non ristampa e rimane
aperto.
Pag. 23/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
6 DESCRIZIONI DI DEFAULT
Se non viene specificata una descrizione, il misuratore stampa una descrizione di default.
SCONTO PERCENTUALE.
1M
Un’eventuale descrizione trasmessa appena prima del comando 1M o 2M viene
2M
ignorata.
3M
SCONTO
4M
MAGGIORAZ. PERCENT.
5M
Un’eventuale descrizione trasmessa appena prima del comando 1M o 2M viene
6M
ignorata.
7M
MAGGIORAZIONE
8M
ENTRATE
10M Un’eventuale descrizione trasmessa appena prima del comando 10M viene
ignorata.
USCITE
11M Un’eventuale descrizione trasmessa appena prima del comando 11M viene
ignorata.
REC.CRED.CONTANTE
13M Un’eventuale descrizione trasmessa appena prima del comando 13M viene
ignorata.
CONTANTE.
1T In modalità MF, nel caso in cui l’importo non venga specificato oppure sia pari a
6T zero e solo se questo pagamento è l’unico sullo scontrino fiscale, il misuratore non
7T stampa né la riga con la descrizione né la riga del resto. Stampa soltanto TOTALE
EURO.
2T ASSEGNI
Il nome della carta di credito 1.
3T Per default la stampante utilizza la dicitura CARTA di CREDITO 1. Il nome è
programmabile tramite SET 07.
4T
CREDITO
12M
5T
Il nome del ticket 1.
20T
Per default la stampante utilizza la dicitura “TICKET 1”. Il nome è
21T
programmabile tramite SET 10.
22T
Siccome il tipo e l’indice vengono specificati, non esiste una descrizione di
<XYY>T
default. Se la descrizione non viene specificata, viene stampato soltanto l’importo.
Pag. 24/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
7 ESEMPI
250H1R
1T
3*250H1R
1T
5.125*250H1R
1T
"BISCOTTI SECCHI"500H2R
1000H"CHEQUE"2T
"GRISSINI"750H3R
"PRODOTTO CONFEZIONATO FRESCO"@
"CDCMAX"3T
1000H4R
"ABCXYZ01A02B123C"@39F
1T
Pag. 25/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
1000H4R
"12345678903"@39F
1T
1250H5R
"* * * * ARRIVEDERCI E GRAZIE * * * *"@40F
2T
1500H6R
"LA SUA CARTA FIDELITY HA RAGGIUNTO 50 PT"@41F
"CDCMAX"3T
123P
"1234567890123"1Z
5T
Pag. 26/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
250H1R
500H2R
0M500H2R
1T
Oppure
250H1R
500H2R
500H0M2R
1T
500H1R
10.001M
1T
1000H1R
2000H2R
20.002M
1T
500H1R
250H3M
1T
Pag. 27/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
1000H1R
2000H2R
1500H4M
1T
250H1R
500H2R
9M500H2R
1T
Oppure
250H1R
500H2R
500H9M2R
1T
250H1R
500H2R
k
250H1R
1234567890#
1T
Pag. 28/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
1000H1R
1000H2R
500H1r3M
1T
1000H1R
1000H2R
"Descrizione Aggiuntiva"@
500H1r3M
"ABCDEFGH"@39F
"Riga aggiuntiva "@41F
"Grazie e Arrivederci "@40F
1T
j
"RIGA 1 TEST STAMPA -- RIGA 1 TEST STAMPA"@
"RIGA 2 TEST STAMPA -- RIGA 2 TEST STAMPA"@
" . . . . . . . . . . . . . . . . . . . "@
"RIGA n TEST STAMPA -- RIGA n TEST STAMPA"@
J
Pag. 29/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
.
- Apertura documento di reso in cui il documento di riferimento è
stato emesso sulla macchina stessa. Z=23, Doc=3 e data=01/10/2019
"0023-0003-01-10-19"104M
"0043-0066-02-10-19-99MEY123456"104M
"0001-0017-04-10-19"104M
"RESO VENDITA"500H1R
1T
"0001-0003-04-10-19-99MEY123456"104M
"RESO VENDITA"500H2R
1T
Pag. 30/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
"0023-0003-01-10-19"105M
"0043-0066-02-10-19-99MEY123456"105M
"0001-0003-04-10-19-99MEY123456"105M"ANNULLO VENDITA"500H2R1T
9F
"EPSON "@38F
"Via Vizzi "@38F
"Milano "@38F
"00001"101M
250H1R
1T
Pag. 31/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
9F
"EPSON "@38F
"Via Vizzi "@38F
"Milano "@38F
"00001"111M
333H11M
1050H13M
Pag. 32/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
7.10 Rapporti X
1f
2f
3f
4f
7.11 Rapporti Z
1F
2F
3F
4F
Pag. 33/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
1w
"010120240220"2w
"00010099"3w
4w
"010120240120"5w
"00010099"6w
"99999999"6w
Pag. 34/35
Epson Italia S.p.A. Protocollo XON-XOFF Rev. 5.1
7.14 Programmazioni
"1304201230"D
Pag. 35/35