Development Guide

 

 

 

 

 

 


 

EPSON ITALIA SpA

 

 ACTIVEX for Fiscal Printer serie FP

 

Name of the control:  EpsonFP2.EpsonFPControl

 


Revision History

 

Ver Rev Fogli Commenti Data Autore
- Draft - Prima versione Agosto 2001

VS

- A - Inserito: Rev History, Elenco proprietà da sviluppare, descrizione parametri funzione 28 Agosto 2001  RC
- B - Inserito descrizione architettura Active X, aggiornato  proprietà, modificato i mnemonici dei seguenti metodi: da Get a Read , definito opX per metodi relativi a trame con Header1=2 mentre con opZ quelli con Header1 = 3, modificato inoltre le Signature dei seguenti metodi: opProgOpr,  modificato inoltre le priorità 1 dei Metodi 31 Agosto 2001  RC
- C - Eliminazione di LastQtaDec e sostituzione del tipo di dati di LastQta da Integer a Single, differenziate LastMM per i mesi e LastMin per i minuti, LastMatrFisc diventa di tipo Long. Introdotta la proprietà EuroSettings. Cambiata la descrizione per opContante per la chiusura scontrino con default=0. Controllata signature per opEndSNoFisc,opZTotOprPer,opReadDataOra,opReadReparto,opReadTassa, opReadCredCC, opRepartoStorno (tolto il parametro Qta), opProgDataOra (non restituisce data e ora). In opReadReparto l'unico parametro in ingresso è solo il numero del reparto. Aggiunta la proprietà LastDate ai metodi che la valorizzano. Accorpate le due sezioni Varie in una sola. Introdotto l'errore OP_EUROLOCK e le costanti EPS_EUROSETTINGS_... 5 Settembre 2001  VS
1.0.7 D - Definito a 40 il numero massimo di character per il parametro Descr nel metodo opMsgVisoreCortesia.
Definito di 4 byte il valore di N.SF e NSNF
Aggiunta la proprietà LastNReparto nelle proprietà impostate da opReadReparto
In opRepartoStornoQDec rinominato il parametro Qta in QtaDec in conformità con opRepartoQDec
Definita in tutto il documento la corretta denominazione della funzione per il riavvio stampa quando la carta è finita. Si chiama opRiavvioStampaDaFineCarta
Uniformato il nome del parametro che descrive il numero dell'operatore (non il codice). Per tutte le funzioni che lo usano questi si chiama NumeroOperatore. Le funzione interessate da questa modifica sono: opXTotOprGior, opXTotOprPer, opZTotOprGior, opZTotOprPer, opProgOpr, opReadOpr
Introdotte tre nuove proprietà (si sola lettura): Major, Minor e Revision per dare la possibilità al programmatore di conoscere la versione del controllo via software.
Correzioni ortografiche
 26 Settembre 2001  VS
1.0.8 E - Viene cambiato (con uno swap fra i valori 2 e 3) il valore del FrameCounter anche nel caso in cui non sia stata ricevuto il frame risposta da parte del PC (ma sia stato ricevuto l'ACK) a differenza delle implementazioni precedenti, che prevedevano il cambio del valore del FrameCounter solo nel caso di ricezione del frame di risposta entro il timeout programmato.  01 Ottobre 2001  VS
1.0.9 F - Su indicazione di Garavaglia Carlo (Epson) viene cambiato (con uno swap fra i valori 2 e 3) il valore del FrameCounter dopo la spedizione di ogni messaggio alla cassa (indipendente dal messaggio di risposta e dalla ricezione dell'ACK) a differenza dell'implementazione precedente, che prevedeva il cambio del valore del FrameCounter solo se era stato ricevuto l'ACK.  09 Ottobre 2001  VS
1.0.20 G - Implementati i metodi per i resi: opRepartoReso, opRepartoResoQInt e opRepartoResoQDec. (come da esigenze di COGITO)
Corretta colorazione di opRepartoQDec: era riportato con priorita' 1 (colore grigio chiaro), ma in realta' era gia' stato implementato.
 12 Novembre 2001  VS
1.0.21 H - * Implementati i metodi: opAlzoCarta, opRepartoPercMinus, opRepartoPercPlus, opReadValuta, opProgValuta, opContanteVal
* Aggiunte le costanti: EPS_SCONTRINO, EPS_GIORNALE, EPS_SCONTRINO_GIORNALE (usate da opAlzoCarta) e tutte le costanti di errore interni della stampante (hanno tutte il prefisso EERR_)
* Aggiunte le proprietà: LastPercReparto, LastNettoPrecedente (usate da opRepartoPercMinus e opRepartoPercPlus) e LastNValuta, LastDescValuta, LastValoreValuta (usate da opReadValuta) e LastImportoValuta (usata da opContanteVal)
* Nella descrizione dei tipi delle funzioni aggiunta la documentazione per il tipo Double usato per definire il valore del rapporto di cambio delle valute straniere.
* Corretta colorazione delle funzioni:
opRiavvioStampaDaFineCarta, opRepartoQDec, opRepartoStorno, opRepartoStornoQDec, opIniSNoFisc, opDatiSNoFisc, opEndSNoFisc, opDescAgg, opZTotFinGior, opZTotOreGior, opZTotOprGior, opZTotFinPer, opZTotOrePer, opZTotOprPer, opZFiscMem, opProgRigaInt, opAttivazioneEuro, opReadMatrFisc, opProgDataOra, opProgOpr, opProgFlag, opProgConf, opProgTipoRigaInt, opReadDataOra, opReadReparto, opReadTassa,opReadCredCC,opProgOpr, opProgFlag, opProgConf, opProgTipoRigaInt,opReadDataOra, opReadReparto, opReadTassa, opReadCredCC, opReadTicket, opReadOpr, opReadFlag, opReadConf, opReadTipoRigaInt: erano riportate con priorita' 1 (colore grigio chiaro), ma in realta' erano gia' state implementate nella versione precedente.
  9 Gennaio 2002  VS
2.0.32 I - * Modificata l'interfaccia ActiveX del controllo (di conseguenza rotta la compatibilità binaria): tutti i metodi pubblici esposti dall'interfaccia (quindi tutti i metodi opXXX ed il metodo GetLastErrorDescription) ora hanno i parametri passati per valore e non più per riferimento. (Problema sollevato da "Apete")
Di conseguenza è stato modificato il nome della libreria in EpsonFP2.EpsonFPControl
Per distinguere il controllo EpsonFP2 dal precedente EpsonFP, oltre al nome ovviamente, è stato aumentato il major number della release (ora siamo alla 2).
Inoltre gli sviluppatori troveranno un numero 2 sulle icone del controllo sia nella toolbox dell'IDE dell'ambiente di sviluppo, sia quando aggiungeranno il controllo EpsonFP2 al container (per esempio un Form in VB) che lo conterrà.
Da questo momento gli sviluppatori che desiderino utilizzare EpsonFP2 debbono includerlo nella loro applicazione e ricompilarla rispettando le nuove specifiche sui parametri dei metodi pubblici.
* Nella documetazione aggiunto il termine ByVal prima di tutti i parametri dei metodi modificati per sottolineare ancora una volta il fatto che i PARAMETERS sono passati per valore e non più per riferimento.
  14 Febbraio 2002  VS
2.0.33 L - * Aggiunti i metodi opRepartoAbbuono, opContanteEntrate, opContanteUscite, opMsgPromo, opContanteConDesc, opProgContanteConDesc con le relative implementazioni.
* Aggiunta la proprietà LastNContanteConDesc.
* Aggiunte le costanti OP_CODE_CONTDESC_RIM e OP_CODE_CONTDESC_REST
* Le proprietà relative agli importi in valuta dopo l'esecuzione dei metodi che le ritornano prevedono ora, già come tipo di dato Currency, il numero di cifre decimali corrispondente all'impostazione della proprietà EuroSettings (EPS_EUROSETTINGS_EURO o EPS_EUROSETTINGS_LIRE). Le proprietà interessate sono: LastImp, LastRest, LastRim, LastSubT, LastImportoValuta, LastTotFisc, LastTotNFisc, LastSubTotFisc, LastSubTotNFisc, LastValoreTicket, LastPre, LastNettoPrecedente, LastPrezzo1, LastPrezzo2, LastPrezzo3 , LastLimite.
  13 Dicembre 2002  VS
2.0.41 M - * Aggiunti i seguenti metodi con le relative implementazioni:
  • opContanteRecCredito
  • opContanteEntrateVal
  • opContanteUsciteVal
  • opAssegnoRecCredito
  • opAssegnoEntrate
  • opAssegnoUscite
  • opAssegnoEntrateVal
  • opAssegnoUsciteVal
  • opAssegnoVal
  • opNonCalcola
  • opFattura
  • opRicFiscale
  • opScontrino
  • opPartitaIVA
  • opCodFiscale
  • opPromoAgg
  • opXTotPLUGior
  • opXTotPLUPer
  • opZTotPLUGior
  • opZTotPLUPer
  • opZFNumPro
  • opZFDate
  • opZSommaSFDate
  • opProgParFatt
  • opReadParFatt
  • opReadContDesc
* Aggiunti i seguenti metodi con le relative implementazioni (Only for FP260 e FP90):
  • opReadNumeroScontrino
  • opPrintBarcode
  • opRepartoValPlus
  • opSubTotValPlus
  • opRepartoLight
  • opReadStato
  • opProgLogoGrafico
* Aggiunti i metodi di lettura totali finanziari con le relative implementazioni (Only for FP260 e FP90):
  • opReadTotaleFinanziarioAnnulliScontrino
  • opReadTotaleFinanziarioApertureCassetto
  • opReadTotaleFinanziarioAssegni
  • opReadTotaleFinanziarioChiusureGiornaliere
  • opReadTotaleFinanziarioContanti
  • opReadTotaleFinanziarioContantiConDesc
  • opReadTotaleFinanziarioContantiVal
  • opReadTotaleFinanziarioCorrezioni
  • opReadTotaleFinanziarioCredCC
  • opReadTotaleFinanziarioEntrateAssegni
  • opReadTotaleFinanziarioEntrateCont
  • opReadTotaleFinanziarioFatture
  • opReadTotaleFinanziarioFiscaleGiornaliero
  • opReadTotaleFinanziarioMaggiorazioniPerc
  • opReadTotaleFinanziarioMaggiorazioniVal
  • opReadTotaleFinanziarioRecCreditiAssegni
  • opReadTotaleFinanziarioRecCreditiContanti
  • opReadTotaleFinanziarioReparto
  • opReadTotaleFinanziarioResi
  • opReadTotaleFinanziarioRicevute
  • opReadTotaleFinanziarioScontiPerc
  • opReadTotaleFinanziarioScontiVal
  • opReadTotaleFinanziarioScontriniFiscali
  • opReadTotaleFinanziarioScontriniMemoriaFiscale
  • opReadTotaleFinanziarioScontriniNonFiscali
  • opReadTotaleFinanziarioStorni
  • opReadTotaleFinanziarioTasse
  • opReadTotaleFinanziarioTicket
  • opReadTotaleFinanziarioUsciteAssegni
  • opReadTotaleFinanziarioUsciteCont
* Aggiunti i metodi per la lettura del D.G.F.E. con le relative implementazioni (Only for FP90):
  • opReadDGFEDate
  • opReadDGFENumPro
  • opZDGFEDate
  • opZDGFENumPro
* Aggiunta la proprietà Retry con accesso in lettura/scrittura per la gestione delle ritrasmissioni a cura dell'utilizzatore di questo OCX
* Aggiunta la proprietà LastDescContante per il metodo opReadContDesc
* Aggiunta la proprietà LastNum per il metodo opNonCalcola
* Aggiunta le proprietà LastNumFatt, LastNRigheFatt, LastNRigheBiancheFatt, LastStampaIntestazione, LastDescEsenzione per il metodo opReadParFatt
* Aggiunta le proprietà LastParametroDaLeggere, LastTotalePezziLetti, LastTotaleImportiLetti, LastTotaleConteggiLetti , LastDatoLetto, LastTotalePezziRepartoLetti, LastImponibileLetto per i metodi opReadTotaleFinanziarioXXXXXX
* Aggiunta le proprietà LastCPUsw, LastMFsw, LastState per il metodo opReadStato
* Aggiunta le proprietà LastOEM, LastModel, LastMatrFiscExtended per il metodo opReadMatrFisc
* Aggiunta le proprietà LastNS, LastNR, LastDGFE per i metodi opReadDGFENumPro e opReadDGFEDate
* Aggiunte le costanti OP_CODE_DGFENUMPRO_VAL e OP_CODE_DGFE_END usate dai metodi opReadDGFENumPro e opReadDGFEDate per verificare se la stampante ha ancora altre righe di scontrino da spedire e se le righe degli socntrini sono finite.
* Aggiunte le costanti EPS_ALIGN_SX e EPS_ALIGN_DX usate dal metodo opRepartoLight
* Aggiunte le costanti OP_CODE_ASSEGVAL_RIM e OP_CODE_ASSEGVAL_REST usate dal metodo opAssegnoVal
* Aggiunta la costante OP_ERR_FILENOTFOUND usata dal metodo opProgLogoGrafico
* Aggiunta la proprietà LastTotAC per il metodo opReadNumeroScontrino
* Aggiunte le costanti EPS_GIORNALIERO e EPS_PERIODICO usate da tutti i metodi opReadTotaleFinanziarioXXXXXX per scegliere tra il totale giornaliero o il totale periodico.
* Esteso il numero di righe per le descrizioni aggiuntive opRigheAgg da 6 a 9 (1-6 per FP210 oppure 1-9 per FP260/FP90)
* Esteso il numero per le configurazioni (in opReadConf e opProgConf) da 10 a 12 (1-11 per FP260 oppure 1-12 per FP90)
* Esteso il parametro Anno di opProgDataOra a 4 byte (ora è possibile specificare 2003 invece di 03). Resta ancora in ogni caso possibile specificare 03 per indicare 2003.
* Corretto in opContanteVal: non venivano valorizzate le proprietà che sono riportate nella documentazione di questo metodo.
* Corretto in opRigheAgg, opMsgPromo, opProgRigaInt: non vengono più eliminati gli spazi in testa alla stringa di descrizione. In questo modo è possibile centrare le descrizioni sullo scontrino.
* Corretta la documentazione: nella parte dove si descrivono le proprietà impostate dai vari metodi è stata corretto il tipo delle proprietà LastNumSF e LastNumSNF da Integer a Long (relativamente a tutti i metodi che impostano queste proprietà)
* Aggiunta alla documentazione che alcuni metodi sono validi Only for  FP260/FP90
  11 Giugno 2003  VS
2.0.45 N - * Aumentato il timeout di attesa di ACK in tutti i metodi (da 3 a 10 secondi)
* Tolto il Trim delle stringhe in tutti i metodi del controllo.
* Aggiunta la documentazione dei byte della proprietà LastState
* Modificato il logo del controllo da Epson FP-210 a Epson FP
  18 Settembre 2003  VS
2.0.47 O - * PARAMETERSzzati i timeout per i metodi opXXX:
I timeout sono 2 e vi si accede (sia in lettura che in scrittura) grazie a 2 nuove proprietà:
  • TimeoutOP indica il tempo massimo di attesa (in secondi), prima di restituire il valore OP_ERR_TIMEOUT, per la risposta completa da parte della stampante
  • TimeoutACK indica il tempo massimo di attesa (in secondi), prima di restituire il valore OP_ERR_ACKTIMEOUT, per la risposta ACK da parte della stampante
Dopo l'esecuzione di ogni metodo opXXX questi due timeout vengono resettati e se non si impostano di nuovo il successivo metodo opXXX utilizzerà i valori di default per questi due timeout.
Per sapere i valori dei timeout utilizzati dall'ultimo metodo opXXX eseguito, è sufficiente consultare le due nuove proprietà LastTimeoutOP e LastTimeoutACK

* Aggiunta la gestione di una sentinella di "busy" per la gestione di chiamate troppo ravvicinate al controllo che non lasciano il tempo al controllo stesso di computarle fino in fondo e nell'ordine richiesto.
La nuova proprietà si chiama OCXBusy (di tipo Boolean). Se vale True indica che il controllo è impegnato nella gestione di una chiamata precedente, se vale False il controllo è disponibile all'esecuzione di un metodo opXXX
L'utente prima di chiamare qualsiasi metodo opXXX dovrebbe controllare OCXBusy e solo questa vale False può utilizzare il controllo OCX.
In ogni caso tutti i metodi opXXX controllano anch'essi la sentinella e se la trovano occupata ritornano il nuovo valore di ritorno OP_ERR_OCXBUSY

* Aggiunti 3 nuovi valori di ritorno a tutti i metodi opXXX:
  • OP_ERR_ACKTIMEOUT (indica che è scaduto il timeout in attesa dell'ACK da parte della stampante)
  • OP_ERR_STXTIMEOUT (indica che è scaduto il Timeout used to wait the reply from the printer)
  • OP_ERR_OCXBUSY (indica che in controllo era occupato a soddisfare un'altra richiesta quando è stato richiesta l'esecuzione del metodo)
* Aggiunte 5 nuove proprietà:
  • TimeoutACK
  • TimeoutOP
  • LastTimeoutACK
  • LastTimeoutOP
  • OCXBusy

* Corretta la documentazione nel caso dei metodi opRepartoLight, opRepartoValPlus, opSubTotValPlus, opPrintBarCode, opProgLogoGrafico, opReadNumeroScontrino, opReadStato in cui erano indicato che i metodi erano compatibili per le stampanti FP210 e FP90, mentre sono compatibili per FP260 e FP90.
  21 Ottobre 2003  VS
2.0.47 P ALL Translated in English the documentation, cutted the unused methods 15 December 2003 R.C.
2.0.48 Q * Modified the Toolbox Image of control
* Increased the value of timeout when the register is not connected to the serial port. Now is up to 7 seconds.
* Added methods:
  • opPrintBarcodeExtended
  • opReadGranTotale
  • opRepartoResoLight
  • opRepartoStornoLight
  • opValMinusLight
  • opPaymentLight
  • opHeaderAggiuntivo
  • opReadDGFEState
  • opDGFEFormat

* Use opPrintBarCode only inside fiscal bill

* Use integer value of Tax
15 April 2004 VS
2.0.52 Q * For all methods "light" (opRepartoLight,opRepartoResoLight,opRepartoStornoLight,opValMinusLight,opPaymentLight) the description field's lenght is up to 32 characters.
* For method opDescAgg the description field's lenght is up to 32 characters.
* For method opRigaInt the description field's lenght is up to 40 characters.
* Added methods:
  • opReadRigaInt
  • opAddRowDesc
* Added property:
  • LastDescrRigaIntestazione
20 May 2004 VS
      *Added a table with a more complete description of the printer errors

*Reviewed and completed English translation 

*For method opAddRowDesc the range of NumRiga is:

  • 1÷9 - If TipoRiga = 1
  • 1÷99 - If TipoRiga = 2 or TipoRiga = 3
  • 0 (Meaningless data) - If TipoRiga = 4

*For method opReadState, property LastState:

  • the range of the fourth byte has been extended to [0÷6].
03 June 2004 CG
2.0.53 R  

*For method opAddRowDesc added the control of the length of row description

16 June 2004 VS
2.00.65 S   *For methods opProgTipoRigaInt,  parameters TipoStampa:
  •  the description of range and values has been completed.

*For method opReadTipoRigaInt, property LastTipoStampa:

  •  the description of range and values has been completed.

Added configuration and flag description tables

Corrected bookmarks and hyperlink to better manage the document

01 July 2005 CG
  *For methods opDescrAgg,  parameters Descr:
  •  the length of the field is 20 characters instead of 32.
22 July 2005 CG
  *For method opReadMatrFisc:
  • Added code description of parameter LastModel:
  • Added code description of parameter LastOEM:
28 Sep 2005 CG
2.00.67 T   Extended the management of method "opValMinusLight" also for surcharge

Added management of Credit Notes

Added description/management of forbidden words

Added method "opReadTotaleFinanziarioNoteDiCredito"

Added management of international settings (decimal separator)

17 Oct 2005 CG
          

Overview


 

This document describes the architecture, properties, methods of the ActiveX control that has been developed for the Epson fiscal printer series.

The active X control can be used in all the environments that are able to manage the COM (Component Object Model of  Microsoft Corporation) technology

 



RELATING DOCUMENTS

 


ARCHITECTURE OF THE CONTROL

This control works in  synchronous way, the application program that makes use of this control must wait until the control closes the communication with the printer before going on. 

The value returned from the fiscal printer to a command is available in the properties with the prefix "LAST"

The methods relating the fiscal printer use the prefix “op”. Each methods implement a single command managed from the printer.

The input parameters of the methods are defined with the following type:

·         String: used for all the description

·         Integer: used for all the value up to  32.767

·         Long: used for all the value up to  2.147.483.647

·         Single: used for all the decimal value, not used in the currency ratio.

·         Double: used in the currency ratio for exchange the currency. Starting from release 2.0.0.67, the ActiveX manages International settings of the operating system (decimal separator).

·         Currency: used for all the figures relating money. Starting from release 2.0.0.67, the ActiveX manages International settings of the oparating (decimal separator)

·         Date: use for the date, the single items (day, year etc.) are used as integer.

Relating the Currency, this activeX is able to format automatically the field to send to the printer, this is done using the propriety EuroSettings, this propriety MUST BE SET, otherwise the Control does not work.

This  control does not manage the communication retry, in case of communication error it returns back  an ERROR.

 

 

 

 


 Sample of Fiscal Receipt printed by FP90

 

LOGO: 384Kyte, reserved for images to be printed at the beginning and/or at the end of the receipt.

 

HEADER: Printed automatically using

- opApriScontrinoFiscale

- opIniSNoFisc

- opAddRowDesc when TipoRiga=4

- any selling command

 

ADDITIONAL HEADER ROWS: They must be loaded in advance, before opening the receipt with the method:- opAddRowDesc: using TipoRiga=1

 

opRepartoResoLight: good return to be refunded

 

opRepartoLight: sale of an item

 

opValMinusLight: to perform discount on the last item sold or on the subtotal

 

opAddRowDesc: using TipoRiga=4

opStampaVisSubtotale: to print and show on the display the subtotal amount

 

opRepartoStornoLight: to cancel the last sale operation

 

opPagamentoLight: to perform payment and close the receipt

 

CHANGE: Automatically computed by the printer

 

NUMBER OF ITEMS: optional, automatically added to the receipt

opAddRowDesc: using TipoRiga=2

 

Cash Id Number: Automatically printed on the receipt

 

Fiscal Receipt Number: Automatically printed on the receipt

Printer Serial Number: printed automatically on the receipt

 

 

opAddRowDesc: using TipoRiga=3

 

opPrintBarcodeExtended: to print bar codes on the receipt

 

 

 

 


Credit Note Receipt

Starting from Rel. 3.00 EPSON fiscal printers FP90 is able to manage "Credit Note" receipt. In other words it allows to refund the amount paid to the customer in the case that he returns to the shop items bought.

The operation requires to release a "Credit note" receipt.

Credit note receipts have the following characteristics:

Opening a Credit Note Receipt

A credit note receipt can be started using the method "opAddRowDesc " with the following parameters:

The sentence "PRATICA DI RESO" represents the keyword to open a credit note:

The part indicated with "xxxxxxxxxxxxxxxxx" represent a free text that can be added for further description. It is composed by 17 characters.

Methods allowed inside a credit note receipt

The following method performs the closure of the credit note if the fiscal printer is not configured for JAVAPOS mode (Flag JavaPos = 0).


Fiscal Printer Modes

EPSON fiscal printers offer additional functions beyond the requirements of the Italian tax authority. Fiscal Printer Modes, mandatory and options, are described in the International standard: “UnifiedPOS Retail Peripheral Architecture”.

EPSON FP family manages all the modes described in the standard:

o  Fiscal: This is the only required mode for a Fiscal Printer. In this mode the application has access to all the methods needed to manage a sale transaction and to print a fiscal receipt. It is assumed that any lines printed to the receipt station while in fiscal mode are also printed on the journal station.

o  Training: In this mode, the Fiscal Printer is used for training purposes (such as cashier training). In this mode, the Fiscal Printer will accept fiscal commands but the Fiscal Printer will indicate on each receipt or document that the transaction is not an actual fiscal transaction. The Fiscal Printer will not update any of its internal fiscal registers while in training mode. Such printed receipts are usually marked as “training” receipts by Fiscal Printers.

o  Non Fiscal: In this mode the Fiscal Printer can be used to print simple text on the receipt station (echoed on the journal station) or the slip station. The Fiscal Printer will print some additional lines along with the application requested output to indicate that this output is not of a fiscal nature. Such printed receipts are usually marked as “non-fiscal” receipts by Fiscal Printers


Fiscal Printer States

As previously described, a Fiscal Printer is characterized by different printing

modes. Moreover, the set of commands that can be executed at a particular

moment depends upon the current state of the Fiscal Printer.

 

The Fiscal Printer has the following states:

 

Monitor:

This is a neutral state. From this state, it is possible to move to most of the other Fiscal Printer states.

 

Fiscal Receipt:

The Fiscal Printer is processing a fiscal receipt.

 

Fiscal Receipt Total:

The Fiscal Printer has already accepted at least one payment method, but the receipt’s total amount has not yet been tendered. 

 

Fiscal Receipt Ending:

The Fiscal Printer has completed the receipt up to the Total line.

 

Monitor and TrainingModeActive are true:

The Fiscal Printer is being used for training purposes. All fiscal receipt and

document commands are available.

 

Fiscal Receipt and TrainingModeActive are true:

The Fiscal Printer is being used for training purposes and a receipt is currently opened. To each line of the receipt, special text will be added in order to differentiate it from a fiscal receipt.

 

Fiscal Total and TrainingModeActive are true:

The Fiscal Printer is in training mode and receipt total is being handled.

 

Fiscal ReceiptEnding and TrainingModeActive are true:

The Fiscal Printer is being used for training is in the receipt ending phase.

 

NonFiscal:

The Fiscal Printer is printing non-fiscal output on either the receipt (echoed on the journal) or the slip.

 

Report:

The Fiscal Printer is currently printing one of the supported types of reports.

The following table reports all the states described. It reports also all the possible state-transactions.

The state “Fiscal Receipt Ending” operates only when the printer is configured in "JavaPOS" mode. Inside the table, the transactions marked with "a" are possible only when the printer operates in JavaPOS mode while, on the contrary, the transactions marked with "b" are possible only when the printer is not configured in JavaPOS mode.

 

 


Forbidden words inside Fiscal Receipt

Inside fiscal receipt, text row and descriptions, can not use some words defined as "forbidden words".

The set of "forbidden words" is described in the following list:

The printer cannot accept the above words regardless the case-letter (Cap., lower or mixed).

The word are refused also if the letters are separated by space or any other kind of not alphabetical character.

 

As example the character sequence "t O-t+a#L,e" will not be accepted by the printer because removing all the not alphabetic characters the remaining word is tOtaLe.

 

When the printer, inside a fiscal receipt,  receives a message that includes a text field, and inside the text field there is a forbidden sequence, the printer doesn't accept the message and returns the error code "EERR_SCRITTA_INVALIDA".

 

These limitations are not applied inside Not Fiscal Receipt

 

Fiscal printers FP90 starting from release 3.00 don't manages the forbidden words in a different way. Before printing a forbidden word in a fiscal receipt, it

replies the last character with the "*" character so "totale" will be written "total*", "sconto" becames "scont*", "importo" becames "import*" and "contante" becames "contant*".

 


LIST OF METHODS


System

 Sales

Subtotal

Payment

 

Other

 

Report 

 

Fiscal report 

 

    Configuration/reading

 

    Electronic Journal "Dispositivo Giornale di Fondo Elettronico" D.G.F.E. 

 


LIST OF PROPERTIES



ERROR LIST


The errors are split in two levels:

The internal activeX errors have been defined with  the prefix "OP" followed by the description. In case of  internal printer errors the variable EERR becames TRUE, the kind of error can be check in the Property LASTERROR.

Any internal printer error can be check in the  LastEERR property. The description of the internal printer errors with associated code can be found in CONSTANT ERROR DESCRIPTION.


LIST OF CONSTANTS



LIST OF EVENTS



LIST OF PARAMETERS



DESCRIPTION OF THE METHODS


The following methods are identified from their signature (or interface)

For every method you can find:

All the methods use the prefix "op"

List of methods

List of methods

List of methods

List of methods

 

List of methods

List of methods

List of methods

List of methods

List of methods

List of methods

List of methods

List of methods

 

List of methods

List of methods

List of methods

List of methods

List of methods

List of methods

List of methods

 

List of methods

 

List of methods

List of methods


PROPERTY DESCRIPTION


Settings

Settings - String
Sets the serial communication port..
Format of string to use for setting the communication port:
Baud rate & "," & Tipo di Parità & "," & Num bit di dati & "," Num bit di stop
Exp 9600,n,8,1
Default value is  9600,n,8,1
Kind of access: READ/WRITE

List of Property

COMM_Modality

COMM_Modality - Integer
Defines the communication Modality (Serial port, TCP/IP communication)
Value: EPS_SERIAL_COMM, EPS_TCP_COMM.
Kind of access: READ/WRITE

List of Property

COMPort

COMPort - Integer
Number of communication port
Default value is COM1.
Kind of access: READ/WRITE

List of Property

RemotePrinterIPAddress

RemotePrinterIPAddress - String
TCP/IP Address of the printer
Example: 123.456.78.9.
Kind of access: READ/WRITE

List of Property

RemotePrinterIPPortNumber

RemotePrinterIPPortNumber - Long
Port number of the printer
Example: 4567.
Kind of access: READ/WRITE

List of Property

EuroSettings

EuroSettings - Integer
Define how to manage the amount with different currency 
Default value is  EPS_EUROSETTINGS_UNKNOWN, in this way the control does not work .
Value: EPS_EUROSETTINGS_UNKNOWN, EPS_EUROSETTINGS_LIRE, EPS_EUROSETTINGS_EURO
Kind of access: READ/WRITE

List of Property

Major

Major - Integer
Number  Major of the ActiveX version OCX
Kind of access: READ

List of Property

Minor

Minor - Integer
Number  Minor of the ActiveX version
Kind of access: READ

List of Property

Revision

Revision - Integer
Version number of ActiveX
Kind of access: READ

List of Property

LastEERR

LastEERR - Integer
Fiscal printer error code
Kind of access: READ

List of Property

LastOP

LastOP (OP) - Integer
Code of operator
Kind of access: READ

List of Property

LastOPCode

LastOPCode - Integer
Number of code relating the command sent to the printer (Header1 + Header2 of the communication protocol) 
Kind of access: READ

List of Property

LastCodProd

LastCodProd (COD) - String
Product code
Kind of access: READ

List of Property

LastQta

LastQta (QTA) - Single - [0000,001-9999,999]
Quantity (with and w/o decimal)
Kind of access: READ

List of Property

LastTipoPre

LastTipoPre (TIPO) - Integer
Kind of price
Kind of access: READ

List of Property

LastPre

LastPre (PREZ) - Cost
Price
Kind of access: READ

List of Property

LastImportoValuta

LastImportoValuta (VAL) - Currency
Currency amount
Kind of access: READ

List of Property

LastImp

LastImp (IMP) - Currency
Amount
Kind of access: READ

List of Property

LastRep

LastRep (REP) - Integer
Department
Kind of access: READ

List of Property

LastPercReparto

LastPercReparto (%) - Single
Percentage of discount/surcharge in the department
Kind of access: READ

List of Property

LastNettoPrecedente

LastNettoPrecedente (NETP) - Currency
Net value before applying  the percentage (discount/surcharge)
Kind of access: READ

List of Property

LastSubT

LastSubT (SUBT) - Currency
SubTotal amount
Kind of access: READ

List of Property

LastTipoRichiestaSubTotal

LastTipoRichiestaSubTotal (TRST) - Integer
Kind of LastSubRim data. 1=LastSubRim is Subtotal; 2=LastSubRim is Remainder
Kind of access: READ

List of Property

LastSubRim

LastSubRim (SUBRIM) - Currency
SubTotal or Remainder amount
Kind of access: READ

List of Property

LastPerc

LastPerc (%) - Single
Percentage
Kind of access: READ

List of Property

LastTotFisc

LastTotFisc (TF) - Currency
Fiscal amount
Kind of access: READ

List of Property

LastTotNFisc

LastTotNFisc (TNF) - Currency
Not fiscal amount
Kind of access: READ

List of Property

LastGG

LastGG (GG) - Integer [1-31]
Days  of the cash register
Kind of access: READ

List of Property

LastMM

LastMM (MM) - Integer [1-12]
Month  of the cash register
Kind of access: READ

List of Property

LastAA

LastAA (AA) - Integer
Year  of the cash register
Kind of access: READ

List of Property

LastHH

LastHH (HH) - Integer [0-23]
Hours  of the cash register
Kind of access: READ

List of Property

LastMin

LastMin (Min) - Integer [0-59]
Minutes  of the cash register
Kind of access: READ

List of Property

LastDate

LastDate () - Date [GG/MM/AA - HH:MM:SS]
Date of the fiscal printer 
Kind of access: READ

List of Property

LastNumSF

LastNumSF (N.SF) - Long
Number of fiscal receipt/invoice
Kind of access: READ

List of Property

LastNumSNF

LastNumSNF (NSNF) - Long
Number of fiscal receipt
Kind of access: READ

List of Property

LastRim

LastRim (RIM) - Currency
Remaining amount to be paid
Kind of access: READ

List of Property

LastRest

LastRest (RES) - Currency
Change of the payment
Kind of access: READ

List of Property

LastCC

LastCC (CC) - Integer
CreditCard
Kind of access: READ

List of Property

LastNValuta

LastNValuta (N) - Integer
Number of currency
Kind of access: READ

List of Property

LastNumTick

LastNumTick (N) - Integer
Ticket
Kind of access: READ

List of Property

LastSubTotFisc

LastSubTotFisc (SBF) - Currency [from -999999999 to 999999999]
Fiscal sub total amount
Kind of access: READ

List of Property

LastSubTotNFisc

LastSubTotNFisc (SBNF) - Currency [from -999999999 to 999999999]
Not fiscal sub total amount
Kind of access: READ

List of Property

LastNReparto

LastNReparto (REP) - Integer [1-40]
Number of the department
Kind of access: READ

List of Property

LastDescReparto

LastDescReparto - (String) [max 20 character]
Description of the department
Kind of access: READ

List of Property

LastPrezzo1

LastPrezzo1 - (Currency) [0-999999999]
Price number 1
Kind of access: READ

List of Property

LastPrezzo2

LastPrezzo2 - (Currency) [0-999999999]
Price number 2
Kind of access: READ

List of Property

LastPrezzo3

LastPrezzo3 - (Currency) [0-999999999]
Price number 3
Kind of access: READ

List of Property

LastCodPLU

LastCodPLU (PLU) - Integer [1-1000]
Number of the PLU
Kind of access: READ

List of Property

LastDescPLU

LastDescPLU - (String) [max 20 character]
Description of the PLU
Kind of access: READ

List of Property

LastPrice1PLU

LastPrice1PLU - (Currency) [0-999999999]
Price number 1
Kind of access: READ

List of Property

LastPrice2PLU

LastPrice2PLU - (Currency) [0-999999999]
Price number 2
Kind of access: READ

List of Property

LastPrice3PLU

LastPrice3PLU - (Currency) [0-999999999]
Price number 3
Kind of access: READ

List of Property

LastNKey

LastNKey (Key) - Integer [1-70]
Number of Direct key related to the PLU
Kind of access: READ

List of Property

LastNRepPLU

LastNRepPLU (RepPLU) - Integer [1-40]
Number of Department related to the PLU
Kind of access: READ

List of Property

LastBarcodePLU

LastBarcodePLU - (String) [max 40 character]
Barcode related to the PLU
Kind of access: READ

List of Property

LastItem

LastItem (ITEM) - Integer [0-1]
Item sold
Kind of access: READ

List of Property

LastNTassaRep

NTassaRep(TAS) - Integer [0-4]; 0 = Tax exempt
Department VAT
Kind of access: READ

List of Property

LastLimite

LastLimite (LIM) - (Currency) [0-999999999]
Range of price
Kind of access: READ

List of Property

LastGruppoStampa

LastGruppoStampa (GR) - (Integer) [0-10]
Kind of pritner 
Kind of access: READ

List of Property

LastSuperGruppoMerceologico

LastSuperGruppoMerceologico (SUP) - (Integer) [0-10]
A kind of main department 
Kind of access: READ

List of Property

LastUMFattura

LastUMFattura (UM) - (String) [MAx two characters]
Unit to be used in the invoice 
Kind of access: READ

List of Property

LastNTassa

LastNTassa (N) - (Integer) [1-4]
Number of VAT
Kind of access: READ

List of Property

LastAliquota

LastAliquota (VAL) - (Single) [0,00-99,99]
Value of VAT 
Kind of access: READ

List of Property

LastNCartaCC

LastNCartaCC (N) - (Integer) [1-10]
Number of Credit Card 
Kind of access: READ

List of Property

LastDescCartaCC

LastDescCartaCC (DESC) - (String) [max 20]
Credit Card description 
Kind of access: READ

List of Property

LastNContanteDesc

LastNContanteDesc (N) - (Integer) [1-5]
Number of kind of cash with description
Kind of access: READ

List of Property

LastNTipoTicket

LastNTipoTicket (N) - (Integer) [1-10]
kind of ticket 
Kind of access: READ

List of Property

LastDescTicket

LastDescTicket (DESC) - (String) [max 20 character]
Description of the  ticket 
Kind of access: READ

List of Property

LastValoreTicket

LastValoreTicket (VAL) - (Currency) [0-999999999]
Amount of the Ticket 
Kind of access: READ

List of Property

LastDescValuta

LastDescValuta (DESC) - (String) [max 2 character]
Description of the currency
Kind of access: READ

List of Property

LastValoreValuta

LastValoreValuta (VAL) - (Currency) [0,000000001-99999,999999999]
Kind of currency ratio
Kind of access: READ

List of Property

LastNumeroOperatore

LastNumeroOperatore (N) - (Integer) [1-12]
Operator number 
Kind of access: READ

List of Property

LastDescOpr

LastDescOpr (DESC) - (String) [max 20 character]
Description of the operator
Kind of access: READ

List of Property

LastCodOprSegr

LastCodOprSegr (COD) - (INTEGER) [0-9999]
Operator keyword
Kind of access: READ

List of Property

LastPerOpr

LastPerOpr (%OP) - (Single) [00,00-99,99]
Operator percentage 
Kind of access: READ

List of Property

LastNumFlag

LastNumFlag (N) - (Integer) [1-26]
Flag Id number
Kind of access: READ

FLAG NUMBER DESCRIPTION
  FISCAL PRINTER
FLAG FP90 FP210/FP285 FP260
1 TRAINING TRAINING TRAINING
2 NOT USED KEYBOARD BUZZER KEYBOARD BUZZER
3 PRINT CASH DRAWER OPENINGS PRINT CASH DRAWER OPENINGS PRINT CASH DRAWER OPENINGS
4 OPERATORS OPERATORS OPERATORS
5 SECRET OPERATORS SECRET OPERATORS SECRET OPERATORS
6 RESET OPERATORS RESET OPERATORS RESET OPERATORS
7 PRINT OPERATORS PRINT OPERATORS PRINT OPERATORS
8 PRINT NUMBER OF PIECES PRINT NUMBER OF PIECES PRINT NUMBER OF PIECES
9 SHORT PRODUCT CODE SHORT PRODUCT CODE SHORT PRODUCT CODE
10 PC ON LINE PC ON LINE PC ON LINE
11 NO AUTOM PAPER END INFORMATION SCALE ITEM SCALE ITEM
12 VIEW PAPER CLOSE TO END FAT/RF PRICE

FAT/RF PRICE

13

SUBTOTAL MANDATORY

SUBTOTAL MANDATORY

SUBTOTAL MANDATORY

14

RECEIPT REPRINT ALLOWED

RECEIPT REPRINT ALLOWED

RECEIPT REPRINT ALLOWED

15

0 = BC 2 CODED. TYPE 1

1 = BC 2 CODED. TYPE 2

0 = BC 2 CODED. TYPE 1

1 = BC 2 CODED. TYPE 2

0 = BC 2 CODED. TYPE 1

1 = BC 2 CODED. TYPE 2

16

0 = BC2 WITH INT. CKS

1 = BC2 WITHOUT INT. CKS

0 = BC2 WITH INT. CKS

1 = BC2 WITHOUT INT. CKS

0 = BC2 WITH INT. CKS

1 = BC2 WITHOUT INT. CKS

17

0 = BC2 WITH WEIGHT INF.

1 = BC2 WITH QUANT. INF.

0 = BC2 WITH WEIGHT INF.

1 = BC2 WITH QUANT. INF.

0 = BC2 WITH WEIGHT INF.

1 = BC2 WITH QUANT. INF.

18

SHIFT KEY ENABLED

SHIFT KEY ENABLED

SHIFT KEY ENABLED

19

REVERSAL KEY ENABLED

REVERSAL KEY ENABLED

REVERSAL KEY ENABLED

20

RETURN-GOOD  KEY ENA.

RETURN-GOOD KEY ENA.

RETURN-GOOD  KEY ENA.

21

CANCEL KEY ENABLE

CANCEL KEY ENABLED

CANCEL KEY ENABLED

22

DISCOUNT KEY ENABLED

DISCOUNT KEY ENABLED

DISCOUNT KEY ENABLED

23

FIX DISCOUNT KEY ENA.

FIX DISCOUNT KEY ENA.

FIX DISCOUNT KEY ENA.

24

PRINT CURRENCY

PRINT CURRENCY

PRINT CURRENCY

25

PRINT TOTAL EURO/LIRE

PRINT TOTAL EURO/LIRE

PRINT TOTAL EURO/LIRE

26

AUTOMATIC OPENING OF THE CASH DRAWER

NOT USED

AUTOMATIC OPENING OF THE CASH DRAWER

27

TX/RX   ACK

NOT USED NOT USED
28 PRINT PRODUCT CODE NOT USED NOT USED
29 JAVAPOS NOT USED NOT USED

The table reports the the operating mode the the printer when the flag is TRUE.

List of Property

LastFlag

LastFlag (VAL) - (Integer) [0-1]
Value of the programmed flag
Kind of access: READ

List of Property

LastNumConf

LastNumConf (N) - (Integer) [1-10] ([1-11] For FP260, [1-99] For FP90)
Number of configuration parameter 
Kind of access: READ


CONFIGURATION TABLE FOR FP90
ID NUMBER FP90 RANGE DEFAULT VALUE
1 IMPUTATION VALUE 1÷99 1
2 ROUNDING AMOUNT 1÷999 1
3 ROUNDING PERCENT 1÷999 1
4 ROUNDING CURRENCY 1÷999 1
5 NUMBER OF COMM. RETRIES 1÷99 1
6 TIMEOUT OF COMM. RETRY 1÷99 5
7 PRINT DENSITY 1÷25 12
8 DISPLAY BRIGHTNESS 1÷99 6
9 GRAPHIC HEADER 0÷99* 0
10 GRAPHIC FOOTER 0÷99* 0
11 CASH ID NUMBER 0÷999 0
12 PRINT PAPER 0=80; 1=60; 2=57 (mm) 0÷2 0
13 STANDBY ON DISPLAY (minutes) 1÷99 60
14** PAY IN ADVANCE 0÷2 0

* Since release 2.00. Previously the range was 0-9.

** Since release 2.013. 0 = Function disabled; 1 = Enabled for all the items; 2 = Enabled for the items with price > 0.

 

CONFIGURATION TABLE FOR FP210/FP265
ID NUMBER FP210/265 RANGE DEFAULT VALUE
1 IMPUTATION VALUE 1÷99 1
2 ROUNDING AMOUNT 1÷999 1
3 ROUNDING PERCENT 1÷999 1
4 ROUNDING CURRENCY 1÷999 1
5 NUMBER OF RETRIES 1÷99 3
6 TIMEOUT OF RETRY 1÷99 5
7 PRINT DENSITY 1÷25 12
8 DISPLAY BRIGHTNESS 1÷99 6

 

CONFIGURATION TABLE DESCRIPTION FOR FP260
ID NUMBER FP260 RANGE DEFAULT VALUE
1 IMPUTATION VALUE 1÷99 1
2 ROUNDING AMOUNT 1÷999 1
3 ROUNDING PERCENT 1÷999 1
4 ROUNDING CURRENCY 1÷999 1
5 NUMBER OF RETRIES 1÷99 3
6 TIMEOUT OF RETRY 1÷99 5
7 PRINT DENSITY 1÷25 12
8 DISPLAY BRIGHTNESS 1÷99 6
9 GRAPHIC HEADER 0÷9 0
10 GRAPHIC FOOTER 0÷9 0
11 CASH ID NUMBER 0÷999 0

List of Property

LastConf

LastConf (VAL) - (Integer) [000-999]
Value of the flag during configuration
Kind of access: READ

List of Property

LastNumRiga

LastNumRiga (N) - (Integer)-  [1-6]
Number of the row 
Kind of access: READ

List of Property

LastTipoStampa

LastTipoStampa (TIPO) - (Integer) [1-4]
Identifies the size and the style of the font (1=Normal; 2=Bold; 3=Double size; 4=Double size bold)
Kind of access: READ

List of Property

LastNumFatt

LastNumFatt (FAT) - (Integer) [1-9999]
Invoice number 
Kind of access: READ

List of Property

LastNRigheFatt

LastNRigheFatt (N.R.) - (Integer) [20-99]
Number of row in the invoice 
Kind of access: READ

List of Property

LastNRigheBiancheFatt

LastNRigheBiancheFatt (NRB) - (Integer) [0-20]
Number of blank row in the invoice (at the beginning) 
Kind of access: READ

List of Property

LastStampaIntestazione

LastStampaIntestazione (LOG) - (Boolean) [True-False]
Flag to able the print out of the HEADER (company name)
Kind of access: READ

List of Property

LastDescEsenzione

LastDescEsenzione (ESEN) - (String) [max 14 character]
Description of VAT TAX exemption 
Kind of access: READ

List of Property

LastDescContante

LastDescContante (DESC) - (String) [max 20 character]
Description of the cash with "description"
Kind of access: READ

List of Property

LastMatrFisc

LastMastFisc (NUM) - (Long) [000000-999999]
Fiscal memory serial number 
Kind of access: READ

List of Property

LastModel

LastModel (MOD) - (String) [2 character]
Identification number of kind of fiscal printer
Kind of access: READ

Code: {EI = FP285; EN = FP90; EP = FP210; ES = FP260}

List of Property

LastOEM

LastOEM (PROD) - (String) [2 character]
Identification number of printer manufacturer
Kind of access: READ

Code: {99 = EPSON}

List of Property

LastMatrFiscExtended

LastMatrFiscExtended (String) [10 character]
Fiscal memory serial number got from the following property:  LastMatrFisc, LastModel, LastOEM
Kind of access: READ

List of Property

LastNum

LastNum (NUM) - (Long) [1-999999999]
Number to be print-out set to the left side.
Kind of access: READ

List of Property

LastParametroDaLeggere

LastParametroDaLeggere (TIPO) - (Integer) [1-29]
Parameter to be read in the request number 2050 e 2051  
Kind of access: READ

List of Property

LastDatoLetto

LastDatoLetto (NUMERO/NR) - (Integer) [1-40]
Data to be read in the request number  2050 e 2051 
Kind of access: READ

List of Property

LastTotItemPLU

LastTotItemPLU (T.I.) - (Double) [0-999999,999]
Total number of Items related to a PLU.
Kind of access: READ

List of Property

LastTotAmountPLU

LastTotAmountPLU (T.A.) - (Currency) [0-999999999]
Total amount related to a PLU 
Kind of access: READ

List of Property

LastTotalePezziLetti

LastTotalePezziLetti (T.P.) - (Long) [0-999999999]
Total number of pieces in the reply to the requests 2050 and 2051.
Kind of access: READ

List of Property

LastTotaleImportiLetti

LastTotaleImportiLetti (T.I.) - (Currency) [0-999999999]
Total amount read to the request  2050 e 2051 
Kind of access: READ

List of Property

LastTotaleConteggiLetti

LastTotaleConteggiLetti (T.P.) - (Long) [0-999999999]
Total amount relating the value computed from the printer in the request 2 050 and 2 051 for:  LETTURA APERTURE CASSETTO (READING NUMBER OF CASH DRAWER OPENING OPERATIONS); LETTURA SCONTRINI FISCALI (READING OF THE NUMBER OF FISCAL RECEIPTS); - LETTURA SCONTRINI DI LETTURA MEMORIA FISCALE (READING OF THE NUMBER OF RECEIPTS ISSUED FOR READING FISCAL MEMORY); - LETTURA SCONTRINI NON FISCALI (READING OF THE NUMBER OF NOT FISCAL RECEIPTS); - NUMERO CHIUSURE GIORNALIERE (READING OF THE NUMBER OF DAILY CLOSURES)
Kind of access: READ

List of Property

LastTotalePezziRepartoLetti

LastTotalePezziRepartoLetti (NR) - (Double) [0-999999999]
Total number of pieces (for department) in the reply to the requests 2050 and 2051 (Reading department);
Kind of access: READ

List of Property

LastImponibileLetto

LastImponibileLetto (T.P.) - (Currency) [0-999999999]
Total amount relating the reading 2050 and 2051 (VAT reading)
Kind of access: READ

List of Property

LastTotAC

LastTotAC (TOT A/C) - (Boolean) [True-False]
Gives indication if the property  LastNSF is relating to the next receipt (TRUE) or the current OPENED fiscal receipt (False)
Kind of access: READ

List of Property

LastCPUsw

LastCPUsw (CPU) - (String)
Software release of fiscal board microcontroller
Kind of access: READ

List of Property

LastMFsw

LastMFsw (MF) - (String)
Software release of fiscal memory microcontroller
Kind of access: READ

List of Property

LastState

LastState (STATO) - (String)
Fiscal printer status
Printer FP260:
first byte:     0=Ok, 1=journal paper close to run out, 2=receipt paper close to run out
second byte: not used
third byte: (status cash drawer) 0=open, 1=close
byte 3 and 4 not used
Printer FP90:
first byte: 0=Ok, 2=paper close to run out; 3=printer off line
second byte (status DGFE) 0=OK, 1= almost  full, 2=not formatted, 3=previous DGFE , 4=DGFE of other printer, 5=DGFE full, 6=DGFE missing
third byte (status cash drawer) 0=open, 1=close
fourth byte (status receipt) 0=Fiscal receipt open, 1=Receipt close, 2=Not fiscal receipt open, 3=Payment, 4=Error on Last ESC/POS command with receipt closed, 5=Negative Total Amount, 6=Error on Last ESC/POS command with Not fiscal receipt open,
fifth byte: not used.
Kind of access: READ

List of Property

LastNS

LastNS (NS) - (Long) [1-9999]
Number of the row reading from the Electronic journal a nd relating to the astNR receipt
Kind of access: READ

List of Property

LastNR

LastNR (NR) - (Long) [1-9999]
Number of the receipt reading from the Electronic journal
Kind of access: READ

List of Property

LastDGFE

LastDGFE (DGFE) - (String) [40 character]
There is the content of a row (LastNR) read from the electronic journal and relating to the LastNS receipt.
Kind of access: READ

List of Property

LastDGFEState

LastDGFEState DGFE State (Integer) [0-6]

Kind of access: READ

List of Property

LastDGFEUtil

LastDGFEUtil UTIL - DGFE Percentage of use (Integer) [1-99]
Kind of access: READ

List of Property

LastDGFENum

LastDGFENum Number of DGFE (Integer) [0-99]
Kind of access: READ

List of Property

Retry

Retry (Boolean)
setting this property TRUE the activeX uses the previous frame counter to manage a method. In this way it is possible to resend to a printer the previous request  relating to a method not close correctly.
Kind of access: READ/WRITE

List of Property

OCXBusy

OCXBusy (Boolean)
Provide indication if the Active is free to manage a new method.
True - it means that the ActiveX is busy to manage the new method
False - it means that the control is free to manage a new method
It is suggested to check this property before use a new method.
Kind of access: READ

List of Property

TimeoutOP

TimeoutOP (Integer)
Set or read the value of time-out (in seconds) needed to end a method. If the application SW does not set the time out value the default value is used.
Kind of access: READ/WRITE

List of Property

TimeoutACK

TimeoutACK (Integer)
Set or read the value of time-out (in seconds) needed to reply with a ACK to a request relating a method. If the application SW does not set the time out value the default value is used.
Kind of access: READ/WRITE

List of Property

LastTimeoutOP

LastTimeoutOP (Integer)
Provide the  value of the time out set from the application SW  in the previous method. This time -out is relating the max time needed to end a method. If the application SW does not set the time out value the default value is used.
Kind of access: READ

List of Property

LastTimeoutACK

LastTimeoutACK (Integer)
Provide the  value of the time out set from the application SW  in the previous method. This time -out is relating the max time from the end of request sent to the fiscal printer and the ACK from the printer. If the application SW does not set the time out value the default value is used.
Kind of access: READ

List of Property

LastGranTotale

LastGranTotale (Currency)
Amount of Gran Totale Kind of access: READ

List of Property

LastNumAzzeramenti

LastNumAzzeramenti (Long)
Number of reset Kind of access: READ

List of Property

LastIsPaymentLightGlobal

LastIsPaymentLightGlobal TRUE - If the payment amount is enough to complete the payment (Boolean)
Kind of access: READ

List of Property

ExtendedLicenseGraphic

ExtendedLicenseGraphic (Integer)
Read / Set the license to execute extended graphics methods
Kind of access: READ/WRITE

List of Property

ExtendedLicenseTicketing

ExtendedLicenseTicketing (Integer)
Read / Set the license to execute extended ticketing methods
Kind of access: READ/WRITE

List of Property

LastDescrRigaIntestazione

LastDescrRigaIntestazione (String) [27-40]
Row Header Description value
Kind of access: READ

List of Property

LastNumPromo

LastNumPromo (Integer) [1-999]
Promo identifier Number
Kind of access: READ

List of Property

LastTypePromo

LastTypePromo (enumEPS_PROMO_TYPE) [EPS_PROMO_EMPLOYEE, EPS_PROMO_MENU, EPS_PROMO_TICKET_SURPLUS]
Type of promotion
Kind of access: READ

List of Property

LastCodKeyPromo

LastCodKeyPromo (integer) [1-999]
Keyboard number to recall the promotion
Kind of access: READ

List of Property

LastBarcodePromo

LastBarcodePromo (string) [40 characters maximum]
Barcode to recall the promotion
Kind of access: READ

List of Property

LastDescPromo

LastDescPromo (string) [40 characters maximum]
Description of the promotion
Kind of access: READ

List of Property

LastPricePromo

LastPricePromo (currency) [0-9999999,99]
Value of the promotion
Kind of access: READ

List of Property

LastNRepPromo

LastPricePromo (integer) [1-40]
Sale department number related to the promotion
Kind of access: READ

List of Property

LastCodPLUPromo

LastCodPLUPromo (integer) [1-9999]
PLU number related to the promotion
Kind of access: READ

List of Property

LastTotOp1

LastTotOp1 (integer) [0-9999]
Promo - Number of operations 1
Kind of access: READ

List of Property

LastTotImp1

LastTotImp1 (Currency) [-9999999,99 - +999999,99]
Promo - Total Amount related to operations 1
Kind of access: READ

List of Property

LastTotOp2

LastTotOp2 (integer) [0-9999]
Promo - Number of operations 2
Kind of access: READ

List of Property

LastTotImp2

LastTotImp2 (Currency) [-9999999,99 - +999999,99]
Promo - Total Amount related to operations 2
Kind of access: READ

List of Property

LastPS2Key

LastPS2Key (Integer) [0-255]
Number of the key in the keyboard
Kind of access: READ

List of Property

LastPS2Fun

LastPS2Fun (Integer) [1 - 999]
Promo - Total Amount related to operations 2
Kind of access: READ

List of Property


PRINTER ERROR DESCRIPTION


Following is reported a new enumeration of CONSTANT related to enumEPS_OP_RETVALUE:

EERR = -1
Errors in the fiscal printer

ERROR DEFINITION TABLE

EERR Definition Code Description
EERR_CARTA_GIORNALE 01 Journal paper close to end.
EERR_CARTA_SCONTRINO 02 Receipt paper close to end
EERR_OFFLINE 03 Printer ERROR: Paper end OR Cover open OR ...
EERR_ERR_04 04 Not used
EERR_ERR_05 05 Not used
EERR_ERR_06 06 Not used
EERR_SLIP_KO 07 Slip printer not connected or not working
EERR_TASTO_ERRATO 08 Pushed a wrong key
EERR_DATA_INFERIORE 09 The date sent is before the expected value. It is not allowed to set a date before last daily closure.
EERR_DATA_ERRATA 10 At least a field of the date sent is out of range.
EERR_SEQUENZA_ERRATA 11 Command sequence not allowed. (i.e. an attempt to void a receipt already closed). 
EERR_DATI_INESISTENTI 12 Tried to read or write not existing data.
EERR_VALORE_ERRATO 13 Generic error message. A field of the record sent is not allowed
EERR_PROG_MATRICOLA 14 The printer has not been configured with the serial number yet.
EERR_GIA_ESISTENTE 15 Tried to perform an already done operation.
EERR_NON_PREVISTO 16 Generic error message. A index parameter not allowed (i.e.: Tax id = 5 when the number of taxes configured is = 4.
EERR_IMPOSSIBILE_ORA 17 Generic error message. The operation required is not allowed now. (i.e. tried to set up date and time without having performed a closure)
EERR_NON_POSSIBILE 18 Generic error message. The operation required is not allowed
EERR_SCRITTA_INVALIDA 19 The frame sent contains the character sequence "TOTALE" or other forbidden word inside.
EERR_SUPERA_VALORE 20 The number of digits of the last input variable (i.e. barcode) is greater than the maximum allowed.
EERR_SUPERA_LIMITE 21 The value sent for a variable is out of the range allowed.
EERR_NON_PROGRAMMATO 22 The command requires that some parameters must be previously configured.
EERR_CHIUDI_SCONTRINO 23 The maximum number of rows allowed for a receipt has been reached. The receipt must be closed performing the payment.
EERR_CHIUDI_PAGAMENTO 24 The maximum number of rows allowed for a receipt and the maximum number of partial payments have been reached. The receipt must be closed performing one global payment.
EERR_MANCA_OPERATORE 25 No operator have been selected while the device has been configured in order to use operators.
EERR_CASSA_INFERIORE 26 The amount in the cash (cash, checks, ...) is not enough for the required operation.
EERR_OLTRE_PROGRAMMAZ 27 The price field is greater than the maximum allowed.
EERR_PC_NON_COLLEGATO   Locally managed error. Communication time out error
EERR_MANCA_MODULO 29 Slip printer is without paper.
EERR_CHECKSUM_ERRATO 30 Checksum of the fiscal code is wrong
EERR_DATI_INESISTENTI_PC   Locally managed error. PC didn't return the required data because they are not existing.

 

 


CONSTANTS DESCRIPTION


Following is reported a new enumeration of CONSTANT related to "enumEPS_EUROSETTINGS":

Following is reported a new enumeration of CONSTANT related to "enumEPS_PAPER":

Following is reported a new enumeration of CONSTANT related to "enumEPS_COMM_MODALITY":

Following is reported a new enumeration of CONSTANT related to "enumTipoStampaVisSubTotale":

 

Following is reported a new enumeration of CONSTANT related to "enumSubRim":

RIM=2
Relating to Subtotal presentation

 

Following is reported a new enumeration of CONSTANT related to "enumEPS_OPCODE":

 

Following is reported a new enumeration of CONSTANT related to "enumEPS_PERIODO":

Following is reported a new enumeration of CONSTANT related to "enumEPS_ALIGNLIGHT":

Following is reported a new enumeration of CONSTANT related to "enumPAYMENT_TYPE":

ENUM DEFINTION TABLE

Enum Definition Constant name Value Comments
enum_EPS_EUROSETTINGS EPS_EUROSETTINGS_UNKNOWN 0  
EPS_EUROSETTINGS_LIRE 1  
EPS_EUROSETTINGS_EURO 2  
enumEPS_PAPER EPS_SCONTRINO 1  
EPS_GIORNALE 2  
EPS_SCONTRINO_GIORNALE 3  
enum_EPS_COMM_MODALITY EPS_SERIAL_COMM 1  
EPS_TCP_COMM 2  
enumEPS_PROMO_TYPE EPS_PROMO_EMPLOYEE 1  
EPS_PROMO_MENU 2  
EPS_PROMO_TICKET_SURPLUS 3  
enumEPS_PERIODO EPS_GIORNALIERO 1  
EPS_PERIODICO 2  
enumEPS_ALIGNLIGHT EPS_ALIGN_SX 1  
EPS_ALIGN_DX 2  
enumEPS_OPCODE OP_CODE_ASSEG_REST 1176  
OP_CODE_ASSEG_RIM 1175  
OP_CODE_CONT_REST 1172  
OP_CODE_CONT_RIM 1171  
OP_CODE_CONTDESC_REST 1183  
OP_CODE_CONTDESC_RIM 1182  
OP_CODE_CONTVAL_REST 1174  
OP_CODE_CONTVAL_RIM 1173  
OP_CODE_ASSEGVAL_REST 1178  
OP_CODE_ASSEGVAL_RIM 1177  
OP_CODE_SUBT 1051  
OP_CODE_SUBT_RIM 1181  
OP_CODE_TICKET_REST 1180  
OP_CODE_TICKET_RIM 1179  
OP_CODE_DGFENUMPRO_VAL 3100  
OP_CODE_DGFEDATE_VAL 3101  
OP_CODE_DGFE_END 3102  
enumTipoStampaVisSubtotale PRINT_AND_VIEW 0  
PRINT_ONLY 1  
VIEW_ONLY 2  
GET_ONLY 3  
enumSubRim SUBTOTAL 1  
RIM 2  
enumPAYMENT_TYPE PAY_CASH 0  
PAY_CHECK 1  
PAY_CC 2  
PAY_TICKET 3  
enumEPS_OP_RETVALUE OP_OK 0  
OP_ERR_NOCOLL 1  
OP_ERR_PORTCLOSE 2  
OP_ERR_TIMEOUT 3  
OP_ERR_CHKS 4  
OP_ERR_EUROLOCK 5  
OP_ERR_FILENOTFOUND 6  
OP_ERR_ACKTIMEOUT 7  
OP_ERR_STXTIMEOUT 8  
OP_ERR_OCXBUSY 9  
OP_ERR_EXTENDEDGRAPHICLICENSENOTFOUND 10  
OP_ERR_EXTENDEDTICKETINGLICENSENOTFOUND 11  
OP_ERR_CREATESOCKETFAILED 12  
OP_ERR_TCPCONNFAILED 13  
OP_ERR_RECEIVE_TIMEOUT 14  
OP_ERR_RECEIVE_NODATA 15  

 


CHARACTER SET

Fiscal printer manages a limited character set when required to print text rows. The character set managed depends upon the printer model and, in case of FP90 upon the firmware release.


Printers P210, FP260, FP285 and FP90 (until release 1.00F)

The character set recognised by the above printers is the subset included between the characters 20h (32, 0010 0000B) and 7Fh (127, 0010 1111B ) with the exclusion of the characters “{”, “|” e “}”.

The following table shows the set of character managed.

If a text sent to the fiscal printer includes characters that are different the than the ones admitted, the characters themselves will not be printed and replaced by spaces.

 

 

Printer FP90 (since release 2.00) 


Since release 2.00 FP90 Fiscal Printer is able to manage also the characters included in the range 80h – 9Fh.

It must be considered that these characters are related to page 0 (PC437 USA) so it's required that the PC must be compliant with this requirement. Otherwise it's possible to send the ASCII code (es.: chr$(138) to get the "è" character to be printed).

If a text sent to the fiscal printer includes characters that are different the than the ones admitted, the characters themselves will not be printed and replaced by spaces.

 

 


EVENT DESCRIPTION


 


DESCRIPTION OF PARAMETERS


    CodOpr (Operator Code)

    NumeroOperatore (operator number)

  DescProd (product description)

   Prezzo (price)

    Rep (department description)

    NumRep (number of the department)

    DescReparto (department description)

    GruppoStampa 

    SuperGruppoMerceologico (association of product)

    UMFattura (kind of q.ty for invoice)

    NTassaRep (VAT number and department cross reference)

    NTassa (VAT number)

    Aliquota (VAT description)

    NValuta (number of currency)

    DescValuta (description of the currency)

    TipoPrezzo (kind of price)

    Prezzo1 (price 1)

    Prezzo2 (price 2)

    Prezzo3 (price 1)

    Limite (max value)

    Item

   CodProd

    Qta (quantity)

    QtaDec (quantity with decimal value)

    Importo (amount)

    ImportoValuta (amount of currency)

    ImportoAssegno (amount of check)

    Perc (percentage)

    PercReparto (percentage Department)

    NCartaCC (number of credit card)

    DescCartaCC (credit card description)

    NTipoTicket (Number of ticket)

    DescTicket (ticket description)

    ValoreTicket (value of the tocket)

    ValoreValuta (value of the currency)

Descr (desription)

    NRiga (number of row)

    DescRiga (Row description)

    Font

    NrigaInt

    DescInt

    NumFlag

    Flag

    NumConf

    Conf

    DescOpr

    CodOprSegr

    PerOpr

    NValuta

    DescValuta

    ValoreValuta

    ImportoValuta

    PercReparto

    TipoCarta (Kind of paper)