You are on page 1of 12

Librera de Enlace Dinmico

TFHKAIF.DLL

Rev 1.1
31/01/08

INDICE

1.- Declaracin de la DLL

2.- Funciones de la DLL

2.1- BOOL OpenFpctrl (LPCSTR lpPortName)

2.2- BOOL CloseFpctrl ( )

2.3- BOOL CheckFprinter ( )

2.4- BOOL ReadFpStatus (LPINT status, LPINT error)

2.5- BOOL SendCmd (LPINT status, LPINT error, LPCSTR cmd)

2.6- INT SendFileCmd (LPINT status, LPINT error, LPCSTR file)

2.7- BOOL UploadReportCmd (LPINT status, LPINT error, LPCSTR cmd, LPCSTR file)

2.8- BOOL UploadStatusCmd (LPINT status, LPINT error, LPCSTR cmd, LPCSTR file)

2.9- BOOL UploadReportCmdDin (LPINT status, LPINT error, LPCSTR cmd)

2.10- BOOL UploadStatusCmdDin (LPINT status, LPINT error, LPCSTR cmd)

3.- Anexos

Anexo 1

Anexo 2

10

Anexo 3

11

Nota 1: Instale el archivo DLL en el System32 en la carpeta donde se ejecutara el Software.


Nota 2: La Impresora ya viene predeterminada inicialmente en Modo Entrenamiento
Nota 3:

Para Ejemplificar el uso de la DLL se emplea el programa The Factory HKA. Demo

Informativo
1

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

Figura 1. The Factory HKA. Demo Informativo

Seleccin de Puertos: Seleccione el puerto de comunicacin con el cual va trabajar.


Envo de Comandos por Archivo: Estructura creada para la bsqueda y seleccin de archivos
(*.dat) y ejecucin de los comandos internos en los mismos.
Datos: Generacin de eventos en el visor, relacionadas a la lectura de la impresora.
Reportes: Diseo de reportes X y Z.
Aplicacin: Diseo de aplicaciones de modo ejemplo para la realizacin en modo prueba de una
factura y de la lectura de la memoria Fiscal.
Ventana de Eventos: Visor de la ejecucin de comandos y datos.
Lectura de Memoria Fiscal y Memoria de Auditoria: Imprime y Carga a la Ventana de Eventos,
los reportes Z realizados tanto por Fecha como por Numero de Z y los datos almacenados en la
memoria de auditoria (aplica solo para la SRP-350).

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

1.- DECLARACIN DE LA DLL (TFHKAIF.DLL)

Para:

BOOL _stdcall OpenFpctrl(LPCSTR lpPortName);


BOOL _stdcall CloseFpctrl();
BOOL _stdcall CheckFprinter();
BOOL _stdcall ReadFpStatus(LPINT status, LPINT error);
BOOL _stdcall SendCmd(LPINT status, LPINT error , LPCSTR cmd );
INT _stdcall SendFileCmd(LPINT status, LPINT error, LPCSTR file );
BOOL _stdcall UploadStatusCmd(LPINT status, LPINT error, LPCSTR cmd, LPCSTR file );
BOOL _stdcall UploadReportCmd(LPINT status, LPINT error, LPCSTR cmd, LPCSTR file );
BOOL _stdcall UploadStatusCmdDin(LPINT status, LPINT error, LPCSTR cmd, ByVal Cadena As String);
BOOL _stdcall UploadReportCmdDin(LPINT status, LPINT error, LPCSTR cmd, ByVal Cadena As String);

Para: Visual Basic

Declare Function OpenFpctrl Lib TFHKAIF.DLL (ByVal lpPortName As String) As Long


Declare Function CloseFpctrl Lib TFHKAIF.DLL () As Long
Declare Function CheckFprinter Lib TFHKAIF.DLL () As Long
Declare Function ReadFpStatus Lib TFHKAIF.DLL (status As Long, error As Long) As Long
Declare Function SendCmd Lib TFHKAIF.DLL (status As Long, error As Long, ByVal cmd As String) As Long
Declare Function SendFileCmd Lib TFHKAIF.DLL (status As Long, error As Long, ByVal file As String) As Long
Declare Function UploadStatusCmd Lib TFHKAIF.DLL (status As Long, error As Long, ByVal cmd As String ByVal file As
String) As Long
Declare Function UploadReportCmd Lib TFHKAIF.DLL (status As Long, error As Long, ByVal cmd As String, ByVal file As
String) As Long
Declare Function UploadStatusCmdDin Lib TFHKAIF.DLL (status As Long, error As Long, ByVal cmd As String, ByVal
Cadena As String) As Long
Declare Function UploadReportCmdDin Lib TFHKAIF.DLL (status As Long, error As Long, ByVal cmd As String, ByVal
Cadena As String) As Long

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

2. FUNCIONES DE LA DLL
2.1.- BOOL OpenFpctrl (LPCSTR lpPortName)

Nombre

Puerto COM (Ej. COM1 o COM2)

Funcin

Apertura del Puerto Serial COM

Retorno

Puerto Abierto = True


Falla de Apertura = False
Esta funcin debe ser llamada antes que otras funciones

Figura 2. Extracto de Cdigo para el funcionamiento de la funcin OpenFpctrl (LPCSTR lpPortName)

2.2.- BOOL CloseFpctrl()

Nombre

Puerto COM (Ej. COM1 o COM2)

Funcin

Cierre del Puerto Serial COM

Figura 3. Extracto de Cdigo para el funcionamiento de la funcin CloseFpctrl ()

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

2.3 .- BOOL CheckFprinter ()

Funcin

Verifica si la Impresora esta Conectada

Retorno

Si esta Conectada = True


Si no esta Conectada = False

Figura 4. Extracto de Cdigo para el funcionamiento de la funcin CheckFprinter ()

2.4.- BOOL ReadFpStatus (LPINT status, LPINT error)

Funcin
Retorno

Lectura Referente a la Informacin del Status & Error de la Impresora Fiscal


Stand-by = True
Error = False
Status: Pointer de Status (Ver Anexo 1)
Error: Pointer de Error (Ver Anexo 2)

Figura 5. Extracto de Cdigo para el funcionamiento de la funcin ReadFpStatus (LPINT status, LPINT error)

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

2.5.- BOOL SendCmd (LPINT status, LPINT error, LPCSTR cmd)

Funcin
Retorno

Enva una Lnea de Comando a la Impresora Fiscal


Stand-by = True
Error = False
Ejemplo de uso: (Indicador #1 comando) 500001+{LF}

LF=0Ah

Ver Anexo 3

Figura 6. Extracto de Cdigo para el funcionamiento de la funcin


SendCmd (LPINT status, LPINT error, LPCSTR cmd)

2.6.- Int SendFileCmd (LPINT status, LPINT error, LPCSTR file)

Funcin
Retorno

Enva una serie de comandos en cadena contenidos en un archivo a la impresora fiscal


Numero de Comando Valido en Stand by
File = Nombre o ruta donde se ubica el archivo a enviar

Figura 8. Extracto de Cdigo para el funcionamiento de la funcin


SendFileCmd (LPINT status, LPINT error, LPCSTR file)

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

2.7.- BOOL UploadReportCmd (LPINT status, LPINT error, LPCSTR cmd, LPCSTR file)

Funcin
Retorno

Carga un reporte de datos y a los almacena en una archivo (ASCII)


Numero de Comando Valido en Stand by

In caso de existir algn archivo de dato, previo al archivo de dato generado este ser actualizado

Figura 9. Extracto de Cdigo para el funcionamiento de la funcin UploadReportCmd (LPINT status, LPINT

error, LPCSTR cmd, LPCSTR file)

2.8.- BOOL UploadStatusCmd (LPINT status, LPINT error, LPCSTR cmd, LPCSTR file)
Funcin
Retorno

Carga los Status de la impresora (S1, S2, S3,S4,S5,S6,S7,S8)


Numero de Comando Valido en Stand by

Figura 9. Extracto de Cdigo para el funcionamiento de la funcin UploadStatusCmd (LPINT status, LPINT

error, LPCSTR cmd, LPCSTR file)

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

2.9.- BOOL UploadReportCmdDin (LPINT status, LPINT error, LPCSTR cmd, LPCSTR Cadena)
Funcin
Retorno

Carga un reporte de datos en una variable dinmica


Numero de Comando Valido en Stand by

In caso de existir algn archivo de dato, previo al archivo de dato generado este ser actualizado

2.10.- BOOL UploadStatusCmdDin (LPINT status, LPINT error, LPCSTR cmd, LPCSTR Cadena))
Funcin
Retorno

Carga los Status de la impresora en una variable dinmica (S1, S2, S3,S4,S5,S6,S7,S8)
Numero de Comando Valido en Stand by

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

3.- ANEXOS
Anexo 1
Informacin del Status de la Impresora Fiscal

STATUS
Retorno

Retorno

(Hex)

(Decimal)

Status 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

En Modo Fiscal y Emisin de Documentos No Fiscales

En Modo Fiscal y Cercana Carga Completa De La Memoria Fiscal Y en Espera

0A

10

0B

11

0C

12

Comentario

En Modo Fiscal y Cercana Carga Completa De La Memoria Fiscal Y en Emisin de


Documentos Fiscales
En Modo Fiscal y Cercana Carga Completa De La Memoria Fiscal Y en Emisin de
Documentos No Fiscales
En Modo Fiscal y Carga Completa De La Memoria Fiscal Y en Espera
En Modo Fiscal y Carga Completa De La Memoria Fiscal Y en Emisin de
Documentos Fiscales
En Modo Fiscal y Carga Completa De La Memoria Fiscal Y en Emisin de
Documentos No Fiscales

Librera de Enlace Dinmico


TFHKAIF.DLL

Rev 1.1
31/01/08

Anexo 2
Informacin del Error de la Impresora Fiscal

Error
Retorno (Hex)

Retorno (Decimal)

00

No hay Error

VALIDO

01

Fin en la Entrega de papel

VALIDO

02

Error de ndole Mecnico en la entrega de Papel

VALIDO

03

Fin en la Entrega de papel y Error Mecnico

VALIDO

50

80

Comando Invalido / Valor Invalido

INVALIDO

54

84

Tasa Invalida

INVALIDO

58

88

No hay Asignadas Directivas

INVALIDO

5C

92

Comando Invalido

INVALIDO

60

96

Error Fiscal

INVALIDO

64

100

Error de la Memoria Fiscal

INVALIDO

6C

108

Memoria Fiscal llena

INVALIDO

112

Buffer Completo (Debe enviar el Comando de

INVALIDO

70

Comentarios

Valido / Invalido

Reinicio)

80

128

Error en la Comunicacin

INVALIDO

89

137

No Hay Respuesta

INVALIDO

90

144

Error LRC

INVALIDO

91

145

Error Interno API

INVALIDO

99

153

Error en la Apertura del Archivo

INVALIDO

10

Librera de Enlace Dinmico


TFHKAIF.DLL
Anexo 3
Gua de Referencia de Comandos

CMD

Hex

Sub CMD

20-25

Operacin
tem de Ventas

30

No Ventas

31

Cierre Promedio Directo

32

Promedio de Precaucin

33

Impresin del Sub total w

35

Indicadores

36

Indicador Off

37

Cancelacin de la Transaccin

38

Impresin del Texto

39

P/O , R/A

42

Bloqueo de la Impresora Fiscal

44

Lugar de Programacin

49

50

Reporte de Transaccin ( Fiscal Z )

Reporte de Transaccin actual

Lectura del Reporte Fiscal por Fecha

Lectura del Reporte Fiscal por Numero Z

Programacin de las Tasa de Impuesto

Programacin del Registro de Identificacin

Programacin del Nombre y cdigo Secreto

Programacin del Cierre Promedio

Programacin de la Hora

Programacin de la Fecha

Programacin de los Mensajes de Cabecera

programacin de las Bandera para las funciones del Sistema

Programacin de los smbolos de Transaccin

Programacin de Mensajes de Impresin

Iniciacin Fiscal

Programacin del Numero de la Maquina

Programacin del Nombre de la Tienda

11

Rev 1.1
31/01/08

Librera de Enlace Dinmico


TFHKAIF.DLL
T

Programacin de las Tasas de Impuesto

Programacin de la Responsabilidad VAT

Almacenamiento de las Tasas de Impuesto dentro de la Memoria Fiscal

Almacenamiento del Registro de Identificacin dentro de la Memoria Fiscal

Almacenamiento del numero de la Maquina dentro de la Memoria Fiscal

Almacenamiento del Nombre de la Tienda dentro de la Memoria Fiscal

Almacenamiento de la Responsabilidad VAT dentro de la Memoria Fiscal

53

Lectura de Informacin

54

Inicio y Finalizacin del modo de entrenamiento

55

Carga del Reporte de una Transaccin Fiscal Z

Carga del Reporte de Transaccin

Carga de los Reportes Fiscales por Fecha

Carga de los Reportes Fiscales por numero Z

Limpieza de los datos de la Transacciones

58

62

Retorno Embotellado

63

Numero de la Tarjeta de Crdito / Recibo del numero impreso

65

Restaurar

6B

Error Correcto

6F

Apertura de la Impresora Fiscal

70

Porcentaje Correcto

74

P/O, R/A Total

78

Impresin de Prueba

7A

Cierre de la Impresora Fiscal

A0-A5

tem de la Transaccin Vaca

E2

Rev 1.1
31/01/08

Vaco del Retorno Embotellado

12

You might also like