Librera: winfis32.dll v04.

27
Para uso con impresoras fiscales HASAR
Argentina , Venezuela, Panam
 Contenido

LIBRERA WINFIS32.DLL V04.27 ..................................................................................................................................... 2

FUNCIONES DISPONIBLES ............................................................................................................................................... 4

FUNCIN: VERSIONDLLFISCAL( ) ........................................................................................................................................ 4
FUNCIN: OPENCOMFISCAL( ).............................................................................................................................................. 4
FUNCIN: REOPENCOMFISCAL( ) ......................................................................................................................................... 5
FUNCIN: CLOSECOMFISCAL( ) ............................................................................................................................................ 6
FUNCIN: INITFISCAL( ) ........................................................................................................................................................ 6
FUNCIN: MANDAPAQUETEFISCAL( )................................................................................................................................... 6
FUNCIN: ULTIMARESPUESTA( ) .......................................................................................................................................... 7
FUNCIN: ULTIMOSTATUS( ) ................................................................................................................................................ 8
FUNCIN: CAMBIARVELOCIDAD( ) ..................................................................................................................................... 10
FUNCIN: SEARCHPRN( ) .................................................................................................................................................... 10
FUNCIN: PROTOCOLMODE( )............................................................................................................................................. 11
FUNCIN: BUSYWAITINGMODE( )...................................................................................................................................... 11
FUNCIN: SETCOMMANDRETRIES( )................................................................................................................................... 12
FUNCIN: ABORT( )............................................................................................................................................................. 12
FUNCIN: SETMODOEPSON( )............................................................................................................................................. 12
FUNCIN: SETCMDRETRIES( )............................................................................................................................................. 13
FUNCIN: SETSNDRETRIES( ).............................................................................................................................................. 13
FUNCIN: SETRCVRETRIES( ) ............................................................................................................................................. 14
FUNCIN: OPENTPCFISCAL( ) ............................................................................................................................................. 14
FUNCIN: OBTENERNUMERODEPAQUETES( ) .................................................................................................................... 15
FUNCIN: SETKEEPALIVEHANDLERSTDCALL( ) ............................................................................................................... 16
FUNCIN: SETKEEPALIVEHANDLER( ) ............................................................................................................................... 17
ERRORES DEVUELTOS POR LAS FUNCIONES......................................................................................................................... 18
SUGERENCIAS .................................................................................................................................................................... 19
DETECCIN DE PROBLEMAS ................................................................................................................................................ 19
CARACTERES ANSI O ASCII ? ......................................................................................................................................... 19
MODO DE OPERACIN ......................................................................................................................................................... 20
Modo BusyWaitingMode(0)........................................................................................................................................... 20
Ejemplo de aplicacin en Windows ........................................................................................................................... 21

Librera winfis32.dll v04.27

Se trata de una librera de enlace dinmico para desarrollos visuales en entorno Win-
dows 32 / 64 bits, la cual puede emplearse de dos formas:

Combinada - Para desarrollos basados en el uso del OCX Fiscal HASAR v010724.

El software de gestin para puntos de venta configura propiedades, e

invoca mtodos, pertenecientes al mencionado OCX. Es este objeto (y
no el software de gestin para puntos de venta) quien finalmente utiliza
las funciones disponibles en la librera winfis32.dll.

Pgina 2 de 23
 (Vlido slo en Argentina)

- Para desarrollos basados en el uso del ejecutable wspooler.exe.

Existen en el mercado incontables desarrollos para MS-DOS -que corren

en ventanas MS-DOS de Windows-, los cuales no cuentan con capaci-
dad para interactuar con el OCX, y tampoco cuentan con la posibilidad
de declarar una interfaz para disponer de las funciones de la librera
winfis32.dll. En estos casos, el desarrollador suele recurrir al uso del
ejecutable wspooler.exe, programa que requiere de la librera win-
fis32.dll para poder operar. Es este programa (y no el software de ges-
tin para puntos de venta) quien utiliza las funciones disponibles en la
librera winfis32.dll.

Independiente - Para desarrollos basados en el uso de las funciones incluidas en la li-

brera.

En este caso, el software de gestin para puntos de venta no hace uso

del OCX Fiscal HASAR v010724, o el ejecutable wspooler.exe, prefe-
renciando el diseador- la invocacin directa de las funciones disponi-
bles en la librera winfis32.dll.

Si bien es cierto que resulta ms amigable el desarrollo de un proyecto basado en el uso

del OCX Fiscal Hasar v010724 (o posteriores basados en clases multiplataforma-), no to-
dos los lenguajes de desarrollo visual soportan el empleo de objetos basados en tecnologa
COM como es el caso del OCX mencionado-, o de objetos basados en clases multiplata-
forma; y tambin es sabido que otros lenguajes no son ciento por ciento compatibles con
el uso de OCX como los descriptos. El desarrollador deber consultar este aspecto en la
documentacin de su entorno de desarrollo.

Para quienes opten por el uso directo de las funciones de la librera winfis32.dll, sea por-
que estn acostumbrados a la generacin directa de strings de comandos y al anlisis de
strings de respuestas (dilogo con la impresora fiscal HASAR), o porque las funciones de
esta librera son independientes del modelo de impresora fiscal HASAR a manejar, se des-
criben a continuacin las funciones incluidas en la librera winfis32.dll.

A partir de la versin 4.00 de la librera winfis32.dll es posible el comercio de strings (co-

mandos y respuestas) tanto a travs de un puerto serie local, como de ethernet (indicando
direccin de IP y nmero de socket a considerar).

Pgina 3 de 23
 Funciones disponibles
Si bien en las descripciones de las funciones incluidas en la librera winfis32.dll escrita en
lenguaje C- se indica que para algunos argumentos y valores retornados, el tipo de dato
declarado es int, se debe tener en cuenta que se trata de un entero representado en 32
bits (ocupa 4 bytes). Este hecho es importante a la hora de declarar la interfaz requerida
en otros lenguajes que utilicen estas funciones. Por ejemplo, en Visual Basic los mismos
datos deben ser declarados como Long.

Funcin: VersionDLLFiscal( )

int VersionDLLFiscal (void)

Argumentos: No requiere.

Retorna: El nmero correspondiente a la versin de la librera winfis32.dll en

uso.

Esta funcin permite al software de gestin para puntos de venta determinar si est tra-
bajando con la versin adecuada de la librera winfis32.dll. Tener presente que las funcio-
nes disponibles pueden ser modificadas o eliminadas, adems de agregarse nuevas.

Funcin: OpenComFiscal( )

int OpenComFiscal (int Com, int Mode)

Argumentos: Com Nmero entero que indica el puerto serie que se desea abrir.
Este argumento puede tomar valores entre 1 y 30.

Mode ANSI = 1 Este valor indica que el comercio de strings entre

la librera winfis32.dll y el software de gestin pa-
ra puntos de venta se realizar en base a caracte-
res ANSI. En este caso, la librera winfis32.dll con-
vertir los caracteres ANSI a sus equivalentes en
ASCII antes de enviar los strings de comandos a la
impresora fiscal HASAR. En sentido inverso, las res-
puestas en caracteres ASCII que entrega la impre-
sora fiscal Hasar sern convertidos a sus equivalen-
tes en ANSI antes de entregar el string al software
de gestin para puntos de venta.

ASCII = 0 Este valor indica que el comercio de strings entre

Pgina 4 de 23
 la librera winfis32.dll y el software de gestin pa-
ra puntos de venta se realizar en base a caracte-
res ANSI. En este caso la librera winfis32.dll no
realiza conversin alguna de los strings de coman-
dos, ni de los correspondientes a respuestas de la
impresora fiscal HASAR.

Retorna: >=0 Nmero (positivo) de handler devuelto por el sistema operati-

vo, para manejar el puerto serie indicado como el argumento
Com. Este valor ser requerido por el resto de las funciones de
la librera winfis32.dll que dialoguen con la impresora fiscal
HASAR, o deban hacer uso del puerto serie (cerrarlo). Este n-
mero indica que la apertura del puerto serie fue exitosa.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta la apertura del puerto
serie, de la PC, donde se conectar la impresora fiscal HASAR.

Es conveniente que la apertura del puerto serie se realice cuando la aplicacin es dispara-
da para su ejecucin, y no por la emisin de cada comprobante. Tener presente que el
puerto serie est dedicado a la impresora fiscal HASAR.

Funcin: ReOpenComFiscal( )

int ReOpenComFiscal (int Com)

Argumentos: Com Nmero entero que indica el puerto serie que ya se encontraba a-
bierto. Este argumento puede tomar valores entre 1 y 30.

Retorna: >=0 Nmero (positivo) de handler devuelto por el sistema operativo,

para manejar el puerto serie indicado como el argumento Com.
Este valor ser requerido por el resto de las funciones de la libre-
ra winfis32.dll que dialoguen con la impresora fiscal HASAR, o
deban hacer uso del puerto serie (cerrarlo). Este nmero indica
que la apertura del puerto serie fue exitosa.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta recuperarse del error
que se produce al intentar abrir un puerto serie que ya estaba abierto.

Pgina 5 de 23
Funcin: CloseComFiscal( )

void CloseComFiscal (int Handler)

Argumentos: Handler Valor devuelto por la funcin OpenComFiscal( ) normalmen

te-, o por la funcin ReOpenComFiscal( ) excepcionalmente-.

Retorna: ------

Esta funcin permite al software de gestin para puntos de venta cerrar el puerto serie
utilizado para comerciar strings de comandos y respuestas, con la impresora fiscal HASAR.

Es conveniente que el cierre del puerto serie se realice cuando se da por finalizada la eje-
cucin de la aplicacin, y no por la emisin de cada comprobante. Tener presente que el
puerto serie est dedicado a la impresora fiscal HASAR.

Funcin: InitFiscal( )

int InitFiscal (int Handler)

Argumentos: Handler Valor devuelto por la funcin OpenComFiscal( ) normalmen

te-, o por la funcin ReOpenComFiscal( ) excepcionalmente-.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta la sincronizacin de la

numeracin de paquetes correspondientes al protocolo de comunicaciones para evitar la
retransmisin de paquetes. La sincronizacin la logra la propia funcin mediante el envo
de sucesivos comandos de pedidos de estado (StatusRequest ver manual publ.pdf-) a la
impresora fiscal HASAR.

Es recomendable que el software de gestin para puntos de venta invoque a esta funcin
despus de abrir con xito el puerto serie.

Funcin: MandaPaqueteFiscal( )
int MandaPaqueteFiscal (int Handler, char *Buffer)

Argumentos: Handler Valor devuelto por la funcin OpenComFiscal( ) normalmen

Pgina 6 de 23
 te-, o por la funcin ReOpenComFiscal( ) excepcionalmente-.

Buffer String de comando destinado a la impresora fiscal HASAR.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta enviar un string de co-
mando a la impresora fiscal HASAR, a travs del puerto serie local. Dicho string debe res-
petar la sintaxis descripta en el manual de comandos correspondiente (publ.pdf el
nombre del archivo depende el modelo de equipo en uso-).

El formato del string de comando, bsicamente, puede describirse como:

ID[Campo1[Campo2[..[CampoN]..]]]

ID Caracter de identificacin del comando.

Separador de campos de informacin: ASCII 28 (decimal).

Campo La cantidad de campos, formato y contenido se describen en el manual pu-

bl.pdf.

[] Indica que la presencia del campo depende del comando en cuestin.

Funcin: UltimaRespuesta( )

int UltimaRespuesta (int Handler, char *Buffer)

Argumentos: Handler Valor devuelto por la funcin OpenComFiscal( ) normalmen

te-, o por la funcin ReOpenComFiscal( ) excepcionalmente-.

Buffer String de respuesta proveniente de la impresora fiscal HASAR.

La variable donde se alojar el string de respuesta debe ser
dimensionada de manera de poder contener la respuesta ms
larga conocida. Generalmente 512 bytes son suficientes.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta obtener el string de res-
puesta de la impresora fiscal HASAR, a travs del puerto serie local, y correspondiente al
ltimo comando enviado mediante la funcin MandaPaqueteFiscal( ). Dicho string respeta

Pgina 7 de 23
la sintaxis descripta en el manual de comandos correspondiente (publ.pdf el nombre
del archivo depende el modelo de equipo en uso-).

El formato del string de respuesta, bsicamente, puede describirse como:

IDStatPrnStatFis[Campo1[Campo2[..[CampoN]..]]]

StatPrn Campo conteniendo el estado en que se encuentra la impresora propiamente

dicha. Este campo se halla presente en todas las respuestas de la impresora
fiscal HASAR. Consta de 4 caracteres ASCII que representan dgitos hexade-
cimales. El significado de cada bit de su representacin binaria se describe
en el apndice Status de Impresora, incluido en el manual de comandos
publ.pdf. Por ejemplo: C080.

StatFis Campo conteniendo el estado fiscal en que se encuentra la impresora fiscal

HASAR. Este campo se halla presente en todas las respuestas de la impresora
fiscal HASAR. Consta de 4 caracteres ASCII que representan dgitos hexade-
cimales. El significado de cada bit de su representacin binaria se describe
en el apndice Status Fiscal, incluido en el manual de comandos
publ.pdf. Por ejemplo: 0600.

ID Caracter de identificacin del comando al cual corresponde la respuesta.

Separador de campos de informacin: ASCII 28 (decimal).

Campo La cantidad de campos, formato y contenido se describen en el manual pu-

bl.pdf.

[] Indica que la presencia del campo depende del comando en cuestin.

La normativa fiscal vigente (en Argentina) obliga al software de gestin para puntos de
venta a examinar cada respuesta de la impresora fiscal, a los efectos de determinar que
ocurri con el comando enviado, y proceder al tratamiento adecuado de errores, si stos
son reportados por la impresora fiscal HASAR. Adems, las respuestas pueden contener in-
formacin de inters para el software de gestin para puntos de venta con objeto de man-
tener la sincronizacin de datos entre el software y la impresora fiscal HASAR.

Funcin: UltimoStatus( )

int UltimoStatus (int Handler, short *FiscalStatus, short *PrinterStatus)

Argumentos: Handler Valor devuelto por la funcin OpenComFiscal( ) normal

mente-, o por la funcin ReOpenComFiscal( ) excepcio
nalmente-.

FiscalStatus Valor numrico, resultado de la conversin del campo

de estado fiscal contenido en el string de la ltima res-

Pgina 8 de 23
 puesta recibida desde la impresora fiscal HASAR.

PrinterStatus Valor numrico, resultado de la conversin del campo

de estado de impresora contenido en el string de la l-
tima respuesta recibida desde la impresora fiscal HA-
SAR.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un

error. Ms adelante se describen los valores posibles de
error.

Esta funcin permite al software de gestin para puntos de venta ahorrarse la extraccin y
conversin a binario de los strings contenidos en los campos de estado incluidos en las
respuestas de la impresora fiscal HASAR.

La normativa fiscal vigente (en Argentina) obliga al software de gestin para puntos de
venta a examinar cada respuesta de la impresora fiscal, a los efectos de determinar que
ocurri con el comando enviado, y proceder al tratamiento adecuado de errores, si stos
son reportados por la impresora fiscal HASAR.

Para ms informacin acerca del significado de cada bit de estado, consultar los apndi-
ces Status de Impresora y Status Fiscal, incluidos en el manual publ.pdf correspon-
diente al equipo en uso.

Un bit en 1 en el campo de estado deber ser interpretado de acuerdo al contexto en el

que se lo est analizando. Por ejemplo, si el status fiscal fuese 8620 (comando invlido)
y forma parte de la respuesta al comando de cierre de un comprobante fiscal (comando
CloseFiscalReceipt), es altamente probable que se trate de un error. Pero si se incluye en
la respuesta al comando de cancelacin general (Cancel), y este comando fue enviado en
la previsin de que podra haber un comprobante abierto, en realidad debera interpretar-
se como Continuar.

Supongamos que se ha invocado a la funcin UltimoStatus( ) y se quiere analizar cada bit,

por ejemplo, del estado fiscal. Una forma de hacerlo podra ser:

mask = 1 '// Bit cero, en 1

For ind = 1 To 16 '// Se recorren los bits del Status

If ((FiscalStatus And mask) <> 0) Then '// Est el bit en 1 ??
'// Decidir si es un error o no, y como tratarlo
'// Tener presente el estado del software
End If

mask = mask * 2 '// Se desplaza el bit en 1 de la mscara un lugar a la izquierda

Next

Pgina 9 de 23
Funcin: CambiarVelocidad( )

int CambiarVelocidad(int PortNumber, long NewSpeed)

Argumentos: PortNumber Nmero entero que indica el puerto serie al que se le

desea modificar la velocidad en baudios con la que traba-
ja. Este argumento puede tomar valores entre 1 y 30.

NewSpeed Velocidad en baudios, con la que se desea configurar el

puerto serie indicado mediante el argumento PortNum-
ber. Los valores posibles son: 1200, 2400, 4800, 9600,
19200, 38400 y 57600.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un error.

Ms adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta modificar la velocidad
de trabajo del puerto serie de la PC.

La funcin CambiarVelocidad( ) no modifica la velocidad del puerto serie de la impresora

fiscal HASAR. El uso de esta funcin solamente tiene sentido cuando se conectan impreso-
ras fiscales HASAR que soportan distintas velocidades en baudios.

Sin embargo, si se desea modificar la velocidad del puerto serie de la impresora fiscal
HASAR (suponiendo que estuviese permitido en el equipo en uso), se debe construir el
string de comando SetComSpeed y hacerlo llegar a la impresora fiscal HASAR a travs del
funcin MandaPaqueteFiscal( ) para ms informacin consultar el manual publ.pdf-.

Cabe aclarar que el cambio de velocidad afecta solamente a la transferencia electrnica

de datos. No afecta la velocidad de impresin del equipo.

Por otro lado, recordar primero modificar la velocidad del puerto serie de la impresora
fiscal HASAR, y luego la velocidad del puerto serie de la PC.

Funcin: SearchPrn( )

long SearchPrn(int Handler)

Argumentos: Handler Valor devuelto por la funcin OpenComFiscal( ) normalmen

te-, o por la funcin ReOpenComFiscal( ) excepcionalmente-.

Retorna: >0 La funcin se ha ejecutado con xito. Velocidad en baudios a

la que han podido sincronizarse ambos puertos serie (el de la

Pgina 10 de 23
 PC y el de la impresora fiscal HASAR). Los valores posibles
son: 1200, 2400, 4800, 9600, 19200, 38400 y 57600.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta determinar la velocidad
a la que se encuentra configurada la impresora fiscal HASAR.

Funcin: ProtocolMode( )

void ProtocolMode(int Mode)

Argumentos: Mode Mediante este argumento se selecciona el modo de trabajo del

protocolo de comunicaciones. Los valores posibles son:

0 No permite consulta de estado intermedio.

1 Permite la consulta de estado intermedio.

Retorna: ------

Funcin: BusyWaitingMode( )

void BusyWaitingMode(int Mode)

Argumentos: Mode Mediante este argumento se selecciona el modo de control de re-

torno. Los valores posibles son:

0 La librera winfis32.dll ceder la CPU en los momentos de

espera. En este modo hay que asegurar por medio del
software de gestin para puntos de venta que lo usa que
dos paquetes no se superpongan para un mismo handler.

1 La librera winfis32.dll no retornar hasta que el proceso

se haya terminado. Este ltimo modo es el default, y el
ms seguro, pero tambin es el ms lento.

Retorna: ------

Pgina 11 de 23
Funcin: SetCommandRetries( )
DEPRECADA A partir de la versin 04.00

int SetCommandRetries(int Retries)

Argumentos: Retries Configura el nmero de reintentos mximo de transmisiones

de paquetes fiscales transmitidos por la funcin MandaPaque-
teFiscal( ) cuando la impresora fiscal HASAR no responde (ti-
me-out).

Retorna: >0 La funcin se ha ejecutado con xito. Devuelve el nmero de

reintentos previo a la reconfiguracin.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Funcin: Abort( )

void Abort (int PortNumber)

Argumentos: PortNumber Interrumpe (aborta) el proceso en curso correspondiente al

puerto especificado en este argumento.

Retorna: ------

Se utiliza para abortar procesos que se encuentran en estado de espera hasta que se cum-
pla un cierto time-out.

Funcin: SetModoEpson( )

int SetModoEpson(void)

Esta funcin es utilizada para configurar el puerto para establecer una comunicacin con
el protocolo Epson, ya que por default este es configurado segn el protocolo HASAR.

Argumentos: No requiere.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Pgina 12 de 23
Funcin: SetCmdRetries( )

int FAR PASCAL _export SetCmdReries(int retries)

Argumentos: retries Configura el nmero de reintentos mximo de transmisiones de

paquetes fiscales transmitidos por la funcin MandaPaqueteFis-
cal( ) cuando la impresora fiscal HASAR responde de manera in-
vlida.

Retorna: =0 La funcin se ha ejecutado con xito. Devuelve el nmero de re-

intentos previo a la reconfiguracin.
<0
Un nmero negativo indica que se ha producido un error. Ms
adelante se describen los valores posibles de error.

La librera winfis32.dll permite una forma alternativa de establecer este valor, mediante
la creacin de una variable de entorno (de sistema) en Windows:

Nombre: CMDRETRIES
Valor: Cantidad de reintentos. Por ejemplo, 3

Este es un recurso extremo que se puede utilizar cuando se est trabajando sobre redes
donde puede haber una cierta lentitud en las comunicaciones.

Funcin: SetSndRetries( )

int FAR PASCAL _export SetSndReries(int retries)

Argumentos: retries Configura el nmero de reintentos mximo de transmisiones de

paquetes fiscales transmitidos por la funcin MandaPaqueteFis-
cal( ) cuando no se recibe el ACK, desde la impresora fiscal HA-
SAR, al comando enviado.

Retorna: =0 La funcin se ha ejecutado con xito. Devuelve el nmero de re-

intentos previo a la reconfiguracin.
<0
Un nmero negativo indica que se ha producido un error. Ms
adelante se describen los valores posibles de error.

La librera winfis32.dll permite una forma alternativa de establecer este valor, mediante
la creacin de una variable de entorno (de sistema) en Windows:

Nombre: SNDRETRIES
Valor: Cantidad de reintentos. Por ejemplo, 3

Este es un recurso extremo que se puede utilizar cuando se est trabajando sobre redes
donde puede haber una cierta lentitud en las comunicaciones.

Pgina 13 de 23
Funcin: SetRcvRetries( )

int FAR PASCAL _export SetRcvRetries(int retries)

Argumentos: retries Configura el nmero de reintentos mximo de transmisiones de

paquetes fiscales transmitidos por la funcin MandaPaqueteFis-
cal( ) cuando la impresora fiscal HASAR no responde (time-out).

Retorna: =0 La funcin se ha ejecutado con xito. Devuelve el nmero de re-

intentos previo a la reconfiguracin.
<0
Un nmero negativo indica que se ha producido un error. Ms
adelante se describen los valores posibles de error.

La librera winfis32.dll permite una forma alternativa de establecer este valor, mediante
la creacin de una variable de entorno (de sistema) en Windows:

Nombre: RCVRETRIES
Valor: Cantidad de reintentos. Por ejemplo, 3

Este es un recurso extremo que se puede utilizar cuando se est trabajando sobre redes
donde puede haber una cierta lentitud en las comunicaciones.

Funcin: OpenTpcFiscal( )

int FAR PASCAL _export OpenTcpFiscal(char *hostname, int socket, long mseg,
int modo)

Argumentos: hostname A travs de este parmetro se indica el nombre que identifica

a una PC en la red por ejemplo, PCVentas1-, o su direc-
cin IP por ejemplo, 192.0.5.135-.

socket Nmero de socket mediante el cual se comerciarn strings de

comandos y respuestas entre el software de gestin para pun-
tos de venta y la PC hostname. Por ejemplo, 5500.

mseg Tiempo de espera en milisegundos para retornar informando

error de time-out. Por ejemplo, 2000.
modo ANSI = 1 Este valor indica que el comercio de strings en-
tre la librera winfis32.dll y el software de ges-
tin para puntos de venta se realizar en base a
caracteres ANSI. En este caso, la librera win-
fis32.dll convertir los caracteres ANSI a sus
equivalentes en ASCII antes de enviar los strings
de comandos a la impresora fiscal HASAR. En

Pgina 14 de 23
 sentido inverso, las respuestas en caracteres
ASCII que entrega la impresora fiscal Hasar se-
rn convertidos a sus equivalentes en ANSI antes
de entregar el string al software de gestin para
puntos de venta.

ASCII = 0 Este valor indica que el comercio de strings en-

tre la librera winfis32.dll y el software de ges-
tin para puntos de venta se realizar en base a
caracteres ANSI. En este caso la librera win-
fis32.dll no realiza conversin alguna de los
strings de comandos, ni de los correspondientes
a respuestas de la impresora fiscal HASAR.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Esta funcin permite al software de gestin para puntos de venta dialogar con la impreso-
ra fiscal en forma remota. Es decir, la impresora fiscal HASAR est conectada en otra PC
en la cual debe estar corriendo el ejecutable wspooler.exe para escuchar la red, redi-
reccionando al puerto serie los strings de comandos que llegan y devolviendo a la red los
strings de respuesta que recibe desde la impresora fiscal HASAR.

Funcin: ObtenerNumeroDePaquetes( )

int FAR PASCAL _export ObtenerNumeroDePaquetes(int handler, int *paqsend,

int *paqrcv, int *idcmd)

Argumentos: handler Valor devuelto por la funcin OpenComFiscal( ) normalmente-

, o por la funcin ReOpenComFiscal( ) excepcionalmente-.

paqsend En este argumento la funcin retorna el nmero de secuencia

del ltimo paquete fiscal, con un string de comando, que ha si-
do enviado a la impresora fiscal HASAR.

paqrcv En este argumento la funcin retorna el nmero de secuencia

del ltimo paquete fiscal, con un string de respuesta, que ha
sido recibido desde la impresora fiscal HASAR.
idcmd En este argumento la funcin retorna el caracter identificador
de comando al cual corresponde la respuesta contenida en el
ltimo paquete fiscal recibido desde la impresora fiscal HASAR.

Retorna: =0 La funcin se ha ejecutado con xito.

<0 Un nmero negativo indica que se ha producido un error. Ms

adelante se describen los valores posibles de error.

Pgina 15 de 23
Mediante esta funcin el software de gestin para puntos de venta puede controlar el sin-
cronismo del protocolo fiscal verificando que el nmero de secuencia del paquete fiscal,
correspondiente al string de comando enviado, se corresponda con el correspondiente al
paquete fiscal que trae el string de respuesta, chequeando (adems) que la respuesta re-
cibida corresponda al comando enviado (mismo caracter de identificacin).

Funcin: SetKeepAliveHandlerStdCall( )
No vlida para programacin en C, C++, y/o Visual C.
Para los lenguajes mencionados ver: SetKeepAliveHandler( )

void FAR PASCAL _export SetKeepAliveHandlerStdCall(PFVSTDCALL handler)

Argumentos: handler Valor devuelto por la funcin OpenComFiscal( ) normalmente-,

o por la funcin ReOpenComFiscal( ) excepcionalmente-.

Retorna: ------

En determinadas circunstancias la impresora fiscal HASAR puede enviar al software de ges

tin para puntos de venta, cada 400 milisegundos, caracteres ASCII especiales que pueden
interpretarse como falta papel, o esperar (la respuesta al comando an no est lista).

La impresora fiscal HASAR reporta la falta de papel (como una de sus formas) mediante el
envo cada 400 milisegundos- del caracter ASCII DC4 (18 decimal ; 12 hexa). Esto ocurri-
r hasta que la situacin se normalice.

Cuando el procesamiento de un comando enviado por el software de gestin para puntos

de venta requiere de ms de 400 milisegundos por parte de la impresora fiscal HASAR para
entregar la respuesta, sta recurre al envo cada 400 milisegundos- del caracter ASCII
DC2 (20 decimal ; 14 hexa). Esto debe ser interpretado por el software de gestin para
puntos de venta como una espera para el envo del siguiente comando. Tener presente
que no se puede enviar un nuevo comando hasta que se haya recibido y procesado la res-
puesta del anterior.

El siguiente es un ejemplo en Visual Basic de uso de esta funcin.

'// Rutina que atiende la llegada de caracteres DC2 o DC4

'// -----------------------------------------------------------------------

Public Sub ManejadorDeMantengaseVivo(ByVal Razon As Long, ByVal Handler As Long)

MsgBox "Lleg un DC2 o un DC4...: " & Razon

End Sub

'// Cuando se carga el form se estable que rutina atender la llegada de caracteres DC2
// o DC4
'// -----------------------------------------------------------------------------------------------------------

Pgina 16 de 23
Public Sub PonerManejadorDeMantengaseVivo()

SetKeepAliveHandlerStdCall AddressOf ManejadorDeMantengaseVivo

End Sub

Funcin: SetKeepAliveHandler( )
De uso exclusivo para programacin en C, C++, y/o Visual C.
Para los lenguajes mencionados ver: SetKeepAliveHandlerStdCall( )

void FAR PASCAL _export SetKeepAliveHandlerStdCall(PFVSTDCALL handler)

Argumentos: handler Valor devuelto por la funcin OpenComFiscal( ) normalmente-,

o por la funcin ReOpenComFiscal( ) excepcionalmente-.

Retorna: ------

En determinadas circunstancias la impresora fiscal HASAR puede enviar al software de ges

tin para puntos de venta, cada 400 milisegundos, caracteres ASCII especiales que pueden
interpretarse como falta papel, o esperar (la respuesta al comando an no est lista).

La impresora fiscal HASAR reporta la falta de papel (como una de sus formas) mediante el
envo cada 400 milisegundos- del caracter ASCII DC4 (18 decimal ; 12 hexa). Esto ocurri-
r hasta que la situacin se normalice.

Cuando el procesamiento de un comando enviado por el software de gestin para puntos

de venta requiere de ms de 400 milisegundos por parte de la impresora fiscal HASAR para
entregar la respuesta, sta recurre al envo cada 400 milisegundos- del caracter ASCII
DC2 (20 decimal ; 14 hexa). Esto debe ser interpretado por el software de gestin para
puntos de venta como una espera para el envo del siguiente comando. Tener presente
que no se puede enviar un nuevo comando hasta que se haya recibido y procesado la res-
puesta del anterior.

Pgina 17 de 23
Errores devueltos por las funciones
Errores generales:
-1 Error general.
-2 Handler invlido.
-3 Intento de enviar un comando cuando se estaba procesando.
-4 Error de comunicaciones.
-5 Puerto ya abierto.
-6 No hay memoria.
-7 El puerto ya estaba abierto.
-8 La direccin del buffer de respuesta es invlida.
-9 El comando no finaliz, sino que volvi una respuesta tipo STAT_PRN.
-10 El proceso en curso fue abortado por el usuario.
-11 No hay ms puertos disponibles.

Errores TCP/IP:
-12 Error estableciendo comunicacin TCP/IP.
-13 No se encontr el host.
-14 Error de conexin con el host.

Errores internos:
-15 Se recibi NAK al comando enviado.

Pgina 18 de 23
 Sugerencias

Deteccin de Problemas
La librera winfis32.dll existe un mecanismo que permite el rastreo problemas consistente
en guardar en un archivo de texto todas las operaciones realizadas por las funciones de la
librera, junto con los detalles de las comunicaciones. Esto permite seguir el protocolo "de
cerca". Para disponer de esta opcin se deben especificar un par de variables de entorno
(de sistema) en Windows antes de ejecutar funciones de la librera winfis32.dll. Estas
variables de entorno (de sistema) son:

FILELOG Especifica el archivo de texto donde se va a guardar la informacin. Si es-

te archivo no se especifica, no se guardar la informacin.

Por ejemplo, [path\]archivo.log

El directorio debe existir en la PC, el archivo lo crea la librera winfis-

32.dll.

DEBUGLEVEL Especifica el nivel de detalle de la informacin. Es un nmero entero de 1

a 3, donde :

1 Slo la informacin estrictamente necesaria.

2 Informacin complementaria a la anterior.
3 Toda la informacin.

Si esta variable de entorno (de sistema) no se especifica, se asume el va-

lor 3.

Caracteres ANSI o ASCII ?

La impresora fiscal HASAR trabaja con el juego de caracteres ASCII segn el cual a la letra
"" le corresponde el valor decimal164. Dentro de Windows, el juego de caracteres es el
ANSI, segn el cual es el valor 241 el que equivale a la letra "". Ambos juegos difieren a
partir del caracter 7F hexa (127 decimal).

Para evitar divergencias, se provee una conversin interna que salva este problema. Si la
apertura del puerto serie se realiza invocando a la funcin OpenComFiscal( ) e indicando
el valor 1 en el argumento Mode, se convierten todos los strings; tanto los que van a la
impresora fiscal HASAR (comandos), como los que vuelven (respuestas a los comandos en-
viados). En el caso de strings de comandos la conversin es de ANSI a ASCII, y en el caso
de los strings de respuestas la conversin es de ASCII a ANSI.

Si el argumento Mode vale 0 cuando se invoca a la funcin OpenComFiscal( ) los strings

no son convertidos, se trate de comandos o respuestas.

Pgina 19 de 23
Modo de Operacin
La forma de operacin del software de gestin para puntos de venta debera seguir los si-
guientes criterios:

Inicializacin del soft- Invocar a la funcin OpenComFiscal( ) para abrir el puerto se-
ware. rie.
Loop hasta que la funcin InitFiscal( ) devuelva xito.

Si se ha invocado a la funcin BusyWaitingMode( ) indicando el valor 0 en el argumento

Mode, el software de gestin para puntos de venta debe controlar posibilidad de inter-
ferencias.

Se envan comandos a la impresora fiscal HASAR mediante la

funcin MandaPaqueteFiscal( ) controlando los valores que de-
Durante la emisin de vuelve (al igual que en el resto de las funciones).
los distintos compro- Se recupera el estado de la impresora fiscal HASAR mediante la
bantes. funcin UltimoStatus( ), realizando chequeo de errores.
Posible uso de informacin contenida en la respuesta mediante
la funcin UltimaRespuesta( ).

Se cierra la aplica- Se cierra el puerto serie mediante la funcin CloseComFiscal( ).

cin.

Modo BusyWaitingMode(0)
La librera winfis32.dll manejada en este modo tiene la ventaja de poder detectar pro-
blemas de comunicacin, o de falta de papel, desde la aplicacin que la usa.
Si la impresora fiscal HASAR se queda sin papel al recibir un comando que causa impre-
sin, no responder hasta que se normalice la situacin. En estos casos, la funcin Manda-
PaqueteFiscal( ) no devuelve el control, y el software de gestin para punto de venta pa-
rece "colgado". Para salir de este estado, podra dispararse un timer que transcurridos n
segundos le avise que algo est ocurriendo.

Por ejemplo, en Visual Basic:

Sub Mandar(Comando As String)

Dim rc As Integer

Screen.MousePointer = vbHourglass
Timer.Enabled = True

Do
rc = MandaPaqueteFiscal(Handler, Comando)

If ((rc < 0) And (rc <> ERR_ATOMIC)) Then // ERR_ATOMIC = -3

MsgBox "Error " & rc & " enviando paquete"
Screen.MousePointer = vbNormal
Timer.Enabled = False

Pgina 20 de 23
 Exit Sub
End If

DoEvents
Loop Until rc = 0

Timer.Enabled = False
Screen.MousePointer = vbNormal
End Sub

Private Sub Timer_Timer()

'// Mostrar un mensaje de advertencia...
ShowWarning.Show
End Sub

El formulario "ShowWarning" es del tipo DialogModal y contiene un mensaje del tipo

"Controle la impresora fiscal". Tiene un timer que al segundo y medio descarga el formu-
lario para permitir la ejecucin de las funciones de la liobrera winfis32.dll nuevamente.
El timer del formulario principal se puede activar en un lapso de cinco segundos.

La librera winfis32.dll tiene que estar funcionando en modo BusyWaitingMode(0), obvia-

mente. En este modo, hay que controlar que no se superpongan comandos, motivo por el
cual hay que proveer cierta capa de proteccin. Por ejemplo:

Sub Mandar (Comando as String)

Static Atomic as Boolean

If Atomic Then
MsgBox "No puede ejecutar ms de un comando por vez"
Exit Sub
End If

Atomic = True

'// Proceso real de envo de comandos...

...

Atomic = False
End Sub

Ejemplo de aplicacin en Windows

El siguiente es un ejemplo de aplicacin en Visual Basic. La aplicacin abre el COM1 como
y cambia la fecha y hora del reloj de tiempo real de la impresora fiscal HASAR.

Los carateres Chr$(28) son los separadores de campo que se utilizan en la construccin de
los strings de comandos.

Pgina 21 de 23
Declare Function MandaPaqueteFiscal Lib "WinFis32" (ByVal Handler As Integer, _
ByVal Name As String) As Integer
Declare Function OpenComFiscal Lib "WinFis32" (ByVal Puerto As Integer, _
ByVal Mode As Integer) As Integer
Declare Function InitFiscal Lib "WinFis32" (ByVal Handler As Integer) As Integer
Declare Function UltimoStatus Lib "WinFis32" (ByVal Handler as Integer, _
ByRef FiscalStatus as Integer, ByRef PrinterStatus as Integer) as Integer

Const MODE_ANSI = 1

Dim Handler As Integer

//--------------------------------------------------
Sub EnviarStringFiscal(Comando As String)
Dim PrinterStatus As Integer, FiscalStatus As Integer

If (MandaPaqueteFiscal(Handler, Comando) < 0) Then

Screen.MousePointer = 0
MsgBox "Error mandando paquete"
else
If UltimoStatus (Handler, FiscalStatus, PrinterStatus) = 0 Then
MsgBox "PrinterStatus: " & PrinterStatus & _
"FiscalStatus: " & FiscalStatus, vbOkOnly, "Status"
End If
End If
End Sub

//------------------------------------
Sub OpenPort (Port As Integer)
Handler = OpenComFiscal(Port, MODE_ANSI)

If Handler < 0 Then

MsgBox "No pude abrir puerto" & Port
End
End If
End Sub

//-------------------
Sub Form_Load ()

OpenPort 1

If InitFiscal(Handler) < 0 Then

MsgBox "Fall InitFiscal()"
End
End If

EnviarStringFiscal "X" & Chr$(28) & "971231" & Chr$(28) & "235900"
End Sub

Pgina 22 de 23
Setiembre 01, 2010 Rev. 001

COPYRIGHT 2008/2010 - CA. HASAR SAIC

_ El presente documento se halla sujeto a cambios sin previo aviso.

_ Ca. HASAR SAIC no asume responsabilidad alguna por errores u omisiones contenidas en
este documento, ni asume responsabilidad alguna por los datos y/o perjuicios que el uso de
esta informacin pudiera causar.
_ Este documento no puede ser reproducido, total o parcialmente, ni almacenado para su pos-
terior reproduccin por cualquier mtodo o medio, sin autorizacin escrita de Ca. HASAR
SAIC.