MANUAL DE PROTOCOLOS Y COMANDOS
Impresoras Fiscales
Versión 8.1 - Venezuela Diciembre de 2016
The Factory HKA, C.A.
MANUAL DE PROTOCOLOS Y COMANDOS VERSIÓN 8.1 - VENEZUELA
The Factory HKA La California Norte, Callejón Gutiérrez Edif. Riva, PB Ofic. 2-1, Caracas - Venezuela Teléfono (212) 237.4112• 2398176 Departamento de Soporte e Integración
[email protected]
2
CONTENIDO PRECAUCIONES .................................................................................................................................. 8 CONCEPTOS BÁSICOS ......................................................................................................................... 9 ¿QUÉ ES UNA IMPRESORA FISCAL? ........................................................................................................... 9 ¿CÓMO ESTÁ CONSTITUIDA LA IMPRESORA FISCAL? ............................................................................... 9 MEMORIA FISCAL .................................................................................................................................... 10 MEMORIA AUDITORIA ............................................................................................................................. 10 MEMORIA DE TRABAJO ........................................................................................................................... 10 DOCUMENTOS QUE EMITE LA IMPRESORA FISCAL ................................................................................ 10 COMUNICACIÓN ENTRE EL PC Y LA IMPRESORA FISCAL .............................................. ....................... 11 PROTOCOLO DE COMUNICACIÓN ........................................................................................................... 11 CONFIGURACIÓN ..................................................................................................................................... 12 ESTRUCTURA DE LA TRAMA DE COMUNICACIÓN ................................................................................... 13 CONTROL DE TRÁFICO Y TRAMA DE COMUNICACIÓN ............................................................................ 14 CARACTERES DE CONTROL ...................................................................................................................... 14 RECEPCIÓN DE ACK (0X06) ...................................................................................................................... 14 RECEPCIÓN DE NAK (0X15) ...................................................................................................................... 14 SECUENCIA DE COMANDOS DE COMUNICACIÓN ................................................................................... 15 LEER ESTADO ........................................................................................................................................... 15 COMANDOS SIMPLES .............................................................................................................................. 17 COMANDO DE LECTURA .......................................................................................................................... 17 COMANDO DE LECTURA DE INFORMACIÓN ........................................................................................... 17 BUENAS PRACTICAS DE PROGRAMACIÓN ......................................................................................... 18 COMPONENTES DE INTEGRACIÓN .......................................................................................................... 18 COMANDOS PARA LA P ROGRAMACIÓN DE LA IMPRESORA FISCAL ..................................... ............... 19 REGISTRO DE CAJERO .............................................................................................................................. 20 INICIO DEL CAJERO .................................................................................................................................. 20 FIN DE CAJERO ......................................................................................................................................... 20 MEDIOS DE PAGO .................................................................................................................................... 20 PROGRAMACIÓN DE HORA ..................................................................................................................... 21 PROGRAMACIÓN DE FECHA .................................................................................................................... 21 TASAS DE IMPUESTO ............................................................................................................................... 22 REGISTRAR TASAS EN LA MEMORIA FISCAL ............................................................................................ 22 3
ENCABEZADO Y PIE DE PÁGINA ............................................................................................................... 22 BANDERAS DE PROGRAMACIÓN (FLAGS) ............................................................................................... 23 MANEJO DEL VISOR O DISPLAY DE PRECIOS CLIENTE ............................................................................. 23 MOSTRAR HORA Y FECHA ....................................................................................................................... 23 PROGRAMACIÓN DE MENSAJE COMERCIAL EN EL VISOR ...................................................................... 24 MOSTRAR MENSAJE COMERCIAL ............................................................................................................ 24 PROGRAMAR MENSAJES TEMPORALES EN EL VISOR O DISPLAY ............................................................ 24 COMANDOS PARA GENERAR UNA FACTURA ..................................................................................... 25 RIF/C.I. DEL CLIENTE ................................................................................................................................ 27 RAZÓN SOCIAL DEL CLIENTE .................................................................................................................... 27 INFORMACIÓN ADICIONAL DEL CLIENTE ................................................................................................ 27 COMENTARIO .......................................................................................................................................... 28 REGISTRO DE PRODUCTO ........................................................................................................................ 28 CORRECCIÓN ........................................................................................................................................... 29 SUBTOTAL ................................................................................................................................................ 29 DESCUENTOS Y RECARGOS ...................................................................................................................... 29 DESCUENTO Y RECARGO POR PORCENTAJE............................................................................................ 29 DESCUENTO Y RECARGO POR MONTO ................................................................................................... 30 ANULACIÓN DE UN ÍTEM......................................................................................................................... 30 ANULACIÓN DE FACTURA ........................................................................................................................ 31 CÓDIGO DE BARRAS ................................................................................................................................ 31 TOTALIZACIÓN POR PAGO DIRECTO ....................................................................................................... 32 TOTALIZACIÓN POR PAGO PARCIAL ........................................................................................................ 32 COMANDOS PARA GENERAR UNA NOTA DE CRÉDITO (DEVOLUCIÓN) ................................................ 33 RIF/C.I. DEL CLIENTE ................................................................................................................................ 35 RAZÓN SOCIAL DEL CLIENTE .................................................................................................................... 35 NÚMERO DE FACTURA AFECTADA .......................................................................................................... 35 FECHA DE FACTURA AFECTADA ............................................................................................................... 35 SERIAL DE LA IMPRESORA QUE EMITIÓ LA FACTURA AFECTADA ........................................................... 36 INFORMACIÓN ADICIONAL DEL CLIENTE ................................................................................................ 36 COMENTARIO .......................................................................................................................................... 37 REGISTRO DE PRODUCTO ........................................................................................................................ 37 CORRECCIÓN ........................................................................................................................................... 38 4
SUBTOTAL ................................................................................................................................................ 38 DESCUENTOS Y RECARGOS ...................................................................................................................... 38 DESCUENTO Y RECARGO POR PORCENTAJE............................................................................................ 38 DESCUENTO Y RECARGO POR MONTO ................................................................................................... 39 ANULACIÓN DE UN ÍTEM......................................................................................................................... 39 ANULACIÓN DE NOTA DE CRÉDITO ......................................................................................................... 40 CÓDIGO DE BARRAS ................................................................................................................................ 40 TOTALIZACIÓN POR PAGO DIRECTO ....................................................................................................... 41 TOTALIZACIÓN POR PAGO PARCIAL ........................................................................................................ 41 COMANDOS PARA GENERAR UNA NOTA DE DÉBITO.......................................................................... 42 RIF/C.I. DEL CLIENTE ................................................................................................................................ 44 RAZÓN SOCIAL DEL CLIENTE .................................................................................................................... 44 NÚMERO DE FACTURA AFECTADA .......................................................................................................... 44 FECHA DE FACTURA RELACIONADA ........................................................................................................ 44 SERIAL DE LA IMPRESORA QUE EMITIÓ LA FACTURA AFECTADA ........................................................... 45 INFORMACIÓN ADICIONAL DEL CLIENTE ................................................................................................ 45 COMENTARIO .......................................................................................................................................... 46 REGISTRO DE PRODUCTO ........................................................................................................................ 46 CORRECCIÓN ........................................................................................................................................... 47 SUBTOTAL ................................................................................................................................................ 47 DESCUENTOS Y RECARGOS ...................................................................................................................... 47 DESCUENTO Y RECARGO POR PORCENTAJE............................................................................................ 47 DESCUENTO Y RECARGO POR MONTO ................................................................................................... 48 ANULACIÓN DE UN ÍTEM......................................................................................................................... 48 ANULACIÓN DE NOTA DE DÉBITO ........................................................................................................... 49 CÓDIGO DE BARRAS ................................................................................................................................ 49 TOTALIZACIÓN POR PAGO DIRECTO ....................................................................................................... 50 TOTALIZACIÓN POR PAGO PARCIAL ........................................................................................................ 51 COMANDOS PARA GENERAR DOCUMENTOS NO FISCALES .................................................... ............. 51 TEXTO EN DOCUMENTO .......................................................................................................................... 52 APERTURA DE GAVETA ............................................................................................................................ 53 RETIRO Y FONDO DE CAJA ....................................................................................................................... 53 FIN DE RETIRO Y FONDO DE CAJA ........................................................................................................... 54 5
IMPRIMIR PROGRAMACIÓN .................................................................................................................... 54 IMPRIMIR ESTADO DE LA MEMORIA DE AUDITORÍA .............................................................................. 54 REIMPRESIÓN Y EXTRACCIÓN DE DOC. DE LA MEMORIA DE AUDITORÍA .............................................. 54 REIMPRESIÓN POR RANGO DE NÚMERO ................................................................................................ 55 REIMPRESIÓN POR RANGO DE FECHA .................................................................................................... 55 REIMPRESIÓN POR NÚMERO DE CÉDULA O RIF ..................................................................................... 56 EXTRACCIÓN POR RANGO DE NÚMERO .................................................................................................. 57 EXTRACCIÓN POR RANGO DE FECHA ...................................................................................................... 57 EXTRACCIÓN POR NÚMERO DE CÉDULA O RIF ....................................................................................... 58 COMANDOS PARA LEER LOS STATUS DE INFORMACIÓN .................................................................... 58 STATUS S1 ................................................................................................................................................ 59 STATUS S2 ................................................................................................................................................ 60 STATUS S2E .............................................................................................................................................. 61 STATUS S21 .............................................................................................................................................. 61 STATUS S22 .............................................................................................................................................. 62 STATUS S23 .............................................................................................................................................. 63 STATUS S3 ................................................................................................................................................ 64 STATUS S4 ................................................................................................................................................ 64 STATUS S5 ................................................................................................................................................ 65 STATUS S8E Y S8P .................................................................................................................................... 65 COMANDO SV .......................................................................................................................................... 66 COMANDOS PARA IMPRIMIR REPORTES .............................................................................. ............. 67 IMPRIMIR REPORTE X .............................................................................................................................. 67 IMPRIMIR REPORTE X2 ............................................................................................................................ 67 BORRAR ACUMULADO DEL REPORTE X2 ................................................................................................. 67 IMPRIMIR REPORTE DE CIERRE DIARIO Z ................................................................................................ 67 IMPRIMIR REPORTE Z2 ............................................................................................................................ 67 BORRAR ACUMULADO DEL REPORTE Z2 ................................................................................................. 68 IMPRIMIR REPORTE DE MEMORIA FISCAL POR NÚMERO ...................................................................... 68 IMPRIMIR REPORTE DE MEMORIA FISCAL POR FECHA ........................................................................... 68 COMANDOS PARA EXTRAER REPORTES .................................................... ......................................... 69 EXTRAER REPORTE X ................................................................................................................................ 69 EXTRAER REPORTE Z ................................................................................................................................ 71 6
EXTRAER REPORTE DE MEMORIA FISCAL POR NÚMERO ........................................................................ 72 EXTRAER REPORTE DE MEMORIA FISCAL POR FECHA ............................................................................ 73 EXTRAER INFORMACIÓN DE REPORTES DETALLADOS POR DOCUMENTO. ........................................... 73 COMANDOS PARA CHEQUERA (SOLO STAR7000)........................................................ ....................... 75 CHEQUE ................................................................................................................................................... 75 MODO DE SLIP ......................................................................................................................................... 75 FORMATO DEL CHEQUE (PARTE FRONTAL)............................................................................................. 75 FORMATO DEL CHEQUE (ENDOSO) ......................................................................................................... 76 IMPRIMIR ENDOSO .................................................................................................................................. 76 MODO DE VALIDACIÓN ........................................................................................................................... 77 IMPRESIÓN DE VALIDACIÓN .................................................................................................................... 77 LECTURA DEL MICR.................................................................................................................................. 77 STATUS S6 ................................................................................................................................................ 78 STATUS S7 ................................................................................................................................................ 78 ANEXOS. TABLA DE CARACTERES ............................................................................... ....................... 79
7
PRECAUCIONES
NO ENCHUFE VARIOS EQUIPOS A UNA MISMA TOMA DE CORRIENTE AL MISMO TIEMPO.
NO MANIPULE EL CABLE CON LAS MANOS HUMEDAS.
EVITE QUE EL CABLE SE DOBLE EN ANGULOS MAYORES A 90° O QUE ESTE DEBAJO DE OBJETOS PESADOS.
SI LA IMPRESORA GENERA HUMO, OLOR O RUIDOS EXTRAÑOS, APAGUE Y DESCONECTE. LLAME A SU DISTRIBUIDOR PARA REPARACIONES.
NO INTENTE DESMONTAR O REPARAR LA IMPRESORA. LLAME A SU DISTRIBUIDOR SI NECESITA ESTOS SERVICIOS.
NO DEJE CAER AGUA U OTROS OBJETOS SOBRE LA IMPRESORA. SI ESTO SUCEDE, DESCONECTE Y LLAME A SU DISTRIBUIDOR.
8
CONCEPTOS BÁSICOS Algunos conceptos básicos que pueden ayudar a manejar las impresoras fiscales son los siguientes:
¿QUÉ ES UNA IMPRESORA FISCAL? Es una unidad de impresión autorizada por el Servicio Nacional Integrado de Administración Aduanera y Tributaria (SENIAT) para la emisión de Facturas, Notas de Crédito, Notas de Débito, Documentos No Fiscales, Reporte Z, Reporte de Memoria Fiscal. En virtud del cumplimiento o exigencias que se establecen en la ley para el manejo de impresoras fiscales.
¿CÓMO ESTÁ CONSTITUIDA LA IMPRESORA FISCAL? La impresora fiscal está constituida por los siguientes módulos: Memoria Fiscal
Módulo Fiscal
Memoria Auditoria Memoria Trabajo
Impresora Fiscal
Impresor Módulo Impresión
Fin Papel Sensores Tapa Abierta
Imagen 1. Estructura de la Impresora Fiscal La impresora fiscal está compuesta por ciertos componentes de hardware que la distinguen de una impresora regular. Por lo general, dichos componentes se ubican sobre una única placa base distinta a la del módulo de impresión y comprende una memoria fiscal, una memoria de trabajo y una memoria de auditoria. A la integración de un software sobre un hardware para ejecutar alguna acción determinada, se le denomina Firmware. La impresora fiscal está controlada por dicho software, quien regula su correcto funcionamiento (particularmente sobre los componentes principales: memorias Fiscal, de Auditoria y de Trabajo). Todos estos componentes serán descritos con mayor detalle en las siguientes secciones de este manual.
9
MEMORIA FISCAL Dispositivo electrónico de almacenamiento, con capacidad de 2000 ó 4000 Reportes Z (la capacidad depende del modelo de la impresora fiscal), su función es almacenar la información contenida en los reportes Z emitidos por el equipo. Es el único tipo de documentos que almacena. Se encuentra adherida al chasis de la impresora.
MEMORIA AUDITORIA Tiene una capacidad de almacenamiento de 2 GB. En este dispositivo se almacenan electrónicamente todas las transacciones realizadas a través de la impresora fiscal (incluyendo las copias de todos los documentos impresos y copias de copias).
MEMORIA DE TRABAJO Tiene una capacidad de almacenamiento que varía dependiendo del modelo de la impresora fiscal. Se encuentra integrada al módulo fiscal. Su función es almacenar la información fiscal de una jornada laboral, en ella se almacenan los contadores y los acumuladores de ventas (estos últimos, se inicializan a cero al realizar un reporte Z).
DOCUMENTOS QUE EMITE LA IMPRESORA FISCAL Los documentos que emite la impresora cumplen con todas las exigencias de Ley establecidas, además genera otros documentos con fines de control administrativo. Estos documentos se dividen en: Facturas Nota de crédito Fiscales Nota de débito Reportes de memoria fiscal Reporte Z Documentos
Reporte X Reporte X2 Reporte Z2 No Fiscales
Copias o Reimpresión de documentos Impresión de Programación Documentos texto
Imagen 2. Documentos emitidos por la impresora fiscal 10
COMUNICACIÓN ENTRE EL PC Y LA IMPRESORA FISCAL El protocolo de comunicación de las impresoras fiscales se basa en el estándar RS232 de comunicación serial. Para esto, es necesaria una interfaz de aplicación que gestione este protocolo, esto es, que sea capaz de enviar los comandos desde el computador hacia la impresora e interpretar las respuestas que esta retorna. Estos comandos corresponden a protocolos seriales almacenados en el firmware de la impresora. Los comandos de estos protocolos pueden ser enviados a la impresora de dos maneras: directamente a través del manejo del puerto serial (llamado Protocolo Directo), o utilizando interfaces de programación de aplicaciones (API, Application Programming Interface) las cuales dependen del sistema operativo a utilizar y del lenguaje de programación utilizado para desarrollar el Sistema Administrativo que estará asociado la impresora.
PC
Protocolo Directo
IMPRESORA FISCAL
Imagen 3. Interfaz de Aplicación Actualmente The Factory HKA posee una amplia gama de herramientas de integración que contienen estas API’s para los diferentes lenguajes de programación y sistemas operativos disponibles.
PROTOCOLO DE COMUNICACIÓN El Protocolo de Comunicación es la manera en que la computadora realiza el intercambio de datos con la impresora. Basado en el estándar serial RS232, el Protocolo de Comunicación está estructurado mediante una trama conformada por una señal de inicio (0x02h) seguida de los caracteres que conforman los comandos y datos a enviar a la impresora, luego un carácter de fin de trama (0x03h) y una señal de detección de errores. De igual manera, si la impresora ha de retornar algún valor, lo hará en una trama conformada de manera idéntica a la anteriormente descrita.
11
CONFIGURACIÓN El protocolo utilizado para enviar información a la impresora es el Serial RS232. La imagen N° 4 muestra las señales de control utilizadas en el protocolo.
Imagen 4. Pinout para conector DB9
Conector RJ11 Pinout del RJ11 1 2 3 4 5 6
Color Blanco Amarillo Rojo Verde Azul
Señal Control CTS Tierra Rx Tx RTS
Pin
Señal
En Ingles
Siglas
2
Receptor de datos Transmisor de datos Señal de tierra
Received Data Transmit ted Data Common Ground
RxD
Tipo de Señal Entrada
TxD
Salida
SG
-
7
Solicitud de envío
Request to send
RTS
Salida
8
Listo para enviar
Clear to Send
CTS
Entrada
3 5
Función Pin de recepción de datos Pin de transmisión de datos Tierra El PC puede recibir datos (porque no está ocupado) El aparato conectado puede recibir datos
Una vez que la PC ha activado la señal RTS (solicitud a la impresora que esté conectada y lista para recibir datos), la impresora fiscal responde con la señal CTS (Impresora lista) para indicar que es posible la recepción. Los parámetros de configuración del puerto serial son los siguientes: Transmisión de data Baud rate Bit de datos Paridad Bits de stop
Serial, Asíncrona 9600 bps 8 bits Par 1
12
ESTRUCTURA DE LA TRAMA DE COMUNICACIÓN La trama de comunicación es el conjunto de datos que debe enviarse a la impresora para que cumpla determinada instrucción; debe enviarse en orden y está constituida siempre por cuatro secciones.
Imagen 5. Estructura de la trama a enviar Las secciones de la trama de comunicación son las siguientes:
Carácter de inicio de trama (STX): representado por el carácter 0x02h, es un valor reservado únicamente a este fin. DATA: Es el comando y sus argumentos, enviados a la impresora para que ejecute una determinada acción. Carácter de Fin de Trama (ETX): representado por el carácter 0x03h indica el fin de la trama y es un valor reservado únicamente a este fin. LRC: Su valor es el OR exclusivo (XOR) entre la DATA y ETX, dirigido a la detección de error de la trama.
IMPORTANTE: El desarrollador podrá utilizar el protocolo directo o usar los componentes de integración que The Factory HKA tiene a su disposición. Cuando se utiliza el protocolo directo la trama se envía completa, cuando se utilizan las interfaces o componentes de Integración solamente se envía el campo DATA. Si se utilizan las herramientas de integración desarrolladas por The Factory HKA, se envía el contenido de DATA mediante caracteres ASCII y para los componentes integración se encargan de convertirlos a su respectivo equivalente hexadecimal enviarlos a la de impresora. Por ejemplo, si se envía por protocolo directo la instrucción de impresión de Reporte X, se debe enviar a la impresora una trama como la que se muestra en la siguiente tabla: ASCII HEX
02 Inicio de trama
I 49
0 30 DATA
X 58
03 Fin de Trama
LRC 22 LRC
Si se utilizan las herramientas de integración desarrolladas por The Factory HKA, la trama anterior se reduciría solo a la DATA, y se utilizaría una función para enviarla a la impresora (verificar el respectivo manual del API a utilizar).
13
CONTROL DE TRÁFICO Y TRAMA DE COMUNICACIÓN CARACTERES DE CONTROL La mayoría de caracteres de control son representados con valores de caracteres no imprimibles, por lo que su inclusión en la trama - Protocolo Directo - debe realizarse mediante su valor hexadecimal. Carácter STX ENQ
Hexadecimal 0x02 0x05
ETX ACK NAK ETB LRC EOT
Descripción Inicio de Trama Solicitud de status & Error
0x03 Fin de Trama 0x06 Reconocimiento del comando 0x15 NO Reconocimiento del comando 0x17 Fin del bloque de transmisión 0x00-0xFF OR exclusivo de data con ETX. (Incluyendo ETX.) 0X04 Fin de trasmisión
De la lista anterior cabe destacar dos caracteres de Control, ya que constituyen las principales respuestas de la impresora ante los comandos enviados.
RECEPCIÓN DE ACK (0X06) Ocurre cuando se satisfacen las siguientes condiciones:
LRC y DATA son correctos. El comando es aceptable para la condición actual de la impresora.
RECEPCIÓN DE NAK (0X15) Ocurre ante cualquiera de las siguientes condiciones:
LRC errado. El comando enviado a la impresora no fue válido.
Si se envía un comando y la impresora está ocupada, no se retorna ningún valor. Se pude verificar esta condición a través de la señal DTR de la impresora. Se debe enviar ENQ o NAK de regreso a la impresora si un error de comunicación fue detectado en La PC. Para los comandos donde las consultas deben retornar una trama de información, tales como la extracción de datos de la Memoria de Auditoría para la obtención de reportes, se lleva a cabo el siguiente protocolo:
PC
Se envía el comando del reporte La impresora responde un (0x05) Se responde un (0x06) a la impresora La impresora retorna la data solicitada
IMPRESORA FISCAL
Imagen 6. Caracteres de control para consulta de una trama de comunicación 14
El comando de solicitud de lectura de la memoria varía de acuerdo al tipo de reporte a requerir, así como también varía la estructura de la trama devuelta por la impresora.
SECUENCIA DE COMANDOS DE COMUNICACIÓN LEER ESTADO Para determinar el estado en que se encuentra la impresora fiscal, se envía un Enquirement (ENQ=0x05h). Este comando se envía para determinar el estado en que se encuentra y si existe un error, evaluar cuál es. Cuando se envía un ENQ a la impresora, ésta responde con una trama similar a la de recepción, donde DATA es un par de bytes que contienen la información del Estado y el posible Error de la impresora. PC ENQ
Impresora STX-STATUS-ETX-LRC
La impresora responderá una trama con la siguiente estructura: STX
STS1
STS2
ETX
LRC
Imagen 7. Trama de repuesta de la impresora Dónde:
STS1 corresponde al Estado de la impresora. STS2 corresponde al Error de la impresora.
Cada bit en alto de STS1 y STS2 representa un estado específico.
Estado
27
0 Valores Constantes
26
1
25
X
24
X
23
X
22
X
21
X
20
X
Modo Fiscal Memoria Fiscal cercana a agotarse Memoria Fiscal llena Buffer Lleno Transacción no fiscal en curso Transacción fiscal en curso
15
Error
27
0
26
1
25
0
24
23
X
X
22
X
21
X
20
X
Valores Constantes Error Crítico Error Gaveta Error Impresor Error en Impresora Error Papel Ejemplo: Evaluar la respuesta 0x62 0x41 0x21
0
1
1
Status (0x62) 0 0 0
Modo Fiscal
1
0
0
1
0
Error (0x41) 0 0 0
Transacción No Fiscal en Curso
0
1
Error de Papel
Las siguientes tablas contienen los valores frecuentes para los bytes de Status (STS1) y Error (STS2) de las impresoras fiscales: Valores de Status (STS1) 0x40 Modo Entrenamiento y en Espera 0x41 Modo Entrenamiento y en medio de una Transacción Fiscal 0x42 Modo Entrenamiento y en medio de una Transacción No fiscal 0x60 Modo Fiscal y en Espera 0x68 Modo Fiscal con la MF llena y en Espera 0x61 Modo Fiscal y en medio de una Transacción Fiscal 0x69 Modo Fiscal con la MF llena y en medio de una Transacción Fiscal 0x62 Modo Fiscal y en medio de una Transacción No fiscal 0x6A Modo Fiscal con la MF llena y en Transacción No fiscal Valores de Error (STS2) 0x40 Ningún error 0x48 Error gaveta 0x41 Error sin papel 0x42 Error mecánico de la impresora / papel 0x43 Error mecánico de la impresora y fin de papel 0x60 Error fiscal 0x64 Error en la memoria fiscal 0x6C Error memoria fiscal llena Imagen 8. Estados y Error de la Impresora en Hexadecimal 16
COMANDOS SIMPLES PC (Ejecución Normal “ACK”)
STX-CMD-DATA-ETX-LRC
(Ejecución con Error “NAK”)
STX-CMD-DATA-ETX-LRC
(Impresora Ocupada “NAK”)
STX-CMD-DATA-ETX-LRC
Impresora ACK NAK (Error de Comunicación) DTR off
En el caso en que la impresora regresa un NAK (no reconocimiento o el comando no fue válido). Cuando se envía un comando y la impresora está ocupada, no se retorna ningún valor, esta condición puede ser verificada a través de la señal DTR de la impresora.
COMANDO DE LECTURA PC STX-CMD-DATA-ETX-LRC
Impresora
ACK
STX-CMD-DATA-ETX-LRC
Se debe enviar ENQ o NAK de regreso a la impresora si un error de comunicación fue detectado en el host (PC).
COMANDO DE LECTURA DE INFORMACIÓN PC STX-CMD1-DATA-ETX-LRC
Impresora
ACK ACK
STX-DATA0-ETB-LRC
STX-DATAn-ETB-LRC EOT
IMPORTANTE: Cuando se utilizan las API suministradas por The Factory HKA, éstas se encargan de enviar de forma automática el ACK, mientras que a través de protocolo directo se debe enviar el ACK a la impresora para poder recibir el próximo bloque de información.
17
BUENAS PRACTICAS DE PROGRAMACIÓN Esto hace referencia a la forma en la que el sistema administrativo o de facturación se comunica con la impresora fiscal. Tome en consideración los siguientes puntos: 1.
2. 3.
Los errores comunes a los que debe estar atento son: impresora apagada, falta de papel, error en la comunicación (configuración de los puertos COM), las tasas de los productos no se encuentran programadas (deben programarse para poder enviar un producto), la impresora se encuentra en medio de una transacción fiscal. Al momento de iniciar el sistema administrativo verifique la comunicación con la impresora. Compruebe el estado y errores (status & error) de la impresora. Para eso emplee la función ReadFpStatus(), si su sistema usa uno de nuestros componentes o el envío del comando 0x05
4.
5.
6. 7.
8.
por el puerto serial en caso de usar el protocolo directo. Lea la respuesta de la impresora basada en las tablas de Status y Error. Utilice los status informativos. Verifique los datos de la impresora referenciados a: Tasas, Fecha, Hora, Serial, RIF, número de la última factura, número de las últimas Notas de crédito y débito y número del último Reporte Z. Para ello haga uso del comando S1. Cuando envíe comandos a la impresora fiscal, lea la respuesta de la impresora referente a ese comando para estar seguro si se procesó o no. De ser exitoso, proceda al envío del siguiente comando; en caso contrario, debe crear una rutina para el manejo de errores. Asegúrese de que la información esté en la impresora antes de procesarla en el sistema. Realice consultas de Status S2 durante las transacciones para comparar los cálculos del sistema administrativo con los de la impresora y realizar posibles ajustes de redondeo antes de cerrar y emitir el documento. No es necesario la apertura y cierre constante del puerto de comunicaciones por cada envío de comandos. Una vez iniciado el sistema, abra el puerto y una vez decida cerrar el sistema, cierre
consigo el puerto de comunicaciones. Depure el desarrollo del sistema administrativo en relación a la impresora fiscal, evite en lo posible errores de los antes mencionados durante la puesta en marcha del mismo. 10. Utilice un programa Monitor de Puerto Serial para verificar las tramas enviadas y las respuestas de la impresora. 11. Se recomienda el manejo de la impresora en un solo “thread” sincronizado. 9.
COMPONENTES DE INTEGRACIÓN The Factory HKA ha desarrollado una serie de Kits de Desarrollo de Software (SDK), a fin de dar soporte a la integración de los sistemas administrativos desarrollados en los diversos lenguajes de programación y plataformas disponibles actualmente. Estos componentes están sometidos a mejoras continuas y transparentes al desarrollador para garantizar una integración exitosa entre sus sistemas y nuestros equipos.
18
Los kits de desarrollo de software contienen:
Interfaces de Programación de Aplicaciones (API’s)
Manuales de Integración. Demos básicos con sus Códigos Fuentes.
En la siguiente tabla se muestran los diferentes lenguajes soportados por las herramientas de desarrollo de The Factory HKA. Sistema Operativo
Tecnología
API
DEMO Delphi
Win32
Librería Dinámica (DLL)
.NET
Librería Dinámica (DLL)
Java Consola Consola Consola Java
Clase compilada (JAR) Aplicación + .php Aplicación Aplicación + .php Clase compilada (JAR)
VB6 C# FoxPro PowerBuilder C# Visual Basic Java PHP PHP Java
Windows
Linux / UNIX
COMANDOS PARA LA PROGRAMACIÓN DE LA IMPRESORA FISCAL La impresora fiscal maneja varios parámetros que son de uso importante para su funcionamiento, los cuales deben ser programados. Algunos son opcionales y otros obligatorios, en algunos casos estos parámetros tienen requisitos previos para su configuración. Cuando el distribuidor entrega la impresora fiscal al cliente final, esta última ya viene programada con ciertos parámetros para su funcionamiento los cuales son: Tasas de Impuesto, Hora y Fecha, Medios de pago, Encabezado y Pie de Página. El sistema administrativo puede igualmente programar los Medios de Pago y Cajeros. Los medios de pago, programación del visor o Display y los cajeros se programan de acuerdo a las necesidades del cliente final. Estructura de los comandos de programación para los parámetros de configuración:
Parametros de impresora
Datos del cajero
Medios pagosde
Fecha / Hora
Tasas de impuesto
Encabezado Pie de página/
Flags
19
REGISTRO DE CAJERO Este comando permite definir la información relativa a un cajero. Es necesaria la programación previa del cajero mediante éste comando para ejecutar el comando Inicio de Cajero. STX STX
PC PC
ID 02
Código Secreto Nombre del Cajero ETX 12345 Pedro ETX
LRC LRC
ID 2 caracteres (01 – 30)
Número de Cajero
Código Secreto 5 caracteres (00000 – 99999) Nombre del Cajero 16 caracteres máximo
Indique un código secreto del Cajero (numérico) Indique la Descripción o Nombre del Cajero
INICIO DEL CAJERO Éste comando permite iniciar un cajero previamente registrado. Este comando es de uso opcional. STX STX
5 5
Código Secreto 12345
Código Secreto del Cajero (numérico)
ETX ETX
LRC LRC
Código Secreto 5 caracteres (00000 – 99999)
FIN DE CAJERO Éste comando finaliza el cajero que este activo en ese momento. No se puede utilizar éste comando si existe una transacción abierta. STX
6
ETX LRC
MEDIOS DE PAGO Este comando permite definir los descriptores para cada medio de pago, por ejemplo: Efectivo, Cheque, Tarjeta de Crédito, Tarjeta de Débito, entre otros. Su uso va de la mano con los pagos parciales y totales. Las impresoras fiscales manejan 16 ó 24 medios de pagos, varía según el modelo.
STX STX
PE PE
ID 02
Nombre del Medio de Pago Tarjeta Debito
ETX ETX
LRC LRC
20
ID 01 – 24
Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112, HSP7000, TALLY 1125, SRP-270, SRP-280, OKI 1120, PP1F3, KUBE)
01 – 16 Nombre del Medio de Pago 14 caracteres máximo
Descriptor del Medio de Pago
PROGRAMACIÓN DE HORA Este comando permite programar la hora actual de la impresora fiscal. Para ello debe realizar previamente un Reporte Z. STX STX
PF PF
HH 13
MM 30
SS 55
ETX LRC ETX LRC
HH 2 caracteres (formato 24h) MM 2 caracteres SS 2 caracteres
Hora Minuto Segundo
PROGRAMACIÓN DE FECHA Este comando permite programar la Fecha actual de la impresora fiscal. Para ello debe realizar previamente un Reporte Z. IMPORTANTE: Debe tenerse en cuenta, una vez fiscalizada la impresora no se puede retroceder la fecha a una anterior a la emisión del último reporte Z. STX STX
Día Mes Año
PG PG
DD 02
MM 06
YY 16
ETX LRC EXT LRC DD 2 caracteres MM 2 caracteres YY 2 caracteres
21
TASAS DE IMPUESTO Este comando permite grabar el valor de las tasas de impuesto en la tarjeta fiscal. Para ello debe realizar previamente un Reporte Z. STX
PT
STX
PT
Tipo 1
Tasa 1 Valor 1200
Tipo 1
Tasa 2 Valor 0800
Tipo 1
Tasa 3 Valor 2700
ETX LRC ETX LRC Tipo 1: Tasa excluida 2: Tasa incluida Valor 4 caracteres
Impuesto Excluido (Precio ítem = base imponible) Impuesto Incluido (Precio ítem = base imponible + IVA) El Valor Consta (2 enteros + 2 decimales)
REGISTRAR TASAS EN LA MEMORIA FISCAL Éste comando se utiliza para confirmar que las tasas registradas en la tarjeta fiscal son correctas y graban dicho valor en la memoria fiscal. IMPORTANTE: Todos los cambios de tasas son grabados en la memoria fiscal como medida de seguridad, por ésta razón éste comando podrá ser ejecutado un máximo de 64 veces. STX
Pt
ETX LRC
ENCABEZADO Y PIE DE PÁGINA Éste comando permite definir los mensajes que se muestran en el encabezado y pie de página de los documentos. Para ello debe realizar previamente un Reporte Z. STX STX
PH PH
Línea 01
Número de línea del Encabezado Número de línea del Pie de Página Texto a programar
Mensaje Hola
ETX LRC ETX LRC
Línea 2 caracteres (01 – 08) 2 caracteres (91 – 98) Mensaje Ver Anexos. Tabla de Caracteres
IMPORTANTE: No debe confundirse la “Programación de encabezado y pie de página” con los “Datos adicionales clienteque en encabezado y pie de página”. La programación de yencabezado y pie de es estática, del mientras los datos adicionales del cliente son dinámicos deben enviarse porpágina cada documento emitido. 22
IMPORTANTE: En el equipos Dascom Tally 1125, la cantidad de caracteres que se muestran para el encabezado y el pie de página puede variar dependiendo de la configuración del formato de página, mientras que el equipo OKI MICROLINE 1120 solo muestra 39 caracteres para encabezado. IMPORTANTE: El equipo Aclas PP1F3 solo muestra 32 caracteres.
BANDERAS DE PROGRAMACIÓN (FLAGS) Éste comando permite definir el valor de las opciones de configuración utilizadas por el equipo. STX
PJ
Bandera
Valor
ETX
LRC
STX
PJ
04
02
ETX
LRC
Bandera 2 caracteres Valor 2 caracteres
Tipo de bandera Valor de la bandera
IMPORTANTE: Descargar la lista de flag de cada equipo del portal Web, ya que la cantidad de flags y función de éstos varía dependiendo del modelo de impresora fiscal.
MANEJO DEL VISOR O DISPLAY DE PRECIOS CLIENTE Estructura de los comandos de programación del visor o display.
Visor o Display
Mostrar Hora / Fecha
Mensaje Comercial
Mensaje Temporal
Mensaje estático
IMPORTANTE: En los equipos Aclas PP9 y PP1F3 no se pueden programar mensajes comerciales ni temporales, ya que el mismo no posee puerto para visor externo, y el visor que tiene incorporado éste equipo no es LCD sino de segmentos.
MOSTRAR HORA Y FECHA Muestra en el Visor la hora y la fecha. No es posible ejecutar éste comando durante una transacción. STX
a
ETX
LRC
23
PROGRAMACIÓN DE MENSAJE COMERCIAL EN EL VISOR Éste comando permite programar el mensaje comercial que se muestra en el Visor. El funcionamiento de este comando está sujeto al valor de los flags 18 y 19 (ver lista de flags de la impresora fiscal). STX STX
PI PI
Mensaje ETX Bienvenido ETX
LRC LRC Mensaje
Indicador de Mensaje comercial en el Display
50 caracteres máximo
MOSTRAR MENSAJE COMERCIAL Permite activar/desactivar la rotación del comercial programado. No es posible ejecutar éste comando durante una transacción. STX
b
ETX
LRC
IMPORTANTE: El comando b de rotación de mensaje debe estar desactivado al momento de programar los flags 18 y 19, a fin de evitar incompatibilidades.
PROGRAMAR MENSAJES TEMPORALES EN EL VISOR O DISPLAY Muestra unimpresora mensaje fiscal. en el Visor. La duración del mensaje es unos segundos y varía dependiendo del modelo de STX STX
c c
Línea U
Mensaje Bienvenido
Línea Superior del Visor Línea Inferior del Visor Indicador de Mensaje en el Visor
ETX ETX
LRC LRC
Línea U L Mensaje 20 caracteres máximo
24
COMANDOS PARA GENERAR UNA FACTURA Esquema general para realizar una factura, el cual incluye todas las operaciones posibles para éste documento.
No
Datos del Cliente (RIF, RAZON SOCIAL, INFORMACION ADICIONAL) (*) No
Comentario (*) Registro de Producto (**) Si Si Corrección (*) No Si Subtotal (*) No Si Descuento/Recargo (*) No Si Registrar otro producto (*)
Comentarios: * Comandos de uso opcional ** Comandos obligatorios
No Si Anular Producto (*) Sí
Anulación de Documento
No Anular Factura (*) No Totalización directa o parcial (**)
25
Ejemplo de impresión de una factura: SENIAT RIF J-312171197 ENCABEZADO 1 …
ENCABEZADO 8 RIF/C.I.: V-123456789 RAZON SOCIAL: Chev Chellios LINEA ADICIONAL CLIENTE 1 …
LINEA ADICIONAL CLIENTE 10 FACTURA FACTURA: 00001325 FECHA: 16-08-2016 HORA: 14:42 ----------------------------------------------------------------|ESTO ES UN COMENTARIO| PRODUCTO EXENTO (E) Bs 0,11 CORRECCION PRODUCTO EXENTO (E) -Bs 0,11 PRODUCTO TASA G (G) Bs 0,11 DESC (10,00%) -Bs 0,01 PRODUCTO TASA R (R) Bs 0,11
PRODUCTO TASA A (A) Bs 0,11 ANULACION PRODUCTO TASA A (A) -Bs 0,11 ----------------------------------------------------------------SUBTTL Bs 0,21 ----------------------------------------------------------------BI G (12,00%) Bs 0,10 IVA (12,00%) Bs 0,01 BI GG(8,00%) Bs 0,11 IVA R (8,00%) Bs 0,01 ----------------------------------------------------------------TOTAL Bs 0,23 EFECTIVO Bs 0,10 CHEQUE Bs 0,03 EFECTIVO Bs 0,10 LINEA ADICIONAL CLIENTE 1 …
LINEA ADICIONAL CLIENTE 10 Pie de Ticket 1 …
Pie de Ticket 8
MH
Z1F8000001
26
RIF/C.I. DEL CLIENTE Éste comando permite ingresar el RIF o Cédula de Identidad del cliente para incluirlo en el documento. STX STX
iR* iR*
RIF/C.I. 21.122.012
ETX ETX
Número de RIF o C.I. del cliente (Depende del modelo de impresora fiscal)
LRC LRC
RIF/C.I. Ver Anexos. Tabla de Caracteres
RAZÓN SOCIAL DEL CLIENTE Éste comando permite ingresar la razón social del cliente en el documento. STX iS* STX iS*
Nombre Pedro VII
ETX ETX
Razón social del cliente (Depende del modelo de impresora fiscal)
LRC LRC Nombre Ver Anexos. Tabla de Caracteres
INFORMACIÓN ADICIONAL DEL CLIENTE Éste comando permite ingresar líneas adicionales de información del cliente en una Factura. STX STX
i i
Línea 00
Datos ETX Cliente 1 ETX
Número de línea Indique la Información adicional (Depende del modelo de impresora fiscal)
LRC LRC
Línea 2 caracteres (00 – 09) Datos Ver Anexos. Tabla de Caracteres
IMPORTANTE: Si el mensaje a programar se desea incorporar al encabezado del documento, debe ser enviado antes de agregar cualquier producto o comentario. Si el mensaje a programar se desea incorporar en el pie de página del documento, debe ser enviado después de agregar un producto o comentario. IMPORTANTE: La cantidad de líneas de información adicional depende del modelo de impresora fiscal, ver tabla de caracteres sección Anexos. 27
COMENTARIO Éste comando permite imprimir mensajes comerciales adicionales para la descripción de un artículo. STX STX
@ @
Mensaje ETX ##OFERTA ESPECIAL## ETX
Indicador de Mensaje en la factura (Depende del modelo de impresora fiscal)
LRC LRC
Mensaje Ver Anexos. Tabla de Caracteres
REGISTRO DE PRODUCTO El registro de un producto solamente es posible si la tasa a la cual está ligada se encuentra programada, Para verificar que las tasas han sido programadas imprima un reporte de programación (comando D).
El monto máximo a registrar para Precio X Cantidad, en una transacción y en el día depende del modelo de impresora fiscal (ver la lista de Flag del equipo). Si se exceden el límite de los montos, el comando de registro de productos es rechazado. Si el monto máximo que puede acumular la impresora es excedido, la impresora rechaza todos los comandos de ventas, en éste caso sería necesario realizar un reporte Z para continuar las ventas.
STX STX
CMD !
Precio 0000000100
Cantidad 00001000
Código |000001|
Descripción arroz
Ítem Exento (0x20h) Ítem Tasa 1 (0x21h) Ítem Tasa 2 (0x 22h) Ítem Tasa 3 (0x 23h) Precio del ítem (8 enteros + 2 decimales) Cantidad del ítem por defecto (5 enteros + 3 decimales)
ETX ETX
LRC LRC
CMD carácter espacio ! “
# Precio 10 caracteres Cantidad 8 caracteres Código
Este comando es opcional y permite la impresión de un código de ítem entre el producto “Precio X Cantidad” y la descripción. Para esto, se debe encerrar el código entre los caracteres ‘|’ (0x7C) y debe ser
Variable
introducido antes de la descripción del producto Descripción del Producto (Depende del modelo de impresora fiscal)
Descripción Ver Anexos. Tabla de Caracteres
IMPORTANTE: El valor máximo para describir la cantidad es 99999,999.
28
CORRECCIÓN Éste comando cancela la última entrada de un ítem o de un descuento. STX STX
k k
ETX LRC ETX LRC
SUBTOTAL Estos comandos permiten imprimir o mostrar en pantalla el monto correspondiente al subtotal de las ventas. IMPORTANTE: Éste comando debe ser ejecutado antes de realizar un descuento/recargo al subtotal. STX CMD ETX LRC CMD 3 4
Subtotal Impreso El Subtotal se Muestra en el Visor o Display
DESCUENTOS Y RECARGOS Realiza un descuento o recargo sobre el último Ítem registrado o sobre el subtotal. Para realizar un descuento sobre el subtotal, se debe ejecutar previamente el comando “SUBTOTAL” y el
monto del descuento se aplica de forma proporcional sobre todos los artículos. Se puede hacer descuento de dos maneras, por porcentaje y por cantidad.
DESCUENTO Y RECARGO POR PORCENTAJE STX STX
p p
Signo Porcentaje 1000
Descuento Recargo El Porcentaje consta (2 enteros + 2 decimales)
ETX ETX
LRC LRC Signo + Porcentaje 4 caracteres
29
DESCUENTO Y RECARGO POR MONTO STX STX
q q
Signo -
Monto 000000500
ETX ETX
LRC LRC Signo + Monto
Descuento Recargo El monto consta (7 enteros + 2 decimales)
9 caracteres
ANULACIÓN DE UN ÍTEM La anulación de un ítem es posible si la tasa a la cual está ligada está registrada. STX CMD Precio Cantidad STX ¡ 0000000010 00001000
Código |00001|
Descripción ETX LRC arroz ETX LRC
Ítem Exento (0xA0h) (Ver Nota*) Ítem Tasa 1 (0xA1h) Ítem Tasa 2 (0xA2h) Ítem Tasa 3 (0xA3h) Precio del ítem (8 enteros + 2 decimales). Debe ser igual al precio del ítem registrado a eliminar Cantidad (5 enteros + 3 decimales). Debe ser igual a la cantidad del ítem registrado a eliminar
CMD (0xA0h) ¡ ¢ £ Precio 10 caracteres Cantidad 8 caracteres Código
Este comando es opcional y permite la impresión de un código del ítem a anular. Al igual que en el registro de productos, debe ir
variable
encerrado por el caracter ‘|’ (0x7Ch)
Descripción del Producto
Descripción Ver Anexos. Tabla de Caracteres
Nota*: Debe aclararse que el carácter para la devolución de un ítem con tasa exenta es (0xA0h) que al imprimirse puede salir un “carácter espacio”, pero dicho carácter es absolutamente diferente al “carácter espacio“(0x20h) el cual es utilizado para registrar un producto con tasa exenta. IMPORTANTE: El valor máximo para describir la cantidad es 99999,999. IMPORTANTE: Es estrictamente necesario que el ítem a anular ya se encuentre registrado en el documento, y que se anule la misma cantidad de ítems que se registraron inicialmente. 30
ANULACIÓN DE FACTURA Éste comando permite anular una factura antes de su totalización. STX
7
ETX LRC
IMPORTANTE: cuando el documento haya sido anulado, el número de contador se incrementará en una unidad con respecto al último documento impreso. Cuando se emite una factura anulada, se imprime la leyenda “FACTURA ANULADA”.
CÓDIGO DE BARRAS Éste comando permite imprimir un código de barra como referencia de un producto dentro de la factura y en el pie de la factura. STX STX
CMD Y
Código 123456789012
ETX ETX
LRC LRC
Código de Barra impreso dentro de la factura Código de Barra impreso en el pie de página de la factura Varía dependiendo del tipo de código utilizado (ver lista de Flags)
CMD Y y Código variable
Nota: La siguiente tabla muestra los tipos de códigos de barra soportados por las impresoras fiscales The Factory HKA, verificar el “flag 43”, si el equipo utilizado soporta todos los códigos que se muestran en la siguiente tabla: Valor 00 01 02 03 04 05
Características EAN 13: 12 Caracteres Numéricos fijos ITF: 1 a 32 Caracteres Numéricos (la cantidad de caracteres debe ser un número par) CODE128: 1 a 32 Caracteres Alfanuméricos CODE39: 32 caracteres alfanuméricos PDF417: 120 caracteres alfanuméricos QR: 120 caracteres alfanuméricos
IMPORTANTE: Para que el código numérico asociado al código de barra se muestre debajo de éste, el “Flag 30” debe ser activado en el valor “01”.
Código de barra para el cuerpo del documento:
Este comando permite imprimir un código de barra en el cuerpo del documento, independiente de los flag 43 y 30.
31
STX STX
j j
Tipo 0
Posición 0
Número 0
Código 123456789012
ETX ETX
LRC LRC
Tipo 0 1 2 3 4 5
EAN 13 (12 Caracteres numéricos fijos) ITF (1 a 32 caracteres numéricos) CODE128 (32 caracteres alfanuméricos) CODE 39 (32 caracteres alfanuméricos) PDF417 (120 caracteres alfanuméricos) QR (120 caracteres alfanuméricos)
Posición 0 1 Número 0 1 Código variable
En el cuerpo del documento En el pie del documento No se imprime el texto del código Se imprime el texto del código Depende del tipo de código de barra utilizado
IMPORTANTE: Este comando no lo soportan algunos modelos de impresora fiscales.
TOTALIZACIÓN POR PAGO DIRECTO Éste comando permite cerrar una factura y asignar el monto total a un medio de pago. Al ejecutar éste comando se abre la gaveta de dinero. STX
1
# Medio
ETX LRC
STX
1
01
ETX LRC
Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112, HSP7000, TALLY 1125, SRP-270, SRP-280, MICROLINE 1120, PP1F3, KUBE)
# Medio 2 caracteres (01 - 24)
2 caracteres (01 - 16)
TOTALIZACIÓN POR PAGO PARCIAL Éste comando permite asignar parte del monto total de una factura a un medio de pago. Si el monto ingresado es mayor o igual al monto del total, se cierra la factura y se abre la gaveta de dinero. STX
2
STX
2
# Medio Monto de Pago 12
000000000100
ETX
LRC
ETX
LRC
32
Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112 HSP7000, TALLY 1125, SRP-270, SRP-280, MICROLINE 1120, PP1F3, KUBE) El Monto de Pago consta (10 Enteros + 2 Decimales)
# Medio 2 caracteres (01 - 24)
2 caracteres (01 - 16) Monto de Pago 12 caracteres
COMANDOS PARA GENERAR UNA NOTA DE CRÉDITO (DEVOLUCIÓN) Esquema general para realizar una Nota de Crédito, la cual incluye todas las operaciones posibles para éste documento.
Datos de Cliente y factura afectada (**) (RIF/C.I, RAZON SOCIAL, FECHA FAC., NUMERO FAC., SERIAL IMPRESORA) Si
Comentarios: * Comandos de uso opcional ** Comandos obligatorios
Registro de Producto para la Devolución (**) Si ¿Registrar otro producto? (*)
Si
No Si Anular Devolución (*)
Anulación de Documento
No Totalización directa o parcial (**)
33
Ejemplo de impresión de una Nota de Crédito: SENIAT RIF J-312171197 ENCABEZADO 1 …
ENCABEZADO 3 #FAC: 00000026 FECHA FAC: 15-08-2016 #CONTROL/SERIAL IF: Z6B1234567 RIF/C.I.: V-123456789 RAZON SOCIAL: Chev Chellios LINEA ADICIONAL CLIENTE 1 …
LINEA ADICIONAL CLIENTE 10 NOTA DE CREDITO NOTA DE CREDITO: 00000025 FECHA: 16-08-2016 HORA: 14:42 ----------------------------------------------------------------|ESTO ES UN COMENTARIO| PRODUCTO EXENTO (E) Bs 0,11 CORRECCION PRODUCTO EXENTO (E) -Bs 0,11 PRODUCTO TASA G (G) Bs 0,11 DESC (10,00%) -Bs 0,01 PRODUCTO TASA R (R) Bs 0,11
PRODUCTO TASA A (A) Bs 0,11 ANULACION PRODUCTO TASA A (A) -Bs 0,11 ----------------------------------------------------------------SUBTTL Bs 0,21 ----------------------------------------------------------------BI G (12,00%) Bs 0,10 IVA G (12,00%) Bs 0,01 BI G (8,00%) Bs 0,11 IVA R (8,00%) Bs 0,01 ----------------------------------------------------------------TOTAL Bs 0,23 EFECTIVO Bs 0,10 CHEQUE Bs 0,03 EFECTIVO Bs 0,10 LINEA ADICIONAL CLIENTE 1
… LINEA ADICIONAL CLIENTE 10 Pie de Ticket 1
… Pie de Ticket 8
MH
Z1F8000001
34
RIF/C.I. DEL CLIENTE Éste comando permite ingresar el RIF o Cédula de Identidad del cliente. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de crédito. STX iR* STX iR*
RIF/C.I. 21.122.012
ETX LRC ETX LRC RIF/C.I.
Número de RIF o C.I. del cliente (Depende del modelo de impresora fiscal)
Ver Anexos. Tabla de Caracteres
RAZÓN SOCIAL DEL CLIENTE Éste comando permite ingresar la Razón Social del cliente. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de crédito. STX STX
iS* iS*
Nombre Pedro VII
ETX ETX
Indique la razón social del cliente (Depende del modelo de impresora fiscal)
LRC LRC
Nombre Ver Anexos. Tabla de Caracteres
NÚMERO DE FACTURA AFECTADA Éste comando permite ingresar el número de la factura a la cual se le está haciendo una nota de crédito. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de crédito. STX STX
iF* iF*
Indique el # factura afectada
# Factura afectada 00000000001
ETX ETC
LRC LRC
# Factura afectada 11 caracteres máximo
FECHA DE FACTURA AFECTADA Este comando permite ingresar la fecha de la factura afectada por la nota de crédito. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de crédito. 35
STX STX
iD* iD*
# Fecha factura 22/08/2016
Indique fecha de factura afectada
ETX ETX
LRC LRC
# Fecha factura 10 caracteres Puede escribirse con los formatos: DD/MM/AAAA o DD-MM-AAAA
SERIAL DE LA IMPRESORA QUE EMITIÓ LA FACTURA AFECTADA Este comando permite ingresar el serial de registro del equipo que emitió la factura afectada por la nota de crédito. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de crédito, IMPORTANTE: el comando CMD consta de la letra i minúscula seguida de la letra I mayúscula y el carácter asterisco. STX STX
iI* iI*
# Registro impresora Z1F1234567
Indique el # registro de la máquina
ETX ETX
LRC LRC
# Registro impresora 10 caracteres
INFORMACIÓN ADICIONAL DEL CLIENTE Éste comando permite ingresar líneas adicionales de información del cliente en una nota de crédito. STX STX
i i
Línea 00
Datos ETX Cliente 1 ETX
Numero de línea Indique la Información adicional (Depende del modelo de impresora fiscal)
LRC LRC
Línea 2 caracteres (00 – 09) Datos Ver Anexos. Tabla de Caracteres
IMPORTANTE: Si el mensaje a programar se desea incorporar al encabezado del documento, debe ser enviado antes de agregar cualquier producto o comentario. Si el mensaje a programar se desea incorporar en el pie de página del documento, debe ser enviado después de agregar un producto o comentario. IMPORTANTE: El orden en que aparecerá impresa la información en el documento es la siguiente:
36
N° de factura afectada (#FAC). Fecha de factura afectada (FECHA FAC). Serial de registro de la Impresora que emitió la factura afectada (#CONTROL/SERIAL IF). Número de rif o cédula del cliente (RIF/C.I.). Razón Social del cliente (RAZON SOCIAL). Información adicional del cliente
IMPORTANTE: La cantidad de líneas de información adicional depende del modelo de impresora fiscal.
COMENTARIO Éste comando permite imprimir mensajes comerciales adicionales para la descripción de un artículo. STX STX
A A
Mensaje ##MENSAJE##
Indicador de Mensaje en la nota de crédito (Depende del modelo de impresora fiscal)
ETX ETX
LRC LRC
Mensaje Ver Anexos. Tabla de Caracteres
REGISTRO DE PRODUCTO El registro de un producto solamente es posible si la tasa a la cual está ligada se encuentra registrada, para . Cuando se envía este comando por primera vez, se imprime en el documento la leyenda: “NOTA DE CREDITO”
El monto máximo a registrar para Precio X Cantidad, por transacción y por día depende del modelo de impresora fiscal (ver la lista de Flag del equipo). Si se exceden el límite de los montos, el comando de registro de productos es rechazado. Si el monto máximo que puede acumular la impresora es excedido, la impresora rechaza todos los comandos de ventas, en éste caso sería necesario realizar un reporte Z para continuar las ventas. STX STX
CMD d1
Precio 0000000100
Cantidad 00001000
Ítem Exento Ítem Tasa 1 Ítem Tasa 2 Ítem Tasa 3 Precio del ítem (8 enteros + 2 decimales) Cantidad del ítem (5 enteros + 3 decimales)
Código |000001|
Descripción arroz
ETX ETX
LRC LRC
CMD d0 d1 d2 d3 Precio 10 caracteres Cantidad 8 caracteres 37
Código Este comando es opcional y permite la impresión de un código de variable
ítem entre el producto “Precio X Cantidad” y la descripción. Para esto, se debe encerrar el código entre los caracteres ‘|’ (0x7C) y debe
ser introducido antes de la descripción del producto Descripción Ver Anexos. Tabla de Caracteres
Descripción del Producto (Depende del modelo de impresora fiscal)
IMPORTANTE: El valor máximo para describir la cantidad es 99999,999. IMPORTANTE: Antes de registrar un ítem, deben registrarse las tasas. Para verificar que las tasas han sido programadas imprima un reporte de programación.
CORRECCIÓN Éste comando cancela la última entrada de un ítem o de un descuento. STX
k
ETX LRC
SUBTOTAL Estos comandos permiten imprimir o mostrar en pantalla el monto correspondiente al subtotal de las ventas. IMPORTANTE: Éste comando debe ser ejecutado antes de realizar un descuento/recargo al subtotal. STX CMD ETX LRC
Subtotal Impreso El Subtotal se Muestra en el Visor o Display
CMD 3 4
DESCUENTOS Y RECARGOS Realiza un descuento o recargo sobre el último Ítem registrado o sobre el subtotal. Para realizar un descuento sobre el subtotal, se debe ejecutar previamente el comando “SUBTOTAL” y el
monto del descuento se aplica de forma proporcional sobre todos los artículos. Se puede hacer descuento de dos maneras, por porcentaje y por cantidad.
DESCUENTO Y RECARGO POR PORCENTAJE STX STX
p p
Signo Porcentaje 1000
ETX LRC ETX LRC
38
Signo + Porcentaje 4 caracteres
Descuento Recargo El Porcentaje consta (2 enteros + 2 decimales)
DESCUENTO Y RECARGO POR MONTO STX STX
q q
Signo -
Monto 000000500
ETX ETX
LRC LRC Signo + Monto 9 caracteres
Descuento Recargo El monto consta (7 enteros + 2 decimales)
ANULACIÓN DE UN ÍTEM La anulación de un ítem es posible si la tasa a la cual está ligada está registrada. STX STX
CMD ä1
Precio 0000000100
Cantidad 00001000
Código |000001|
Descripción arroz
ETX ETX
LRC LRC
CMD Ítem Exento Ítem Tasa 1 Ítem Tasa 2 Ítem Tasa 3 Precio del ítem (8 enteros + 2 decimales). Debe ser igual al precio del ítem registrado a eliminar Cantidad (5 enteros + 3 decimales). Debe ser igual a la cantidad del ítem registrado a eliminar
ä0 ä1 ä2 ä3 Precio 10 caracteres Cantidad 8 caracteres Código
Este comando es opcional y permite la impresión de un código del ítem a anular. Al igual que en el registro de productos, debe ir
variable
encerrado por el carácter ‘|’ (0x7Ch)
Descripción del Producto (Depende del modelo de impresora fiscal)
Descripción Ver Anexos. Tabla de Caracteres
IMPORTANTE: El valor máximo para describir la cantidad es 99999,999. 39
IMPORTANTE: Es estrictamente necesario que el ítem a anular ya se encuentre registrado en el documento, y que se anule la misma cantidad de ítems que se registraron inicialmente.
ANULACIÓN DE NOTA DE CRÉDITO Éste comando permite anular una nota de crédito antes de su totalización. STX
7
ETX LRC
IMPORTANTE: cuando el documento haya sido anulado, el número de contador se incrementará en una unidad con respecto al último documento impreso. Cuando se emite una nota de crédito anulada, se imprime la leyenda “NOTA DE CREDITO ANULADA”.
CÓDIGO DE BARRAS Éste comando permite imprimir un código de barra como referencia de un producto dentro de la nota de crédito o en el pie de la nota de crédito. STX STX
CMD Y
Código 123456789000
ETX ETX
LRC LRC CMD
Código de Barra impreso dentro de la nota de crédito como descriptor de un producto Código de Barra impreso al pie de la nota de crédito Varía dependiendo del modelo de impresora (ver lista de Flags)
Y y Código variable
Nota: En la siguiente tabla muestra cada uno de los tipos de códigos de barra soportados por la impresoras de The Factory HKA, verificar en la lista de flag de la impresora “flag 43”, si el mismo soporta
todos los que se muestran en la siguiente tabla: Valor 00 01 02 03 04 05
Características EAN 13: 12 Caracteres Numéricos fijos ITF: 1 a 32 Caracteres Numéricos (la cantidad de caracteres debe ser un número par) CODE128: 1 a 32 Caracteres Alfanuméricos CODE39: 32 caracteres alfanuméricos PDF417: 120 caracteres alfanuméricos QR: 120 caracteres alfanuméricos
IMPORTANTE: Para que el código numérico asociado al código de barra se muestre debajo de éste, el “Flag 30” debe ser activado en el valor “01”.
40
Código de barra para el cuerpo del documento:
Este comando permite imprimir un código de barra en el cuerpo del documento, independiente de los flag 43 y 30. STX STX
j j
Tipo 0
Posición 0
Número 0
Código 123456789121
ETX ETX
LRC LRC
Tipo 0 1
EAN 13 (12 Caracteres numéricos fijos) ITF (32 caracteres numéricos) CODE128 (32 caracteres alfanuméricos) CODE 39 (32 caracteres alfanuméricos) PDF417 (120 caracteres alfanuméricos) QR (120 caracteres alfanuméricos)
2 3 4 5 Posición 0 1 Número 0 1 Código variable
En el cuerpo del documento En el pie de ticket No se imprime el texto del código Se imprime el texto del código Depende del tipo de código de barra utilizado
IMPORTANTE: Este comando no está so portado para algunos modelos de impresora fiscales.
TOTALIZACIÓN POR PAGO DIRECTO Éste comando permite cerrar una nota de crédito y asignar el monto total a un medio de pago. Al ejecutar éste comando se abre la gaveta de dinero. STX STX
1 1
# Medio 01
ETX LRC ETX LRC
Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112, HSP7000, TALLY 1125, SRP-270, SRP-280, MICROLINE 1120, PP1F3, KUBE)
# Medio 2 caracteres (01 - 24)
2 caracteres (01 - 16)
TOTALIZACIÓN POR PAGO PARCIAL Éste comando permite asignar parte del monto total de una nota de crédito a uny medio el monto ingresado es mayor o igual al monto del total, se cierra la nota de crédito se abredelapago. gavetaSide dinero. 41
STX STX
2 2
# Medio 12
Monto de Pago 000000000100
Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112 HSP7000, TALLY 1125, SRP-270, SRP-280, MICROLINE 1120, PP1F3, KUBE) El Monto de Pago consta (10 Enteros + 2 Decimales)
ETX ETX
LRC LRC
# Medio 2 caracteres (01 - 24)
2 caracteres (01 - 16) Monto de Pago 12 caracteres
COMANDOS PARA GENERAR UNA NOTA DE DÉBITO Esquema general para realizar una Nota de Débito, la cual incluye todas las operaciones posibles para éste documento. IMPORTANTE: La nota de débito solo esta soportado para los siguientes modelos de impresoras: DT230, SRP-812, ACLAS PP9, HKA-80, SPP-R200II y PANTUM P3100DL.
Datos de Cliente y factura afectada (**) (RIF/C.I, RAZON SOCIAL, FECHA FAC., NUMERO FAC., SERIAL IMPRESORA) Si Registro de Producto para Nota de Débito (**)
Comentarios: * Comandos de uso opcional ** Comandos obligatorios
Si ¿Registrar otro producto? (*)
Si
No Si Anular Nota de Débito (*)
Anulación de Documento
No Totalización directa o parcial (**)
42
Ejemplo de impresión de una Nota de Débito: SENIAT RIF J-312171197 ENCABEZADO 1 …
ENCABEZADO 8 #FAC: 00000026 FECHA FAC: 15-08-2016 #CONTROL/SERIAL IF: Z6B1234567 RIF/C.I.: V-123456789 RAZON SOCIAL: Chev Chellios LINEA ADICIONAL CLIENTE 1 …
LINEA ADICIONAL CLIENTE 10 NOTA DE DEBITO NOTA DE DEBITO: 00000025 FECHA: 16-08-2016 HORA: 14:42 ----------------------------------------------------------------|ESTO ES UN COMENTARIO| PRODUCTO EXENTO (E) Bs 0,11 CORRECCION PRODUCTO EXENTO (E) -Bs 0,11 PRODUCTO TASA G (G) Bs 0,11 DESC (10,00%) -Bs 0,01 PRODUCTO TASA R (R) Bs 0,11
PRODUCTO TASA A (A) Bs 0,11 ANULACION PRODUCTO TASA A (A) -Bs 0,11 ----------------------------------------------------------------SUBTTL Bs 0,21 ----------------------------------------------------------------BI G (12,00%) Bs 0,10 IVA G (12,00%) Bs 0,01 BI G (8,00%) Bs 0,11 IVA R (8,00%) Bs 0,01 ----------------------------------------------------------------TOTAL Bs 0,23 EFECTIVO Bs 0,10 CHEQUE Bs 0,03 EFECTIVO Bs 0,10 LINEA ADICIONAL CLIENTE 1 …
LINEA ADICIONAL CLIENTE 10 Pie de Ticket 1 …
Pie de Ticket 8
MH
Z1F8000001
43
RIF/C.I. DEL CLIENTE Éste comando permite ingresar el RIF o Cédula de Identidad del cliente. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de débito. STX STX
iR* iR*
RIF/C.I. 21.122.012
ETX ETX
LRC LRC RIF/C.I.
Número de RIF o C.I. del cliente (Depende del modelo de impresora fiscal)
Ver Anexos. Tabla de Caracteres
RAZÓN SOCIAL DEL CLIENTE Éste comando permite ingresar la Razón Social del cliente. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de débito. STX STX
iS* iS*
Nombre Pedro VII
ETX ETX
Indique la razón social del cliente (Depende del modelo de impresora fiscal)
LRC LRC
Nombre Ver Anexos. Tabla de Caracteres
NÚMERO DE FACTURA AFECTADA Éste comando permite ingresar el número de la factura afectada por la nota de débito. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de débito. STX STX
iF* iF*
Indique el # factura afectada
# Factura afectada 00000000001
ETX ETX
LRC LRC
# Factura afectada 11 caracteres máximo
FECHA DE FACTURA RELACIONADA Este comando permite ingresar la fecha de la factura afectada por la nota de débito. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de débito. 44
STX STX
iD* iD*
# Fecha factura 22/08/2016
Indique fecha de factura afectada
ETX ETX
LRC LRC
# Fecha factura 10 caracteres Puede escribirse con los formatos: DD/MM/AAAA o DD-MM-AAAA
SERIAL DE LA IMPRESORA QUE EMITIÓ LA FACTURA AFECTADA Este comando permite ingresar el serial de registro del equipo que emitió la factura afectada por la nota de débito. IMPORTANTE: Es obligatorio enviar ésta información si se desea emitir una nota de débito. IMPORTANTE: el comando CMD consta de la letra i minúscula seguida de la letra I mayúscula y el carácter asterisco. STX STX
iI* iI*
# Registro impresora Z1F1234567
Indique el # registro de la máquina
ETX ETX
LRC LRC
# Registro impresora 10 caracteres
INFORMACIÓN ADICIONAL DEL CLIENTE Éste comando permite ingresar líneas adicionales de información del cliente en una nota de débito. STX i Línea Datos ETX LRC STX i 00 Cliente 1 ETX LRC
Numero de línea Indique la Información adicional (Depende del modelo de impresora fiscal)
Línea 2 caracteres (00 – 09) Datos Ver Anexos. Tabla de Caracteres
IMPORTANTE: Si el mensaje a programar se desea incorporar en el encabezado del documento, debe ser enviado antes de agregar cualquier producto o comentario. Si el mensaje a programar se desea incorporar en el pie de página del documento, debe ser enviado después de agregar un producto o comentario. IMPORTANTE: El orden en que aparecerá impresa la información en el documento es la siguiente:
45
N° de factura afectada (#FAC). Fecha de factura afectada (FECHA FAC). Serial de registro de la Impresora que emitió la factura afectada (#CONTROL/SERIAL IF). Número de rif o cédula del cliente (RIF/C.I.). Razón Social del cliente (RAZON SOCIAL). Información adicional del cliente
IMPORTANTE: La cantidad de líneas de información adicional depende del modelo de impresora fiscal.
COMENTARIO Éste comando permite imprimir mensajes comerciales adicionales para la descripción de un artículo. STX STX
B B
Mensaje ##MENSAJE##
Indicador de Mensaje en la nota de débito (Depende del modelo de impresora fiscal)
ETX ETX
LRC LRC
Mensaje Ver Anexos. Tabla de Caracteres
REGISTRO DE PRODUCTO El registro de un producto solamente es posible si la tasa a la cual está ligada se encuentra registrada. Cuando se envía este comando por primera vez, se imprime en el ticket la leyenda: “NOTA DE DEBITO”
El monto máximo a registrar para Precio X Cantidad, por transacción y por día depende del modelo de impresora fiscal (ver la lista de Flag del equipo). Si se exceden el límite de los montos, el comando de registro de productos es rechazado. Si el monto máximo que puede acumular la impresora es excedido, la impresora rechaza todos los comandos de ventas, en éste caso sería necesario realizar un reporte Z para continuar las ventas. STX STX
CMD `1
Precio 0000000100
Cantidad 00001000
Ítem Exento Ítem Tasa 1 Ítem Tasa 2 Ítem Tasa 3 Precio del ítem (8 enteros + 2 decimales) Cantidad del ítem (5 enteros + 3 decimales)
Código |000001|
Descripción arroz
ETX ETX
LRC LRC
CMD `0 `1 `2 `3 Precio 10 caracteres Cantidad 8 caracteres 46
Código Este comando es opcional y permite la impresión de un código de variable
ítem entre el producto “Precio X Cantidad” y la descripción. Para esto, se debe encerrar el código entre los caracteres ‘|’ (0x7C) y debe
ser introducido antes de la descripción del producto Descripción Ver Anexos. Tabla de Caracteres
Descripción del Producto (Depende del modelo de impresora fiscal)
IMPORTANTE: El valor máximo para describir la cantidad es 99999,999. IMPORTANTE: Antes de registrar un ítem, deben registrarse las tasas. Para verificar que las tasas han sido programadas imprima un reporte de programación.
CORRECCIÓN Éste comando cancela la última entrada de un ítem o de un descuento. STX
k
ETX LRC
SUBTOTAL Estos comandos permiten imprimir o mostrar en pantalla el monto correspondiente al subtotal de las ventas. IMPORTANTE: Éste comando debe ser ejecutado antes de realizar un descuento/recargo al subtotal. STX CMD ETX LRC Subtotal Impreso El Subtotal se Muestra en el Visor o Display
CMD 3 4
DESCUENTOS Y RECARGOS Realiza un descuento o recargo sobre el último Ítem registrado o sobre el subtotal. Para realizar un descuento sobre el subtotal, se debe ejecutar previamente el comando “SUBTOTAL” y el
monto del descuento se aplica de forma proporcional sobre todos los artículos. Se puede hacer descuento de dos maneras, por porcentaje y por cantidad.
DESCUENTO Y RECARGO POR PORCENTAJE STX STX
p p
Signo Porcentaje 1000
ETX LRC ETX LRC 47
Signo + Porcentaje 4 caracteres
Descuento Recargo El Porcentaje consta (2 enteros + 2 decimales)
DESCUENTO Y RECARGO POR MONTO STX STX
q q
Signo -
Monto 000000500
ETX ETX
LRC LRC Signo + Monto 9 caracteres
Descuento Recargo El monto consta (7 enteros + 2 decimales)
ANULACIÓN DE UN ÍTEM La anulación de un ítem es posible si la tasa a la cual está ligada está registrada. STX STX
CMD à1
Precio 0000000100
Cantidad 00001000
Código |000001|
Descripción arroz
Ítem Exento Ítem Tasa 1 Ítem Tasa 2 Ítem Tasa 3 Precio del ítem (8 enteros + 2 decimales). Debe ser igual al precio del ítem registrado a eliminar Cantidad (5 enteros + 3 decimales). . Debe ser igual a la cantidad del ítem registrado a eliminar
ETX ETX
LRC LRC
CMD à0 à1 à2 à3 Precio 10 caracteres Cantidad 8 caracteres Código
Este comando es opcional y permite la impresión de un código del ítem a anular. Al igual que en el registro de productos, debe ir
variable
encerrado por el carácter ‘|’ (0x7Ch)
Descripción Descripción del Producto (Depende del modelo de impresora fiscal)
Ver Anexos. Tabla de Caracteres
IMPORTANTE: El valor máximo para describir la cantidad es 99999,999. 48
IMPORTANTE: Es estrictamente necesario que el ítem a anular ya se encuentre registrado en el documento, y que se anule la misma cantidad de ítems que se registraron inicialmente.
ANULACIÓN DE NOTA DE DÉBITO Éste comando permite anular una nota de débito antes de su totalización. STX
7
ETX LRC
IMPORTANTE: cuando el documento haya sido anulado, el número de contador se incrementará en una unidad con respecto al último documento impreso. Cuando se emite una nota de débito anulada, se imprime la leyenda “NOTA DE DEBITO ANULADA”.
CÓDIGO DE BARRAS Éste comando permite imprimir un código de barra como referencia de un producto dentro de la nota de débito o en el pie de la nota de débito. STX STX
CMD Y
Código 123456789000
ETX ETX
LRC LRC CMD
Código de Barra impreso dentro de la nota de débito como descriptor de un producto Código de Barra impreso al pie de la nota de débito Varía dependiendo del modelo de impresora (ver lista de Flags)
Y y Código variable
Nota: En la siguiente tabla muestra cada uno de los tipos de códigos de barra soportados por la impresoras de The Factory HKA, verificar en la lista de flags de la impresora, “flag 43”, si el mismo soporta todos los que se muestran en la siguiente tabla: Valor 00 01 02 03 04 05
Características EAN 13: 12 Caracteres Numéricos fijos ITF: 1 a 32 Caracteres Numéricos (la cantidad de caracteres debe ser un número par) CODE128: 1 a 32 Caracteres Alfanuméricos CODE39: 32 caracteres alfanuméricos PDF417: 120 caracteres alfanuméricos QR: 120 caracteres alfanuméricos
IMPORTANTE: Para que el código numérico asociado al código de barra se muestre debajo de éste, el “Flag 30” debe ser activado en el valor “01”.
49
Código de barra para el cuerpo del documento:
Este comando permite imprimir un código de barra en el cuerpo del documento, independiente de los flag 43 y 30. STX STX
j j
Tipo 0
Posición 0
Número 0
Código 123456789121
ETX ETX
LRC LRC
Tipo 0 1
EAN 13 (12 Caracteres numéricos fijos) ITF (32 caracteres numéricos) CODE128 (32 caracteres alfanuméricos) CODE 39 (32 caracteres alfanuméricos) PDF417 (120 caracteres alfanuméricos) QR (120 caracteres alfanuméricos)
2 3 4 5 Posición 0 1 Número 0 1 Código variable
En el cuerpo del documento En el pie de ticket No se imprime el texto del código Se imprime el texto del código Depende del tipo de código de barra utilizado
IMPORTANTE: Este comando no está so portado para algunos modelos de impresora fiscales.
TOTALIZACIÓN POR PAGO DIRECTO Éste comando permite cerrar una nota de débito y asignar el monto total a un medio de pago. Al ejecutar éste comando se abre la gaveta de dinero. STX STX
1 1
# Medio 01
ETX LRC ETX LRC
Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112, HSP7000, TALLY 1125, SRP-270, SRP-280, MICROLINE 1120, PP1F3, KUBE)
# Medio 2 caracteres (01 - 24)
2 caracteres (01 - 16)
50
TOTALIZACIÓN POR PAGO PARCIAL Éste comando permite asignar parte del monto total de una nota de débito a un medio de pago. Si el monto ingresado es mayor o igual al monto del total, se cierra la nota de débito y se abre la gaveta de dinero. STX STX
2 2
# Medio 12
Monto de Pago 000000000100
ETX STX
LRC LRC # Medio
Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112 HSP7000, TALLY 1125, SRP-270, SRP-280, MICROLINE 1120, PP1F3, KUBE)
2 caracteres (01 - 24) 2 caracteres (01 - 16) Monto de Pago 12 caracteres
El Monto de Pago (10 Enteros + 2 Decimales)
COMANDOS PARA GENERAR DOCUMENTOS NO FISCALES Esquema general para realizar un Documento No Fiscal, el cual incluye todas las operaciones posibles para éste documento.
Documentos No Fiscales
Texto en Documento
Apertura de la Gaveta de Dinero
Retiro/ Fondo de Caja
Imprimir Programación
Reimpresion Documentos
Estatus de Memoria de Auditoría
Inicio de Documento Si Texto Si ¿Agregar otro Texto?
Si
No Fin de Documento. 51
TEXTO EN DOCUMENTO Este comando permite imprimir información de reportes y notas como documentos no fiscales. En un documento no fiscal se imprime automáticamente cada cuatro líneas la siguiente leyenda: “N O F I S C A L”
STX CMD Tipo STX 80 *
Texto Pruebas 1
ETX ETX
LRC LRC CMD 80 81
Imprime una línea y espera otro comando Imprime una línea y cierra el documento
Tipo (0X20h)@LOGO (0X20h) * ! ¡ $ > Texto variable
Imprime el logo programado a la impresora Texto normal sin efecto Efecto negrita Efecto centrado Efecto negrita + centrado Efecto negrita + centrado + doble ancho Efecto expandido Texto a imprimir (Depende del modelo de impresora fiscal)
Código de barra en el cuerpo de los documentos de texto: STX STX
CMD Y
Código 123456789000
ETX ETX
LRC LRC
IMPORTANTE: El campo código es variable, depende del tipo de código de barra utilizado. Nota: En la siguiente tabla muestra cada uno de los tipos de códigos de barra soportados por la impresoras de The Factory HKA, verificar en la lista de flag de la impresora “flag 43”, si el mismo soporta todos los que se muestran en la siguiente tabla: Valor 00
02 03
Características EAN 13: 12 Caracteres Numéricos fijos ITF: 1 a 32 Caracteres Numéricos (la cantidad de caracteres debe ser un número par) CODE128: 1 a 32 Caracteres Alfanuméricos CODE39: 32 caracteres alfanuméricos
04 05
PDF417: 120 caracteres alfanuméricos QR: 120 caracteres alfanuméricos
01
52
IMPORTANTE: Para que el código numérico asociado al código de barra se muestre debajo de éste, el “Flag 30” debe ser activado en el valor “01”.
IMPORTANTE: Algunos efecto en el texto, la cantidad de caracteres por línea para el texto y el código de barras en los documentos de texto, no están soportados por algunos modelos de impresora fiscal.
APERTURA DE GAVETA Éste comando permite abrir la gaveta de dinero. Se imprime un documento no fiscal con la siguiente leyenda: “A P E R T U R A GAVETA”. STX
0
ETX
LRC
Comando para abrir la gaveta en medio de una transacción fiscal: STX
w
ETX
LRC
IMPORTANTE: Debe haber al menos 1 producto registrado, el comando w solo abre la gaveta de dinero en medio de una transacción, activando el Flag 24 en 01 (ver lista de flags del equipo), mientras que el comando 0 abre la gaveta en cualquier momento con el Flag 24 en 00 (ver lista de flags del equipo).
RETIRO Y FONDO DE CAJA Estos comandos permiten reportar fondos de caja y retiros de efectivo, o de otro medio de pago de la gaveta de dinero. Son necesarios para realizar el arqueo de la caja. STX STX
9 9
PR 0
# Medio Monto ETX 12 000000000100 ETX
Retiro Fondo de Caja Número del Medio de Pago (SRP-812, HKA-80, DT-230, PP9, P3100DL, SPP-R200II) Número del Medio de Pago (SRP-350, HKA-112, HSP7000, TALLY 1125, SRP-270, SRP-280, MICROLINE 1120, PP1F3, KUBE) El Monto de Pago Consta (10 enteros + 2 decimales)
LRC LRC PR 0 1 # Medio 2 caracteres (01 – 24) 2 caracteres (01 – 16) Monto 12 caracteres
53
FIN DE RETIRO Y FONDO DE CAJA Éste comando finaliza un reporte de egresos / ingreso de un medio de pago. Al ejecutar éste comando, se cierra el reporte y se abre la gaveta de dinero. STX
t
ETX LRC
STX
D
ETX LRC
IMPRIMIR PROGRAMACIÓN
Éste comando imprime los valores almacenados para los siguientes parámetros:
Tasa de impuesto. Nombre de cajero activo (luego de programarlo e iniciarlo). Nombre de medios de pago programados. Banderas (FLAGS) del sistema y sus valores programados. Versión de Firmware de la impresora fiscal. Mensajes.
IMPRIMIR ESTADO DE LA MEMORIA DE AUDITORÍA STX
E
ETX LRC
Por medio de éste comando la impresora genera un ticket con la siguiente información correspondiente al estado general de la memoria de Auditoria:
Número de la memoria de auditoria. Capacidad total de la memoria de auditoria. Disponibilidad de memoria en la memoria de auditoria. Numero de documentos almacenados en la memoria de auditoria.
REIMPRESIÓN Y EXTRACCIÓN DE DOC. DE LA MEMORIA DE AUDITORÍA Todos los documentos que se generen con la impresora fiscal, quedarán registrado en la memoria de auditoria, por lo cual puede acceder a ellos mediante la reimpresión o extracción de los documentos existentes en dicha memoria. IMPORTANTE: En los equipos que no tienen memoria de auditoria no se pueden hacer uso de los comandos de extracción y reimpresión, estos equipos son: SRP-270 y Aclas PP1F3.
54
REIMPRESIÓN POR RANGO DE NÚMERO Este comando permite reimprimir documentos ya registrados en la memoria de auditoria por un rango de número. STX STX
R R
Modo F
Inicio 0000001
Fin 0000001
ETX ETX
Facturas Notas de Crédito Notas de Débito Todos los documentos no fiscales Reportes X Reportes Z Reportes de lectura de memoria fiscal RAM CLEAR Copias Facturas, Notas de Crédito y Notas de Débito Todos los documentos excepto copias y errores de bloqueo Documentos no Fiscales excepto RAM CLEAR, copias y Reportes X Todos los documentos Reimpresión por rango de número
Reimpresión por rango de número
LRC LRC Modo F C D T X Z R Y E S A N @ Inicio 7 caracteres Formato: 0000000 Fin 7 caracteres Formato: 0000000
Nota: El siguiente comando permite realizar la reimpresión del último documento registrado en la memoria de auditoria. STX
RU00000000000000
ETX
LRC
REIMPRESIÓN POR RANGO DE FECHA Este comando permite reimprimir documentos ya registrados en la memoria de auditoria por un rango de fecha. STX STX
R R
Modo f
Inicio Fin ETX 0 160822 0 160822 ETX
LRC LRC
55
Facturas Notas de Crédito Notas de Débito Todos los documentos no fiscales Reportes X Reportes Z Reportes de lectura de memoria fiscal RAM CLEAR Copias Facturas, Notas de Crédito y Notas de Débito Todos los documentos excepto copias y errores de bloqueo Documentos no Fiscales excepto RAM CLEAR, copias y Reportes X Todos los documentos Reimpresión por rango de fecha
Reimpresión por rango de fecha
Modo f c d t x z r y e s a n * Inicio 7 caracteres Formato: 0YYMMDD Fin 7 caracteres Formato: 0YYMMDD
REIMPRESIÓN POR NÚMERO DE CÉDULA O RIF Para reimprimir documentos por el número de cédula del cliente, se debe enviar el número de cédula del mismo modo que en el comando de registro del cliente. La forma general del comando es la siguiente: STX STX
RK RK
RIF/C.I. ETX 21.122.012 ETX
Número de RIF o C.I. del cliente (Depende del modelo de impresora fiscal)
LRC LRC RIF/C.I. Ver Anexos. Tabla de Caracteres
56
EXTRACCIÓN POR RANGO DE NÚMERO Este comando permite la subida de un documento ya registrado en la memoria de auditoria por un rango de número. STX STX
U4 U4
Modo F
Inicio 0000001
Fin 0000001
ETX ETX
Facturas Notas de Crédito Notas de Débito Todos los documentos no fiscales Reportes X Reportes Z Reportes de lectura de memoria fiscal RAM CLEAR Copias Facturas, Notas de Crédito y Notas de Débito Todos los documentos excepto copias y errores de bloqueo Documentos no Fiscales excepto RAM CLEAR, copias y Reportes X Todos los documentos Extracción por rango de número
Extracción por rango de número
LRC LRC Modo F C D T X Z R Y E S A N @ Inicio 7 caracteres Formato: 0000000 Fin 7 caracteres Formato: 0000000
EXTRACCIÓN POR RANGO DE FECHA Este comando permite la subida de un documento ya registrado en la memoria de auditoria por un rango de fecha. STX STX
U4 U4
Modo f
Facturas Notas de Crédito Notas de Débito Todos los documentos no fiscales Reportes X
Inicio Fin ETX 0 160822 0 160822 ETX
LRC LRC Modo f c d t x 57
Reportes Z Reportes de lectura de memoria fiscal RAM CLEAR Copias Facturas, Notas de Crédito y Notas de Débito Todos los documentos excepto copias y errores de bloqueo Documentos no Fiscales excepto RAM CLEAR, copias y Reportes X Todos los documentos Extracción por rango de fecha
z r y e s a n * Inicio 7 caracteres Formato: 0YYMMDD Fin 7 caracteres Formato: 0YYMMDD
Extracción por rango de fecha
EXTRACCIÓN POR NÚMERO DE CÉDULA O RIF Para cargar documentos al PC por el número de cédula del cliente, se debe enviar el número de cédula del mismo modo que en el comando de registro del cliente. La forma general del comando es la siguiente: STX STX
U4K U4K
RIF/C.I. ETX 21.122.012 ETX
Número de RIF o C.I. del cliente (Depende del modelo de impresora fiscal)
LRC LRC
Ver Anexos. RIF/C.I. Tabla de Caracteres
COMANDOS PARA LEER LOS STATUS DE INFORMACIÓN Se puede tender acceso a la información que posee la impresora Fiscal, dicha información es repartida en diversos status informativos. En el caso de que se utilice protocolo directo debe enviar la trama de la solicitud que desee y leer la respuesta en el puerto de comunicaciones basándose en las tablas de respuesta aquí descritas. En el caso de que use algunos de los componentes de The Factory HKA (DLL, API, App consola) debe usar la función UploadStatusCmd(String cmd, String file), UploadStatusDin(Status As Long, Error As Long, cmd As String, Cadena As String) o hacer uso de los atributos públicos de la clase Tfhka (aplica para desarrollos en .NET y Java). Esquema general para realizar la solicitud de la lectura de los Status de la Impresora. Status S1
S2
S3
S4
S5 58
IMPORTANTE: El separador (0Ah) aplica cuando se envía éste comando a través del protocolo directo, sin embargo el separador (0Ah) no aparece cuando se emplea los componentes proporcionados por The Factory HKA (DLL, API, App Consola). IMPORTANTE: Las tramas devueltas que se muestran en esta sección corresponden a la impresora Dascom DT-230, para visualizar la trama devuelta por la solicitud de los status informativos correspondiente a la impresora de su interés, puede descargar el Manual Diferencias de integración Reportes y Status.
STATUS S1 Éste comando permite consultar información referente a parámetros de la impresora fiscal como Serial de la misma, RIF, datos de factura, entre otros. Este comando es posible ejecutarlo en cualquier condición. STX
S1
ET X LRC
Desde 1 3 5 6 23 24 32 33 38
Hasta 2 4 5 22 23 31 32 37 38
Long 2 2 1 17 1 8 1 5 1
Clase ASCII ASCII HEX ASCII HEX ASCII HEX ASCII HEX
Descripción
39 47 48 53 54 62 63 68 69 77 78 83 84 88 89 93
46 47 52 53 61 62 67 68 76 77 82 83 87 88 92 93
8 1 5 1 8 1 5 1 8 1 5 1 4 1 4 1
ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX
Número de la última nota de débito Separador 0x0A Cantidad de notas de débito emitidas en el día Separador 0x0A Número de la última nota de crédito Separador 0x0A Cantidad de notas de crédito emitidas en el día Separador 0x0A Número del último documento no fiscal Separador 0x0A Cantidad de documentos no fiscales emitidos en el día Separador 0x0A Contador de reportes de Memoria Fiscal Separador 0x0A Contador de cierres diarios Z Separador 0x0A
94 105 106 116
104 105 115 116
11 1 10 1
ASCII HEX ASCII HEX
RIF Separador 0x0A Número de Registro de la Máquina Separador 0x0A
“S1”
Número de Cajero asignado Separador 0x0A Total de ventas diarias Separador 0x0A Número de la última factura Separador 0x0A Cantidad de facturas emitidas en el día Separador 0x0A
59
117 123 124 130
122 123 129 130
6 1 6 1
ASCII HEX ASCII HEX
Hora actual de la impresora (HHMMSS) Separador 0x0A Fecha actual de la impresora (DDMMAA) Separador 0x0A
STATUS S2 Éste comando permite consultar información referente el estado de la Factura, Nota de Crédito o Nota de Débito en curso. Si es ejecutado y no existe una Factura, Nota de Crédito o Nota de Debito abierta, los valores obtenidos serán cero, es muy útil para evitar errores de redondeo entre el sistema administrativo y la impresora fiscal. STX
S2
ET X LRC
Desde Hasta L Clase Descripción 1 2 2 ASCII “S2” 3 3 1 ASCII Separador espacio 4 16 13* ASCII Subtotal de bases imponibles 17 17 1 HEX Separador 0x0A 18 18 1 ASCII Separador espacio 19 31 13* ASCII Subtotal de Impuesto 32 32 1 HEX Separador 0x0A 33 33 1 ASCII Separador espacio 34 46 13* ASCII Para uso futuro 47 47 1 HEX Separador 0x0A 48 53 6 ASCII Cantidad de Artículos 54 54 1 HEX Separador 0x0A 55 55 1 ASCII Separador espacio 56 68 13* ASCII Monto a Pagar 69 69 1 HEX Separador 0x0A 70 73 4 ASCII Cantidad de pagos realizados 74 74 1 HEX Separador 0x0A 75 75 1 ASCII Tipo de Documento*** 76 76 1 HEX Separador 0x0A *(11 enteros + 2 decimales) ***El campo Tipo de Documento puede tomar los siguientes valores: 0 = No transacción 1 = En Factura 2 = En Nota de Crédito 3 = En Nota de Débito
60
STATUS S2E Éste comando permite consultar información referente a los acumulados de la tasa exenta de la transacción en curso. STX S2E ETX LRC Desde 1 3 4 17 18 19 32 33 34 47 48 54 55 56 69 70 74 75
Hasta 2 3 16 17 18 31 32 33 46 47 53 54 55 68 69 73 74 75
L 2 1 13* 1 1 13* 1 1 13* 1 6 1 1 13* 1 4 1 1
Clase ASCII ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX ASCII HEX ASCII ASCII HEX ASCII HEX ASCII
Descripción “S2E”
Separador espacio Subtotal de Exento Separador 0x0A Separador espacio Subtotal de impuestos Separador 0x0A Separador espacio Para uso futuro Separador 0x0A Cantidad de Artículos Separador 0x0A Separador espacio Monto a Pagar Separador 0x0A Cantidad de pagos realizados Separador 0x0A Tipo de Documento***
76 enteros + 2 decimales) 76 1 HEX Separador 0x0A *(11 ***El campo Tipo de Documento puede tomar los siguientes valores: 0 = No transacción 1 = En Factura 2 = En Nota de Crédito 3 = En Nota de Débito
STATUS S21 Éste comando permite consultar información referente a los acumulados de la tasa 1 de la transacción en curso. STX S21 ETX LRC Desde
Hasta
L
Clase
Descripción
1 3 4 17
2 3 16 17
2 1 13* 1
ASCII ASCII ASCII HEX
“S21”
Separador espacio Subtotal de Base Imponible Tasa 1 Separador 0x0A 61
18 19 32 33 34 47 48 54 55 56
18 31 32 33 46 47 53 54 55 68
1 13* 1 1 13* 1 6 1 1 13*
ASCII ASCII HEX ASCII ASCII HEX ASCII HEX ASCII ASCII
Separador espacio Subtotal de Impuesto Tasa 1 Separador 0x0A Separador espacio Para uso futuro Separador 0x0A Cantidad de Artículos Separador 0x0A Separador espacio Monto a Pagar
69 69 1 HEX Separador 0x0A 70 73 4 ASCII Cantidad de pagos realizados 74 74 1 HEX Separador 0x0A 75 75 1 ASCII Tipo de Documento*** 76 76 1 HEX Separador 0x0A *(11 enteros + 2 decimales) ***El campo Tipo de Documento puede tomar los siguientes valores: 0 = No transacción 1 = En Pago Factura 2 = En Nota de Crédito 3 = En Nota de Débito
STATUS S22 Éste comando permite extraer información referente a los acumulados de la tasa 2 de la transacción en curso. STX S22 ETX LRC Desde 1 3 4 17 18 19 32 33 34 47 48 54 55 56 69
Hasta 2 3 16 17 18 31 32 33 46 47 53 54 55 68 69
L 2 1 13* 1 1 13* 1 1 13* 1 6 1 1 13* 1
Clase ASCII ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX ASCII HEX ASCII ASCII HEX
Descripción “S22”
Separador espacio Subtotal de Base Imponible Tasa 2 Separador 0x0A Separador espacio Subtotal de impuesto Tasa 2 Separador 0x0A Separador espacio Para uso futuro Separador 0x0A Cantidad de Artículos Separador 0x0A Separador espacio Monto a Pagar Separador 0x0A 62
70 73 4 ASCII Cantidad de pagos realizados 74 74 1 HEX Separador 0x0A 75 75 1 ASCII Tipo de Documento*** 76 76 1 HEX Separador 0x0A *(11 enteros + 2 decimales) ***El campo Tipo de Documento puede tomar los siguientes valores: 0 = No transacción 1 = En Factura 2 = En Nota de Crédito 3 = En Nota de Débito
STATUS S23 Éste comando permite consultar información referente a los acumulados de la tasa 3 de la transacción en curso. STX S23 ETX LRC Desde 1 3 4 17 18 19 32
Hasta 2 3 16 17 18 31 32
L 2 1 13* 1 1 13* 1
Clase ASCII ASCII ASCII HEX ASCII ASCII HEX
Descripción “S23”
Separador espacio Subtotal de Base Imponible Tasa 3 Separador 0x0A Separador espacio Subtotal de Impuesto Tasa 3 Separador 0x0A
33 33 1 ASCII Separador espacio 34 46 13* ASCII Para uso futuro 47 47 1 HEX Separador 0x0A 48 53 6 ASCII Cantidad de Artículos 54 54 1 HEX Separador 0x0A 55 55 1 ASCII Separador espacio 56 68 13* ASCII Monto a Pagar 69 69 1 HEX Separador 0x0A 70 73 4 ASCII Cantidad de pagos realizados 74 74 1 HEX Separador 0x0A 75 75 1 ASCII Tipo de Documento*** 76 76 1 HEX Separador 0x0A *(11 enteros + 2 decimales) ***El campo Tipo de Documento puede tomar los siguientes valores: 0 = No transacción 1 = En Factura 2 = En Nota de Crédito 3 = En Nota de Débito
63
STATUS S3 Éste comando permite consultar información referente a la configuración de las tasas de impuesto y flags. STX Desde 1 3 4 8 9 10 14 15 16 20 21
Hasta 2 3 7 8 9 13 14 15 19 20 22
L 2 1 4* 1 1 4* 1 1 4* 1 2
Clase ASCII ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX ASCII
…
S3
ET X LRC
Descripción “S3”
Tipo de Tasa 1 (1= Incluido, 2= Excluido) Valor Tasa 1 Separador 0x0A Tipo de Tasa 2 (1= Incluido, 2= Excluido) Valor Tasa 2 Separador 0x0A Tipo de Tasa 3 (1= Incluido, 2= Excluido) Valor Tasa 3 Separador 0x0A Flag 0 …
119 120 2 ASCII 121 121 1 HEX *(2 enteros + 2 decimales)
Flag 63 Separador 0x0A
STATUS S4 Éste comando permite extraer información referente a los montos acumulados para cada medio de Pago durante las ventas del día. Los medios de pago varían dependiendo del modelo de la impresora. STX Desde 1 3 13 14 24
Hasta 2 12 13 23 24
L 2 10* 1 10* 1
S4 Clase ASCII ASCII HEX ASCII HEX
ET X LRC Descripción "S4" Medio de Pago 1 Separador 0x0A Medio de Pago 2 Separador 0x0A …
169 178 10* ASCII 179 179 1 HEX * (8 Enteros + 2 Decimales)
Medio de Pago 24 Separador 0x0A
64
STATUS S5 Éste comando permite consultar información referente al estado de la memoria de Auditoria. Es posible ejecutar este comando en cualquier condición. STX Desde 1 3 14 15 25 26 30 31
Hasta 2 13 14 24 25 29 30 34
L 2 11 1 10 1 4 1 4
Clase ASCII ASCII HEX ASCII HEX ASCII HEX ASCII
35 36 40 41 47
35 39 40 46 47
1 4 1 6 1
HEX ASCII HEX ASCII HEX
S5
ET X LRC Descripción “S5”
RIF Separador 0x0A Serial Separador 0x0A Número de la memoria de auditoría Separador 0x0A Capacidad en la memoria de auditoría en MB Separador 0x0A Espacio disponible en la memoria en MB Separador 0x0A Número de documentos registrados Separador 0x0A
STATUS S8E Y S8P Este comando permite leer la información de los datos programados en las líneas del encabezado y el pie de página. STX CMD ETX LRC CMD S8E
Encabezado
Desde 1 4 44 45 95 96 136 137 177 178 218 219
Hasta 3 43 44 94 95 135 136 176 177 217 218 258
L 3 40 1 40 1 40 1 40 1 40 1 40
Clase ASCII ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII
Pie de Ticket
CMD S8P
Descripción “S8E”
Primera Línea de Encabezado Separador 0x0A Segunda Línea de Encabezado Separador 0x0A Tercera Línea de Encabezado Separador 0x0A Cuarta Línea de Encabezado Separador 0x0A Quinta Línea de Encabezado Separador 0x0A Sexta Línea de Encabezado 65
259 260 300 301
259 299 300 340
1 40 1 40
HEX ASCII HEX ASCII
Separador 0x0A Séptima Línea de Encabezado Separador 0x0A Octava Línea de Encabezado
Desde 1 4 44 45
Hasta 3 43 44 94
L 3 40 1 40
Clase ASCII ASCII HEX ASCII
Descripción
95 96 136 137 177 178 218 219 259 260 300 301
95 135 136 176 177 217 218 258 259 299 300 340
1 40 1 40 1 40 1 40 1 40 1 40
HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII
Separador 0x0A Tercera Línea de Pie de Página Separador 0x0A Cuarta Línea de Pie de Página Separador 0x0A Quinta Línea de Pie de Página Separador 0x0A Sexta Línea de Pie de Página Separador 0x0A Séptima Línea de Pie de Página Separador 0x0A Octava Línea de Pie de Página
“S8P”
Primera Línea de Pie de Página Separador 0x0A Segunda Línea de Pie de Página
COMANDO SV Extrae información del país y modelo de la impresora fiscal. STX
SV ETX LRC
Ejemplo de respuesta “SVZ1FVE”, donde:
Z1F: Modelo SRP812 VE : Venezuela
IMPORTANTE: Para más información acerca del uso de éste comando, ver manual de API de integración.
66
COMANDOS PARA IMPRIMIR REPORTES
Reportes
Reporte X, X2 / borrar acumulados X2
Reporte Z, Z2 / borrar acumulados Z2
Reportes de memoria fiscal por número
Reportes de memoria fiscal por fecha
IMPRIMIR REPORTE X Este comando permite generar un reporte X. STX
I0X
ETX
LRC
IMPRIMIR REPORTE X2 Este comando permite generar un reporte parcial entre cada cambio de cajero. STX
I1X
ETX LRC
BORRAR ACUMULADO DEL REPORTE X2 Este comando permite borrar acumulados del reporte X2 (se debe enviar siempre después del comando I1X). STX
XIX
ETX
LRC
ETX
LRC
IMPRIMIR REPORTE DE CIERRE DIARIO Z Este comando permite generar un reporte Z. STX
I0Z
IMPRIMIR REPORTE Z2 Este comando permite mantener el acumulado de los reportes Z emitidos hasta una fecha este tipo de documento no es fiscal. Una vez impreso borra el acumulado automáticamente. STX
I1Z
ETX
LRC 67
BORRAR ACUMULADO DEL REPORTE Z2 Este comando permite borrar el acumulado del Z2 en cualquier momento. STX
X1Z
ETX
LRC
IMPRIMIR REPORTE DE MEMORIA FISCAL POR NÚMERO Éste comando permite imprimir un reporte fiscal definido entre dos números. STX STX
I3 I3
Modo 00 A 00
N° Inicio 0001
00 00
N° Fin 0005
ETX ETX
LRC LRC
Modo A S M N° Inicio 4 caracteres N° Fin 4 caracteres
Se incluye toda la información de los reportes Un resumen del total de los reportes Un reporte Mensual del conjunto de reportes Número inicial del reporte Número final del reporte
IMPRIMIR REPORTE DE MEMORIA FISCAL POR FECHA Éste comando permite imprimir un reporte fiscal definido entre dos fechas. STX STX
I2 I2
Modo A
21
Fecha Inicio 06 15
Se incluye toda la información de los reportes Un Resumen del total de los reportes Un reporte Mensual del conjunto de reportes Fecha inicial del reporte
Fecha final del reporte
22
Fecha Fin 06 15
ETX ETX
LRC LRC
Modo A S M Fecha Inicio 6 caracteres Formato: DDMMYY Fecha Fin 6 caracteres Formato: DDMMYY
68
COMANDOS PARA EXTRAER REPORTES
Reportes
Subir Reporte X, X2
Subir Reportes de memoria
Subir Reporte Z, Z2
Subir Reportes X y Z por número y fecha
EXTRAER REPORTE X Extrae la información de las ventas actuales. La trama devuelta varía de acuerdo al modelo de la impresora. STX
U0X
ETX
LRC
Desde 1 5 6 12 13 17
Hasta 4 5 11 12 16 17
L 4 1 6 1 4 1
Clase ASCII HEX ASCII HEX ASCII HEX
Descripción Número del próximo reporte Z Separador 0x0A Fecha del último reporte Z emitido Separador 0x0A Hora del último reporte Z emitido Separador 0x0A
18 26 27 33 34 38 39 47 48 56 57 65 66 79 80 93 94 107 108 121
25 26 32 33 37 38 46 47 55 56 64 65 78 79 92 93 106 107 120 121
8 1 6 1 4 1 8 1 8 1 8 1 13 1 13 1 13 1 13 1
ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX
Número de la última factura emitida Separador 0x0A Fecha de emisión de la última factura Separador 0x0A Hora de emisión de la última factura Separador 0x0A Número de la última nota de crédito Separador 0x0A Número de la última nota de débito Separador 0x0A Número del último documento no fiscal Separador 0x0A Acumulado exento Separador 0x0A Acumulado Base Imponible Tasa 1 Separador 0x0A Acumulado Impuesto Tasa 1 Separador 0x0A Acumulado Base Imponible Tasa 2 Separador 0x0A 69
122 135 136 149 150 163 164 177
134 135 148 149 162 163 176 177
13 1 13 1 13 1 13 1
ASCII HEX ASCII HEX ASCII HEX ASCII HEX
178
190
13
ASCII
191 192 205
191 204 205
1 13 1
HEX ASCII HEX
206
218
13
ASCII
219 220 233
219 232 233
1 13 1
HEX ASCII HEX
234
246
13
ASCII
247 248 261 262 279
247 260 261 278 279
1 13 1 13 1
HEX ASCII HEX ASCII HEX
280
292
13
ASCII
293 294 307
293 306 307
1 13 1
HEX ASCII HEX
308
320
13
ASCII
321 322 335
321 334 335
1 13 1
HEX ASCII HEX
336
348
13
ASCII
349 350 363
349 362 363
1 13 1
HEX ASCII HEX
Acumulado Impuesto Tasa 2 Separador 0x0A Acumulado Base Imponible Tasa 3 Separador 0x0A Acumulado Impuesto Tasa 3 Separador 0x0A Acumulado exento Nota de Débito Separador 0x0A Acumulado Base Imponible Tasa 1 Nota de Débito Separador 0x0A Acumulado Impuesto Tasa 1 Nota de Débito Separador 0x0A Acumulado Base Imponible Tasa 2 Nota de Débito Separador 0x0A Acumulado Impuesto Tasa 2 Nota de Débito Separador 0x0A Acumulado Base Imponible Tasa 3 Nota de Débito Separador 0x0A Acumulado Impuesto Tasa 3 Nota de Débito Separador 0x0A Acumulado exento Nota de Crédito Separador 0x0A Acumulado Base Imponible Tasa 1 Nota de Crédito 0x0A Separador Acumulado Impuesto Tasa 1 Nota de Crédito Separador 0x0A Acumulado Base Imponible Tasa 2 Nota de Crédito Separador 0x0A Acumulado Impuesto Tasa 2 Nota de Crédito Separador 0x0A Acumulado Base Imponible Tasa 3 Nota de Crédito Separador 0x0A Acumulado Impuesto Tasa 3 Nota de Crédito Separador 0x0A
IMPORTANTE: La trama del U0X varía de acuerdo al modelo de la impresora.
70
EXTRAER REPORTE Z Extrae la información de las ventas actuales. La trama devuelta varía de acuerdo al modelo de la impresora. STX
U0Z
ETX
LRC
Desde 1 5
Hasta 4 5
L 4 1
Clase ASCII HEX
Descripción Número del último reporte Z emitido Separador 0x0A
6 12 13 17 18 26 27 33 34 38 39 47 48 56 57 65 66 79 80 93 94 107 108 121 122 135 136 149 150 163 164 177
11 12 16 17 25 26 32 33 37 38 46 47 55 56 64 65 78 79 92 93 106 107 120 121 134 135 148 149 162 163 176 177
6 1 4 1 8 1 6 1 4 1 8 1 8 1 8 1 13 1 13 1 13 1 13 1 13 1 13 1 13 1 13 1
ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX ASCII HEX
178
190
13
ASCII
191 192
191 204
1 13
HEX ASCII
Fecha del último reporte Z emitido Separador 0x0A Hora del último reporte Z emitido Separador 0x0A Número de la última factura emitida Separador 0x0A Fecha de emisión de la última factura Separador 0x0A Hora de emisión de la última factura Separador 0x0A Número de la última nota de crédito Separador 0x0A Número de la última nota de débito Separador 0x0A Número del último documento no fiscal Separador 0x0A Acumulado exento Separador 0x0A Acumulado Base Imponible Tasa 1 Separador 0x0A Acumulado Impuesto Tasa 1 Separador 0x0A Acumulado Base Imponible Tasa 2 Separador 0x0A Acumulado Impuesto Tasa 2 Separador 0x0A Acumulado Base Imponible Tasa 3 Separador 0x0A Acumulado Impuesto Tasa 3 Separador 0x0A Acumulado exento Nota de Débito Separador 0x0A Acumulado Base Imponible Tasa 1 Nota de Débito Separador 0x0A Acumulado Impuesto Tasa 1 Nota de Débito 71
205
205
1
HEX
206
218
13
ASCII
219 220 233
219 232 233
1 13 1
HEX ASCII HEX
234
246
13
ASCII
247 248
247 260
1 13
HEX ASCII
261 262 279
261 278 279
1 13 1
HEX ASCII HEX
280
292
13
ASCII
293 294 307
293 306 307
1 13 1
HEX ASCII HEX
308
320
13
ASCII
321 322 335
321 334 335
1 13 1
HEX ASCII HEX
336
348
13
ASCII
349 350 363
349 362 363
1 13 1
HEX ASCII HEX
Separador 0x0A Acumulado Base Imponible Tasa 2 Nota de Débito Separador 0x0A Acumulado Impuesto Tasa 2 Nota de Débito Separador 0x0A Acumulado Base Imponible Tasa 3 Nota de Débito Separador 0x0A Acumulado Impuesto Tasa 3 Nota de Débito Separador 0x0A Acumulado exento Nota de Crédito Separador 0x0A Acumulado Base Imponible Tasa 1 Nota de Crédito Separador 0x0A Acumulado Impuesto Tasa 1 Nota de Crédito Separador 0x0A Acumulado Base Imponible Tasa 2 Nota de Crédito Separador 0x0A Acumulado Impuesto Tasa 2 Nota de Crédito Separador 0x0A Acumulado Base Imponible Tasa 3 Nota de Crédito Separador 0x0A Acumulado Impuesto Tasa 3 Nota de Crédito Separador 0x0A
IMPORTANTE: La trama del U0Z varía de acuerdo al modelo de la impresora.
EXTRAER REPORTE DE MEMORIA FISCAL POR NÚMERO Éste comando permite subir los reportes de memoria fiscal por rango de número. STX STX
U3 Modo 00 U3 A 00
N° Inicio 0001
00 00
Se incluye toda la información de los reportes Un resumen del total de los reportes Un reporte Mensual del conjunto de reportes Número inicial del reporte Número final del reporte
N° Fin 0005
ETX ETX
LRC LRC
Modo A S M N° Inicio 4 caracteres N° Fin 4 caracteres 72
EXTRAER REPORTE DE MEMORIA FISCAL POR FECHA Éste comando permite subir los reportes de memoria fiscal de la impresora por rango de fecha. STX STX
U2 U2
Modo A
21
Fecha Inicio 06 15
22
Fecha Fin 06 15
ETX ETX
LRC LRC
Modo A S M Fecha Inicio 6 caracteres Formato: DDMMYY Fecha Fin 6 caracteres Formato: DDMMYY
Se incluye toda la información de los reportes Un Resumen del total de los reportes Un reporte Mensual del conjunto de reportes Fecha inicial del reporte
Fecha final del reporte Secuencia de la Lectura Fiscal: PC STX + U + … + ETX + LRC
Impresora
ACK
ACK
ENQ
STX - DATAn - ETB - LCR (Ver Nota*) EOT
NOTA*: el segmento señalado se repetirá (n-1) veces, siendo el valor de n la cantidad de reportes Z a cargar en la máquina. Por ejemplo, si son 10 reportes Z, ese segmento se repetirá 9 veces para luego seguir con el esquema explicado. IMPORTANTE: Cuando se utilizan las API suministradas por The Factory HKA, éstas se encargan de enviar de forma automática el ACK, mientras que a través de protocolo directo se debe enviar el ACK a la impresora para poder recibir el próximo bloque de información.
EXTRAER INFORMACIÓN DE REPORTES DETALLADOS POR DOCUMENTO. Este comando permite subir la información detalla de los reportes acumulados en la jornada fiscal. STX STX
U0X U0X
Tipo 4
ETX ETX
LRC LRC 73
Extrae los acumulados de las ventas Extrae los acumulados de las notas de crédito Extrae los acumulados de las notas de débito Devuelve la misma estructura devuelta por el comando S1
Tipo 4 5 6 7
Formato de respuesta desde la impresora fiscal: Desde 1 3 19 20 21 37 38 39 55 56 57 73 74 75 91 92 93 109 110 111 127
Hasta 2 18 19 20 36 37 38 54 55 56 72 73 74 90 91 92 108 109 110 126 127
Long 1 16 1 1 16 1 1 16 1 1 16 1 1 16 1 1 16 1 1 16 1
Clase ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX ASCII ASCII HEX
Descripción Separador Espacio Acumulados de Exento Separador 0x0A Separador Espacio Acumulados de Base Imponible Tasa 1 Separador 0x0A Separador Espacio Acumulados de Base Imponible Tasa 2 Separador 0x0A Separador Espacio Acumulados de Base Imponible Tasa 3 Separador 0x0A Separador Espacio Acumulados de Impuesto Tasa 1 Separador 0x0A Separador Espacio Acumulados de Impuesto Tasa 2 Separador 0x0A Separador Espacio Acumulados de Impuesto Tasa 3 Separador 0x0A
74
COMANDOS PARA CHEQUERA (SOLO STAR7000) Los siguientes comandos son exclusivos para las impresoras fiscales que tienen la funcionalidad adicional de chequera, como la STAR HSP7000.
CHEQUE MODO DE SLIP Activa la estación de trabajo de la chequera y el endoso. Es el primer comando requerido para activar las funciones siguientes. STX
:
ST
ETX
LRC ST 1 0
Activa el slip Desactiva el slip
FORMATO DEL CHEQUE (PARTE FRONTAL) Proporciona a la impresora los datos de la parte frontal del cheque que se desea sea impreso. STX
<
F1
F2
F3
F4
F5
Cantidad
Datos Cliente
Datos Fecha
ETX
LRC
Longitud
Descripción
F1 F2
1 carácter fijo 1 carácter fijo
Número de líneas entre el top y la cantidad (0-9) Número de líneas entre la cantidad y No Endosable (0-9)
F3
1 carácter fijo
Número de líneas entre No Endosable y el nombre (0-9)
F4
1 carácter fijo
Número de líneas entre el nombre y la cantidad (0-9)
F5
1 carácter fijo
Número de líneas entre la cantidad y la fecha (0-9)
Cantidad
10 caracteres fijos
Datos Cliente
50 caracteres máximo
Monto a pagar (8 enteros + 2 decimales) Información del Cliente
Datos Fecha
50 caracteres máximo
Información de la Fecha
75
FORMATO DEL CHEQUE (ENDOSO) Proporciona a la impresora los datos de la parte posterior del cheque que se desea sea impreso. STX
F1
Línea
=
Longitud 1 carácter fijo
F1
Línea
ETX
LRC
Descripción Número de línea a ser enviada (0-9)
30 caracteres máximo
Si el valor de F1 es: 1: se imprime el Número de Cuenta. 2: se imprime el Nombre de la Tienda. 3: continuación del Nombre de la Tienda. 4: se imprime el Nombre del Banco. 5-9: se imprime información adicional, y son opcionales. Entre la línea 4 y la 5 se establece una línea de separación de forma automática. Los caracteres de la descripción por línea deben ser completados con espacios en blanco hasta tener los 30 caracteres.
IMPRIMIR ENDOSO Este comando debe ser enviado una sola vez luego de haber enviado todos los comandos de la sección anterior. STX
[
F1
Longitud 1 carácter fijo
Línea
30 caracteres máximo
F1
Línea
ETX
LRC
Descripción Número de líneas entre el top y el número de cuenta (0-9) Información adicional
76
MODO DE VALIDACIÓN STX
;
ST
ETX
LRC ST 1 0
Activar Validación Desactivar Validación
IMPRESIÓN DE VALIDACIÓN STX
>
Texto
ETX
LRC Texto 50 caracteres máximo
Texto a Imprimir
LECTURA DEL MICR Este comando realiza la petición de lectura de los caracteres magnéticos, contenidos en la parte inferior del cheque, y almacena la misma en el búfer de la impresora para su posterior solicitud desde la PC. STX
?
ETX
LRC
Caracteres Magnéticos
77
STATUS S6 Consulta la información de la presencia o no de papel en las 3 estaciones de impresión (Facturación, Slip/Chequera, Validación) y la coloca en un archivo para su posterior lectura. STX
S6
ET X LRC
Desde 1
Hasta 2
Long 2
Clase ASCII
Descripción
3 4 5
3 4 5
1 1 1
ASCII ASCII ASCII
Bit de la estación de impresión de Facturación Bit de la estación de impresión de Slip/Chequera Bit de la estación de impresión de Validación
“S6”
STATUS S7 Extrae la información de la lectura del MICR. STX Desde 1 3
Hasta 2 41
Long 2 39
Clase ASCII ASCII
S7
ETX
LRC
Descripción “S7”
Cadena de caracteres MICR
78
ANEXOS. TABLA DE CARACTERES IMPORTANTE:X (Y líneas) significa: X: Representa la cantidad de caracteres por línea que muestra la impresora para el comando o campo especifico. Y: Representa el número de líneas que soporta la impresora para el comando o campo específico. MODELO IMPRESORA
SRP-812 HKA-80 DT-230 PP9 P3100DL (VERTICAL 80) P3100DL (VERTICAL 136) P3100DL (HORIZONTAL 187) SRP-350 HKA-112 HSP7000 TALLY 1125 (1/2 CARTA - 80) TALLY 1125 (1/2 CARTA - 136) TALLY 1125 (CARTA - 80) TALLY 1125 (CARTA - 136) SRP-270 SRP-280 OKI 1120 (1/2 CARTA) OKI 1120 (CARTA) PP1F3 KUBE
ENCABEZADOS
PIE DE PÁGINA
RIF/C.I
RAZÓN SOCIAL
INFORMACIÓN ADICIONAL
COMENTARIO
DESCRIPCIÓN PRODUCTO
40 (8 líneas) 40 (8 líneas) 40 (8 líneas) 40 (8 líneas)
40 (8 líneas) 40 (8 líneas) 40 (8 líneas) 40 (8 líneas)
40 40 40 38
40 40 40 34
40 (10 líneas) 40 (10 líneas) 40 (10 líneas) 40 (10 líneas)
40 40 40 40
127 127 127 120
38 (6 líneas) 40 (6 líneas) 40 (6 líneas) 40 (8 líneas) 40 (8 líneas) 40 (8 líneas) 38 (3 líneas) 40 (2 líneas) 38 (6 líneas) 40 (6 líneas) 40 (8 líneas) 40 (8 líneas) 39 (4 líneas) 39 (8 líneas) 32 (8 líneas) 40 (8 líneas)
38 (variable) 40 (variable) 40 (variable) 40 (8 líneas) 40 (8 líneas) 40 (8 líneas) 38 (variable) 40 (variable) 38 (variable) 40 (variable) 40 (8 líneas) 40 (8 líneas) No soportado No soportado 32 (8 líneas) 40 (8 líneas)
24 40 40 47 40 47 29 40 29 40 35 33 30 30 23 47
20 40 40 43 40 43 38 40 38 40 31 40 26 26 19 43
33 ENC, 38 PIE 40 ENC, 40 PIE 40 ENC, 40 PIE 56 (10 líneas) 40 (10 líneas) 50 (10 líneas) 38 ENC, 38 PIE 40 ENC, 40 PIE 38 ENC, 38 PIE 40 ENC, 40 PIE 40 (10 líneas) 40 (10 líneas) 39 (3 líneas) 39 (7 líneas) 32 (10 líneas) 56 (10 líneas)
27 40 40 40 40 40 39 60 39 60 40 40 40 40 31 40
127 127 127 37 116 120 118 118 118 118 26 120 105 105 33 120
79
The Factory HKA La California Norte, Callejón Gutiérrez Edif. Riva, PB Ofic. 2-1, Caracas - Venezuela Teléfono (212) 237.4112• 2398176 Departamento de Soporte e Integración [email protected] 80