TKRP_GENERIC_10

This driver manages the communication to non-fiscal devices such as normal printers and thermal printers.

The layout of the document is defined by a Layout Document. As by now the Layout Document name is fixed as DocumentLayout.utdl. Future releases will allow to specify the Layout Document Name.

Due to the variety of the devices supported, it is possible (and in some case mandatory) to specify parameter values in the related section of the XML document.

Allowed parameters are:

Name	Values	Remarks	Mandatory
Protocol	epos	HTTP only	Yes
	escpos	SPOOL and TCP
	image	SPOOL only
	toshiba4610	SPOOL only
Dialect		Standard protocol	No
Dialect	bixolon	Bixolon Printer (esc-pos only)	No
DeviceModel	<various>	Used to map different font types depending on the printer model	No
LineLength	<integer>	Number of characters per line (fixed spacing) Default = 46 If the Layout specify a LineLength value, this value will be ignored	No
NumberingSequence	<string>	Specifies the sequence to be used to assign a number to the receipt. If empty, the number will be assigned or by the POS application or by the Fiscal Processor (if used). It is possible to specify a list of the following values separated by commas: Store Till Year Month Day For example, if the NumberingSequence is set to “Store,Till,Day” the receipt number will be different (starting from 1) per Store,Till,Day.	No
XZReport	<boolean>	If true, the driver keeps locally the sales total so that it is able to autonomously print XReports and ZReports. If NumberingSequence is specified, XZReport is always true and there is no need to specify it	No
MailReceiptServerURL	<string>	URL of the server used to send the Receipt via Email	No

Sending Receipts by eMail

The email is sent by a Vibecode Server.
The server URL must be included or in the MailReceiptServerURL parameter or can be set in the configuration file TKRP_GENERIC_10.cfg.

The URL has the following structure:
http[s]://SERVERADDRESS/ENVIRONMENT/V2.0/api/POSible_EpsonReceiptUpload?TemplateCode=EMAILTEMPLATE&Authorization=Bearer BEARER TOKEN

If the URL is set in TKRP_GENERIC_10.cfg file, the parameter name is eReceiptServer

Example

CODE

eReceiptServer=https://myserver.com/MYENV/V2.0/api/POSible_EpsonReceiptUpload?TemplateCode=MYTEMPLATE&Authorization=Bearer MYBEARER

Change History

Version	Release Date	Notes	Download
1.46	05/02/2025	Aggiunto supporto parametro “dialect”	TKRP_GENERIC_0146.zip
1.45	17/10/2024	Corretto errore in serializzazione CustomAttributes di kReceipt	TKRP_GENERIC_0145.zip
1.44	23/09/2024	Aumentato retry lock contatori da 5 a 20
1.43	01/08/2024	Corretta stampa barcode Interleaved 2 of 5 su ESCPOS
1.42	11/06/2024	Aggiunto supporto Code Page e Layout in Z-Report
1.41	28/05/2024	Aggiunta gestione conversione dalla code page passata nel parametro CP a UTF-8
1.40	26/02/2024	Attivata possibilità di ristampa documenti
1.39	10/10/2023	Calcolo del resto e assegnazione del valore alla variabile ChangeAmount
1.38	08/08/2023	Predisposizione gestione Code Page differenti da Latin-1 Gestione Code Page Greek
1.37	05/06/2023	Aggiunta variabile CustomerCountryDescription
1.36	04/04/2023	Aggiunto possibilità stampa Z-Report con testo definito dal chiamante anche senza gestione del processore fiscale
1.35	01/04/2023	Aggiunto parametro MailReceiptServerURL Aggiunta definizione LineLength in DocumentLayout Modificato processo di invio mail per evitare mail duplicate in caso di apertura di istanze multiple del driver
1.34	31/01/2023	Migliorato supporto Toshiba4610 Se connessione TCP forzata disconnessione iniziale perchè non necessaria Corretta anomalia Toshiba 4610 se CharHeight non impostato Corretta anomalia in allineamento a destra stringhe Ridotto margine a 5px in generazione PDF Corretta anomalia in serializzazione Devicehandler Se non specificato Imagesource, prende Filesystem come default"
1.33	23/01/2023	Corretta anomalia in totalizzatori giornalieri
1.32	03/01/2023	Ricevuta via mail in formato PDF
1.31	27/12/2022	Aggiunta possibilità di invio via mail della ricevuta attraverso Vibecode
1.30	29/08/2022	Aggiunto Driver Text e possibilità di ritornare il testo della ricevuta
1.29	20/08/2022	Esposta variabile TotalNoSubTotalDiscountsPercentage Esposta variabile -TotalNoSubTotalDiscountsPercentage
1.28	10/08/2022	Corretto errore in espressione condizionale numerica con valori negativi
1.27	10/07/2022	Aggiunte gestione proprietà OriginalReceipt.References.InvoiceNumber e OriginalReceipt.References.InvoiceDateTime Esposta variabile TotalNoSubTotalDiscounts Esposta variabile -TotalNoSubTotalDiscounts Esposta variabile NetAmountNoSubTotalDiscounts Corretta anomalia gestione HRI su Barcode
1.26	08/05/2022	Esposta variabile -Amount per sconti
1.25	05/05/2022	Corretto errore in picture date
1.24	24/04/2022	Modificato livello ECL in stampa QRCode da L a M Introdotta possibilità di specificare il livello minimo di versione per la stampa di QRCode
1.23	06/03/2022	Aggiunta Gestione Nativa per X-Report e Z-Report [solo se numerazione gestita internamente dal driver] Risolto errore in caso di allocazione del file di numeratori. Vengono adesso eseguiti 5 tentativi prima di ritornare errore
1.22	19/02/2022	Risolti problemi encoding. Vengono ora utilizzati Array di Bytes e non più stringhe
1.21	30/09/2021	RT Server: Corretto errore mancata stampa X e Z Report
1.20	28/09/2021	Gestione messaggi di errore su protocollo ePOS
1.19	20/09/2021	Aggiunta Scritta 'Resto' per ServerRT
1.18	25/08/2021	Corretto errore in formattazione importo riga pagamenti
1.17	24/08/2021	Aggiunta stampa immagini da risorse o filesystem
1.16	20/08/2021	Aggiunta numerazione scontrini tramite il parametro 'NumberingSequence'
1.15	19/08/2021	Aggiunta stampa intestazione in caso di formato NON default Corretto errore in allineamento centrato Aggiunta stampa formati LinesH, LinesF, NFLinesH, NFLinesF Aggiunto allineamento valori colonne Corretto errore in VoucherSale Resettati attributi di stampa ove necessario Aggiunto TipAmount in Receipt Aggiunti valori TotalAmountTaxes, TotalAmountNoTaxes, TotalAmountDue
1.14	30/07/2021	Rimossa forzatura allineamento righe
1.13	23/07/2021	Corretto errore in risoluzione variabili multiple sulla stessa riga Aggiunto supporto NewLine=False Aggiunta stampa Tasse e Pagamenti in caso di utilizzo formato non standard
1.12	22/07/2021	Eliminato AV qualora non venga ritornato il numero di chiusura fiscale
1.11	25/06/2021	Aggiunta X-Report e Z-Report su Processore Fiscale
1.10	23/06/2021	Aggiunta Gestione Processore Fiscale Aggiunta Formattazione di Default del documento di vendita
1.09	22/06/2021	Corretta anomalia in apertura cassetto
1.08	19/06/2021	RT Server: Corretto calcolo totale in caso di omaggi RT Server: Corretta scritta NA in caso di reso/annullo senza riferimenti RT Server: Corretto errore stampa ripetuta delle esenzioni IVA a piede documento RT Server: Corretto errore in attribuzione aliquota IVA su SpecialAdjustment
1.07	29/05/2021	Corretta anomalia formattazione righe in caso di Server RT
1.06	29/05/2021	Rimosso AV in chiusura connessione se RT Server connesso
1.05	28/05/2021	Inserito supporto caratteri speciali Inserito supporto barcode Interleaved2of5 Inserito supporto InvertColors
1.04	27/05/2021	Corretta Anomalia in caricamento DLL RTServer di default
1.03	21/05/2021	Corretta Anomalia stampa TrailMessages
1.02	19/05/2021	Getstatus ora ritorna data e ora del computer In caso di errore durante la Open adesso viene ritornato il messaggio di errore
1.01	19/05/2021	RIlascio RC1
1.00	30/04/2021	Rilascio Iniziale