Manual Técnico CajasActualizado Exe

MODULO DE CAJAS – MANUAL TÉCNICO

MODULO EJECUTABLE PARA LA INTERFASE DE CAJAS REGISTRADORAS CON EL

PUNTO DE VENTA (POS)

MANUAL TECNICO

CAJAS.EXE Versión 4.0

Abril 2011


1. INTRODUCCIÓN : Basado en la necesidad de estandarizar y centralizar el desarrollo e interpretación de las especificaciones de comunicación entre el terminal POS y los múltiples sistemas de cajas registradoras de los comercios que utilizan el sistema VTOL 2, se implementa el modulo ejecutable para la interfase entre la terminal y las cajas registradoras que operan bajo el sistema operativo Windows, mediante el archivo ejecutable CAJAS.EXE. Este programa trabaja de frente a la terminal a través de puerto serie, utilizando las especificaciones técnicas entregadas por Redeban Multicolor S.A., y frente al usuario desarrollador del aplicativo de cajas registradoras, mediante el intercambio de datos utilizando archivos planos. Su funcionalidad consiste en invocar el programa desde otro aplicativo desarrollado sobre la plataforma Windows, indicando en un archivo de solicitud (descrito en el punto 2 de este documento) el requerimiento financiero que se desea realizar en la terminal y recibiendo a través de un archivo de respuesta (descrito en el punto 2 de este documento), los datos del resultado de la operación financiera. Una vez el programa termina devuelve el control al programa del cual fue invocado. Dependiendo la configuración del programa, el usuario podrá o no interactuar y verificar datos de resultados por pantalla, mediante ventanas prediseñadas.


2. DESCRIPCIÓN DEL SISTEMA :

Nombre : Cajas.exe Tipo : Aplicación Windows Sistema Operativo : Windows El programa CAJAS.EXE toma como entrada el archivo SOLICITUD.TXT y deja como salida el archivo RESPUESTA.TXT y según la información tomada del archivo CONFIG.TXT configura el entorno de comunicación y de presentación de la aplicación así: La estructura del archivo CONFIG.TXT es <Puerto>,<configuración>,<tiempo de buffer>,<tiempo time out>,<silencio>,<archivo solicitud>,<archivo respuesta>,<cajero>

Donde <Puerto>: Indica el número del puerto serie (COM x) donde está conectado el datáfono <Configuración>: Es una cadena conformada por la configuración del puerto de la forma velocidad, paridad, bits de datos y bits de parada. El valor predeterminado es “9600,N,8,1” <Tiempo de buffer>: Es el tiempo en milisegundos que se espera entre la entrada de datos al buffer y la lectura que lo descarga. Esto se debe ajustar según la velocidad del procesador del equipo. <Tiempo time out>: Es el tiempo de espera en milisegundos para recibir respuesta del puerto serial y se debe ajustar según la velocidad del procesador del equipo <silencio>: Según el usuario, puede definir si la aplicación es silenciosa o no, es decir, es silenciosa cuando la ejecución del programa no muestra ninguna ventana ni evento al usuario, sino que simplemente se ejecuta en background y entrega el archivo de respuesta. Cuando la aplicación no es silenciosa, se presentan en pantalla, las ventanas que interactúan con el usuario. Los valores que puede tener son: 0 = No silenciosa (Presenta Ventanas) 1 = Silenciosa (Ejecuta en Background) 2 = Ocultar mensajes


<Archivo solicitud>: Nombre del archivo a leer con la información a enviar al datafono en el momento de la transacción (Estándar SOLICITUD.TXT).

<Archivo respuesta>: Nombre del archivo a escribir con la información de

respuesta enviada por el datafono (Estándar RESPUESTA.TXT).

<Cajero>: En caso que el usuario desee reportar al datafono el código del cajero para que sea impreso en el recibo de la transacción, se debe agregar información del mismo. Los valores validos para la configuración son: 0 = No se reporta el código cajero en el archivo solicitud.txt 1 = Se reporta el código cajero en el archivo solicitud.txt Según el contenido del archivo SOLICITUD.TXT el programa identifica el tipo de operación. La estructura de este archivo debe ser la siguiente:

<Operación>, [<valor>, <valor>, ....] Donde <Operación> : Indica el tipo de operación que se desea hacer en el datáfono, el

campo puede contener: 0 : Para indicar que se realiza una compra 1 : Para indicar una Anulación 2 : Para Indicar un pago con cheque

3 : Para Habilitación de Bonos 4 : Para Redención de Bonos

<Valor> : Dependiendo del tipo de operación, <valor> contiene los valores

solicitados por la transacción que se desea realizar: Para una Compra se necesitan en el orden: <Monto> , <IVA> , <factura>,<base_dev>,<cod_cajero> Para una Anulación se necesita en el orden: <Recibo> , <factura> , <clave>,<cod_cajero> Para un Cheque se necesita en el orden : <Monto>, <factura>, <tipoaut>, <tipodoc>, <documento>, <Teléfono>, <banco>, <cuenta>, <# Cheque>,<cod_cajero> El campo <# Cheque> se utiliza únicamente para transacciones

Fenalcheque.


Para una Habilitación de Bono se necesita en el orden: <Clave>, <cod_cajero> Para una Redención de Bono se necesita en el orden: <Monto>, <cod_cajero> Donde : <Monto> : Es un campo numérico de 12 posiciones que indica

el valor de la operación <IVA> : Es un campo numérico de 12 posiciones que indica

el IVA de la operación <Factura>: Es un campo Alfanumérico de 10 posiciones que

indica el número de la factura <base_dev>: Es un campo numérico de 12 posiciones que

indica la base de devolución del IVA, según reforma tributaria. <Recibo> : Es un campo alfanumérico de 6 posiciones que

indica el número del recibo de la operación <Clave> : Es un campo alfanumérico de 4 posiciones que

indica la clave de supervisor para permitir anular en la terminal <tipoaut> : Es un campo numérico de 1 posición que indica el

autorizador del cheque así : 1= COVINOC 2= FENALCHEQUE <tipodoc> : Es un campo numérico de 1 posición que indica el

tipo de documento que se va a ingresar según el autorizador, los posibles valores son :

Covinoc 0 = Cédula 1 = Nit 2 = Cedula de Extranjería 3 = Pasaporte 4 = Tarjeta de Identidad Fenalcheque 1 = Cédula


2 = Nit 3 = Pasaporte <documento> : Es un campo alfanumérico de 9 posiciones

con el número de documento <teléfono> : Es un campo alfanumérico de 7 posiciones

con el número de teléfono <banco> : Es un campo alfanumérico de 2 posiciones

que indica el código de compensación del banco del cheque <cuenta> : Es un campo alfanumérico de 13 posiciones

con el número de la cuenta del cheque <cheque> : Es un campo alfanumérico de 6 posiciones

con el número del cheque, Solo aplica para FENALCHEQUE. <cod_cajero> : Es el código del cajero

Un ejemplo de una transacción de Compra por $10.000 con IVA de $1600, factura Nº 1234567890 y Base de devolución de $6.000 es: 0,10000,1600,1234567890, 6000 Un ejemplo de una anulación para el recibo 1234, con factura Nº 1234567890 y clave de supervisor 1111 es: 1,1234,1234567890,1111 Según el tipo de operación y modo silencioso, se presentan las siguientes pantallas: Compra Anulación


Habilitación de Bonos Redención de Bonos Cheque ERRORES


El archivo de salida RESPUESTA.TXT se genera una vez se reciba respuesta por parte de la terminal y según ésta, respuesta.txt tiene la siguiente información: <respuesta>,<autorización>,<tarjeta>,<tipotarjeta>,<franquicia>,<monto>, <IVA>, <recibo>,<cuotas>,<RRN> donde : <respuesta> : Es un campo numérico de 2 posiciones que indica la respuesta de la transacción y tiene los siguientes valores : 00= Aprobada 01= Declinada 02= Pin Incorrecto 03= Clave de Supervisor Errada 04= Entidad no responde <autorización>: Es un campo numérico de 6 posiciones que indica el número de autorización, cuando la transacción es aprobada. <tarjeta> : Es un campo alfanumérico de 12 posiciones donde los cuatro primeros dígitos corresponden al prefijo, los siguientes son asteriscos y los cuatro últimos dígitos son los cuatro últimos de la tarjeta. <tipotarjeta> : Es un campo alfanumérico de 2 posiciones que indica el tipo de tarjeta Debito o Crédito. AH = Ahorro, CC = Corriente, CR = Crédito


<Franquicia> : Es un campo alfanumérico de 10 posiciones que indica la franquicia de la tarjeta en caso de ser crédito o la palabra Debito en caso de ser débito. <Monto> : Es un campo numérico de 12 posiciones que indica el valor de la transacción. <IVA> : Es un campo de tipo numérico que indica el IVA de la transacción. <Recibo> : Es un campo alfanumérico de 6 posiciones que indica el número del recibo de la transacción <Cuotas> : Es un campo alfanumérico de 2 posiciones que indica el número de cuotas seleccionado por el usuario . Un ejemplo de una transacción de Compra por $10.000 con IVA de $1600 y factura N° 1234567890 es aprobada es: 00,234567,589517**3245,AH,DEBITO ,000000010000,000000001600,123456,00

y una transacción rechazada por Entidad no respondes es : 04, ,503396**9916,DEBITO ,000000002342,000000002432,555540,00

La transacción de bonos genera el archivo de respuesta con la siguiente estructura: Habilitación: <Respuesta>,<autorización>,<recibo>,<RRN>,<terminal>,<monto habilitado>,<cuotas>,<número Bono> Redención: <Respuesta>,<autorización>,<recibo>,<RRN>,<terminal>,<cuotas>,<monto>,<número Bono>


PROYECTO LEALTAD 3. DESCRIPCION OPERATIVA SEGÚN ESPECIFICACIONES : Para este proyecto se van a manejar 4 tipos de transacción para las cuales se realizarán por medio del datafono: 1- Activación 2- Consulta 3- Redención 4- Acumulación 5- Recarga de Bonos En la Acumulación se va a manejar el siguiente menú en el datafono. 1- Tarjeta 2- Cédula Para este proyecto se van a trabajar los siguientes códigos de mensaje - Tabla de Códigos de Transacciones

Código de Transacción Descripción

05 Activación Tarjeta

06 Recarga de Bonos

08 Redención Lealtad

09 Acumulación Puntos

Campos que intervienen en la respuesta de la transacción de lealtad.

Tipo de Campo

Atributo

Longitud

Descripción

00 2 Código de respuesta de la transacción 00–Aprobación 01-Declinada 04– Entidad no Responde

01 6 Código de Autorización

65 Ans 6 Número de recibo en el Datafono

70 Ans 12 Número de Cédula – Cambiar a 12 bytes la longitud

71 Ans 10 Número de Teléfono

77 Ans 6 RRN Retriveral Referan Number


78 Ans 8 Número de la terminal

84 Ans 4 Clave de Supervisor

85 Ans 12 Número de Puntos acumulados

86 Ans 12 Número de Puntos Redimidos para Redención y Puntos Totales Acumulados para Acumulación

87 Ans 19 Número de la tarjeta

Activación Tarjeta: Se debe enviar al igual que en la habilitación de Bonos el número de la clave de supervisor y adicionalmente se debe ingresar el número de cédula del tarjetahabiente. Es decir campo 70 y el número del teléfono en el campo 71. La operación será la siguiente:

Consulta Tarjeta: Está Transacción funciona únicamente en el datafono. No requiere interacción con la caja registradora. Redención Tarjeta: Se va a manejar igual que la transacción de Redención de Bonos, se debe enviar el campo 40 con el monto a redimir y a su vez el datafono entregará los mismos datos que la transacción de bonos. Los reversos de Redención se manejaran igual que los de las compras es decir los maneja directamente el datafono y le enviará a la caja con código de respuesta 04 Entidad no responde.

Tecla de activación de

puntos Datos Rta de la

Caja

ACK 06

ACK 06

ACK 06

Solicitud Datos a la

Caja

Datos Rta

Transacción

Función Menú Transacciones

Lealtad Activación


Acumulación Tarjeta :

Para esta transacción se van a manejar dos tipos de transacciones:

1- Cuando se realiza el pago con efectivo o con otras tarjetas :

En el datafono se ingresa al menú de Lealtad y se escoge el tipo de información por medio

del cual se van a acumular los puntos, es decir, si va ser con la tarjeta de lealtad o con el

Número de cédula. Una vez se realice el paso anterior la caja registradora enviará la clave

de supervisor en el campo 84 y los datos de Monto en el campo 40 y el valor del IVA en

el campo 41

2- Cuando el pago se realiza con tarjeta ya sea Débito o Crédito y hay

acumulación automática:



Caja

ACK 06

ACK 06

ACK 06


Caja

Datos Rta

Transacción


Lealtad Redención



Caja

ACK 06

ACK 06

ACK 06


Caja

Datos Rta

Transacción


Lealtad Acumulación


Se realiza todo el procedimiento de la compra que venimos manejando actualmente y una

vez sea aprobada la compra, el datafono enviará la transacción de acumulación

automática solo en el caso de que el prefijo de la tarjeta lo permita y la respuesta a la caja

tendrá dentro de la misma respuesta los puntos acumulados y totales, cerrando la

operación con una misma operación.

Para el caso de pago con tarjetas que no estén configuradas en la inicialización para

acumulación automática, en la respuesta hacia la caja no estarán presentes los campos de

puntos acumulados y puntos totales, así que para realizar la acumulación se deberá

realizar el proceso planteado para acumulación en efectivo o pago con otras tarjetas.

Cuando la acumulación automática no pueda realizarse, el terminal en la actualidad

guarda la información y la envía al realizarse el cierre del datafono, de tal manera que si

los campos de puntos acumulados y puntos totales son enviados pero en ceros, no se

debe enviar de nuevo la acumulación, ya que el terminal va enviar esta acumulación

posteriormente.

a. Recarga de Bonos:

Se va a manejar igual que la transacción de Redención de Bonos, se debe enviar el campo 40 con el monto a recargar y a su vez el datafono entregará los mismos datos que la transacción de bonos.

4. DESCRIPCION TECNICA:

Para manejar los 4 tipos de transacción:



Caja

ACK 06

ACK 06

ACK 06


Caja

Datos Rta Transacción con

Lealtad

Función Transacción de

Compra.


Activación Consulta Redención Acumulación Recarga Bonos

Los siguientes son los parámetros que deben estar incluidos en el archivo solicitud.txt (o el equivalente archivo de entrada) a. Activación

El registro de solicitud estará conformado así: 5,<clave de supervisor>,<número de documento>,<teléfono>,[Código de Cajero]

Donde: <Clave supervisor>: Es un campo numérico de 4 posiciones que indica la clave del supervisor que activa la tarjeta.

<Documento>: Es un campo alfanumérico de 12 posiciones con el número de documento del cliente que se va a activar el el producto.

<Teléfono>: Es un campo alfanumérico de 14 posiciones con el número de teléfono del cliente que se va a activar el el producto.

[Código de Cajero]: Es un campo opcional, alfanumérico de 10 posiciones que indica el código del cajero.

b. Redención El registro de solicitud estará conformado así:

8,<valor>,[Código de Cajero]

Dónde:

<Valor>: Es un campo numérico de 12 posiciones que indica el valor de la redención.

[Código de Cajero]: Es un campo opcional, alfanumérico de 10 posiciones que indica el código del cajero.


c. Acumulación

El registro de solicitud estará conformado así:

9,<monto1>,<IVA>,<clave de supervisor>,[Código de Cajero]

Donde:

<monto1>: Es un campo numérico de 12 posiciones que indica el valor de la transacción. Con este valor se realiza la conversión y acumulación de puntos. <IVA>: Es un campo numérico de 12 posiciones que indica el valor del IVA de la la transacción. <Documento>: Es un campo alfanumérico de 12 posiciones con el número de documento del cliente que realiza la acumulación. <Clave supervisor>: Es un campo numérico de 4 posiciones que indica la clave del supervisor que activa la tarjeta. [Código de Cajero]: Es un campo opcional, alfanumérico de 10 posiciones que indica el código del cajero.

d. Recarga de Bonos

El registro de solicitud estará conformado así:

6,<monto1>, [Código de Cajero]

Donde:

<monto1>: Es un campo numérico de 12 posiciones que indica el valor de la transacción. Este valor indica el monto a recargar al bono. [Código de Cajero]: Es un campo opcional, alfanumérico de 10 posiciones que indica el código del cajero.


INFORMACIÓN ADICIONAL – DETALLE CAMPOS Valores del campo Franquicia BCO_SUP = Banco Superior – Diners DINERSCLUB = Diners MAESTRO = Maestro VISA = Visa CREDENCIAL = Credencial MASTERCARD = Mastercard VISA DEBIT = Visa Debito AMEX = American Express V.ELECTRON = Visa Electron MASTER = Master Debit CREDENVISA = Credencial Visa CAJA C.F. = Caja Compensación Familiar T. PRIVADA = Tarjetas privadas de bancos T. CREDITO = Tarjetas privadas terceros T. CREDITO = Tarjetas crédito marca privada T. EXITO = Tarjeta Exito C M R = CMR Falabella PRIVADA = Tarjeta EPM CREDITO PR = Tarjetas crédito marca privada configuración dos BONO CODEN = Codensa BONOS = Bonos SODEXHO = Sodexho BIG PASS = Sodexho Big Pass Valores del campo Tipo Cuenta Ahorros = AH Corriente = CC Crédito = CR Lealtad = LT Cuota Monetaria = CM Cupo Crédito = CU Bono Efectivo = BE Crédito Rotativo = RT Bono Regalo = RG Bono Descuento = DS Bolsillo Crédito = BC Bolsillo Débito = BD SP = SuperCupo


Valores del campo Tipo Cuenta para Cajas de Compensación Familiar Lealtad = LT Cuota Monetaria = CM Cupo Crédito = CU Bono Efetivo = BE

Manual Técnico CajasActualizado Exe

Documents

Transcript of Manual Técnico CajasActualizado Exe