Integración
Integración
Soporte e Integración
Aplicación Tfinulx
Manual de Integración
SOPORTE E INTEGRACIÓN
Manual de Integración
Revision 1.0
Introducción
La aplicación Tfinulx está pensada para dar soporte a sistemas administrativos
basados en Linux/Unix/QNX que no puedan hacer uso directamente del puerto
serie.
Resumen
1
T H E F A C T O R Y H K A
Requerimientos de Hardware
Procesador de 1Ghz o superior
Requerimientos de Software
Sistema Operativo Linux/Unix/QNX
2
T H E F A C T O R Y H K A
2
Capítulo
Generalidades
La aplicación “tfinulx” utiliza lenguaje C como lenguaje de programación y puede ser
invocada directamente en consola o desde una aplicación secundaria – remota.
La aplicación “tfinulx” está destinada a dar una solución a las aplicaciones desarrolladas
bajo sistemas UNIX, LINUX y QNX que no pueden hacer uso del puerto de
comunicación directamente, su función es controlar la apertura del puerto, gestionar las
comunicaciones y cerrar el puerto.
Una aplicación remota, puede ser cualquier desarrollo que pueda acceder al Prompt y/o
consola del sistema.
3
T H E F A C T O R Y H K A
Instalación y Configuración
Para instalar la aplicación tfinulx solamente copie los archivos correspondientes a la
versión del Sistema Operativo que esté usando (32 o 64 bits) en una nueva carpeta,
digamos /home/usuario/tfinulx. Los archivos a copiar deben ser tfinulx (la aplicación),
puerto.txt (el archivo de configuración del puerto) y retorno.txt (donde la aplicación
devuelve los valores que se obtienen al ejecutar la función).
Use el comando chmod 777 /home/usuario/tfinulx para dar permiso a la carpeta donde
copió los archivos de la aplicación.
Durante las pruebas aquí realizadas se usó el conversor Prolific PL2303, que es muy
común conseguir en el mercado. El Sistema Operativo Ubuntu 13 instala los drivers de
este convertidor automáticamente. En cualquier otro sistema operativo deberá chequear
si los drivers están instalados antes de usar la impresora, use el comando lsusb para
visualizar los dispositivos instalados y verifique que el que está usando aparece.
4
T H E F A C T O R Y H K A
Alcance de la librería
La aplicación Tfinulx es compatible con cualquier distribución de Linux.
5
T H E F A C T O R Y H K A
3
Capítulo
Cabecera
Cabecera Comando
Cabecera Ruta
Cabecera Comando Ruta
6
T H E F A C T O R Y H K A
Ej: >echo $?
7
T H E F A C T O R Y H K A
CheckFprinter
BOOLEAN CheckFprinter()
Retorno:
8
T H E F A C T O R Y H K A
ReadFpStatus
BOOLEAN ReadFpStatus()
Retorno:
9
T H E F A C T O R Y H K A
SendCmd
Parámetros:
Retorno:
10
T H E F A C T O R Y H K A
R E T O R N EOL C O M A N D O F U E R E C I B I D O C O R R E C T A M E N T E = T R U E
EL COMANDO NO SE REC IBIÓ CORRECTAMENTE = FALSE
SendFileCmd
Parámetros:
Retorno:
11
T H E F A C T O R Y H K A
UploadReportCmd
12
T H E F A C T O R Y H K A
Parámetros:
String cmd: tipo de reporte a solicitar. Los reportes que pueden ser
solicitados son los siguientes (consultar manual general de integración
de las respectivas impresoras):
- U0X - U1Z
- U0Z - U1X
Retorno:
R E T O R NE
OL R E P O R T E S E H A C A R G A D O C O R R E C T A M E N T E = TRUE
ERROR AL CARGAR EL REPORTE = FALSE
13
T H E F A C T O R Y H K A
UploadStatusCmd
Ésta función se encarga de cargar los status de la impresora (S1, S2, S3,
S4, S5) y almacenar la información en un archivo de texto con el
nombre indicado por el parámetro Ruta, el cual se crea de forma
automática en la ruta indicada, en el caso en que la Ruta solo contenga
el nombre del archivo se guarda en la misma ubicación de la aplicación,
si el archivo ya existe se borra su contenido anterior. Para armar el
comando se mantendrá lo establecido en el “Manual de Protocolos y
Comandos”.
Parámetros:
String cmd: tipo de Status a solicitar. Los Status que pueden ser
solicitados son los siguientes:
- S1 - S4 - S8P
- S2 - S5
- S3 - S8E
Retorno:
14
T H E F A C T O R Y H K A
R E T O R N OE L S T A T U S S E H A C A R G A D O C O R R E C T A M E N T E = TRUE
ERROR AL CARGAR EL STATUS = FALSE
15
T H E F A C T O R Y H K A
16
T H E F A C T O R Y H K A
Anexos
ANEXO 1: Lista de códigos de Status
STATUS
Retorno Retorno
Comentario
(Hex) (Decimal)
0 0 Estado desconocido.
1 1 En modo prueba y en espera.
2 2 En modo prueba y emisión de documentos fiscales.
3 3 En modo prueba y emisión de documentos no fiscales.
4 4 En modo fiscal y en espera.
5 5 En modo fiscal y emisión de documentos fiscales.
6 6 En modo fiscal y emisión de documentos no fiscales.
En modo fiscal, cercana carga completa de la memoria fiscal y
7 7
en espera.
En modo fiscal, cercana carga completa de la memoria fiscal y
8 8
en emisión de documentos fiscales.
En modo fiscal, cercana carga completa de la memoria fiscal y
9 9
en emisión de documentos no fiscales.
En modo fiscal, carga completa de la memoria fiscal y en
0A 10
espera.
En modo fiscal, carga completa de la memoria fiscal y en
0B 11
emisión de documentos fiscales.
En modo fiscal, carga completa de la memoria fiscal y en
0C 12
emisión de documentos no fiscales.
17
T H E F A C T O R Y H K A
ERROR
Retorno Retorno
Comentario
(Hex) (Decimal)
00 0 No hay error.
01 1 Fin en la entrega de papel.
02 2 Error de índole mecánico en la entrega de papel.
03 3 Fin en la entrega de papel y error mecánico.
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 comunicación.
89 137 No hay respuesta.
90 144 Error LRC.
91 145 Error interno api.
99 153 Error en la apertura del archivo.
18
T H E F A C T O R Y H K A
19