THE FACTORY HKA

Soporte e Integracin

Librera TfhkaNet
Manual de Integracin

SOPORTE E INTEGRACIN

Manual de Integracin
Revision 1.0

The Factory HKA

La California Norte, Callejn Gutirrez
Edif. Riva, PB Ofic. 2-1
Caracas - Venezuela
Telfono (212) 237.4112 Fax (212) 239.8176

Historial de Revisiones
Revisin

Fecha

1.o

02/05/14

Paginas
Afectadas
Todas

Comentario
Versin inicial

ndice
Capitulo 1 .......................................................................................................... 1
Introduccin .............................................................................................................. 1
Resumen .................................................................................................................... 1
Requerimientos de Hardware ................................................................................. 2
Requerimientos de Software ................................................................................... 2

Capitulo 2 .......................................................................................................... 3
Instalacin ................................................................................................................. 3
Instalacin .................................................................................................... 3
Alcance de la librera ................................................................................................ 6

Capitulo 3 .......................................................................................................... 7
Importacin y Declaraciones .................................................................................. 7
Mtodos de la clase Tfhka ....................................................................................... 9
OpenFpctrl .................................................................................................. 9
CloseFpctrl................................................................................................... 9
CheckFprinter ............................................................................................. 9
CheckDrawer............................................................................................. 10
ReadFpStatus ............................................................................................. 10
SendCmd .................................................................................................... 10
SendFileCmd ............................................................................................. 11
UploadReportCmd ................................................................................... 11
UploadStatusCmd ..................................................................................... 11
Atributos pblicos orientados a objetos de la Clase Tfhka .............................. 13
StatusErrorPrinter tipo PrinterStatus..................................................... 13
GetZReport tipo ReportData ................................................................. 13
GetS1PrinterData tipo S1PrinterData ................................................... 14
GetS2PrinterData tipo S2PrinterData ................................................... 14
GetS3PrinterData tipo S3PrinterData ................................................... 14
GetS4PrinterData tipo S4PrinterData ................................................... 15
GetS5PrinterData tipo S5PrinterData ................................................... 15
GetS6PrinterData tipo S6PrinterData ................................................... 15
GetS7PrinterData tipo S7PrinterData ................................................... 15
GetS8EPrinterData tipo S8PrinterData ................................................ 15
GetS8PPrinterData tipo S8PrinterData................................................. 16
PrinterException ....................................................................................... 16
Mtodos pblicos orientados a objetos de la Clase Tfhka de Objetos........... 17
GetPrinterStatus........................................................................................ 17
GetXReport ............................................................................................... 17
GetX2Report ............................................................................................. 17

GetX4Report ............................................................................................. 18
GetX5Report ............................................................................................. 18
GetX7Report ............................................................................................. 18
GetZReport ............................................................................................... 19
PrintZReport ............................................................................................. 20
PrintXReport ............................................................................................. 21
GetS1PrinterData ..................................................................................... 21
GetS2PrinterData ..................................................................................... 21
GetS2EPrinterData .................................................................................. 21
GetS21PrinterData ................................................................................... 22
GetS22PrinterData ................................................................................... 22
GetS23PrinterData ................................................................................... 22
GetS24PrinterData ................................................................................... 23
GetS25PrinterData ................................................................................... 23
GetS3PrinterData ..................................................................................... 23
GetS4PrinterData ..................................................................................... 24
GetS5PrinterData ..................................................................................... 24
GetX4Report ............................................................................................. 24
GetX5Report ............................................................................................. 25
Anexos ..................................................................................................................... 26
ANEXO 1: Lista de cdigos de Status .................................................. 26
ANEXO 2: Lista de cdigos de Error ................................................... 27
ANEXO 3: Ejemplo bsico de emisin de Factura para Consumidor
Final ............................................................................................................ 28

T H E

F A C T O R Y

Captulo

H K A

Introduccin
La librera TfhkaNet permite la integracin con sistemas
administrativos desarrollados bajo la tecnologa de .NET; como lo
son C#, J#, VB.NET y ASP

Resumen

n las siguientes pginas se describen los detalles de la interfaz de aplicacin

TfhkaNet, desde los requerimientos de hardware, le referencia a la librera
de integracin, los componentes adicionales tales como libreras dinmicas y
finalmente la estructura de la Clase compilada que contiene los mtodos y
propiedades para el uso de cualquiera de las impresoras distribuidas por The Factory
HKA a travs de un sistema administrativo desarrollado en .NET.

T H E

F A C T O R Y

H K A

Requerimientos de Hardware

Procesador de 1Ghz o superior

Memoria RAM de 512MB o superior

Espacio

Puerto

libre

en

Serial

Disco
fsico

Duro
o

de

50MB

USB

2.0

en

.NET

Requerimientos de Software

Sistema Operativo Windows

IDE
para
manejar

un

desarrollo

T H E

F A C T O R Y

H K A

Captulo

Instalacin
En el SDK descargado, usted se encontrar con las tres herramientas bsicas para
realizar la integracin del sistema administrativo con nuestra impresora fiscal; la librera
de integracin (TfhkaNet.dll), el manual de dicha librera y un demo funcional de
cdigo abierto en donde se ejemplifica el uso de la librera de forma prctica.
Instalacin
Antes de comenzar a hacer uso de la librera en el desarrollo, lo primero que se debe
hacer es incluir y referenciar la librera en nuestro proyecto. Esto se consigue siguiendo
los siguientes pasos:
1. Creamos un nuevo Proyecto.

T H E

F A C T O R Y

H K A

2. Agregamos la referencia a la librera de integracin, desde nuestro IDE.

Esta normalmente se encuentra localizada en la ruta: TFHKA SDK

.NET\TFHKA_DemoC_SharpNET\DemoInf_C_SharpNET\bin\Debug

T H E

F A C T O R Y

H K A

3. Una vez tenemos nuestra referencia a la librera implementada en nuestro

proyecto, ya podemos hacer uso de ella. Para comenzar debemos incluir los
mtodos a utilizar de la librera, de la siguiente manera:

4. Finalmente, creamos dos variables para trabajar la clase durante el uso de

nuestro desarrollo e inicializamos un objeto de tipo Tfhka que es el que manejara
los distintos mtodos y funciones a utilizar para interactuar con la impresora fiscal.

Acto seguido, nos encontramos listos para empezar a utilizar los mtodos y
funciones que contiene la clase Tfhka.

T H E

F A C T O R Y

H K A

Alcance de la librera
La librera TfhkaNet es compatible con cualquier desarrollo cuya base sea la tecnologa
.NET.

T H E

F A C T O R Y

H K A

Captulo

Importacin y Declaraciones
Una vez agregada la referencia de la clase TfhkaNet a la Solucin e importado el
espacio de nombre respectivo se puede empezar a trabajar con la clase Tfhka, con sus
atributos y mtodos pblicos.
using TfhkaNet.IF;
using TfhkaNet.IF.VE;

1.

Declaracin de un objeto tipo Tfhka.

<Tipo de modificador> Tfhka <Nombre del Objeto>

Ejemplos:
private Tfhka Impresora;
public Tfhka Impresora;

2.

Inicializacin del objeto Tfhka.

La clase Tfhka tiene dos constructores, uno por defecto y otro que recibe
como parmetro un String o cadena de carcter con el nombre del puerto serial o
terminal serial.
Constructor 1:
<Nombre del Objeto> = new Tfhka();
Este solo inicializar las propiedades del objeto fiscal.
Constructor 2:
<Nombre del Objeto> = new Tfhka(<Nombre del Puerto serial>);
Este adems de inicializar las propiedades del objeto fiscal, abre puerto y
verifica comunicacin.
Ejemplos:
Impresora = new Tfhka ( COM1 );

T H E

F A C T O R Y

H K A

Si el parmetro <nombre de puerto serial> est correctamente escrito, al

efectuar esta inicializacin se define el Terminal de la clase o String nombre de puerto,
se abre si no est en uso y se define el estado del mismo por medio de la variable global
booleana StatusPort, donde siendo su valor true si el puerto fue abierto exitosamente o
false si el puerto est cerrado o no pudo ser abierto.
Si se usa el constructor por defecto solo se inicializan las propiedades
fundamentales de la interface, en este escenario posteriormente se debe usar el mtodo
correspondiente para realizar la apertura del puerto, que es el que se explica adelante.

T H E

F A C T O R Y

H K A

Mtodos de la clase Tfhka

OpenFpctrl
BOOLEAN OpenFpctrl(String IpPortName)
Permite realizar la apertura del puerto de comunicaciones por el cual se
establecer comunicacin con la impresora. Este mtodo se ejecuta en
el constructor nico de la clase, pero puede ser ejecutada nuevamente
de ser requerido.
Parmetros:

String IpPortName: Nombre del puerto COM a abrir.

Retorno:
True: Puerto Abierto
False: Falla en apertura
CloseFpctrl
VOID CloseFpctrl()
Permite cerrar del puerto COM asociado, abierto anteriormente
Retorno:
Esta funcin devuelve un booleano en donde si el mismo es
verdadero, significa que se ha cerrado el puerto de comunicaciones
con xito, de lo contrario no se cerr el puerto de comunicaciones.
CheckFprinter
BOOLEAN CheckFprinter()
Permite verificar si la impresora est conectada al PC.
Retorno:
True: impresora conectada.
False: impresora no detectada.

T H E

F A C T O R Y

H K A

CheckDrawer
BOOLEAN CheckDrawer()
Permite verificar si la gaveta de dinero est conectada al PC.
Retorno:
True: Gaveta conectada.
False: Gaveta no detectada.
ReadFpStatus
BOOLEAN ReadFpStatus()
Permite leer las variables de estado y error de la impresora. Al ejecutar
este mtodo se establece el valor de la variable tipo String Estado. (Ver
Anexos 1 y 2)
Retorno:
True: Mtodo ejecutado exitosamente
False: Error en ejecucin del mtodo
Nota: En la librera .NET esta funcin esta obsoleta y no se recomienda su uso, ser
eliminada en futuras versiones de la librera, use la funcin GetPrinterStatus().

SendCmd
BOOL SendCmd(String Cmd)
Permite realizar el envo de comandos hacia la impresora, en forma de
tramas de caracteres ASCII, tal como es descrito en los manuales de
integracin de las respectivas impresoras, y en el manual general de
protocolos y comandos del protocolo TFHKA.
Parmetros:

String cmd: trama de comando en ASCII que se enviara a la

impresora.
Retorno:
True: Mtodo ejecutado exitosamente.

10

T H E

F A C T O R Y

H K A

False: Error en ejecucin del mtodo.

SendFileCmd
INT SendFileCmd(String rutafile)
Permite realizar el envo de un archivo de lotes de comando hacia la
impresora.
Parmetros:

String rutaFile: ruta en la cual se encuentra el archivo de comandos

por lote que se enviar a la impresora.
Retorno:
(int) Nmero de lneas del archivo de lotes de comandos ejecutadas
exitosamente.
UploadReportCmd
BOOLEAN UploadReportCmd(String cmd, String file)
Permite almacenar en un archivo de texto simple, un reporte de la
impresora.
Parmetros:

String cmd: tipo de reporte a solicitar. Los reportes que pueden ser

solicitados son los siguientes (consultar manual general de integracin

de
las
respectivas
impresoras):
-

U0X

U0Z

U1Z

U1X

String file: ruta del archivo donde se almacenar el reporte solicitado.

Retorno:
True: Mtodo ejecutado exitosamente.
False: Error en ejecucin del mtodo.
UploadStatusCmd
BOOLEAN UploadStatusCmd(String cmd, String file)

11

T H E

F A C T O R Y

H K A

Esta funcin permite almacenar en un archivo de texto simple, un

status de la impresora.
Parmetros:

String cmd: tipo de Status a solicitar. Los Status que pueden ser
solicitados
-

son

S1
S2
S3

los

S4
S5
S8E

siguientes:

S8P

String file: ruta del archivo donde se almacenar el Status solicitado.

Retorno:
True: Mtodo ejecutado exitosamente.
False: Error en ejecucin del mtodo.

12

T H E

F A C T O R Y

H K A

Atributos pblicos orientados a objetos de la Clase

Tfhka
StatusErrorPrinter tipo PrinterStatus
Representa una estructura que establece y retorna los parmetros de
Status y Error de la impresora fiscal cunado se ejecuta el mtodo
correspondiente. Sus elementos son los siguientes.
0) bool ErrorValidity: Validez del Error
1) int PrinterErrorCode: Valor entero del Error (Ver Anexo 2)
2) string PrinterErrorDescription: Descripcin del Error.
3) int PrinterStatusCode: Valor entero del Status (Ver Anexo 1)
4) string PrinterStatusDescription: Descripcin del Status.

GetZReport tipo ReportData

Representa una estructura que contiene todos los datos de los
reportes X y Z cuando se envan al PC con los mtodos
correspondientes. Sus elementos son los siguientes:
0) double AdditionalRate3Sale: BI Adicional del IVA 3
1) double AdditionalRate3Tax: IVA Adicional o tasa 3
2) double AdditionalRateDebit: BI Adicional en Nota Debito
3) double AdditionalRateDevolution: BI Adicional Devolucion
4) double AdditionalRateTaxDebit: IVA Adicional en Nota Debito
5) double AdditionalRateTaxDevolution: IVA Adicional en Devolucion
6) double FreeSalesTax: Monto Exento
7) double FreeTaxDebit: Exento en Nota Debito
8) double FreeTaxDevolution: Exento en Devolucin
9) double GeneralRate1Sale: BI General del IVA 1
10) double GeneralRate1Tax: IVA General o tasa 1
11) double GeneralRateDebit: BI General en Nota Debito
12) double GeneralRateDevolution: BI General Devolucin
13) double GeneralRateTaxDebit: IVA General en Nota Debito
14) double GeneralRateTaxDevolution: IVA General en Devolucion
15) DateTime LastInvoiceDate: Fecha Ultima Factura
16) int NumberOfLastCreditNote: Ultima Nota de Credito
17) int NumberOfLastDebitNote: Ultima Nota de Debito
18) int NumberOfLastInvoice: Ultima Factura
19) int NumberOfLastNonFiscal: Utimo Documento No Fiscal
20) int NumberOfLastZReport: Ultimo Reporte Z
21) double ReducedRate2Sale: BI Reducida del IVA 2
22) double ReducedRate2Tax: IVA Reducido o tasa 2
23) double ReducedRateDebit: BI Reducido en Nota Debito
24) double ReducedRateDevolution: BI Reducido Devolucion
25) double ReducedRateTaxDebit: IVA Reducido en Nota Debito
26) double ReducedRateTaxDevolution: IVA Reducido en Devolucion
27) DateTime ZReportDate: Fecha Ultimo Reporte Z

13

T H E

F A C T O R Y

H K A

GetS1PrinterData tipo S1PrinterData

Representa la estructura de datos del estado S1 que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
0) int AuditReportsCounter: Contador de reporte de auditora
1) int CashierNumber: Numero de Cajero Asignado
2) DateTime CurrentPrinterDateTime: Fecha y hora de la impresora
3) int DailyClosureCounter: Contador de Cierre Diario
4) int LastCreditNoteNumber: Nmero de la ltima Nota de Crdito
5) int LastDebitNoteNumber: Numero de la ltima Nota de Debito
6) int LastInvoiceNumber: Nmero de la ltima factura emitida
7) int LastNonFiscalDocNumber: Nmero del ltimo Documento No Fiscal
8) int QuantityNonFiscalDocuments: Cantidad de Documentos No Fiscales
9) int QuantityOfCreditNotesToday: Cantidad de Notas de Crdito en el da
10) int QuantityOfDebitNotesToday: Cantidad de Notas Debito en el da
11) int QuantityOfInvoicesToday: Cantidad de facturas en el da
12) string RegisteredMachineNumber: Serial de la impresora fiscal
13) string RIF: RIF de fiscalizacin de la impresora fiscal
14) double TotalDailySales: Monto total de ventas diarias

GetS2PrinterData tipo S2PrinterData

Representa la estructura de datos del estado S2 que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
0) double AmountPayable: Monto Por Pagar
1) int Condition: Condicin de Transaccin
2) string DataDummy: Data de relleno.
3) int NumberPaymentsMade: Cantidad de Pagos Realizados
4) int QuantityArticles: Cantidad de Artculos
5) double SubTotalBases: Subtotal Bases Imponibles
6) double SubTotalTax: Subtotal IVA
7) int TypeDocument: Tipo de Documento

GetS3PrinterData tipo S3PrinterData

Representa la estructura de datos del estado S3 que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
0) int[ ] AllSystemFlags: Todas las banderas
1) double Tax1():Valor de la tasa 1 (%)
2) double Tax2():Valor de la tasa 2 (%)
3) double Tax3():Valor de la tasa 3 (%)
4) int TypeTax1(): Tipo de tasa 1 (Modo Incluido = 1, Modo Excluido = 2)
5) int TypeTax2(): Tipo de tasa 2 (Modo Incluido = 1, Modo Excluido = 2)
6) int TypeTax3(): Tipo de tasa 3 (Modo Incluido = 1, Modo Excluido = 2)

14

T H E

F A C T O R Y

H K A

GetS4PrinterData tipo S4PrinterData

Representa la estructura de datos del estado S4 que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes
double[] AccumulatedMountsAllMeansOfPayment: Lista de los
montos acumulados de los 15 medios de pagos de la impresora fiscal, y
del monto correspondiente a las donaciones.
GetS5PrinterData tipo S5PrinterData
Representa la estructura de datos del estado S5 que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
0) double AuditMemoryFreeCapacity: Disponibilidad Memoria Auditoria (MB)
1) int AuditMemoryNumber: Nmero de memoria de auditoria
2) double AuditMemoryTotalCapacity: Capacidad Memoria Auditoria (MB)
3) int NumberRegisteredDocuments: Cantidad Documentos Memoria Auditoria
4) string RegisteredMachineNumber: Serial de la impresora fiscal
5) string RIF: RIF de fiscalizacin de la impresora

GetS6PrinterData tipo S6PrinterData

Representa la estructura de datos del estado S6 que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
0) string Bit_Facturacion(): Indica la presencia de papel en la estacin de facturacin.
1) string Bit_Slip(): Indica la presencia de papel en la estacin de Slip/Chequera.
2) string Bit_Validacion(): Indica la presencia de papel en la estacin de Validacin.

GetS7PrinterData tipo S7PrinterData

Representa la estructura de datos del estado S6 que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
String MICR(): Lectura del MICR del cheque
GetS8EPrinterData tipo S8PrinterData
Representa la estructura de datos del estado S8E que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
string Header1: Encabezado, lnea numero 1.
string Header2: Encabezado, lnea numero 2.
string Header3: Encabezado, lnea numero 3.
string Header4: Encabezado, lnea numero 4.

15

T H E

F A C T O R Y

H K A

string Header5: Encabezado, lnea numero 5.

string Header6: Encabezado, lnea numero 6.
string Header7: Encabezado, lnea numero 7.
string Header8: Encabezado, lnea numero 8.

GetS8PPrinterData tipo S8PrinterData

Representa la estructura de datos del estado S8P que se establece
cuando se sube al PC con su mtodo correspondiente. Sus elementos
son los siguientes:
string Footer1: Pie de Pagina, lnea numero 1.
string Footer2: Pie de Pagina, lnea numero 2.
string Footer3: Pie de Pagina, lnea numero 3.
string Footer4: Pie de Pagina, lnea numero 4.
string Footer5: Pie de Pagina, lnea numero 5.
string Footer6: Pie de Pagina, lnea numero 6.
string Footer7: Pie de Pagina, lnea numero 7.
string Footer8: Pie de Pagina, lnea numero 8.

PrinterException
Representa un tipo de excepcin que arrojan algunos mtodos de
creacin de objetos de las estructuras anteriormente definidas cuando
ocurre un error en la transaccin con la impresora fiscal. Est
compuesto por los siguientes elementos:
PrinterStatus StatusError(): retorna un objeto que contiene
informacin del Status y el Error al momento de generarse la
excepcin.
Message(): Contiene la descripcin de la excepcin arrojada.

16

T H E

F A C T O R Y

H K A

Mtodos pblicos orientados a objetos de la Clase

Tfhka de Objetos
GetPrinterStatus
PrinterStatus GetPrinterStatus()
Obtiene un reporte del Status y Error de la impresora en un objeto del
tipo PrinterStatus que contiene el cdigo y una descripcin tanto para el
Status como para el Error actual.
Retorno:
Un objeto de tipo PrinterStatus con los valores correspondientes a la
repuesta.
GetXReport
ReportData GetXReport() throws PrinterException
Obtiene un reporte X desde la impresora.
Retorno:
Un objeto de tipo ReportData con los valores correspondientes al
reporte.
Excepcin:
Arroja la excepcin PrinterException
GetX2Report
ReportData GetX2Report() throws PrinterException
Sube al PC un reporte X2 por medio del comando U1X
actualizando sus valores de data.
Retorno:
Un objeto de tipo ReportData con toda la informacin para la carga
de un reporte X2 actual.

17

T H E

F A C T O R Y

H K A

Excepcin:
Arroja la excepcin PrinterException
GetX4Report
ReportData GetX4Report() throws PrinterException
Sube al PC un reporte X4 por medio del comando U0X4
actualizando sus valores de data.
Retorno:
Un objeto de tipo ReportData en la variable global ReportePC con
toda la informacin para la carga de un reporte X4 actual.
Excepcin:
Arroja la excepcin PrinterException
GetX5Report
ReportData GetX5Report() throws PrinterException
Sube al PC un reporte X5 por medio del comando U0X5
actualizando sus valores de data.
Retorno:
Un objeto de tipo ReportData en la variable global ReportePC con
toda la informacin para la carga de un reporte X5 actual.
Excepcin:
Arroja la excepcin PrinterException
GetX7Report
ReportData GetX7Report() throws PrinterException
Sube al PC un reporte X7 por medio del comando U0X7
actualizando sus valores de data.
Retorno:
Un objeto de tipo ReportData en la variable global ReportePC con
toda la informacin para la carga de un reporte X7 actual.

18

T H E

F A C T O R Y

H K A

Excepcin:
Arroja la excepcin PrinterException
GetZReport
ReportData GetZReport() throws PrinterException
Sube al PC un reporte Z por medio del comando U0Z actualizando
sus valores de data.
Retorno
Un objeto de tipo ReportData en la variable global ReportePC con
toda la informacin del ltimo reporte Z emitido.
Excepcin
Arroja la excepcin PrinterException.
ReportData[] GetZReport(string StartDate, string EndDate) throws
PrinterException
Realiza una lectura de memoria fiscal por rango de fecha.
Parmetros:

StartDate: Fecha del reporte Z inicial.

EndDate: Fecha de reporte Z final.
Retorno:
Una lista de objetos ReportData con la informacin de los reportes Z
comprendidos en el intervalo solicitado.
Excepcin:
Arroja la excepcin PrinterException
ReportData[]
GetZReport(int
StartReportNumber,
EndReportNumber ) throws PrinterException
Realiza una lectura de memoria fiscal por rango de nmeros.
Parmetros:

StartReportNumber: Numero del reporte Z inicial.

19

int

T H E

F A C T O R Y

H K A

EndReportNumber: Numero de reporte Z final.

Retorno:
Una lista de objetos ReportData con la informacin de los reportes Z
comprendidos en el intervalo solicitado.
Excepcin:
Arroja la excepcin PrinterException
PrintZReport
VOID PrintZReport() throws PrinterException
Imprime el Reporte Diario Z
Excepcin
Arroja la excepcin PrinterException
VOID PrintZReport(int StartReportNumber, int EndReportNumber)
throws PrinterException
Imprime un histrico de reportes Z por rango de nmeros
Parmetros

StartReportNumber: Nmero de reporte Z inicial.

EndReportNumber: Nmero de reporte Z final.
Excepcin
Arroja la excepcin PrinterException
VOID PrintZReport(Date
PrinterException

StartDate,

Date

EndDate)

Imprime un histrico de reportes Z por rango de fechas

Parmetros

StarDate: Fecha de reporte Z inicial.

EndDate: Fecha de reporte Z final.

20

throws

T H E

F A C T O R Y

H K A

Excepcin
Arroja la excepcin PrinterException

PrintXReport
VOID PrintXReport() throws PrinterException
Imprime el Reporte Diario X
Excepcin
Arroja la excepcin PrinterException
GetS1PrinterData
S1PrinterData GetS1PrinterData() throws PrinterException
Sube el estado S1 de la Impresora fiscal al PC y Sube el estado S1 de la
Impresora fiscal al PC y actualiza sus valores de data.
Retorno:
Un objeto de tipo S1PrinterData en la variable global S1Estado.
Excepcin:
Arroja la excepcin PrinterException.
GetS2PrinterData
S2PrinterData GetS2PrinterData() throws PrinterException
Sube el estado S2 de la Impresora fiscal al PC y actualiza sus valores de
data.
Retorno
Un objeto de tipo S2PrinterData en la variable global S2Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS2EPrinterData
S2PrinterData GetS2EPrinterData() throws PrinterException
21

T H E

F A C T O R Y

H K A

Sube el estado S2 correspondiente a los montos exentos de la

transaccin actual al PC y actualiza sus valores de data.
Retorno
Un objeto de tipo S2PrinterData en la variable global S2Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS21PrinterData
S2PrinterData GetS21PrinterData() throws PrinterException
Sube el estado S2 correspondiente a los montos Tasa1 de la
transaccin actual al PC y actualiza sus valores de data.
Retorno
Un objeto de tipo S2PrinterData en la variable global S2Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS22PrinterData
S2PrinterData GetS22PrinterData() throws PrinterException
Sube el estado S2 correspondiente a los montos Tasa2 de la
transaccin actual y actualiza sus valores de data.
Retorno
Un objeto de tipo S2PrinterData en la variable global S2Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS23PrinterData
S2PrinterData GetS23PrinterData() throws PrinterException
Sube el estado S2 correspondiente a los montos Tasa3 de la
transaccin actual y actualiza sus valores de data.

22

T H E

F A C T O R Y

H K A

Retorno
Un objeto de tipo S2PrinterData en la variable global S2Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS24PrinterData
S2PrinterData GetS24PrinterData() throws PrinterException
Sube el estado S2 correspondiente a los montos Tasa4 de la
transaccin actual y actualiza sus valores de data.
Retorno
Un objeto de tipo S2PrinterData en la variable global S2Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS25PrinterData
S2PrinterData GetS25PrinterData() throws PrinterException
Sube el estado S2 correspondiente a los montos Tasa5 de la
transaccin actual y actualiza sus valores de data.
Retorno
Un objeto de tipo S2PrinterData en la variable global S2Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS3PrinterData
S3PrinterData GetS3PrinterData() throws PrinterException
Sube el estado S3 de la Impresora fiscal al PC y actualiza sus valores de
data.
Retorno
Un objeto de tipo S3PrinterData en la variable global S3Estado. Es
importante mencionar que el objeto del tipo S3PrinterData contiene
23

T H E

F A C T O R Y

H K A

como primer argumento un arreglo de tipo Long donde cada elemento

(59 en total) indica una bandera de la impresora que determina un
comportamiento especfico, como la actuacin cuchilla de corte, etc.
En la demo entregada en este SDK no se muestran estas banderas por
simplicidad pero pueden ser vistas enviando el comando D (Desde la
seccin Enviar Comando) a una impresora conectada, esto hace que se
imprima la programacin de la impresora y se pueden ver las banderas.
Excepcin
Arroja la excepcin PrinterException.
GetS4PrinterData
S4PrinterData GetS4PrinterData() throws PrinterException
Sube el estado S4 de la Impresora fiscal al PC y actualiza sus valores de
data.
Retorno
Un objeto de tipo S4PrinterData en la variable global S4Estado.
Excepcin
Arroja la excepcin PrinterException.
GetS5PrinterData
S5PrinterData GetS5PrinterData() throws PrinterException
Sube el estado S5 de la Impresora fiscal al PC y actualiza sus valores de
data.
Retorno
Un objeto de tipo S5PrinterData en la variable global S5Estado.
Excepcin
Arroja la excepcin PrinterException.
GetX4Report
AcumuladosX GetX4Report() throws PrinterException
Sube el reporte de acumulados de Ventas con Crdito Fiscal y
actualiza sus valores de data.

24

T H E

F A C T O R Y

H K A

Retorno
Un objeto de tipo AcumuladosX en la variable global ReporteAcumX.
Excepcin
Arroja la excepcin PrinterException.

GetX5Report
AcumuladosX GetX5Report() throws PrinterException
Sube el reporte de acumulados de Notas de Crdito con Crdito Fiscal
y actualiza sus valores de data.
Retorno
Un objeto de tipo AcumuladosX en la variable global ReporteAcumX.
Excepcin
Arroja la excepcin PrinterException.

25

T H E

F A C T O R Y

H K A

Anexos
ANEXO 1: Lista de cdigos de Status
STATUS
Retorno
(Hex)

Retorno
(Decimal)

Estado desconocido.

En modo prueba y en espera.

En modo prueba y emisin de documentos fiscales.

En modo prueba y emisin de documentos no fiscales.

En modo fiscal y en espera.

En modo fiscal y emisin de documentos fiscales.

0A

10

0B

11

0C

12

En modo fiscal y emisin de documentos no fiscales.

En modo fiscal, cercana carga completa de la memoria fiscal y
en espera.
En modo fiscal, cercana carga completa de la memoria fiscal y
en emisin de documentos fiscales.
En modo fiscal, cercana carga completa de la memoria fiscal y
en emisin de documentos no fiscales.
En modo fiscal, carga completa de la memoria fiscal y en
espera.
En modo fiscal, carga completa de la memoria fiscal y en
emisin de documentos fiscales.
En modo fiscal, carga completa de la memoria fiscal y en
emisin de documentos no fiscales.

Comentario

26

T H E

F A C T O R Y

H K A

ANEXO 2: Lista de cdigos de Error

ERROR
Retorno
(Hex)

Retorno
(Decimal)

00

No hay error.

01

Fin en la entrega de papel.

02

Error de ndole mecnico en la entrega de papel.

03

Fin en la entrega de papel y error mecnico.

50

80

Comando invalido o valor invalido.

54

84

Tasa invalida.

58

88

No hay asignadas directivas.

5C

92

Comando invalido.

60

96

Error fiscal.

64

100

Error de la memoria fiscal.

6C

108

Memoria fiscal llena.

70

112

Buffer completo. (debe enviar el comando de reinicio)

80

128

Error en la comunicacin.

89

137

No hay respuesta.

90

144

Error LRC.

91

145

Error interno api.

99

153

Error en la apertura del archivo.

Comentario

27

T H E

F A C T O R Y

H K A

ANEXO 3: Ejemplo bsico de emisin de Factura para Consumidor Final

package ejemplomanual;
import tfhka.ve.*;
import tfhka.*;
public class EjemploManual {
private static Tfhka tf; //declaracin de la clase
public static void main(String[] args) {
try {
imprimir_factura();
} catch (PrinterException ex) {
System.out.println("Ha
ocurrido
ex.getMessage()); // Manejo de error
}

una

excepcin:

"

}
public static void imprimir_factura() throws PrinterException{
tf = new tfhka.ve.Tfhka("COM1"); //inicializacin de la clase
if(tf!=null){
tf.SendCmd(" 000000010000000100Papas"); //Agregar Item
tf.SendCmd("101"); //Pago Total en Efectivo
}
}
}

28