MODULO DE CAJAS – MANUAL TÉCNICO

MODULO EJECUTABLE PARA LA INTERFASE DE

CAJAS REGISTRADORAS CON EL
PUNTO DE VENTA (POS)

MANUAL TECNICO

CAJAS.EXE

VERSION 5.2

Agosto 2016
 MODULO DE CAJAS – MANUAL TÉCNICO

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 interface 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 serial, 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.
 MODULO DE CAJAS – MANUAL TÉCNICO

2. DESCRIPCION GENERAL DE LA INTERFACE

Conforme la arquitectura de comunicación, el sistema Cajas.exe® intercambia

información con el software del Punto de Venta a través de dos mensajes,
mensaje de SOLICITUD (IN) y Mensaje de RESPUESTA (OUT). Los mensajes de
SOLICITUD y RESPUESTA, se intercambian entre los sistemas a través de
archivos identificados físicamente como SOLICITUD.txt y RESPUETA.txt

El protocolo general de comunicación, cumple los siguientes pasos:

En los momentos en que se tienen esperas, se fijan tiempos parametrizables, los

cuales se afinan o ajustan conforme el desempeño de los equipos y de la interface
en general.

Se resalta en el cuadro anterior, que el encargado de borrar el mensaje, es aquel

que lo procesa, es mandatorio que no se pueda escribir sobre el mensaje si no
está vacío, esto asegura el proceso de la contraparte. Es decir cada vez que el
sistemas cajas.exe lee el archivo solicitud.txt, se encarga de borrarlo una vez lo
procesa, a su vez el sistema POS debe borrar el archivo respuesta.txt una vez lo
procesa.
 MODULO DE CAJAS – MANUAL TÉCNICO

3. INSTALACION :

Para instalar el programa cliente Cajas.exe® se debe ejecutar el programa de

instalación setup.exe que se encuentra en la carpeta \Instaladores. De acuerdo
con su sistema, debe elegir la arquitectura de 32 o 64 bits.

Dentro de la carpeta del instalador seleccionado, encontrará el archivo de

instalación Stup.exe.

El asistente de instalación lo guiará por los pasos necesarios para la instalación del
programa así:
 MODULO DE CAJAS – MANUAL TÉCNICO

Seleccione la carpeta donde se instalará el programa y seleccione el perfil de

usuario que puede ejecutar este programa después de instalado. Se recomienda
seleccionar “Para todos los usuarios”
 MODULO DE CAJAS – MANUAL TÉCNICO

Al finalizar la instalación, se habrán registrado los componentes necesarios para la

ejecución del sistema y habrá creado los archivos. Adicionalmente, se deberá
copiar en esta ubicación el archivo EMF.SIP enviado en el paquete.

El archivo de configuración EMF.SIP, indica los campos que son entregados al

datafono en la trama de solicitud.

4. DESCRIPCIÓN DEL SISTEMA :

Nombre : Cajas.exe
Tipo : Aplicación Windows
Sistema Operativo : Windows

Para la instalación del cajas.exe se deben tener los instaladores para su correcto
funcionamiento.

1. Se deberá ejecutar el instalador de cajas.

2. Se deberá ejecutar el asistente para la instalación de cajas.

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.SIP, configura el entorno de comunicación y de presentación de
la aplicación así:

 Estructura del archivo CONFIG.SIP es

[ID-TERMINAL]=192.168.1.110
[PUERTO]=
[CONFIGURACION]=9600,N,8,1
[SLEEP]=120
[TIMEOUT]=120
[VISIBLE]=
[CODIGOCAJERO]=
[ENTRADA]=SOLICITUD.TXT
[SALIDA]=RESPUESTA.TXT
 MODULO DE CAJAS – MANUAL TÉCNICO

[CONFIRMAR]=SI

Donde

<Puerto>: Indica el número del puerto serie (COM x) donde está conectado
el datafono

<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”

<Sleep>: 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.

<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

<Visible>: 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:

2 = Ejecución en Background. Sin mensajes.

3 = Visible básica.
4 = Visible incluye configuración cajas.

<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 válidos 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

<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).
 MODULO DE CAJAS – MANUAL TÉCNICO

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

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

<Confirmar>: Indica si en el momento de invocar la aplicación cajas.exe

con la interface habilitada, se deberá confirmar el envió de la mensajería al
datafono. Los posibles valores son:

Si = Solicita botón confirmar.

No = Al ejecutar cajas.exe, se envía automáticamente el mensaje al
datafono.

 Estructura del archivo SOLICITUD.TXT es

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

datafono, el campo puede contener:

0 – Compra
1 – Anulación
2 – Cheques
3 – Habilitación de Bonos
4 – Redención de Bonos
5 – Activa Tarjeta de Lealtad
6 – Recarga Bonos Recargables
8 – Redime puntos Tarjeta de Lealtad
9 – Acumula Puntos Tarjeta de Lealtad
10 – Avance en efectivo
11 – Recarga en efectivo

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

valores solicitados por la transacción que se desea realizar.

<Monto> : Es un campo numérico de 12 posiciones que indica el valor de

la operación
 MODULO DE CAJAS – MANUAL TÉCNICO

<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 numé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 10 posiciones con el número de

documento
 MODULO DE CAJAS – MANUAL TÉCNICO

<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 un campo alfanumérico de 9 posiciones con el código del

cajero

<imp_consu>: Es un campo numérico de 12 posiciones que indica el valor del

impuesto al consumo de la operación
 MODULO DE CAJAS – MANUAL TÉCNICO

PANTALLAS

Según el tipo de operación y modo silencioso, se presentan las siguientes

pantallas:

 COMPRA

Para una Compra se necesitan en el orden:

<Operación>, <Monto>, <IVA>, <factura>, <base_dev>, <imp_consu>,

<cod_cajero>

Ejemplo:

Se realiza una compra por un monto de $15.000, con IVA de $2.400, con
número de factura 123456, base de devolución $1.000, código de cajero 58 y un
Valor de impuesto al consumo por $1.500.

0, 15000, 2400, 123456, 1000, 1500,58

 MODULO DE CAJAS – MANUAL TÉCNICO

 ANULACION

Para una Anulación se necesita en el orden:

<Operación>, <Recibo>, <factura>, <Clave>, <cod_cajero>

Ejemplo:

Se realiza una anulación con el N° de recibo 56 y factura 123456

*** Se debe tener en cuenta que la clave corresponde a la clave de supervisor

Configurada en el datafono.

1, 56, 123456, 0000, 58

 MODULO DE CAJAS – MANUAL TÉCNICO

 CHEQUE

Para un Cheque se necesita en el orden:

<Operación>, <Monto>, <factura>, <tipoaut>, <tipodoc>, <documento>,

<Teléfono>, <banco>, <cuenta>, <# Cheque>, <cod_cajero>

** El campo <# Cheque> se utiliza únicamente para transacciones Fenalcheque.

Ejemplo:

2,100000,123456,2,1,1030550247,2024339,02,1234567891895,777777,58
 MODULO DE CAJAS – MANUAL TÉCNICO

 HABILITACION DE BONOS

Para una Habilitación de Bono se necesita en el orden:

<Operación>, <Clave>, <cod_cajero>

*** Se debe tener en cuenta que la clave corresponde a la clave de supervisor

Configurada en el datafono.

Ejemplo:

3, 0000, 58
 MODULO DE CAJAS – MANUAL TÉCNICO

 REDENCION DE BONOS

Para una Redención de Bono se necesita en el orden:

<Operación>, <Monto>, <cod_cajero>

Ejemplo:

4, 10000, 58
 MODULO DE CAJAS – MANUAL TÉCNICO

 RECARGA DE BONOS

Para una Recarga de Bono se necesita en el orden:

<Operación>, <Monto>, <Clave>, <cod_cajero>

*** Se debe tener en cuenta que la clave corresponde a la clave de supervisor

Configurada en el datafono.

Ejemplo:

6,10000,1526,58
 MODULO DE CAJAS – MANUAL TÉCNICO

 REDENCION DE PUNTOS

Para una Redención de Puntos se necesita en el orden:

<Operación>, <Monto>, <cod_cajero>

Ejemplo:

8,10000,58
 MODULO DE CAJAS – MANUAL TÉCNICO

 ACUMULA PUNTOS

Para una Acumulación de Puntos se necesita en el orden:

<Operación>, <Monto>, <IVA>, <Documento>, <Clave>, <imp_consu>,

<cod_cajero

Ejemplo:

9,25000, 300,3202589,0000,1000,58
 MODULO DE CAJAS – MANUAL TÉCNICO

 AVANCES

Para un Avance se necesita en el orden:

<Operación>, <Monto>, <IVA>, <Factura>, <base_dev>, <indicador>,

<imp_consu>,<cod_cajero>.

Ejemplo:

10,10000,500,12345,8895,99,58,789

** El campo indicador debe ir con valor fijo 99

 MODULO DE CAJAS – MANUAL TÉCNICO

PANTALLA DE ERRORES

Esta pantalla se puede presentar cuando no se configura adecuadamente el tipo

de operación requerida.
 MODULO DE CAJAS – MANUAL TÉCNICO

 Estructura del archivo RESPUESTA.TXT es

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>, < Bas Dev> , <recibo>,<cuotas>, <RRN>

Dónde:

<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
 MODULO DE CAJAS – MANUAL TÉCNICO

03= Clave de Supervisor Errada

04= Entidad no responde

<Autorización>: Es un campo alfanumé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.

<Tipo tarjeta>: 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.

<Bas 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 numé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.

<RRN>: Es un campo de numérico de 6 posiciones que indica el número de

auditoria que asigna el sistema de seguimiento de transacciones para Base24.
 MODULO DE CAJAS – MANUAL TÉCNICO

Un ejemplo de una transacción de Compra por $1.000 con IVA de $0 y factura N°

12345 aprobada es:

00,509744,601660**0164,AH,MAESTRO ,00000001000,000000000000,000013,00,000109

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>