Vmaxocx Manual Programacion V1106

ELEPOS electrnica y puntos de venta, c.a.
Impresoras Fiscales VMAX

Manual de programacin OCX v1.1.06
Manual de Programacin componente OCX
1
Instalacin
1. Copiar los archivos vmax.ocx y mscomm32.ocx en la carpeta

\WINDOWS\system32
2. En el men INICIO seleccionar la opcin Ejecutar...
3. Ejecutar el comando: regsvr32 mscomm32.ocx
4. Ejecutar el comando: regsvr32 vmax.ocx
Historial de cambios:
Fecha 14 de Abril de 2009
Version 1.1.06
- El nuevo OCX puede enviar informacin de manera automtica a un Visor de Precios
conectado en uno de los puertos adicionales de la.
- Al momento del Subtotal en el ticket el OCX puede abrir la gaveta de dinero
automticamente si la propiedad NautoGaveta es igual a 1.
- Se valida que los parmetros Monto y Cantidad no tengan valor NULO, de ser as se
colocan en cero (0)
-
Fecha 6 de Marzo de 2009
Version 1.0.63
- Se corrigio falla en la funcin Item que ocasionaba que si los montos tenian ceros a la
izquierda no se imprimieran correctamente.
Fecha 28 de Enero de 2009

Version 1.0.62
- La funcin AbrirCF ahora acepta Razones Sociales de hasta 120 caracteres de longitud
y automticamente las divide en varias lneas al imprimir.
- La funcin AbrirCF ahora imprime una lnea punteada al terminar de imprimir los datos
del cliente para separar el encabezado de los Items de venta.
- La funcin Item ahora acepta descripciones de hasta 120 caracteres de longitud y la
divide automticamente en hasta 3 lneas adicionales antes de registrar el Item.
- La funcin Item ahora calcula e imprime correctamente el monto total cuando el
producto de la Cantidad por el Precio llega hasta BsF 9.999.999,99
- La funcin Item ahora imprime las cantidades y precios con la COMA como el
separador de decimales manteniendo consistencia con la impresora Fiscal.
- Se aplicaron las mismas correcciones a la funcion ItemDev
Fecha 08 de Enero de 2009

Version 1.0.57
- Se agregaron los contadores de Facturas y notas de credito en la respuesta del

comando LeeDatosFiscales
- La funcion Item (Venta de un Item) ahora acepta cantidades hasta 99.999,999
(Noventa y nueve mil novecientos noventa y nueve con novecientos noventa y nueve
milesimas de unidad)
Fe de errata y fallas por resolver:
2
1. El OCX NO devuelve correctamente el contador de comprobantes fiscales ni notas de

credito anulados. Solo deben tomarse en cuenta las variables UltimoCFAbierto y
UltimaNCAbierta.
3
Indice
Propiedades ......................................................................................................... 5
NPuerto............................................................................................................. 5
Mtodos................................................................................................................ 5
AbrirCF.............................................................................................................. 5
Item ................................................................................................................... 7
ItemDev............................................................................................................. 8
ItemDesc........................................................................................................... 9
CancelaCF ...................................................................................................... 10
CerrarCF ......................................................................................................... 10
SubTotal.......................................................................................................... 11
DescuentoCF.................................................................................................. 12
PagoCF........................................................................................................... 13
AbrirGavetaDinero .......................................................................................... 13
CierreDiario..................................................................................................... 14
AbrirDNF ......................................................................................................... 15
TextoDNF........................................................................................................ 15
CerrarDNF ...................................................................................................... 16
EstableceFechaHora ...................................................................................... 16
LeeDatosFiscales ........................................................................................... 17
LeeEstatus ...................................................................................................... 18
LeeZ................................................................................................................ 19
ReporteMemoriaFiscal.................................................................................... 20
SoftReset ........................................................................................................ 21
4
Propiedades
NPuerto: A esta propiedad se le asigna el numero del puerto serial a utilizar.

Debe ser inicializada antes de intentar utilizar cualquier mtodo del OCX. Tipo
Integer
NPuertoVisor: A esta propiedad se le asigna el numero del puerto serial de

la impresora fiscal (COM1 o COM2) a utilizar para enviar datos al visor de
forma automtica. Por omisin la propiedad tiene el valor 1, que indica que se
enviarn datos a un visor en el puerto 1. Si la propiedad se coloca en 0 no se
enviarn datos de forma automtica. Tipo String
NAutoGaveta: Si es igual a 1 el OCX abrir la gaveta de dinero de forma

automtica con el comando de SubTotal. Si es igual a 0 no se abre la gaveta
de forma automtica. Tipo String
Mtodos
AbrirCF(Optional Razon As String, Optional Rif As String, Optional Tipo As

String, Optional NCD As String, Optional SMaquina As String, Optional Fecha
As String, Optional Hora As String) As Boolean
Comportamiento:
Abre una Factura o una Nota de Crdito
Parmetros:
Tipo:
Si es D se abrir una Devolucin o Nota de Crdito
Si es cualquier otro valor se abrir una Factura
Razon: Razn social del cliente. Puede tener una longitud de hasta 107
caracteres y el OCX la imprimir automticamente en 1, 2 o 3 lneas segn la
longitud de la misma.
Rif: RIF del cliente
NCD: Nmero de Factura original (*)
Smaquina: Serial de la mquina que emiti la factura (*)
Fecha: Fecha en que se emiti la factura (*)
Hora: Hora en que se emiti la factura (*)
(*) Slo para notas de crdito
Retorno:
5
True OK, la factura fue abierta correctamente

False- Error
Propiedades que modifica:

Estatus:
0 OK
1- NAK
2- Timeout
Entrada: Contiene la respuesta de la impresora al comando

UltimoCFAbierto: Contiene el nmero de la Factura que se abri
UltimoCFAnulado: Contiene el nmero de la ltima Factura anulada
UltimaNCAbierta: Contiene el nmero de la Nota de Crdito que se abri
UltimaNCAnulada: Contiene el nmero de la ltima Nota de Crdito anulada
6
Item(Des As String, Cant As String, Monto As String, Tasa As String, Optional

Tipo As Integer) As Boolean
Comportamiento:
Efecta la venta o anulacin de un Artculo dentro de una Factura.
Parmetros:
Des: contiene la descripcin del articulo en venta, puede contener hasta 120
caracteres y el OCX la dividir en hasta 3 lneas adicionales antes de la venta
del Item
Cant: indica la cantida del producto. Entre 0 y 99.999,999
La longitud mxima son 8 dgitos: EEEEEDDD
EEEEE Enteros
DDD Decimales
Ejemplo: si queremos vender 1,250 tendramos en colocar 1250
Si queremos vender 1, tendramos que colocar 1000
Monto: es el precio sin impuesto del articulo. Formato EEEEEEEEDD
Siempre con 2 decimales, sin punto ni coma.
Ejemplo: 100,45 se enviara como 10045
89,00 se enviara como 8900
Tasa: es la tasa de impuesto que corresponde a dicho producto
E: Exento
G: General (IVA general, actualmente 9%)
R: Reducida
A: Adicional
Tipo: 0Anulacin. 1-Venta
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
3- Parmetro errneo
7
ItemDev(Des As String, Cant As String, Monto As String, Tasa As String,

Optional Tipo As Integer) As Boolean
Comportamiento:
Efecta la Devolucin o anulacin de devolucin de un Artculo dentro de una
Nota de crdito
Parmetros:
Des: contiene la descripcin del articulo en devolucin, puede contener hasta
120 caracteres y el OCX la dividir en hasta 3 lneas adicionales antes de la
devolucin del Item.
Cant: indica la cantida del producto. Entre 0 y 99.999,999
La longitud son 4 dgitos: EEEEEDDD
EEEEE Enteros
DDD Decimales
Ejemplo: si queremos vender 1,250 tendramos en colocar 1250
Si queremos vender 1, tendramos que colocar 1000
E: Exento
R: Reducida
A: Adicional
Tipo: 0Anulacin. 1-Venta
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
3- Parmetro errneo
8
ItemDesc(Des As String, Monto As String, Tasa As String, Optional Tipo As

Integer) As Boolean
Comportamiento:
Efecta un Descuento o anulacin de descuento de un Artculo dentro de una
factura o Nota de crdito
Parmetros:
Des: contiene la descripcin del articulo o descuento Max 19 caracteres
E: Exento
R: Reducida
A: Adicional
Tipo: 1Anulacin de descuento. 0-Descuento
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
3- Parmetro errneo
9
CancelaCF() As Boolean
Comportamiento:
Anula un comprobante en curso, Factura o Nota de Crdito
Parmetros:
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
CerrarCF() As Boolean
Comportamiento:
Cierra un comprobante en curso, Factura o Nota de Crdito.
Slo se ejecuta si se han efectuado los pagos correspondientes en el caso de
la factura.
En el caso de la nota de crdito no es necesario efectuar pagos para cerrarla.
Parmetros:
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
10
SubTotal() As Boolean
Comportamiento:
Subtotaliza el ticket y deja la impresora lista para recibir pagos
Parmetros:
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
TotalFactura Contiene el monto total de la factura en el siguiente formato

EEEEEEEEEEDD
Los ltimos 2 dgitos siempre son los decimales.

La longitud es variable.
11
DescuentoCF(Descripcion As String, montoE As String, montoG As String,

montoR As String, montoA As String) As Boolean
Comportamiento:
Permite realizar un descuento global sobre el subtotal de un comprobante fiscal
Parmetros:
Descripcion: Texto de 20 caracteres descriptivo de la operacion

montoE: Monto a descontar del total exento del ticket EEEEEEEEEEDD (*)
montoG: Monto a descontar del total tasa General del ticket EEEEEEEEEEDD
(*)
montoR: Monto a descontar del total tasa Reducida del ticket EEEEEEEEEEDD
(*)
montoA: Monto a descontar del total tasa Adicional del ticket EEEEEEEEEEDD
(*)
(*)Suponiendo que el nmero de decimales con que trabaja la mquina son 2
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
12
PagoCF(Desc as String, Monto as String, Tipo as Integer) As Boolean
Comportamiento:
Envia un pago a la impresora fiscal
Es importante notar que el comprobante fiscal no se podr cerrar si no se han
enviado pagos suficientes para cubrir el monto total de la venta.
Parmetros:
Desc: Descripcin en 20 caracteres

Monto: EEEEEEEEEEDD
Longitud: 12 caracteres, 10 enteros y 2 decimales

E: Enteros
D: Decimales
Tipo: 1-Pago
0- Anulacin de Pago
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
AbrirGavetaDinero() As Boolean
Comportamiento:
Abre la gaveta de dinero conectada al puerto de gaveta de la impresora fiscal
Parmetros:
Retorno:
True OK, Se abri la gaveta
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
13
CierreDiario(Tipo as string) As Boolean
Comportamiento:
Imprime un Reporte No fiscal X un Reporte Fiscal Z
Parmetros:
Tipo:
X Indica que el reporte a imprimir es un X
Z Indica que el reporte a imprimir es una Z
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
14
AbrirDNF() As Boolean
Comportamiento:
Abre un comprobante NO Fiscal
Parmetros:
Retorno:
True OK, el comprobante fue abierto correctamente
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
TextoDNF(TextoNoFiscal as String) As Boolean
Comportamiento:
Imprime una lnea de texto en un comprobante NO Fiscal
Parmetros:
TextoNoFiscal: Lnea a imprimir. No debe contener la palabra TOTAL.
Retorno:
True OK, la lnea se imprimi correctamente
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
15
CerrarDNF() As Boolean
Comportamiento:
Cierra un comprobante NO Fiscal
Parmetros:
Retorno:
True OK, el comprobante fue cerrado correctamente
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
EstableceFechaHora(FechaDDMMAAAA As String, HoraHHMM As String)

As Boolean
Comportamiento:
Corrige la fecha y hora de la Impresora Fiscal
Parmetros:
FechaDDMMAAAA: Fecha en formato DDMMAAAA
HoraHHMM: Hora en formato HHMM
Retorno:
True OK, La fecha y hora fueron actualizadas correctamente
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
16
LeeDatosFiscales() As Boolean
Comportamiento:
Lee los siguientes valores de la impresora fiscal:
Fecha, Hora, Serial Fiscal, Rif, Tasa G, Tasa R, Tasa A, Numero de decimales
Parmetros:
Retorno:
True OK, La fecha y hora fueron actualizadas correctamente
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
FechaMaquinaFiscal
HoraMaquinaFiscal
Serial
RIF
TasaG
TasaR
TasaA
NumDecimales
UltimoCFAbierto
UltimoCFAnulado
UltimaNCAbierta
UltimaNCAnulada
17
LeeEstatus () As Boolean
Comportamiento:
Lee el estatus de la Impresora Fiscal
Parmetros:
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
EstadoFiscal:
0 En Espera Estado inicial, listo para iniciar cualquier operacin
1 Inicio Venta Hay un comprobante fiscal abierto
2 Venta Hay un comprobante fiscal abierto con ventas
3 SubTotal Est esperando pago
4 Pago Ya recibi al menos un pago
5 Fin Venta
6 No Fiscal
7 Programacin
8 Error Debe verificar los estatus de errores especficos
9 Inicio Devolucin
: (Signo de puntuacin Dos Puntos) Devolucin
ErrorFecha:
True Fecha errnea o reloj detenido
False Fecha OK
ErrorMemoriaFiscal
True Memoria desconectada o llena
False Memoria OK
ErrorImpresora
True Impresora sin papel o con tapa abierta
False Impresora OK
18
LeeZ (optional numZ as string) As Boolean
Comportamiento:
Lee una Z de la impresora fiscal
Parmetros:
numZ: nmero de la Z que se desea leer. Si no se enva el comando retorna la
ltima Z
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
rNumZ: nmero de la Z
rFechaHoraZ: Fecha y hora de la Z (DDMMAAAAHHMM)
rBaseE: Monto de la base imponible tasa Exenta
rBaseG: Monto de la base imponible tasa General
rBaseR: Monto de la base imponible tasa Reducida
rBaseA: Monto de la base imponible tasa Adicional
rDevE: Monto de devoluciones tasa exenta
rDevG: Monto de devoluciones tasa General
rDevR: Monto de devoluciones tasa Reducida
rDevA: Monto de devoluciones tasa Adicional
rDescE: Monto de descuentos tasa exenta
rDescG: Monto de descuentos tasa General
rDescR: Monto de descuentos tasa Reducida
rDescA: Monto de descuentos tasa Adicional
rTasaG: Tasa de impuesto General
rTasaR: Tasa de impuesto Reducida
rTasaA: Tasa de impuesto Adicional
rUltimaFacturaZ: nmero de la ltima factura incluida en el reporte Z
rFechaHoraUltimaFactura: Fecha y hora de la ltima factura
(DDMMAAAAHHMM)
rTotalFacturas: Cantidad de facturas includas en el reporte Z
rTotalNotasCredito: Cantidad de notas de crdito includas en el reporte Z
rDecimales: Nmero de decimales con que estn expresados los montos
rMoneda: Descriptor de la moneda en que estn expresados los montos
rSerialZ: Serial de la mquina a la que corresponde la Z
19
ReporteMemoriaFiscal(fechaInicial As String, fechaFinal As String, Tipo

As String) As Boolean
'Imprime un reporte de la memoria fiscal
'Tipo = DIA imprime un reporte de los acumulados diarios de la impresora para
cada dia dentro del rango solicitado
'Tipo = MES imprime un reporte de los acumulados mensuales de la impresora
para cada mes dentro del rango
'fechaInicial, fechaFinal => DDMMAAAA
Comportamiento:
Imprime un reporte de la memoria fiscal
Parmetros:
Tipo:
-DIA imprime un reporte de los acumulados diarios de la impresora para cada
dia dentro del rango solicitado
-MES imprime un reporte de los acumulados mensuales de la impresora para
cada mes dentro del rango
fechaInicial, fechaFinal => DDMMAAAA
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
20
SoftReset() As Boolean
'Reinicia la Impresora Fiscal
Comportamiento:
Obliga a que la impresora Fiscal cumpla el ciclo de apagado y encendido como
si se hubiese accionado el switch fsico de encendido.
Parmetros:
Retorno:
True OK
False- Error

Estatus:
0 OK
1- NAK
2- Timeout
21
Ejemplos:
Una secuencia tpica de una Factura sera la siguiente:
Resp = VMAX1.AbrirCF("Elepos C.A.", "J-309860895")
Resp = VMAX1.Item("Item de prueba E", "1000", "9999", "E", 1)

Resp = VMAX1.Item("Item de prueba G", "1000", "9998", "G", 1)
Resp = VMAX1.Item("Item de prueba R", "1000", "9997", "R", 1)
Resp = VMAX1.Item("Item de prueba A", "1000", "9996", "A", 1)
Resp = VMAX1.SubTotal
Resp = VMAX1.PagoCF("Efectivo", VMAX1.Total, 1)
Resp = VMAX1.CerrarCF
22

Vmaxocx Manual Programacion V1106

Cargado por

Copyright:

Formatos disponibles

Vmaxocx Manual Programacion V1106

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Vmaxocx Manual Programacion V1106

Cargado por

Copyright:

Formatos disponibles

ELEPOS electrnica y puntos de venta, c.a.

Impresoras Fiscales VMAX

Manual de Programacin componente OCX

Impresoras Fiscales VMAX

1. Copiar los archivos vmax.ocx y mscomm32.ocx en la carpeta

Fecha 28 de Enero de 2009

Fecha 08 de Enero de 2009

- Se agregaron los contadores de Facturas y notas de credito en la respuesta del

Fe de errata y fallas por resolver:

1. El OCX NO devuelve correctamente el contador de comprobantes fiscales ni notas de

NPuerto: A esta propiedad se le asigna el numero del puerto serial a utilizar.

NPuertoVisor: A esta propiedad se le asigna el numero del puerto serial de

NAutoGaveta: Si es igual a 1 el OCX abrir la gaveta de dinero de forma

AbrirCF(Optional Razon As String, Optional Rif As String, Optional Tipo As

(*) Slo para notas de crdito

True OK, la factura fue abierta correctamente

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

Item(Des As String, Cant As String, Monto As String, Tasa As String, Optional

Propiedades que modifica:

ItemDev(Des As String, Cant As String, Monto As String, Tasa As String,

Propiedades que modifica:

ItemDesc(Des As String, Monto As String, Tasa As String, Optional Tipo As

Propiedades que modifica:

Propiedades que modifica:

Propiedades que modifica:

Propiedades que modifica:

TotalFactura Contiene el monto total de la factura en el siguiente formato

Los ltimos 2 dgitos siempre son los decimales.

DescuentoCF(Descripcion As String, montoE As String, montoG As String,

Descripcion: Texto de 20 caracteres descriptivo de la operacion

(*)Suponiendo que el nmero de decimales con que trabaja la mquina son 2

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

PagoCF(Desc as String, Monto as String, Tipo as Integer) As Boolean

Desc: Descripcin en 20 caracteres

Longitud: 12 caracteres, 10 enteros y 2 decimales

Propiedades que modifica:

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

CierreDiario(Tipo as string) As Boolean

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

TextoDNF(TextoNoFiscal as String) As Boolean

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

EstableceFechaHora(FechaDDMMAAAA As String, HoraHHMM As String)

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

Propiedades que modifica:

Entrada: Contiene la respuesta de la impresora al comando

Propiedades que modifica:

LeeZ (optional numZ as string) As Boolean

Propiedades que modifica:

ReporteMemoriaFiscal(fechaInicial As String, fechaFinal As String, Tipo