Sei sulla pagina 1di 36

Guida pratica RT XML7&Lotteria

Registratore telematico
EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Notes
(1) All rights reserved.
(2) Reproduction of any part of this documentation by any means is prohibited, in
whatever form, without explicit written permission from Epson.
(3) The contents of this documentation are subject to change without notice.
(4) Comments and notification of any mistakes in this documentation are gratefully
accepted.
(5) This software cannot be used with other equipment that the specified.
(6) EPSON will not be responsible for any consequences resulting from the use of any
information in this documentation.

Trademarks

(1) EPSON® and ESC/POS® are registered trademarks of SEIKO EPSON


CORPORATION.
(2) Other product and company names used herein are for identification purposes
only and may be trademarks or registered trademarks of their respective
companies.
(3) Other trademarks and trade names are those of their respective owners.

Copyright © 2021 SEIKO EPSON CORPORATION


Copyright © 2021 Epson Italia S.p.A.

Epson Italia S.p.A.


Via Margherita Viganò De Vizzi, n. 93/95
20092 Cinisello Balsamo (MI)
Italy

Guida pratica XML7 & Lotteria Page 2 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

REVISION HISTORY
Rev Sheet Comment Date Author
31 dicembre
1 All First release CR
2020
2 All Aggiunto dettagli programmazione Scanner Lotteria 4 gennaio 2021 CR
Aggiunto check list utente finale e funzioni lotteria e
3 All 7 gennaio 2021 CR
scanner
4 All Aggiunto tabella Errori DW 2 febbraio 2021 CR
5 All Aggiunto tabella pagamenti 21 febbraio 2021 CR
Capitolo Orologio, visualizzazione gg/mm/aaaa in caso
6 All 12 aprile 2021 CR
di NTP attivo

Guida pratica XML7 & Lotteria Page 3 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Index

1. INTRODUZIONE ................................................................................................................................................... 5

2. PRE REQUISITI E CHECK LIST ESERCENTE .............................................................................................. 6

3. MODELLI E FIRMWARE RT ........................................................................................................................... 12

4. AGGIORNAMENTO FIRMWARE ................................................................................................................... 13

5. REGISTRAZIONE FIRMWARE ....................................................................................................................... 14

6. NUOVE FUNZIONI E CODICI TASTIERA .................................................................................................... 15

7. TABELLA IVA E VENTILAZIONI ................................................................................................................... 16

8. PROGRAMMAZIONE TABELLA ATECO ..................................................................................................... 17

9. PROGRAMMAZIONE REPARTI ..................................................................................................................... 17

10. PAGAMENTI ........................................................................................................................................................ 18

11. OROLOGIO .......................................................................................................................................................... 19

12. ACCESSO MEMORIE FISCALI ....................................................................................................................... 20

13. TIPS & TRICK ..................................................................................................................................................... 21

14. FAQ ........................................................................................................................................................................ 21

15. LOG COMUNICAZIONE ADE .......................................................................................................................... 22

16. SIGNIFICATO ERRORI DW ............................................................................................................................. 23

17. LOTTERIA............................................................................................................................................................ 25

17.1. GESTIONE LOTTERIA DA TASTIERA FISICA E SCANNER ............................................................... 25

17.2. GESTIONE LOTTERIA DA TASTIERA VIRTUALE MPOS E SCANNER ........................................... 28

17.3. GESTIONE LOTTERIA DA SW APPLICATIVO ...................................................................................... 30

17.4. TEST E VERIFICA FUNZIONAMENTO CODICE LOTTERIA ............................................................. 32

Guida pratica XML7 & Lotteria Page 4 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

1. INTRODUZIONE

Con l’introduzione del firmware che supporta il tracciato XML7 si introducono nuove funzionalità
di seguito elencate

N Funzionalità
1 Lotteria
2 Gestione Login per accesso memorie fiscali
3 Nuovi modificatori (acconto/buono monouso/Omaggio
4 Nuovi pagamenti Non riscossi
5 Gestione Beni e servizi
6 Gestione Codici ATECO
7 Arrotondamenti

Guida pratica XML7 & Lotteria Page 5 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

2. PRE REQUISITI E CHECK LIST ESERCENTE

Prima di installare RT Epson con FW XML7 verificare le seguenti condizioni:

CONFIGURAZIONE FIREWALL

URL IP PORTA Certificato Scopo


SSL
https://private.tooshi.sumorize.com 188.166.40.155 443 Non Registrazione FW - verifica
verificato nuovo FW e recupero password
accesso memorie fiscali
http://0.it.pool.ntp.org Non prevedibile NTP Gestione Network Time Protocol
(se abilitato)
https://apid- 443 Non Trasmissione corrispettivi
ivaservizi.agenziaentrate.gov.it/v1/ verificato (in alternativa a STS quando
dispositivi/ abilitato)
https://apid.sanita.finanze.it/v1/disp 443 Non Trasmissione corrispettivi STS
ositivi/evento/ verificato (se abilitato con flag s14)

Guida pratica XML7 & Lotteria Page 6 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

ASPETTI FISCALI

TIPO COSA CHIEDERE COSA FARE NOTE DEFAULT


ALL’ESERCENTE
CODICI ATECO Il pagamento IVA è effettuato Se risposta Se il cliente non Codici Ateco
per codice ATECO? affermativa, ottenere gestisce il disattivi
la lista dei codici pagamento IVA
ATECO e per codice
programmare la ATECO non
tabella ATECO serve
nell’RT programmare la
tabella dei
codici ATECO.
VENTILAZIONE IVA Se l’esercente gestisce l’IVA Impostare la La Ventilazione
in ventilazione ventilazione nell’RT programmazione disattivata
globalmente o se è possibile dopo
presenti i codici una chiusura
ATECO per singolo fiscale
codice
ALIQUOTE IVA Ottenere la lista delle aliquote Programmare la Con 4, 5,10 e 22
IVA divise per BENI e tabella IVA con tutte Ventilazione
SERVIZI e successivamente le aliquote, IVA i servizi
per codice Ateco sono venduti
sempre con
aliquota
puntuale. La
programmazione
è possibile dopo
una chiusura
REPARTI Se la printer è collegata ad un Assegnare ad ogni La Solo BENI,
SW, verificare l’assegnazione reparto il codice programmazione codici Ateco
Reparto/aliquotaIVA/Beni e Ateco e è possibile dopo disattivi
Servizi l’informazione se si una chiusura
tratta di BENE o
SERVIZIO
PAGAMENTI Richiedere la lista dei tipi di Assegnare ai tasti i Non riscosso
pagamento utilizzati tipi di pagamento: automatico
Non Riscosso suddivide
Non Riscosso Beni l’importo tra
Non Riscosso Servizi BENI e
Non Riscosso SSN SERVIZI con
Non Riscosso Fattura priorità ai BENI
Sconto a Pagare
Buoni Multiuso
Ticket

MODIFICATORI Chiedere se sono utilizzati: Assegnare ai tasti le Gli ACCONTI


ACCONTI/OMAGGI e nuove funzioni si applicano solo
BUONO MONOUSO ai BENI
ARROTONDAMENTI Chiedere se abilitare Abilitare con S15/27 Disattivo
l’arrotondamento automatico
PASSWORD MEM Informare il cliente di come Funzione S39 Tempo 12345
FISCALI cambiare la password e autologout = 30 (17-18-19-20-
inserire tramite Wizard la min 21)
email di recupero password

Guida pratica XML7 & Lotteria Page 7 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

TABELLE DA FAR COMPILARE AL CLIENTE


Aliquota IVA Nessun Codice Codice Codice istruzioni
utilizzata codice Ateco 1 Ateco 2 Ateco 3
Ateco
Inserire il codice Ateco e
utilizzato
(6 numeri)
VENTILAZIONE Inserire SI/NO
(solo per Beni)
4% Specificare se Beni e/o servizi
5% Specificare se Beni e/o servizi
10% Specificare se Beni e/o servizi
22% Specificare se Beni e/o servizi
N1 Specificare se Beni e/o servizi
N2 Specificare se Beni e/o servizi
N3 Specificare se Beni e/o servizi
N4 Specificare se Beni e/o servizi
N5 Specificare se Beni e/o servizi
N6 Specificare se Beni e/o servizi

TABELLA DA COMPILARE SOLO SE il SW GESTIONALE NON PROGRAMMA I


REPARTI IN AUTONOMIA
Indice Aliquota IVA Codice Ateco Beni/Servizi
reparto
Specificare se Inserire il codice Specificare se
VENTLAZIONE o ATECO assegnato al Beni o Servizi
Aliquota IVA (%) reparto
Riga VENTILAZIONE 11.11.11 BENI
esempio
Riga 22% 11.11.11 SERVIZI
esempio
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Guida pratica XML7 & Lotteria Page 8 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

FUNZIONI PER ASSEGNAZIONE TASTI (o da abilitare come arrotondamento)

TIPO TASTO SI/NO Descrizione


ACCONTO
OMAGGIO
BUONO MONOUSO Buoni di acquisto di cui si conosce l’IVA
applicata
BUONO MULTIUSO Buoni di acquisto di cui NON si conosce
l’IVA applicabile in fase di utilizzo
SCONTO A PAGARE Utilizzato per sconti in fase di pagamento
NON RISCOSSO AUTOMATICO Suddivide l’importo non riscosso tra BENI
e SERVIZI scalando l’importo partendo
dai BENI
NON RISCOSSO BENI Importo da assegnare ai solo BENI
NON RISCOSSO SERVIZI Importo da assegnare ai solo SERVIZI
NON RISCOSSO SSN Utilizzato per richiedere rimborso al
servizio SSN
NON RISCOSSO FATTURA Utilizzato quando si rilascia fattura senza
pagamento
TICKET Utilizzato per qualsiasi ticket e buono
emesso da società terze
LOTTERIA
PAGAMENTO ELETTRONICO
CONTANTI
ASSEGNI
ARROTONDAMENTI AUTOMATICI Specificare se si vuole abilitare
l’arrotondamento ai centesimi di legge
(applicato si soli pagamenti integrali in
contanti)

PASSWORD ACCESSO MEMORIE FISCALI


FUNZIONE VALORE
Password (alfanumerica)

Email per recupero eventuale


smarrimento password

Tempo auto logout (In minuti)

Guida pratica XML7 & Lotteria Page 9 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

ESEMPIO 1 TABELLA ATECO/IVA/BENI-SERVIZI


Aliquota IVA Nessun Codice Codice Codice
codice Ateco 1 Ateco 2 Ateco 3
Ateco
47.11.10 55.10.00 Non usato
VENTILAZIONE SI NO
4%
5%
10% Servizi Servizi
22% Beni
N1
N2
N3
N4
N5
N6

Tabella Ateco
Indice Codice Ateco Ventilazione
1 47.11.10 SI
2 55.10.00 NO

Tabella IVA
Indice aliquota
1 10%
2 22%

Tabella Reparti
Indice Indice IVA Indice Ateco Beni/Servizi
reparto
1 Ventilazione 1 B
2 1 1 S
3 1 2 S
4 2 2 B

Guida pratica XML7 & Lotteria Page 10 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

ESEMPIO 2 TABELLA ATECO/IVA/BENI-SERVIZI

Aliquota IVA Nessun Codice Codice Codice note


codice Ateco 1 Ateco 2 Ateco 3
Ateco
utilizzato Non usato Non usato Non usato
VENTILAZIONE SI
4%
5%
10% Servizi
22%
N1
N2
N3
N4
N5
N6

Tabella Ateco (non utilizzata)

Tabella IVA (con flag ventilazione attiva)


Indice aliquota
1 10%

Tabella Reparti
Indice Indice IVA Indice Ateco Beni/Servizi
reparto
1 Ventilazione 0 B
2 1 0 S

Guida pratica XML7 & Lotteria Page 11 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

3. MODELLI E FIRMWARE RT

Come leggere la versione del Firmware

1 – durante la fase di accensione sul display si può leggere la versione del firmware alla voce REL

2 – a partire dal FW che supporta la lotteria digitare sulla tastiera 2222 + chiave + G

3 – Tramite interfaccia WEB della printer, selezionare la pagina web


www/printer_status/get_status.html

FP81 II FP90 III FP81-RT FP90 RT RT 90 Server


Campo matricolare 99MEX 99MEY 99IEB 99IEC 99SEA
Sigillo Piombo Piombo Etichetta Etichetta Etichetta
FW minimo lotteria 10.01 10.01 6.01 6.01 03.01
FW minimo XML7 11.00 11.00 07.00 07.00 04.00
FW minimo agg.remoto 07.00 07.00 06.00 06.00 02.00

Guida pratica XML7 & Lotteria Page 12 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

4. AGGIORNAMENTO FIRMWARE

Verificare se il vostro RT supporta l’aggiornamento del Firmware da remoto come da tabella al


paragrafo MODELLI E FIRMWARE RT.
La printer supporta le seguenti modalità di aggiornamento del FW

MODALITÀ TOOL NOTE


Rimozione Sigillo FP Flash writer Switch 2 ON – solo seriale 115kbps
Rimozione Sigillo FP Flash writer Switch 3 ON Seriale o USB
Rimozione Sigillo USB PEN DRIVER Switch 3 ON
No rimozione sigillo FPWIZARD e USB PEN DRIVER Verificare FW minimo
No rimozione sigillo FPWIZARD e URL Remoto HTTPS supportato dalla versione FW
Lotteria in poi

ATTENZIONE:
1 - nel passaggio dal FW 5.x alla versione 7.0 per gli RT modificati solo FP FLASH WRITER con
rimozione sigillo

2 –Utilizzare il corretto FW in base al campo matricolare

3 – Il FW XML7 richiede la registrazione tramite l’acquisto del codice FW per evitare la stampa
dello scontrino di FIRMWARE NON REGISTRATO e l’utilizzo dei loghi grafici

4 – i parametri salvati durante l’aggiornamento del FW senza rimozione sigillo fino al FW XML7
sono:
• intestazione scontrini
• parametri porte comunicazione
• tabella IVA (no flag ventilazione)
• tabella reparti
• S14 (flag)
• S15 (setting)
• S34 (intelligent)

5 – i parametri salvati dal FW XML7 oltre a quelli precedenti (per aggiornamenti futuri)
• Flag ventilazione
• Tabella Ateco
• Biglietteria Spettacolo
• S29 (tastiera)
• Data scadenza VP
• S30 (EFT POS)
• Configurazione Password MF/DGFE
• Tabella URLs

Guida pratica XML7 & Lotteria Page 13 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

5. REGISTRAZIONE FIRMWARE

Dopo l’acquisto del codice di registrazione vi sono due modalità per la registrazione del FW. In
entrambi i casi la stampante NON deve essere nella modalità DEMO

Dedicato al tecnico di manutenzione:


tramite browser accedere alla pagina WEB della printer:
http://xxx.xxx.xxx.xxx/www/librettoElettronico/
selezionare il pulsante FUNZIONI SPECIALI
inserire il codice di sicurezza: 1973
selezionare il pulsante REGISTRA FIRMWARE
inserire il codice e premere il pulsante REGISTRAZIONE
In caso di errori verificare il messaggio sul display

Dedicato all’esercente
Accedere alla pagina WEB https://tooshi.sumorize.com/sites/tooshi/form-registrazione
Inserire matricola della printer, versione del FW nel formato xx.yy e il codice di registrazione e
indirizzo email per ricevere un nuovo codice OTP
Premere il pulsante PROSEGUI
Attendere la ricezione dell’email
Inserire il codice OTP ricevuto (attenzione la vita del codice OTP è di 30 minuti al massimo, se
scade l’operazione è annullata)
Eseguire una chiusura giornaliera sulla printer RT

ATTENZIONE:

Se la printer NON E’ CENSITA e si effettua l’aggiornamento del FW rimuovendo il sigillo non è


necessaria nessuna registrazione del firmware che risulta registrato in autonomia.

Guida pratica XML7 & Lotteria Page 14 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

6. NUOVE FUNZIONI E CODICI TASTIERA

KEY FUNCTION CODE KEY FUNCTION CODE


09 000  009 MxN (1) 116
00 010 MxN (2) 117
000 011 OPERATOR 118
VOID TOTAL /
CL / CLEAR 012 119
CANCEL ALL
X 013 NOT USED 120
CANCEL / VOID 014 PRODUCT CODE 121
, 015 OVERRIDE LIMIT 122
DEP 1  DEP 40 016  055 LAST RECEIPT INVOICE 123
PLU 1  PLU 30 056  085 PERSONAL RECEIPT 124
CASH 1  CASH 5 086  090 VISUALISE PRODUCT 125
CURR 1  CURR 5 091  095 TICKET 1  10 126  135
CURRENCY 096 CLIENT CODE 136
CREDIT / CREDIT CARD 097 LOTTERIA/CODICE FISCALE 137
CHEQUES 098 CHIAVE (KEY) 138
SUBTOTAL /
099 AMOUNT SURCHARGE 139
OPEN DRAWER
CASH / TOTAL 100 CREDIT CARD 1  10 140  149
S 101 PLU 31  PLU 70 150  189
G 102 EMPLOYEE 190
PLU 103 AGREEMENT 191
PLU-ENTRY 104 TICKET SURPLUS 192
REFUND 105 CREDIT NOTE 193
CASH IN 106 RECEIPT + INVOICE 194
CASH OUT 107 DECIMAL QUANTITY 195
% SURCHARGE 108 DIRECT INVOICE 196
% DISCOUNT 109 REQUEST E-MAIL * 197
VERIFY RECEIPT AS IMAGE
AMOUNT DISCOUNT 110 198
NUMBER * **
ACTIVATE RECEIPT AS IMAGE *
DO NOT CALCULATE 111 199
**
STORNO (CORRECTION) 112 ACTIVATE PHP *** 200
TICKET 113 DEP 41  DEP 99 **** 201  259
CHOOSE PLU / DEP PRICE 114 INDIRECT DEP ***** 260
LAST TOTAL 115

ACCONTO 261 NON RISCOSSO 265


OMAGGIO 262 NON RISCOSSO BENI 266
BUONO MONOUSO 263 NON RISCOSSO SERVIZI 267
BUONO MULTIUSO 272 NON RISCOSSO FATTURA 268
SCONTO A PAGARE 271 NON RISCOSSO SSN 270
TICKET con Numero 264
Guida pratica XML7 & Lotteria Page 15 of 36
EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

7. TABELLA IVA E VENTILAZIONI

Gli RT gestiscono una tabella IVA composta da 56 elementi come mostrato in tabella
Le Nature sono cablate agli indici 0 e da 10 a 15
Programmare le aliquote utilizzate tramite gli indici da 1 a 9
Gli indici da 10 1 59 sono riservate per le aliquote “vecchie” e non più utilizzate.

Indici IVA Descrizione


0 N4 ESENTE nature
1-9 Aliquote IVA
10 - 18 Nature
21 - 29
31 - 39 Aliquote IVA
41 - 49 storiche
51 - 59
19 - 20, 30, 40 and
Indici non utilizzati
50

Sui modelli RT, è possibile attivare e disattivare la ventilazione premendo il tasto <G>. In caso di
attivazione, la dicitura "Vent." appare sulla riga superiore:

S 05 Vent.

Se l’esercente utilizza i codici ATECO occorre definire nella tabella ATECO l’utilizzo o meno della
tabella IVA

ATTENZIONE
La ventilazione IVA è applicata solo ai BENI mentre per i SERVIZI occorre impostare la corretta
aliquota IVA, Esempio: i farmaci sono dei Beni mentre la misurazione della pressione è un
Servizio. Quindi i reparti impostati come BENI, nel caso di ventilazione, l’aliquota IVA non è presa
in considerazione.

Guida pratica XML7 & Lotteria Page 16 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

8. PROGRAMMAZIONE TABELLA ATECO

Tramite la funzione S37 si accede alla programmazione (opzionale) dei tre codici Ateco.
I codici Ateco sono composti da 6 numeri e si deve definire se applicare la Ventilazione o meno per
singolo codice Ateco

ATTENZIONE
Non è possibile avere nello stesso Documento Commerciale vendite tra diversi codici Ateco.

9. PROGRAMMAZIONE REPARTI

Tramite la funzione S02 programmare i reparti avendo cura di impostare il tipo (BENE O
SERVIZIO), l’indice della tabella IVA e se utilizzato l’indice della tabella ATECO

ATTENZIONE
La programmazione reparti è possibile solo dopo una chiusura (come tabelle IVA e ATECO)

Nuovi campi XML7:

TIPOLOGIA DI VENDITA => Beni = 0 – Servizi = 1


ATTROIBUTO DI VENDITA => lasciare valore 0
GRUPPO ATECO => riportare l’indice dalla tabella ATECO programmato (0 per codici Ateco non
utilizzati)

Guida pratica XML7 & Lotteria Page 17 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

10. PAGAMENTI

Con l’installazione del FW XML7 vi sono nuovi metodi di pagamento.


Da tenere in considerazione che:

A - Il pagamento NON RISCOSSO SERVIZI è accettato solo se nel Documento Commerciale vi


sono SERVIZI di con importo maggiore/uguale all’importo indicato

B - In caso di Reso/Annullo non automatico i pagamenti dovranno riflettere i pagamenti riportati


nel Documento Commerciale di Vendita

TABELLA PAGAMENTI

Type Index significato


0 0 cash
1 0 assegno
2 1 elettronico
3 1 Ticket
4 Xx (numero) Ticket con Numeri
5 00 Non riscosso generico
5 01 NR BENI
5 02 NR SERVIZI
5 03 NR segue fattura
6 00 Sconto a pagare
6 01 Buono Multiuso

Guida pratica XML7 & Lotteria Page 18 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

11. OROLOGIO

L’orologio della stampante supporta la modalità NTP (Network Time Protocol) e Ora Legale
Per capire se NTP e ORA LEGALE sono stati abilitati e sono attivi controllare il display premendo
il tasto “X” coma da tabella:

FUNZIONE NTP ATTIVO NTP ATTIVO NTP NON NTP NON


LEGALE NON LEGALE IN ATTIVO ATTIVO
IN CORSO CORSO LEGALE NON LEGALE IN
IN CORSO CORSO
FLAG S14/14 -34 S14/14 -34 S14/14 -34 S14/14 -34
Visualizzazione gg-mm-aaaa gg/mm/aaaa gg-mm-aa gg/mm/aa
data
Opzione 1 in NTP – DST0 NTP – DST1 DST0 DST1
alternativa alla
riga sopra

ATTENZIONE:

il servizio NTP è chiamato dalla printer solo dopo una chiusura di cassa , il servizio NTP non
funziona se in modalità DEMO.

Guida pratica XML7 & Lotteria Page 19 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

12. ACCESSO MEMORIE FISCALI

L’accesso alla memoria fiscale e DGFE è possibile tramite la fase di LOGIN


La password di default è = 12345
Per effettuare il login premere:
3333 + CHIAVE + 39
Inserire la password nel formato come da tabella seguente, esempio
12345 => 17 18 19 20 21
Premere il tasto G per effettuare il LOGIN e CHIAVE per uscire

Con il menu S38 è possibile cambiare la password e il tempo di auto logout (default 30 minuti)
Attenzione: l’accesso al menu S38 è possibile solo dopo il LOGIN

Codice Carattere Codice Carattere Codice Carattere Codice Carattere Codice Carattere

00 SPAZIO 19 3 38 F 57 Y 76 l
01 ! 20 4 39 G 58 Z 77 m
02 " 21 5 40 H 59 [ 78 n
03 # 22 6 41 I 60 \ 79 o
04 $ 23 7 42 J 61 ] 80 p
05 % 24 8 43 K 62 ^ 81 q
06 & 25 9 44 L 63 _ 82 r
07 ' 26 : 45 M 64 ` 83 s
08 ( 27 ; 46 N 65 a 84 t
09 ) 28 < 47 O 66 b 85 u
10 * 29 = 48 P 67 c 86 v
11 + 30 > 49 Q 68 d 87 w
12 , 31 ? 50 R 69 e 88 x
13 - 32 @ 51 S 70 f 89 y
14 . 33 A 52 T 71 g 90 z
15 / 34 B 53 U 72 h
16 0 35 C 54 V 73 i
17 1 36 D 55 W 74 j
18 2 37 E 56 X 75 k

Guida pratica XML7 & Lotteria Page 20 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

13. TIPS & TRICK

Gestione eventi ATTIVAZIONE – DISATTIVAZIONE – DISMISSIONE


L’orologio della printer non deve essere maggiore di 10 secondi quello del server ADE, per questo
motivo impostare l’orologio della printer indietro di 1 minuto rispetto alla ora in corso

14. FAQ

N QUESTION ANSWER
1 Non riesco a censire la printer Scaricare una nuova richiesta di certificato tramite la
funzione S36, utilizzare il codice sotto riportato e
rifare il censimento
99MEX => codice 885312
99MEY => codice 894488
99IEB => codice 188210
99IEC => codice 995679

2 Non riesco a disattivare la printer


Impostare l’orologio della printer un minuto indietro
rispetto a quella in corso
3 Non riesco a leggere/stampare dal Eseguire il LOGIN
DGFE o memoria fiscale
4 RT non trasmette i corrispettivi Controllare test s20
Controllare cartella file rifiutati
Controllare i log comunicazione
5 Ripristino certificato Utilizzare questa funzione solo DOPO la medesima
operazione eseguita dall’esercente sul proprio cassetto
fiscale
6 Disattivazione Forzata Utilizzare questa operazione SOLO se l’esercente ha
disattivato l’RT sul proprio cassetto fiscale
7 Ottengo l’errore 500 Controllare il file XML dei corrispettivi o della
lotteria nella cartella FILE DA INVIARE e verificare
se sono state programmate Nature o aliquote IVA
errate.

Guida pratica XML7 & Lotteria Page 21 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

15. LOG COMUNICAZIONE ADE

Guida pratica XML7 & Lotteria Page 22 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

16. SIGNIFICATO ERRORI DW

Gli errori sotto riportati sono mostrati a display quando l’errore non è recuperabile.
Azioni: verificare il componente fisico (MF, DGFEo scheda fiscale) ed eseguire HARD INIT della
printer

DESCRIZIO+B2:D28NE INDICE AZIONI


DW_MF_NOT_FISCAL 1 HARD INIT
DW_MF_NOT_CONNECTED 2 Verificare cavo Memoria fiscale
DW_DGFE_INIT_ON_ERR 3 Vericare DGFE
DW_DGFE_TO_FORM 4 Vericare DGFE
DW_SD_WRITE_ERR 5 Vericare DGFE
DW_SD_CREATE_FILE_ERR 6 Vericare DGFE
DW_SD_CREATE_DIR_ERR 7 Vericare DGFE
DW_FIRMWARE_ERR 8 Errore nel Firmware
DW_PRN_ASB_ERR 9 Errore gruppo di stampa
DW_SRAM_INIT_ERR 10 Errore memoria statica scheda fiscale
DW_NVAM_INIT_ERR 11 Errore memoria flash scheda fiscale
DW_DB_INIT_ERR 12 Errore Data Base
DW_HOST_INIT_ERR 13 Errore Porte comunicazione
DW_CERT_MATR_ERR 14 Errore matricola fiscale
DW_CERT_PPKEY_ERR 15 Errore chiave certificato
DW_CERT_CA_AE_ERR 16 Errore certificato comunicazione ADE
DW_CERT_CA_TLS_ERR 17 Errore certificato comunicazione ADE
DW_CERT_XML_ERR 18 Errore certificato comunicazione ADE
DW_WAIT_POWER_OFF 19 Attesa Spegnimento printer
DW_LOTTERIA_DB_CKS_ERR 20 Errore DataBase Lotteria
DW_LOTTERIA_SD_CKS_ERR 21 Errore DataBase Lotteria
DW_DGFE_DGFE_ERROR 22 Vericare DGFE
DW_MF_READ_MATRICOLA 23 Errore MF lettura matricola
DW_MF_READ_PPK 24 Errore MF lettura certificato
DW_MF_MISSING_NLAST_MESSA_SERVIZIO 25 Errore MF lettura data messa servizio
DW_MF_READ_ATTIVAZIONE 26 Errore MF lettura Attivazione
DW_MF_READ_CERT_DISP 27 Errore MF Certificato dispositivo
DW_MF_READ_DISMISSIONE 28 Errore MF Dismissione
DW_MF_READ_MESSA_SERVIZIO 29 Errore MF Lettura messa servizio
DW_MF_READ_NLAST_MESSA_SERVIZIO 30 Errore MF lettura data Messa Servizio
DW_MF_READ_XML_CERT 31 Errore MF Lettura Certificato
DW_RT_ERROR_STATUS 32 Errore lettura stato non congruente
DW_WRITE_CA_TO_SD 33 Errore salvataggio Certificato CA ADE
Guida pratica XML7 & Lotteria Page 23 of 36
EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

DW_MF_READ_MESSA_SERVIZIO_1 34 Errore MF lettura Messa in Servizio


DW_MF_READ_MESSA_SERVIZIO_2 35 Errore MF lettura Messa in Servizio
DW_RT_LOTTERY_SIGN_ERR 34 Errore firma file Lotteria
DW_RT_LOTTERY_ARRAY_ERR 35 Errore lettura buffer Lotteria
DW_RT_ERROR_XML_CORR 36 Errore Generazione XML Corrispettivi

Guida pratica XML7 & Lotteria Page 24 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

17. LOTTERIA

17.1. GESTIONE LOTTERIA DA


TASTIERA FISICA E SCANNER

Assicurasi che vi sia presente in tastiera il tasto PAGAMENTO ELETTRONICO

Il tasto pagamento elettronico è obbligatorio per la lotteria in quanto solo l’importo riportato alla
voce PAGAMENTO ELETTRONICO sul Documento Commerciale sarà convertito in biglietti
lotteria.
Funzione PAGAMENTO ELEETTRONICO = 140

Configurare tasto LOTTERIA/CODICE FISCALE

3333 + chiave + 29
Selezionare il tasto che si vuole utilizzare
Inserire il codice 137
Premere CONTANTE e CHIAVE
Premendo il tasto LOTTERIA sul display compare la scritta LOTTERIA / C.F.
Inserire il codice lotteria di 8 caratteri utilizzando la tastiera con il metodo SMS
Confermare l’inserimento del codice premendo il tasto Lotteria
Inserire i dati dello scontrino
Verificare che sullo scontrino sia stampato il codice lotteria

N.B. il codice lotteria può essere inserito in qualsiasi fase dello scontrino: come prima funzione fino
alla fase precedente il pagamento.

Guida pratica XML7 & Lotteria Page 25 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Configurare lettore codice barre

Per velocizzare l’inserimento del codice lotteria è possibile utilizzare uno scanner USB
La porta USB della printer RT supporta al massimo 0,5 Ampere, si consiglia l’utilizzo di un HUB
USB alimentato

Configurare lo scanner con Prefisso e Suffisso come segue:

PREFISSO SUFFISSO
Con utilizzo del tasto LOTTERIA su 1B esadecimale (ESC) 1B esadecimale (ESC)
tastiera
Integrare il tasto LOTTERIA nello 62 esadecimale (b) 1B esadecimale (ESC)
scanner 1B esadecimale (ESC)

Attenzione

1 - su scanner Honeywell xenon 1900 utilizzare il codice 0Fhex

2 – la presenza della tastiera 23 tasti o querty e lo scanner funzionano solo se dopo l’accensione si
inserisce in sequenza primo lo scanner e poi la tastiera. Si raccomanda l’utilizzo delle tastiera 32
tasti o 60 tasti per l’utilizzo tastiera con lotteria e XML7.

In alternativa utilizzare la tastiera Virtuale:


https://neon.epson-europe.com/files/repo/2020/RTfiles/custom_keyboard/index.htm

Guida pratica XML7 & Lotteria Page 26 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Verifica corretta configurazione dello scanner

Collegare lo scanner ad un PC, aprire il browser ed aprire il seguente pagina web:


https://w3c.github.io/uievents/tools/key-event-viewer.html

leggere con lo scanner un codice lotteria e verificare che la prima riga e l’ultima riga abbiamo il
codice 27 (ESCAPE) come sotto nel riquadro.

Se avete programmato come PREFISSO il tasto CODICE/LOTTERIA e ESCAPE verificate di


leggere la sequenza “b” ed “ESC”

Guida pratica XML7 & Lotteria Page 27 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

17.2. GESTIONE LOTTERIA DA


TASTIERA VIRTUALE MPOS E SCANNER

Se si utilizza la tastiera WEB mPOSKeyboard disponibile al seguente link:


https://neon.epson-europe.com/files/repo/2020/RTfiles/custom_keyboard/index.htm

Seguire le seguenti configurazioni:

1 - configurare il lettore scanner senza prefissi o suffisso con il solo carattere CR dopo la lettura del
codice
2 - collegare lo scanner alla printer

3 – configurare la tastiera mPOSKeyboard come segue:


A premere il tasto Modalità Funzionamento Tastiera
B selezionare SI al menu WEB SOCKET

Guida pratica XML7 & Lotteria Page 28 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Guida pratica XML7 & Lotteria Page 29 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

17.3. GESTIONE LOTTERIA DA SW


APPLICATIVO

Valido per tutti driver e FW DirectIO command="1135" data="113501ABCDEFGN 0000"


Fpmate.cgi versione XML7 printRecLotteryID code="12345678"
fpserver.cgi printRecLotteryID lotteryID="12345678"
Fpmate.exe (fpsuite 2.01) printRecLotteryID lotteryID ="12345678"
Fpmate.exe (fpsuite 2.01) printRecLotteryCode lotteryCode ="12345678"

ESEMPIO FPMATE.EXE tutte le versioni

directIO|DirectIO|1135<numero operatore due digit><codice lotteria 16 byte con gli eventuali


spazi>0000

Per esempio:
directIO|DirectIO|113501ABCDEFGN 0000
<directIO OcxMethod="DirectIO" Arg0="113501ABCDEFGN 0000" />

ESEMPIO FPMATE.EXE con FPSUITE 2.01

printerFiscalReceipt
Printer|1
printRecLotteryCode|1|12345678
printRecItem|1|VENDITA BENE (Goods Sale) €100|1|100|1|1
printRecItemAdjustment|1|Buono Monouso (Single use Voucher)|12|10|1|1
printRecItemAdjustment|1|Acconto (Deposit)|10|20|1|1
printRecItemAdjustment|1|Omaggio (Free of Charge)|11|30|1|1
printRecSubtotal|1|0
printRecTotal|1|Contante (Cash) €5|5|0|1|1
printRecTotal|1|Ticket (Voucher) €5|5|3|1|1
printRecTotal|1|Non Riscosso (Not Paid) €10|10|5|0|1
printRecTotal|1|Sconto a Pagare (Payment discount) €15|15|6|0|1

Guida pratica XML7 & Lotteria Page 30 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

printRecTotal|1|Buono Multiuso (Multi-use Voucher) €5|5|6|1|1


endFiscalReceipt|1

ESEMPIO FPMATE.CGI con tutti i FW

<Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<printerFiscalReceipt>
<beginFiscalReceipt operator="1"/>
<printRecItem operator="1" Text="BLONDYS 1 `deco`" Qty="1,00" UnitCost="40,00" Dep="1"
Just="1"/>
<directIO command="1135" data="0112345678 0000"/>
<printRecSubtotal operator="1" Type="1"/>
<printRecTotal operator="1" Text="CONTANTI" Amount="40,00" Type="0" Index="0"
Just="1"/>
<endFiscalReceipt operator="1"/>
</printerFiscalReceipt>
</Body>
</Envelope>

Esempio JAVAPOS
int[] icmd = {0};
icmd[0] = 1135;
StringBuffer sbcmd = new StringBuffer("01ABCDEFGH ");
fiscalprinter.directIO(0, icmd, sbcmd);

Esempio epsonFP2.ocx

<directIO OcxMethod=" opCodLotteria" Arg0="01" Arg1="ABCD1234" />

Guida pratica XML7 & Lotteria Page 31 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

17.4. TEST E VERIFICA


FUNZIONAMENTO CODICE LOTTERIA

Per eseguire i test LOTTERIA la printer si deve trovare nella modalità IN SERVIZIO
Potete abilitare la modalità SIMULAZIONE
La modalità DEMO accetta il codice Lotteria solo se attivata quando la printer è in modalità
CENSITA o ATTIVA

La printer trasmette alla ADE i dati lotteria quando una delle seguenti condizioni sono verificate:
1 – Buffer temporaneo interno alla printer raggiunge il numero di 100 scontrini
2 – Dopo una chiusura giornaliera

Verificare i file XML trasmessi nella cartella WEB della printer:


http://xxx.xxx.xxx.xxx/www/dati-rt/lotteria

per avere un report dei file trasmessi e ricevuti dalla printer eseguire da tastiera:

2222 + chiave + 99
Data inizio
Data fine
Premere il tasto LOTTERIA (funzione 137)

La stampante genera un report


TX => S/N RT – XML data – ZrepNum – FirtRec – lastRec – number of Lottery file
RX => S/N RT – XML date – ZrepNum – FirtRec – lastRec – number of Lottery file –
LotteryResult - LotteryID

Esempio
99MEY123456 – 20191113T171233 – Z0091 – I0011 - F0022 – L0007 – LOTTERIA.xml

99MEY123456 – 20191113T171233 – Z0091 – I0011 - F0022 – L0007 – LOTTERIAESITO-


AC-ea7ad092-8483-48ed-94a2-26949551d24b.xml

99MEY123456 Serial number


20191113T171233 Data e ora di quanto l’XML è stato salvato
Z0091 Zreport
I0011 Primo scontrino della lotteria presente nel file
F0022 Ultimo scontrino lotteria presente nel file
L0007 Numero di scontrini lotteria
AC/SE/SC Risposta dalla A.D.E. (AC accettato)

Guida pratica XML7 & Lotteria Page 32 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

DOCUMENTO GESTIONALE
Memoria Permanente di Dettaglio DGFE
14-11-2019 16:27 99MEY123456

Trasmissione Lotteria
Dal 13-11-2019 al 15-11-2019

13-11-2019

99MEY123456 – 20191113T171233 – Z0091 – I0011 - F0022 – L0005 – LOTTERIA.xml


99MEY123456 – 20191113T171233 – Z0091 – I0011 - F0022 – L0005 –LOTTERIAESITO-AC-
ea7ad092-8483-48ed-94a2-26949551d24b.xml

Z0091 documenti ACC:


0011-0012-0015-0021-0022

14-11-2019

99MEY123456 – 20191114T181233 – Z0092 – I0001 - F0044 – L0007 – LOTTERIA.xml


99MEY123456 – 20191114T181233 – Z0092 – I0001 - F0044 – L0007 –LOTTERIAESITO-SE-
esdfw6g-1234-4567-94a2-26949551d24b.xml

Z0092 documenti ACC:


0001-0002-0003-0004-0005

Z0092 Documenti Rifiutati SE:


0006-0009

15-11-2019

99MEY123456 – 20191115T191233 – Z0093 – I0001 - F0005 – L0003 – LOTTERIA.xml


99MEY123456 – 20191115T191233 – Z0093 – I0001 - F0005 – L0003 –LOTTERIAESITO-SC-
ea7ad092-8483-48ed-94a2-26949551d24b.xml

Z0093 documenti SCARTATI SC:


0001-0002-0003

FILE DA INVIARE
Z0094
0001-0004-0005

Guida pratica XML7 & Lotteria Page 33 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Guida pratica XML7 & Lotteria Page 34 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Guida pratica XML7 & Lotteria Page 35 of 36


EPSON Italia S.p.A. - SD Italian Fiscal Printer Rev:5

Example of XML lottery file sent to Tax Authority


<r:DocCommercialiLotteria xmlns:r="http://ivaservizi.agenziaentrate.gov.it/docs/xsd/docco
mmercialilotteria/v1.0" versione="1.0">
<DatiTrasmissione>
<Formato>DCL10</Formato>
<Denominazione> CCCCCCCCCCC </Denominazione> => based on the message 5-015-26
</DatiTrasmissione>
<DocumentoCommerciale>
<IdCliente>AAAAAAAA</IdCliente> => Lottery code sent with message 1.035
<DataOra>2020-03-08T18:32:50</DataOra>
<NumeroProgressivo>0085-0001</NumeroProgressivo>
<Ammontare>1.00</Ammontare>
<Vendita>
<DatiPagamento>
<Tipo>PC</Tipo>
<Importo>1.00</Importo>
</DatiPagamento>
</Vendita>
</DocumentoCommerciale>
<DocumentoCommerciale>
<IdCliente>AAAAAAAA</IdCliente> => Lottery code sent with message 1.035
<DataOra>2020-03-08T18:32:53</DataOra>
<NumeroProgressivo>0085-0002</NumeroProgressivo>
<Ammontare>1.00</Ammontare>
<Vendita>
<DatiPagamento>
<Tipo>PC</Tipo> => cash payment
<Importo>1.00</Importo>
</DatiPagamento>
</Vendita>
</DocumentoCommerciale>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">...</Signature>
</r:DocCommercialiLotteria>

RESULT FROM TAX AUTHORITY


<ns2:DocCommercialiLotteriaEsito xmlns:ns2="http://ivaservizi.agenziaentrate.gov.it/docs/
xsd/doccommercialilotteria/esito/v1.0">
<IdOperazione>2923e7d8-5bf1-4dd6-8ec6-ad58b2815892</IdOperazione>
<DataOra>2020-03-08T18:35:15</DataOra>
<NumElementi>2</NumElementi>
<Esito>AC</Esito> => positive result
<SegnalazioniDocComm/>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/>
<Reference URI="">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
<DigestValue>k95hUC8ctn5vVWmrb2akqKxjmytOn4KruEJXdnJlpYY=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>...</SignatureValue>
<KeyInfo>...</KeyInfo>
</Signature>
</ns2:DocCommercialiLotteriaEsito>

Guida pratica XML7 & Lotteria Page 36 of 36