Protocolo de Comunicación QPrint MF

download Protocolo de Comunicación QPrint MF

of 19

Transcript of Protocolo de Comunicación QPrint MF

Protocolo de Comunicacin

Impresor Fiscal QUORiON Modelo QPrint MF

1CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

Indice:INTRODUCCIN ............................................................................................................. 4 1. FUNCIONES DE LA IMPRESORA FISCAL ............................................................... 41.1. STATUS QPRINT (CMD_STAT): ................................................................................................................................. 5 1.2. DOCUMENTOS NO FISCALES....................................................................................................................................... 5 1.2.1. Abrir un documento no fiscal (CMD_NF_OPEN): .......................................................................................... 5 1.2.2. Imprimir Texto No fiscal en un Documento No Fiscal (CMD_PRINT_TEXT): ................................................. 5 1.2.3. Cerrar un Documento No Fiscal (CMD_NF_CLOSE): ..................................................................................... 5 1.3. RECIBOS FISCALES .................................................................................................................................................... 5 1.3.1. Abrir Recibo fiscal (CMD_FS_OPEN): ............................................................................................................ 5 1.3.2. Imprimir un Item de una lnea (CMD_RCPT_ITEM):...................................................................................... 6 1.3.3 Cerrar recibo fiscal (CMD_RCPT_CLOSE): ...................................................................................................... 6 1.3.4 Subtotal (CMD_RCPT_SUM): ......................................................................................................................... 6 1.3.5. Cancelando (CMD_CANCEL) ......................................................................................................................... 6 1.3.6. Descuentos (CMD_DISCOUNT): .................................................................................................................... 6 1.4. REPORTE DE AUDITORA ............................................................................................................................................ 6 1.4.1. Reporte Fiscal Diario (CMD_Z_REPORT): ...................................................................................................... 6 1.4.2. Reporte de Memoria Fiscal por fecha (CMD_FM_DATE): ............................................................................. 6 1.4.3. Reporte de Memoria Fiscal por Z (CMD_FM_Z): .......................................................................................... 6 1.4.4. Impresin de Jornada Electrnica Interna (CMD_PRN_EJ): .......................................................................... 6 1.4.5. Impresin de Jornada Electrnica por fecha (CMD_PRN_EJ_DATE): ............................................................ 6 1.4.6. Impresin de Jornada Electrnica por Nmero Z (CMD_PRN_EJ_Z): ............................................................ 6 1.5. PROGRAMANDO QPRINT ........................................................................................................................................... 7 1.5.1. Activacin de la Memoria Fiscal (CMD_FM_ACTIVATION): ........................... Error! Marcador no definido. 1.5.2. Cambio de Emcabezado (VAT / Owner) (CMD_FM_CHANGE): ..................... Error! Marcador no definido. 1.5.3. Enviar Datos durante el proceso de recuperacin (CMD_FM_RECOVERY): ... Error! Marcador no definido.

2. DESCRIPCIN DEL PROTOCOLO QPRINT ............................................................. 72.1. PROTOCOLO DE BAJO NIVEL ....................................................................................................................................... 7 2.2. PROTOCOLO DE ALTO NIVEL ....................................................................................................................................... 8 2.3. COMANDOS DISPONIBLES .......................................................................................................................................... 8 2.3.0. Status QPrint (CMD_STAT): .......................................................................................................................... 8 2.3.1. Comandos No Fiscales .................................................................................................................................. 82.3.1.1. Abrir un Documento No Fiscal (CMD_NF_OPEN):.................................................................................................... 9 2.3.1.2. Cerrar un Documento No Fiscal (CMD_NF_CLOSE):................................................................................................. 9 2.3.1.3. Imprimir un Texto No Fiscal en un Documento No Fiscal (CMD_PRINT_TEXT):....................................................... 9

2.3.2. Comandos Fiscales ........................................................................................................................................ 92.3.2.1. Abrir un Recibo Fiscal(CMD_FS_OPEN): ................................................................................................................. 11 2.3.2.2. Cerrar Recibo Fiscal (CMD_CLOSE): ....................................................................................................................... 11 2.3.2.3. Imprimiendo Item Fiscal (CMD_RCPT_ITEM): ........................................................................................................ 12 2.3.2.4. Subtotal (CMD_RCPT_SUM): .................................................................................................................................. 12 2.3.2.5. Cancelando (CMD_CANCEL): ................................................................................................................................. 12 2.3.2.6. Descuentos (CMD_DISCOUNT): ............................................................................................................................ 12 2.3.2.7. Imprimiendo Item Fiscal (CMD_RCPT_ITEM_F) Especial version fuel (Albania) ..... Error! Marcador no definido.

2.3.3. Reportes de Auditora ................................................................................................................................. 142.3.3.1. Reporte Diario(CMD_Daily_Rp): ............................................................................................................................ 14 2.3.3.2. Reporte de Memoria Fiscal por Fecha (CMD_FM_DATE): ..................................................................................... 14

2CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

2.3.3.3. Reporte de Memoria Fiscal por Z (CMD_FM_Z): .................................................................................................... 14 2.3.3.4. Imprime la Jornada Interna E (CMD_PRN_EJ): .......................................................... Error! Marcador no definido. 2.3.3.5. Imprime Jornada E (Tarjeta SD) por fecha (CMD_PRN_EJ_DATE): ......................................................................... 14 2.3.3.6. Imprime Jornada E (Tarjeta SD) por Numero Z (CMD_PRN_EJ_Z): ........................................................................ 15

2.3.4. Programando QPrint ..................................................................................... Error! Marcador no definido.2.3.4.1. Status de la Rutina de activacin (CMD_STAT_ACTIVATION): .................................. Error! Marcador no definido. 2.3.4.2. Activacin de la Memoria Fiscal (CMD_FM_ACTIVATION): ...................................... Error! Marcador no definido. 2.3.4.3. Cambiar encabezado (VAT / Propietario) (CMD_FM_CHANGE): .............................. Error! Marcador no definido. 2.3.4.4. Enviar Data durante el proceso de recuperacin (CMD_FM_RECOVERY): ............... Error! Marcador no definido.

3. RESPUESTAS DE LA IMPRESORA FISCAL (SIN COMANDOS F4) ..................... 15 4. MENSAJE DE ERROR DE LA IMPRESORA FISCAL ............................................. 164.1 ERRORES GENERALES DE QMP................................................................................................................................... 16 4.2 ERRORES ESPECIALES DEL MODULO FISCAL .................................................................................................................... 18

3CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

IntroduccinLa impresora fiscal es un dispositivo que permite registrar y controlar la informacin que se imprime en un recibo fiscal. Esta informacin puede ser revisada en cualquier momento por las autoridades fiscales, y el usuario. Se trata de del dispositivo QPRINT, conectado a un controlador fiscal.

MEMORIA (TRABAJO) Equipo de Puerto - RS232 - LAN - USB

CONTROL DE PROGRAMA

MEMORIA (FISCAL)

IMPRESORA

1. Funciones de la Impresora FiscalLa impresora fiscal presenta las siguientes funciones: Restringir la informacin que se puede imprimir en la recepcin y validacin de los datos recibidos de acuerdo con la transaccin fiscal que se est procesando. Asegurar que la informacin precisa se imprime para cada transaccin fiscal. Asegurar que la informacin coincidente se imprime en el recibo y en la cinta de auditora para cada transaccin fiscal. Acumula y registra el monto total de artculos vendidos y el valor de impuesto sobre el valor a pagar por cada factura. Acumula y registra los totales de los recibos emitidos durante el da. Numera e identifica las facturas y los cupones No fiscales Suministra los reportes fiscales para extraer la informacin registrada en la memoria fiscal.

4CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

1.1. Status QPrint (CMD_STAT):El QPrint responde con el status (ver 3. Respuestas para la Impresora Fiscal)

1.2. Documentos No FiscalesLos documentos no fiscales se usan para emitir documentos que no son facturas de venta, recibos de pago con tarjetas de crdito y los informes de los cambios de caja (Cierres X). Los comandos asociados son los siguientes:

1.2.1. Abrir un documento no fiscal (CMD_NF_OPEN):Es el primer comando que se enva, para que la impresora fiscal acepte, el texto de impresiones de carcter no fiscal. Este comando ser rechazado si ya existe un recibo fiscal o un documento no fiscal abierto. El documento se identifica como "Documento No Fiscal".

1.2.2. Imprimir Texto No fiscal en un Documento No Fiscal (CMD_PRINT_TEXT):La Impresora Fiscal acepta todas las lneas de texto fiscal necesarias para producir el documento. Este comando slo se aceptar si se trata de un documento de carcter no fiscal abierto y si hay papel para imprimir. Slo se aceptarn textos Fiscal para la impresin.

1.2.3. Cerrar un Documento No Fiscal (CMD_NF_CLOSE):Este es el ltimo comando que se enva para hacer un documento No fiscal. Este comando ser rechazado si un documento no fiscal no est abierto. Al procesar el comando, se termina de imprimir el documento y el corte de papel se realiza.

1.2.4. Avance de Papel (CMD_PAPER_FEED):Este comando realiza una avance de una lnea en el papel en un documento. (Solo cuando el mismo este permitido).

1.2.5. Command of Paper Cut (CMD_PAPER_CUT):Este comando realiza un avance de una lnea y realiza el corte de papel. (Solo cuando el mismo este permitido).

1.2.6. Command of Send Message to Customer/Operator Display (CMD_DISP_OUT):Este comando imprime lneas de texto en el display seleccionado.del operador o Cliente.

1.3. Recibos Fiscales QPrint usa los siguientes comandos para emitir Facturas:1.3.1. Abrir Recibo fiscal (CMD_FS_OPEN):Este comando se enva para establecer la personalizacin de la factura, cuando es necesario. La Factura se comienza a imprimir al enviar el primer item.

5CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

1.3.2. Imprimir un item de una lnea (CMD_RCPT_ITEM):Este comando tiene campos para la descripcin, cantidad, impuestos establecidos y precio unitario de los artculos de la factura. Con la primer item se imprime el encabezado fiscal

1.3.3 Cerrar recibo fiscal (CMD_RCPT_CLOSE):Este comando se utiliza para cerrar la factura. Tambien nos permite registrar las formas de pago a ser usadas.

1.3.4 Subtotal (CMD_RCPT_SUM):Este comando hace que las ventas subtotal sean opcionalmente impresas, y puede ser utilizado en cualquier momento mientras el recibo fiscal est abierto para conocer el estado de la transaccin fiscal. Los comandos de item de una lnea sern admitidos despus que este comando haya sido aceptado.

1.3.5. Cancelar (CMD_CANCEL)Cancelar la factura que se est emitiendo.

1.3.6. Descuentos (CMD_DISCOUNT):Realizar descuentos globales sobre la cantidad total de la factura antes de impuestos. Con el comando subtotal, la aplicacin en el host ser capaz de calcular cul ser el descuento antes de impuestos, necesarios para producir el descuento deseado en el total del recibo. Si un documento fiscal ha sido cancelado, este paso no debe ser ejecutado.

1.4. Reporte de AuditoraEstos reportes de auditoria son los siguientes:

1.4.1. Reporte Fiscal Diario (CMD_Z_REPORT):Es el Reporte de Cierre Diario de la Qprint, el cual imprime los datos del da. Los datos son escritos en el mdulo fiscal. Todos los datos son borrados en la memoria.

1.4.2. Reporte de Memoria Fiscal por fecha (CMD_FM_DATE):Imprime los datos del reporte fiscal de fecha a fecha

1.4.3. Reporte de Memoria Fiscal por Z (CMD_FM_Z):Imprime los datos del reporte fiscal de un Nmero Z a otro Nmero Z.

1.4.4. Impresin de Jornada Electrnica Interna (CMD_PRN_EJ):Imprime los datos del la memoria de Auditoria Electrnica.

1.4.5. Impresin de Jornada Electrnica por fecha (CMD_PRN_EJ_DATE):Imprime los datos del la memoria de Auditoria Electrnica.

6CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

1.4.6. Impresin de Jornada Electrnica por Nmero Z (CMD_PRN_EJ_Z):Imprime los datos del la memoria de Auditoria Electrnica.

2. Descripcin del Protocolo QPrint 2.1. Protocolo de Bajo NivelInterface de Protocolo Nivel 2 Graba el transporte El protocolo conocido como nivel 2, es de grabacin graba los datos y responde a los registros. Cada dato grabado es respondido por el recibidor con una respuesta grabada.

Caracteres de Control usados:STX = 0x02 ETX = 0x03 ACK = 0x06 DLE = 0x10 NAK = 0x15

Diagrama General de la Grabacin de Datos:DLE STX Comando Datos DLE ETX CRC Alto CRC Bajo

Notas: - DLE STX es el comienzo del registro - DLE ETX es el final del registro - The CRC es un clculo CRC-16 de acuerdo al 8005 Poly (x16+x15+x2+1). Apndice A. - Cuando el campo de datos contiene DLE es enviado como DLE DLE. - Los datos es un comando descrito bajo Protocolo de Alto Nivel. Una respuesta positive de grabacin

DLE

STX

ACK Error

Estado de la Impresora

DLE

ETX

CRC Alto

CRC Bajo

Un registro de respuesta positiva siempre se enva si el CRC del registro de datos recibido es correcto. Cualquier error ms all de esto se indica por los dos bytes de estado. Si la unidad de control procesa el registro de datos correctamente, el estado es 0x00. La lista de los valores de estado figura en el apndice C. Si se producen varios errores slo el primer error que se reporta. Una respuesta Negativa de Grabacin

DLE

STX

NAK

DLE

ETX

CRC Alto

CRC Bajo

7CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

2.2. Protocolo de Alto Nivel Descripcin GeneralLa seccin de datos se inicia siempre con la letra 'F' (0x46 hexadecimal, decimal 67). Campo0 sigue inmediatamente sin separador. Este indica el comando. Los campos adicionales pueden seguir y estn separados por punto y coma. Los campos obligatorios contienen al menos un carcter, campos opcionales pueden estar vacos. No es necesario transmitir detrs de los campos vacos. (Por ejemplo vase el apndice B)

Tipos de DataNumrica: caracteres ASCII 0 9 (hex 0x30 0x39, decimal 48 57) Alfa: cualquier carcter ms largo o igual a ESPACIO (hex 0x20, decimal 32) Monto: caracteres ASCII 0 9 (hex 0x30 0x39, decimal 48 57), mximo 1 punto decimal (hex 0x2E, decimal 46), opcional 1 menos (hex 0x2d, decimal 45). Los montos tienen siempre una aproximacin de dos puestos decimales. Montos negativos son precedidos por un Menos, Opcionalmente los montos con valor cero pueden ser presentados como un campo vaco. Se suprimen los ceros que siguen antes y despus del punto decimal. Pero se puede suprimir cualquier cero y el punto decimal. (Ejemplos ver apndice B) Porcentaje: Caracteres ASCII 0 9 (hex 0x30 0x39, decimal 48 57), mximo 1 punto decimal (hex 0x2E, decimal 46). Porcentajes tienen siempre una aproximacin de dos puestos decimales. Opcionalmente los montos con valor cero pueden ser presentados como un campo vaco. Se pueden suprimir los ceros si el porcentaje es mayor que 0. 99%. Si el monto es menor al 1%, est permitido suprimir los ceros que siguen antes y despus del punto decimal. Pero se puede suprimir cualquier cero y el punto decimal. (Ejemplos ver apndice B)

2.3. Comandos Disponibles2.3.0. Status QPrint (CMD_STAT):Campo 1 2 F0 3 Ejemplo Descripcin byte 2 Hasta 4 Tipo Data Alfa numerico Requerido Opcional

Responde con Status QPrint 3 Estado Completo de la Qprint

2.3.1. Comandos No FiscalesNota: - El documento no fiscal debe empezar siempre con el comando "CMD_NF_OPEN" y terminar con el comando "CMD_NF_CLOSE". Entre estos comandos pueden haber cualquier nmero de lneas de texto (comando "CMD_PRINT_TEXT"). No se permite un comando fiscal, cuando se abre un documento no fiscal.

8CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

2.3.1.1. Abrir un Documento No Fiscal (CMD_NF_OPEN):Campo 1 2 F1 1 Bsp. Descripcin byte 2 Hasta 4 Data tipo Alfa numerico Nota Requerido Requerido

Documento No Fiscal Abre el Documento No FiscalTX -> F1;1 RX F1;2 RX F1;1 RX F1;3;"===========" RX F1;3;"12345678901" RX F1;3;"===========" RX F1;2 RX F1;4 RX F1;5 RX F1;6;1;1;"Message" RX F1;7;8711400405471 RX F2;1 // Preparacin del recibo fiscal de venta (por defecto) RX F2;1;0 RX F2;1;1 // Preparacin del recibo de reembolso RX F2;2 // Cierra el recibo e imprime 11CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

RX F2;2;;2;CHECK RX F2;2;10000;1;CASH RX F2;3;Manzanas;200;2;123 RX tipo de correccin es recibo anulado.

2.3.2.6. Descuentos (CMD_DISCOUNT):Campo 1 2 3 4 5 6 F2 6 10,00 1 Name 10,00 Ejemplo Descuento Monto (opcional) Tipo de descuento Nombre de descuento Monto (fijo) Descripcin Documento Fiscal byte 2 Hasta 4 Hasta 5 Hasta 4 Hasta 25 Hasta 5 Data tipo Alpha Numerico Numerico Numerico Alfa Numerico Requerido Requerido Opcional*) Opcional Opcional *) Opcional *) 12CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve

7 8 9 10 11

0 356 0 0

Exento Opcin Especial Limite

Hasta 4 Hasta 16 Hasta 8 Hasta 8 Hasta 16

Numerico Numerico Numerico Numerico Numerico

Opcional *) Opcional *) Opcional *) Opcional *) Opcional *)

0 Sin Bandera Ejemplo: TX -> F2;6;;1;Descuento%-;1000;;356 RX F2;6;;2;Cargo %+;2000;;2567 RX F2;6;10,00;1 RX F2;6;20;2 RX F2;12;0;3;"Line1";"Line2";"Line3" RX F2;13; RX F3;1 RX F3;2;090401;090430 RX F3;2;1;10 RX F3;5; 090401; 090430 RX F3;5;1;12 RX algunos ajustes como en la estructura delreporte no ok - con FM conectada la EJ ha sido cambiada por otra - EJ est llena - EJ no est online (test DSR linea) - EJ casi llena (3 rollos de papel antes d su uso) - No permitido (modo no fiscal)

F48_BATT_LOW

- Bateria muy baja

Nota, estos errores de QProg. son fijos y no pueden ser cambiados

19CORPORACION ECRS, C. A., Av. Los Samanes, Calle Madariaga Edif. EURO, Nivel Mezzanina, Local 19 y 20, El Paraso. Caracas Venezuela. Tlfs.: +58 212 481.9721 / 482.8806 / 8803. E-mail: [email protected] http://www.ecrs.com.ve