Escolar Documentos
Profissional Documentos
Cultura Documentos
CONNECTOR 2.0
MANUAL DE INTEGRACIÓN.
1
DOCUMENTO CONFIDENCIAL
info@cashlogy.com
www.cashlogy.com
HISTÓRICO DE REVISIONES
Fecha Versión
Abril 2015 V0 Generación del documento
Añadidos comandos error,
relaciones a comandos sin
Mayo 2016 V1
pantallas y MiniPC, y anexos
1y2
Septiembre 2016 V1.1 Unificado para diferentes
productos
Abril 2018 V2 Añadidos ejemplos.
Modificación estructura
Julio 2018 V2.1 Añadido tercer parámetro
comando vaciado completo #V#
Nuevas opciones configuración
El contenido de este manual puede sufrir modificaciones sin previo aviso, debido a
modificaciones, mejoras o actualizaciones.
2
DOCUMENTO CONFIDENCIAL
Tabla de contenido
1 INTRODUCCIÓN. ______________________________________________________ 5
2 QUÉ ES CASHLOGYCONNECTOR. _________________________________________ 5
2.1 PRODUCTOS COMPATIBLES. _____________________________________________ 5
3 DESCRIPCIÓN DEL FUNCIONAMIENTO. ____________________________________ 6
4 REQUISITOS MÍNIMOS DEL DISPOSITIVO TPV ______________________________ 6
5 ARQUITECTURA. ______________________________________________________ 7
5.1 FUNCIONAMIENTO. ____________________________________________________ 7
5.2 DIFERENTES ARQUITECTURAS. ___________________________________________ 8
5.2.1 TPV Windows. _______________________________________________________________ 8
5.2.2 Conexión a Cashlogy POS1500X o un MiniPC. ______________________________________ 8
5.3 MODELOS DE INTEGRACIÓN. _____________________________________________ 9
5.3.1 Integración exprés: ___________________________________________________________ 9
5.3.2 Integración Completa o sin pantallas de CashlogyConnector. _________________________ 9
5.3.3 Integración avanzada o personalizada: __________________________________________ 10
5.4 CONEXIÓN E INSTALACIÓN. _____________________________________________ 10
5.4.1 Conexión e instalación en un MiniPC ____________________________________________ 13
5.5 RECOMENDACIONES DE CONEXIÓN ______________________________________ 14
6 PROGRAMACIÓN. ___________________________________________________ 15
6.1 CONFIGURACIÓN._____________________________________________________ 15
6.2 CÓDIGOS DE ERROR: __________________________________________________ 20
6.3 COMANDOS. _________________________________________________________ 21
6.3.1 INTEGRACIÓN EXPRÉS. _______________________________________________________ 22
6.3.1.1 #I# Comando de Inicializar la máquina: _____________________________________ 22
6.3.1.2 #E# Finalizar la aplicación CashlogyConnector: _______________________________ 23
6.3.1.3 #C# Cobrar: ___________________________________________________________ 23
6.3.1.4 #G# BackOffice: ________________________________________________________ 28
6.3.2 INTEGRACIÓN AVANZADA O PERSONALIZADA: ____________________________________ 32
6.3.2.1 COBRO ANTICIPADO ____________________________________________________ 33
6.3.2.1.1 #B# Inicializar admisión: ______________________________________ 34
6.3.2.1.2 #Q# Consulta importe admitido: ______________________________ 34
6.3.2.1.3 #J# Finalizar admisión: ________________________________________ 35
6.3.2.1.4 #P# Dispensar: ________________________________________________ 35
6.3.2.2 OPERACIONES DE CAMBIO Y CAJA _________________________________________ 37
6.3.2.2.1 #A# Añadir cambios: __________________________________________ 38
6.3.2.2.2 #H# Dar cambio: ______________________________________________ 40
6.3.2.2.3 #R# Retirar efectivo: __________________________________________ 43
6.3.2.2.4 #U# Dispensar por denominación:_____________________________ 45
3
DOCUMENTO CONFIDENCIAL
6.3.2.2.5 #S# Retirar Stacker: __________________________________________ 46
6.3.2.2.6 #F# Cierre / fondo de caja: ____________________________________ 49
6.3.2.2.7 #1# Recarga manual 1 céntimo: ______________________________ 51
6.3.2.3 REVISION DE CONTABILIDADES ____________________________________________ 53
6.3.2.3.1 #D# Estado: ___________________________________________________ 53
6.3.2.3.2 #T# Cantidad total de efectivo: ________________________________ 55
6.3.2.3.3 #X# Cantidad de una determinada denominación: ____________ 55
6.3.2.3.4 #Y# Cantidad de todas las denominaciones: ___________________ 56
6.3.2.3.5 #GC# Nivel de cada denominación ____________________________ 56
6.3.2.3.6 #GI# Información auxiliar de cada denominación ______________ 57
6.3.2.3.7 #M# Estadísticas Absolutas: ___________________________________ 58
6.3.2.3.8 #N# Estadísticas Relativas: ____________________________________ 59
6.3.2.4 OPERACIONES DE MANTENIMIENTO _______________________________________ 60
6.3.2.4.1 #!# Cancelar __________________________________________________ 61
6.3.2.4.2 #Z# Reset _____________________________________________________ 62
6.3.2.4.3 #V# Vaciado completo: ________________________________________ 62
6.3.2.4.4 #GV# Consulta de versiones y números de serie. _____________ 65
6.3.2.4.5 #O# Mantenimiento (con pantallas) ___________________________ 67
6.3.2.4.6 #W# Mantenimiento sin pantallas: ____________________________ 68
6.3.2.4.7 #L# Ver logs: __________________________________________________ 70
6.3.2.4.8 #K# Poner a cero todas las monedas: _________________________ 70
6.3.2.5 CONSULTA DE ERRORES _________________________________________________ 71
6.3.2.5.1 #?#SHOW# Mostrar errores. __________________________________ 71
6.3.2.5.2 #?# ¿Error? ____________________________________________________ 73
6.3.2.5.3 #?#error# Detalle de error ____________________________________ 75
6.3.3 INTEGRACIÓN COMPLETA O SIN PANTALLAS ______________________________________ 77
6.3.3.1 CONFIGURACION _______________________________________________________ 78
6.3.3.2 OPERACIONES DE COBRO ________________________________________________ 80
6.3.3.3 OPERACIONES DE CAMBIO. _______________________________________________ 82
6.3.3.4 REVISIÓN DE CONTABILIDADES. ___________________________________________ 83
6.3.3.5 OPERACIONES DE MANTENIMIENTO _______________________________________ 84
6.3.3.6 MOSTRAR ERRORES _____________________________________________________ 85
6.4 PANTALLAS DE INFORMACIÓN DE ERRORES: _______________________________ 86
7 CHECKLIST INTEGRACIÓN. _____________________________________________ 90
8 EJEMPLOS. _________________________________________________________ 92
ANEXO 1 INDICE Y RESUMEN DE COMANDOS __________________________ 94
4
DOCUMENTO CONFIDENCIAL
1 INTRODUCCIÓN.
Este manual va dirigido a los técnicos programadores como ayuda en el
proceso de integración de productos Azkoyen con sus aplicaciones TPV
mediante el software CashlogyConnector.
2 QUÉ ES CASHLOGYCONNECTOR.
CashlogyConnector es un módulo que permite ejecutar las diferentes
opciones operativas de diferentes productos Azkoyen sin necesidad de utilizar
las funciones OPOS de bajo nivel.
CashlogyConnector debe de ir integrado en un software de gestión, esta
integración se hará mediante envío de una serie de comandos a través de un
puerto TCP/IP determinado.
5
DOCUMENTO CONFIDENCIAL
Este manual será válido para la integración de software para el uso
de cualquiera de estos dispositivos. Se especificará en aquellos
comandos exclusivos o no compatibles dicha compatibilidad y se
referirá a “el dispositivo” o “el producto” a integrar para hablar de
cualquiera de ellos.
6
DOCUMENTO CONFIDENCIAL
5 ARQUITECTURA.
5.1 FUNCIONAMIENTO.
Aplicación T.P.V.
CashlogyConnector
(Socket) IP , Puerto
Dispositivo Azkoyen a
integrar
8
DOCUMENTO CONFIDENCIAL
La conexión entre el TPV y el MiniPC se recomienda que se haga por una
red cableada por motivos de seguridad, aunque es posible la conexión
por WiFi.
10
DOCUMENTO CONFIDENCIAL
• Cashlogy Monitor. Este módulo lanzará en el inicio de cada
usuario “CashlogyConnector.exe” y se encargará de asegurar que
está ejecutándose. Será siempre necesario instalar en caso
de usar un MiniPC sin pantalla.
• Log Service. Servicio de Azkoyen de envío de logs.
• Cashlogy Remote Updater. Actualizador remoto
• Azkoyen TeamViewer. Versión host de Azkoyen, no instalar si ya
dispone de TeamViewer
• Overwrite previous login data. Sobrescribir en caso de que sea
necesario la clave para el servicio de logs y actualizador remoto
que se suministra con la máquina.
11
DOCUMENTO CONFIDENCIAL
iv. Procedemos a la instalación pulsando siguiente.
v. Configuramos el producto a utilizar y el puerto COM al que está
conectado. Esta configuración podrá ser modificada en
C:\Cashlogy\CashlogyConfig\CashlogyConfig.exe
12
DOCUMENTO CONFIDENCIAL
En caso de trabajar con el simulador para realizar la
integración, instale CashlogySimulator.exe y seleccione el
producto CashlogySimulatorPOS20 (el último de la lista
desplegable)
13
DOCUMENTO CONFIDENCIAL
Al estar trabajando desde un TPV en el que CashlogyConnector no está
instalado ni conectado al dispositivo, el integrador debe de mostrar los
posibles errores de la máquina al usuario en el TPV. En la instalación de
CashlogyConnector, además, se instalan una serie de videos que
ayudan al usuario en la resolución de errores. CashlogyConnector,
mediante los comandos #?# “error” y #?#err1,err2,…# “detalle del
error”, sección 6.3.2.5, ofrece al software la información de los errores
presentes, texto a mostrar, y ubicación del video si hubiera un video
relacionado con dicho error. Estos videos se encuentran en formato .avi
en la carpeta por defecto “C:\Cashlogy\ CashlogyConnector\Videos” ahí
donde se ha instalado CashlogyConnector (en este caso en el MiniPC). El
integrador deberá recoger estos videos y mostrarlos en el TPV al
usuario.
14
DOCUMENTO CONFIDENCIAL
- Al iniciar el software de gestión, se debe lanzar la aplicación
CashlogyConnector.exe (Si tiene instalado CashlogyMonitor, este lo
lanzará al iniciar Windows)
- A continuación, establecer la conexión con CashlogyConnector a través
del socket
o En caso de que esta fallara se recomienda reintentar la conexión,
y esperar a que CashlogyConnector se inicialice y comprobar que
este inicializado (en caso contrario, volver a lanzarlo)
- Una vez establecida la conexión, se debe enviar el comando #I# (ver
punto 6.3 comandos) y esperar su respuesta (esta puede tardar un
minuto aproximadamente, ya que es el tiempo que necesita la máquina
para iniciar y hacer el test de hardware)
- Operar siempre con el puerto conectado. Se recomienda implementar
un mecanismo de reconexión para, en caso de que el TPV recibiese un
evento de error de su socket, tratar de reconectar estableciendo su
controlador de socket a estado de reposo, esperar 1-2 segundos e
intentar establecer de nuevo la conexión con CashlogyConnector.
- Al cerrar el software de gestión, salvo en integraciones con MiniPC, se
debe enviar el comando de finalizar (#E#), esperar su respuesta y
cerrar el socket.
6 PROGRAMACIÓN.
Una vez establecido el modelo de relación entre la aplicación T.P.V. y el
dispositivo, podremos modificar el código de la aplicación solicitando las
funcionalidades programadas en CashlogyConnector.
6.1 CONFIGURACIÓN.
Mediante el programa CashlogyConnector_Config.exe, suministrado con el
módulo instalador, debemos configurar las monedas, idioma y los parámetros
necesarios para el correcto funcionamiento de CashlogyConnector.
Cuando lanzamos el programa CashlogyConnector_Config.exe se presenta la
siguiente pantalla:
15
DOCUMENTO CONFIDENCIAL
Grabamos el puerto en el que escuchará el módulo CashlogyConnector, por
defecto propone el puerto 8092.
▪ “Cambiar configuración”. Pulsando este botón podremos elegir el
idioma en el que queremos que trabaje CashlogyConnector, y el tipo de
máquina y moneda con la que trabajaremos.
16
DOCUMENTO CONFIDENCIAL
▪ En el campo “Nombre” se presenta el nombre de la máquina. Este
vendrá dado según la configuración elegida en “Cambiar configuración”
▪ En el campo “Idioma” se muestra el código del idioma en el que
CashlogyConnector presenta los textos, mensajes, avisos, etc. Para
cambiar el idioma deberá de hacerse a través del botón “Cambiar
configuración”
▪ En el campo “Descripción” se permite crear un texto que será la
cabecera de aquellos tickets que CashlogyConnector imprima
▪ En el campo “Símbolo moneda” se presenta el símbolo de la moneda
€, $, etc. Según la configuración elegida en “Cambiar configuración”
▪ “Puerto”. En este campo se puede cambiar el puerto de comunicación
con el software TPV. Se recomienda usar el puerto por defecto, 8092.
▪ “Nº días log” permite indicar el número de días que mantiene la
información de los archivos LOG. Se recomienda para optimizar recursos
no guardar más de 10 días este tipo de logs.
▪ El campo “Cobro manual”, le indica a CashlogyConnector si en la
pantalla de cobro acepta el cobro manual (1) o no lo acepta (0) Este
parámetro podrá ser modificado por el software POS. (ver apartado
6.3.1.3).
▪ “Nº segundos visible segunda pantalla” Podemos determinar el
número de segundos que permanecerá la información que
CashlogyConnector presenta en la segunda pantalla de cliente.
▪ “Ver pantalla error”. Parámetro para configurar si se desea que
Cashlogy Connector muestre error en caso de no tener cambios
suficientes para realizar una operación.
▪ “Ver totales en la pantalla de cambios”. Mediante este parámetro
se configurara la opción de mostrar al usuario (1) o no hacerlo (0) la
cantidad de billetes y monedas disponibles en los recicladores de billetes
y monedas al usar la opción “Añadir cambios” (#A#). Ver apartado
6.3.2.2.1.
▪ “Ver errores de”. Podremos seleccionar el tipo de error que queremos
se muestre al usuario y video de ayuda:
o Tipo 0. Avisos, por ejemplo: nivel de monedas cerca de vacío,
suciedad.
o Tipo 1. Error de primer nivel (usuario). Por ejemplo, atasco de
billete en admisión
17
DOCUMENTO CONFIDENCIAL
o Tipo 2. Error de segundo nivel (usuario-técnico). Por ejemplo,
atasco de billete en reciclador.
o Tipo 3. Error fatal. Todo error que impide cualquier
funcionalidad, por ejemplo problemas de conexión.
▪ “Mostrar mensaje coger devolución”. Tras una devolución muestra
un recordatorio a usuario de que debe recoger su cambio (1).
▪ En la ventana “Monedas y billetes” guarda la información relativa a
los billetes y monedas con los que trabajará CashlogyConnector:
▪ “Denominación”, descripción del billete o moneda.
▪ “Valor” Valor de la moneda o billete multiplicado por cien.
▪ “Billete”, 0 si es moneda y 1 si es billete.
▪ “Imagen”, la ruta de la carpeta donde guardamos el archivo de
la imagen de la moneda o billete y el nombre del archivo.
▪ “Nº Hopper”, Número de Hopper donde se almacenará la
moneda
En el caso de que en un Hopper se almacenen varios tipos de
monedas, cada una de ellas tendrá grabado como parámetro el
mismo número de Hopper.
▪ “Puede dar cambio” (solo válido para el proceso “dar cambio”,
apartado 6.3.2.2.2.)
o = 1 indica que esa moneda o billete se puede utilizar, en el
proceso de dar cambios, para entregar el cambio solicitado.
o = 0 indica esa moneda o billete que no se pueden utilizar en ese
proceso.
▪ “Puede entrar para cambio” (solo válido para el proceso “dar
cambio”, apartado 6.3.2.2.2.)
o = 1 indica que esa moneda o billete se puede utilizar en el
proceso de dar cambios para recibir en esas denominaciones.
o = 0 indica que no se utilizan solamente para el proceso de “dar
cambio”.
▪ “Se acepta”
o = 1 indica que esa moneda o billete se puede utilizar tanto en los
procesos de venta como en los procesos de cambio, a no ser que
en este último esté deshabilitada.
18
DOCUMENTO CONFIDENCIAL
o = 0 indica que esa moneda o billete no será admitida ni en los
procesos de venta ni en el proceso de cambio, aunque esté
habilitada para este proceso.
▪ “Nº Minutos autocierre”.
o = n, CashlogyConnector se cerrara automáticamente si tras
iniciarse, pasado este número de minutos no hay conexión con el
software TPV. (solo en caso de que CashlogyMonitor.exe no esté
instalado)
o = 0, no se cierra automáticamente aunque no haya
comunicación. En situaciones en las que CashlogyConnector esté
instalado en un MiniPC debe de estar a 0 este parámetro.
▪ “Modo pantalla”. Se modificará este parámetro en aquellas
configuraciones que no quieran utilizar pantallas proporcionadas por
CashlogyConnector, especialmente para integraciones con un MiniPC sin
pantalla.
o Normal. CashlogyConnector mostrará las pantallas en aquellos
comandos que las requieran.
o Sin Pantalla. CashlogyConnector nunca mostrará pantallas, y en
caso de recibir un comando que la requiera devolverá error.
Tampoco muestra mensajes de error aunque se haya definido a 1
el parámetro “Ver pantalla de error”.
o Pantallas siempre encima. Se mostrarán las pantallas de
CashlogyConnector siempre por encima de cualquier aplicación.
▪ “Formato video imagen”. Formato y resolución en la que desea que
se presenten los videos / imágenes de error (válido para integración
completa, ver comando detalle error #?#error#)
▪ “Opciones en caso de error en devolución”. Si se produce un error
en la devolución por falta de cambio o por error en la máquina
CashlogyConnector permite tres opciones al usuario. En este campo se
pueden configurar todas las combinaciones a mostrar:
o Aceptar. Si el usuario pulsa aceptar, la devolución se hará
manualmente. Si es por falta de cambio la máquina no devolverá
nada, no realizará un pago fraccionado.
o Cancelar. Si el usuario pulsa cancelar, la máquina devolverá el
importe introducido para realizar la venta en otra forma de pago.
(en caso de estar usando comando de cobro #C#)
19
DOCUMENTO CONFIDENCIAL
o Añadir cambios. Se permite al usuario acceder a la pantalla de
añadir cambios para posteriormente finalizar la devolución.
o Ninguna. Si esta opción esta seleccionada, el usuario
simplemente recibirá un mensaje en pantalla informando del
importe que no se ha podido devolver.
▪ “Modo desatendido”. Si el valor de este campo es 1, no se muestran
videos de error y así mismo, en caso de error en devolución se muestra
un mensaje indicando que debe de contactar con el encargado.
▪ “Restaurar valores por defecto” Para reestablecer los valores por
defecto
Cuando hayamos ajustado los valores de los parámetros a nuestro modelo de
trabajo, pulsaremos “Grabar”, para salvar los cambios.
A partir de este momento el módulo CashlogyConnector utilizará estos
parámetros, para operar cada vez que sea llamado por la aplicación T.P.V.
20
DOCUMENTO CONFIDENCIAL
o #ER:BAD_DATA# CashlogyConnector devuelve esta cadena
cuando el programa T.P.V. ha enviado mal los parámetros del
comando.
o #ER:BUSY# CashlogyConnector devuelve esta cadena
cuando el programa de TPV ha enviado una orden al software
Connector sin que éste haya finalizado la anterior.
o #ER:ILLEGAL# El cmd pedido no puede realizarse en el
estado actual, p.ej: se ha pedido COBRAR sin haber
inicializado previamente. También se devolverá si se llama a
un comando que muestre pantalla de CashlogyConnector en
caso de haber configurado en modo sin pantallas
6.3 COMANDOS.
En esta sección se explicarán los diferentes comandos de CashlogyConnector y
las Cadenas de envío y recepción..
21
DOCUMENTO CONFIDENCIAL
En cualquiera de las opciones que se presentan a continuación, se deben tener
en cuenta los siguientes puntos:
• Debemos ejecutar un procedimiento que asegure que el programa
CashlogyConnector.exe este lanzado y de no ser así lo lance justo
antes, o en el momento, de lanzar el programa T.P.V.
• Debemos establecer la conexión con el socket. En caso de que esta
fallara se recomienda reintentarla de nuevo.
• Debemos operar siempre con el puerto conectado e implementar un
controlador de socket para asegurar que siempre hay conexión o
reconectar en caso de que se perdiera.
• El primer comando a ejecutar es el de inicialización #I#. Este comando
lo ejecutaremos una sola vez al inicio del programa y no volveremos a
ejecutarlo en ningún otro momento, salvo si ejecutamos el comando
#E#, el cual, cierra la conexión y finaliza la ejecución de
CashlogyConnector.
• El comando #E# lo ejecutaremos justo antes de cerrar la aplicación
T.P.V.
Una vez que hemos lanzado CashlogyConnector.exe, ejecutado el comando de
inicialización #I# y recibida la respuesta a este comando, estamos en
disposición de utilizar los comandos que permiten hacer operaciones con la
máquina, cobros, pagos, etc.
22
DOCUMENTO CONFIDENCIAL
necesitan aproximadamente un minuto para iniciar, por lo tanto la respuesta
se demorara al menos este tiempo.
- Cadena que se envía: #I#
- Cadena que devuelve: #0#x.yy#
a. Devolverá 0, indicando que se ha podido realizar la conexión con
el dispositivo y una cadena con la versión del protocolo
implementado. En la actual versión esta cadena será 2.01
Si no se puede inicializar porque el dispositivo está fallando, la
cadena que se devuelve es #ER.GENERIC#2.01#
Ejemplos:
23
DOCUMENTO CONFIDENCIAL
f. Posición Y de la segunda pantalla en twips. Normalmente, un
pixel equivaldrá a 15 twips. Si no ve la segunda pantalla, 0.
g. 1 si quiere ver el botón de “ACEPTAR”, 0 si no quiere verlo.
h. 1 si acepta cobros parciales, 0 si no los acepta. Se entenderá
por cobros parciales el hecho de que se pueda terminar un
cobro aunque no se haya introducido todo el importe. Para
poder usar esta opción también deberá mostrarse el botón
“ACEPTAR”
i. 1 si quiere que la pantalla se vea por delante del resto de
pantallas, 0 pantalla en segundo plano. (Cuando está
funcionando con el simulador de Cashlogy tendrá que ponerle
0 para poder realizar las pruebas. Cuando está funcionando
directamente con la máquina debería ponerle 1)
j. 1 si quiere que aparezca el cajetín para introducir céntimos
manualmente. SOLO PARA CASHLOGY POS15 y si no se
muestra el parámetro “cobro manual”
k. 1 si quiere que aparezca el botón de cobro manual (también
configurable en la configuración de CashlogyConnector,
aunque el valor introducido sobre este comando será el que
tenga prioridad. CashlogyConnector consultará el valor
introducido en la configuración en caso de encontrarse vacío
este parámetro)
- La cadena que devuelve puede ser una de las siguientes:
• #a#b#c#d#e#
a. Código de error en la ejecución (Ver 6.2)
b. Importe que ha cobrado automáticamente desde la
máquina.
c. Importe que ha devuelto
d. Importe que se ha cobrado manualmente
e. Si ha dado error al devolver, tiene opción de añadir
cambios. Si añade cambios, devuelve el importe que se
ha añadido en cambios.
• #WR:CANCEL#b#c#d#e#
a. Ejecución cancelada
b. Cantidad introducida automáticamente antes de la
cancelación.
c. Cantidad devuelta por la máquina (tras cancelar
devolverá el importe introducido)
d. Cantidad cobrada manualmente.
e. Cantidad introducida si se usa la opción de añadir
cambios tras error en devolución.
• #ER:GENERIC#b#c#d#e#
24
DOCUMENTO CONFIDENCIAL
a. Error en la ejecución, el dispositivo no ha podido
terminar la operación correctamente, se debe revisar la
cantidad introducida y devuelta.
b. Cantidad introducida automáticamente.
c. Cantidad devuelta por la máquina
d. Cantidad cobrada manualmente.
e. Cantidad introducida si se usa la opción de añadir
cambios tras error en devolución.
25
DOCUMENTO CONFIDENCIAL
SIEMPRE hay que controlar tanto el importe recibido
automáticamente como el recibido manualmente, ya que la
presentación del botón [COBRO MANUAL] se decide en función
del parámetro “Manual Deposit” de la configuración del
CashlogyConnector.
Ejemplo 1 :
26
DOCUMENTO CONFIDENCIAL
Ejemplo 2.
En el siguiente ejemplo, no ha habido cambio suficiente para realizar la
operación y el usuario ha añadido cambios durante el cobro. Además tenía la
opción de finalizar manualmente.
27
DOCUMENTO CONFIDENCIAL
Error en el cambio 1
28
DOCUMENTO CONFIDENCIAL
Para un funcionamiento correcto además de las funciones cobrar y pagar es
necesario utilizar otras funciones como: Añadir cambios, retirar efectivo,
retirar el contenido del almacén (Stacker), etc.
Con objeto de facilitar una integración de la aplicación T.P.V. en un tiempo
record, CashlogyConnector agrupa todas estas funciones en la pantalla
“BackOffice” de tal forma que con una sola llamada a la función BackOffice
desde el programa T.P.V. el usuario tendrá todas las funciones a su
disposición.
El programador puede decidir qué funciones se presentan o permanecen
ocultas, colocando uno o cero en la cadena que envía para cada parámetro.
Tras dos minutos sin realizar una operación esta pantalla se cerrará
automáticamente.
30
DOCUMENTO CONFIDENCIAL
El desarrollador debe asegurarse que la resta del importe al
finalizar menos el importe al inicio, es igual al importe
introducido menos el retirado.
31
DOCUMENTO CONFIDENCIAL
6.3.2 INTEGRACIÓN AVANZADA O PERSONALIZADA:
En esta sección se ofrecen alternativas a los comandos expuestos en la
integración exprés en la que el desarrollador puede realizar una integración
más avanzada para un mayor control.
Los comandos de Inicialización #I# y Finalización #E# deberán de ser
integrados y además se ofrecen alternativas al de Cobro #C# y Menú de Back
office #G# del cual se pueden personalizar las funciones deseadas y para el
resto mantener el menú Back Office #G# con las funciones restantes.
En la siguiente tabla se muestra un resumen de todos los comandos que se
pueden integrar con sus diferentes alternativas sin pantallas, con pantallas o
dentro del menú de Back Office.
INTEGRACION AVANZADA O PERSONALIZADA
(Se muestra en la parte izquierda el comando con pantalla y en la derecha su alternativa sin
ella)
MENU COMANDOS MOSTRANDO
COMANDOS SIN MOSTRAR PANTALLA DE CASHLOGY
BACK PANTALLA DE CASHLOGY
CONNECTOR
OFFICE CONNECTOR
CONEXIÓN CON LA MÁQUINA
INICIALIZAR #I#
FINALIZAR** #E#
OPERACIONES DE COBRO
INCIAR ADMISION #B#
VER IMPORTE ADMITIDO #Q#
COBRAR #C#
FINALIZAR ADMISION #J#
DISPENSAR #P#
OPERACIONES DE CAMBIO
AÑADIR CAMBIOS #A#2#
AÑADIR CAMBIOS #A# VER IMPORTE ADMITIDO #Q# o #Y#
#G# FINALIZAR ADMISION #J#
DISPENSAR POR
RETIRAR EFECTIVO #R# DENOMINACIÓN
#U#
32
DOCUMENTO CONFIDENCIAL
AÑADIR CAMBIO #A#2#
VER IMPORTE ADMITIDO #Q# o #Y#
DAR CAMBIO #H# FINALIZAR ADMISION #J#
DISPENSAR POR
#U#
DENOMINACIÓN
RETIRAR STACKER #S# RETIRAR STACKER #S#2#
DISPENSAR POR
#U#
DENOMINACIÓN
AÑADIR CAMBIOS #A#2#
CIERRE CAJA #F#
VER IMPORTE ADMITIDO #Q# o #Y#
FINALIZAR ADMISION #J#
REVISION DE CONTABILIDADES
EFECTIVO TOTAL #T#
CANTIDAD DE UNA
DENOMINACION (Integración #X#
no obligatoria)
ESTADO CASHLOGY #D# CANTIDAD TODAS
#Y#
DENOMINACIONES
#G# NIVEL DE CADA
#GC#
DENOMINACION
INFORMACION AUXILIAR
#GI#
(Integración no obligatoria)
ESTADISTICAS ABSOLUTAS #M# Sin alternativa
ESTADISTICAS RELATIVAS #N# Sin alternativa
OPERACIONES DE MANTENIMIENTO
VACIADO COMPLETO #V#1# VACIADO COMPLETO #V#2#
MANTENIMIENTO #O# MANTENIMIENTO #W#
#G# VER LOGS #L# Sin alternativa
PONER A CERO LAS PONER A CERO LAS MONEDAS
#K#1# #K#2#
MONEDAS (integración no obligatoria)
CANCELAR OPERACIÓN #!#
RESET DE LA MÁQUINA #Z#
CONSULTA DE VERSIONES Y
NÚMEROS DE SERIE (integración #GV#
no obligatoria)
GESTION DE ERRORES
#?#SHOW# CONSULTA DE ERROR #?#
MOSTRAR ERRORES
#?#SHOWALL# DETALLE DE ERROR #?#error1,error2…#
34
DOCUMENTO CONFIDENCIAL
b. Importe que ha recibido desde que se habilitó.
36
DOCUMENTO CONFIDENCIAL
> 11:04:43.240,#Q# Consulta importe admitido
# WR:LEVEL '=ejecución OK con aviso de nivel'#500
< 11:04:43.250,#WR:LEVEL#500#
'=Importe admitido'#
> 11:04:45.040,#J# Finalizar admisión
# WR:LEVEL '=ejecución OK con aviso de nivel'#500
< 11:04:45.340,#WR:LEVEL#500#
'=Importe admitido'#
#P '=Dispensar'#350 '=importe a dispensar#0 '=pantalla 2º
> 11:05:12.530,#P#350#0#0#0# plano'#0 '=Sin pantalla al pagar'#0 '=No devolver solo con
monedas'#
# WR:LEVEL '=Ejecución OK con aviso de nivel'#350
'=Importe devuelto#1645 '=importe añadido como
cambio durante la operación'#
<
11:05:57.460,#WR:LEVEL#350#1645# En este caso no se ha podido realizar el pago en una
primera instancia y le ha salido a usuario un mensaje en el
que ha elegido la opción de añadir más cambios (Ver
comando Cobrar, Error en el cambio 1
37
DOCUMENTO CONFIDENCIAL
VER IMPORTE ADMITIDO #Q# o #Y#
FINALIZAR ADMISION #J#
DISPENSAR POR
#U#
DENOMINACIÓN
RETIRAR STACKER #S# RETIRAR STACKER #S#2#
DISPENSAR POR
#U#
DENOMINACIÓN
AÑADIR CAMBIOS #A#2#
CIERRE CAJA ##
VER IMPORTE ADMITIDO #Q# o #Y#
FINALIZAR ADMISION #J#
38
DOCUMENTO CONFIDENCIAL
- Cadena que se envía: #A#a#
• a será 0 si quiere que la pantalla se vea en segundo plano, 1
por delante del resto de pantallas, 2 si no se desea ver la
pantalla de Cashlogy Connector, en cuyo caso actuará como el
comando #B# (6.3.2.1.1 Iniciar admisión), y deberá usar los
comandos ver importe admitido y finalizar admisión para
terminar la operación. (ver apartados 6.3.2.1.2 y 6.3.2.1.3)
- La cadena que devuelve será:
• En caso que enviemos #A#0# o #A#1#
▪ #a#b#
a. Código de error en la ejecución (Ver 6.2)
b. Importe añadido en cambios.
• En caso de enviar #A#2#, este comando actuará como el
comando #B# devolviendo #a# siendo a el código de error en
la ejecución (Ver 6.2)
39
DOCUMENTO CONFIDENCIAL
Donde cada parámetro indica lo siguiente
Cadena enviada → #A ‘=Comando añadir cambio’#1’=Mostrar pantalla de
CashlogyConnector en primer plano’#
Respuesta de Cashlogy Connector #0 ‘=Sin error en ejecución’#1690
‘Importe introducido por el usuario’#
Ejemplo 2. Añadir cambios sin pantalla de CashlogyConnector
40
DOCUMENTO CONFIDENCIAL
Mediante esta pantalla podemos cambiar el importe introducido en billetes o
monedas por el mismo importe en billetes o monedas de otras
denominaciones.
Cuando enviamos el comando “DAR CAMBIO”, mediante la cadena #H#a#, el
módulo CashlogyConnector presenta la pantalla anterior, en la que solicita la
entrada de billetes y /o monedas. (Se irá mostrando el valor del efectivo
según se va introduciendo). A continuación pulsamos [ACEPTAR] y el
programa nos presentará una pantalla con los billetes y monedas que
podemos disponer para hacer el cambio e incluso propondrá unos valores que
el usuario podrá cambiar.
(En la pantalla de configuración inicial se determinan las denominaciones que
se permite utilizar en este proceso).
41
DOCUMENTO CONFIDENCIAL
Se presentan en rojo los valores que están “casi vacío”.
En la columna “Cant. Retirar” tecleamos las unidades de cada valor que
solicitamos. En la línea inferior nos presenta el importe introducido y el
importe de los valores solicitados. A continuación pulsamos [ACEPTAR].
En el caso de que el importe introducido no coincida con el importe a devolver,
el programa presentará un aviso solicitando que se modifique.
Con el botón [CANCELAR] podemos cancelar la operación y el dispositivo
devolverá el importe introducido. Debemos tener en cuenta que si se ha
introducido billetes que no maneja el reciclador, la devolución la realizara en
denominaciones de las que utiliza el reciclador.
43
DOCUMENTO CONFIDENCIAL
Tecleamos las unidades de billetes y monedas que queremos retirar y
pulsamos el botón [RETIRAR TODO LO MARCADO].
También podemos ir retirando los billetes y monedas por cada una de las
denominaciones independientemente pulsando retirar.
- Cadena que se envía: #R#a#
• a será 1 si quiere que la pantalla se vea por delante del resto
de pantallas, 0 pantalla en segundo plano.
- La cadena que devuelve será:
• #a#b#
a. Código de error en la ejecución (Ver 6.2)
b. Importe que ha retirado. (La cantidad de billetes
enviada a stacker no se mostrará)
Si no desea mostrar esta pantalla de Connector, consulte el apartado “#U#
Dispensar por denominación”
Ejemplo.
44
DOCUMENTO CONFIDENCIAL
6.3.2.2.4 #U# Dispensar por denominación:
Comando análogo al anterior pero en el que no se muestra pantalla de
CashlogyConnector. Mediante este comando el dispositivo devolverá las
cantidades de monedas y billetes indicadas por el software TPV.
46
DOCUMENTO CONFIDENCIAL
Siempre que se desee retirar el contenido del stacker, se debe informar a
CashlogyConnector mediante el uso de este comando, de lo contrario la
cantidad retirada no se descontará de la contabilidad.
47
DOCUMENTO CONFIDENCIAL
En el caso en que se mande el parámetro con valor “2” Connector
esperará a que se detecte que el Stacker se ha retirado para
mandar la cadena de respuesta con un OK. Si no se detecta no
manda nada y se queda en BUSY. Para poder cancelar esta
operación se deberá de mandar el comando “Cancelar”, ver
apartado 6.3.2.4.1
- La cadena que devuelve será:
• #a#b#
a. Código de error en la ejecución (Ver 6.2)
b. Importe que se ha retirado en el stacker.
Ejemplo 1. Retirar stacker mostrando las pantallas de CashlogyConnector
Debe tenerse en cuenta que el usuario puede tardar varios minutos en retirar
los billetes del stacker, y hasta que no se vuelva a colocar el stacker,
CashlogyConnector no devolverá la respuesta. Durante este tiempo el envío de
cualquier comando salvo el de cancelar (tampoco se podrá mandar el comando
de error) devolverá ER:BUSY al tratarse de un proceso síncrono, por lo tanto
se tomaran las siguientes precauciones:
o CashlogyConnector responderá a este comando cuando el
proceso finalice, que será cuando la máquina detecte que el
stacker ha sido retirado y se ha vuelto a introducir, por lo tanto
se debe de crear un botón en el que el usuario pueda cancelar el
proceso (con el comando #!#).
o Al finalizar se enviará el comando #Y# para conocer los
contadores tanto en Reciclador como en Stacker. Se actualizará
la información mostrada a usuario.
48
DOCUMENTO CONFIDENCIAL
6.3.2.2.6 #F# Cierre / fondo de caja:
Esta función será utilizada por el usuario cuando desee cerrar un turno y
mantener un importe como cambio para el turno siguiente.
49
DOCUMENTO CONFIDENCIAL
La columna “Fondo de Caja” permite dejar una cantidad determinada de
billetes y monedas en los recicladores para las operaciones de cobro y pago.
Por defecto nos propone las unidades de cada denominación que dejamos
como fondo de caja en el último cierre. Si nos interesa podemos cambiarlos y
para mayor comodidad, si hacemos doble ‘Click’ sobre una de las celdas,
copiará automáticamente el contenido de la misma fila de la columna “Cant.
Recic.”.
Para terminar pulsamos el botón [PROCESAR EL CIERRE].
En caso de que para una o varias denominaciones propongamos como fondo
de caja una cantidad mayor que la que tiene en ese momento en el reciclador,
CashlogyConnector presenta la siguiente pantalla en la que se solicita que
introduzcamos los billetes o monedas que faltan en los recicladores para
igualar al fondo de caja.
50
DOCUMENTO CONFIDENCIAL
d. Importe que se deja como fondo de caja. (Si el usuario
no vacía el stacker al finalizar la operación, dentro de
este valor aparecerá también el importe de los billetes
que hayan quedado en el stacker sumado a el valor
dejado en los recicladores de monedas y billetes)
Si no desea mostrar esta pantalla de Connector, consulte el apartado
“Dispensar por denominación” y “Añadir cambios”
Ejemplo 1.
51
DOCUMENTO CONFIDENCIAL
Esta pantalla se utiliza para añadir monedas de 1 céntimo en el almacén de 1
céntimo de carga manual.
Para presentar la pantalla enviamos la cadena #1#a#
Como podemos ver, en la pantalla disponemos de un botón que permite
vaciar el almacén de monedas de un céntimo mientras cuenta las
monedas y una ventana con un teclado y un campo en el que podemos teclear
el número de monedas que cargamos.
Si el usuario conoce exactamente el número de monedas que va a introducir
manualmente, lo tecleará y pulsará el botón [ACEPTAR]. A continuación
pulsará el botón [SALIR].
En el caso de que el usuario desconozca la cantidad de monedas que quiere
introducir, puede seguir el proceso siguiente:
1.- Introduce sin contar las monedas en el almacén manualmente.
2.- Pulsa el botón [VACIAR Y CONTAR MONEDAS…].
3.- El programa le presenta el importe contado como opción de carga.
4.- Recoge las monedas que ha expulsado la máquina y las introduce
manualmente en el almacén.
5.- Pulsa el botón [ACEPTAR].
6.- Pulsa el botón [SALIR].
- Cadena que se envía: #1#a#
• a será 1 si quiere que la pantalla se vea por delante del resto
de pantallas, 0 pantalla en segundo plano.
- La cadena que devuelve será:
52
DOCUMENTO CONFIDENCIAL
• #a#b#
a. Código de error en la ejecución (Ver 6.2)
b. Importe añadido en monedas de 1 céntimo
53
DOCUMENTO CONFIDENCIAL
Esta pantalla se presenta cuando enviamos el comando #D#a#
En rojo presenta las denominaciones que están “casi vacío” y en azul las que
están “casi lleno”.
Cuando pulsamos el botón [Salir] CashlogyConnector devuelve una cadena en
la que figura el importe total y un código de error, o 0 si no hay error.
- Cadena que se envía: #D#a#
• a será 1 si quiere que la pantalla se vea por delante del resto
de pantallas o 0 para pantalla en segundo plano.
- La cadena que devuelve será:
o #a#b#
a. Código de error en la ejecución (Ver 6.2)
b. Valoración total de dinero que tiene la máquina
Ejemplo 1. Estado de la contabilidad con pantalla de CashlogyConnector
57
DOCUMENTO CONFIDENCIAL
Ejemplo 1. Información auxiliar en CashlogyPOS1500EU
58
DOCUMENTO CONFIDENCIAL
- Cadena que se envía: #M#a#
• a será 1 si quiere que la pantalla se vea por delante del resto de
pantallas, 0 pantalla en segundo plano.
- La cadena que devuelve será:
• #a#
a. Código de error en la ejecución (Ver 6.2)
59
DOCUMENTO CONFIDENCIAL
Tanto en las estadísticas relativas como en las absolutas se muestra la fecha
desde la que se empieza a llevar la contabilidad de las mismas. En el caso de
las estadísticas relativas esta fecha se actualiza cada vez que se pulsa borrar
estadísticas.
- Cadena que se envía: #N#a#
• a será 1 si quiere que la pantalla se vea por delante del resto de
pantallas, 0 pantalla en segundo plano.
- La cadena que devuelve será:
• #a#
a. Código de error en la ejecución (Ver 6.2)
PONER A CERO LAS MONEDAS #K#1# PONER A CERO LAS MONEDAS #K#2#
60
DOCUMENTO CONFIDENCIAL
Además, CashlogyConnector dispone de los siguientes comandos que también
pueden ser integrados sin mostrar pantallas de CashlogyConnector.
61
DOCUMENTO CONFIDENCIAL
Dónde:
---> #B#0#0#0# Inicialización admisión
<--- #0# Respuesta OK
---> #Q# Consulta importe admitido
<--- #0#50# #Sin error#50 admitidos#
---> #!# Cancelación de la operación
Respuesta comando en curso (#B# admisión)
<--- #WR:CANCEL#100#
#Cancelado#100 céntimos admitidos#
Dónde:
---> #B#0#0#0# Inicialización admisión
<--- #0# Respuesta OK
---> #Q# Consulta importe admitido
<--- #0#50# #Sin error#50 céntimos admitidos#
---> #Z# Reset
<--- #0# Respuesta OK, Sin error en la ejecución
62
DOCUMENTO CONFIDENCIAL
El vaciado completo expulsa todas las monedas y billetes, los billetes los pasa
al almacén (Stacker).
También se puede especificar que el vaciado se produzca en un determinado
Hopper / reciclador o en varios de ellos.
63
DOCUMENTO CONFIDENCIAL
c. Sólo si el parámetro a=2 y b es vacío, se puede especificar
que monedas/billetes se quieren vaciar.
En este parámetro se indicaran las denominaciones deseadas
a ser dispensadas en céntimos, seguido de dos puntos y la
cantidad que se quiere dispensar. Se utilizarán comas para
separar las denominaciones y punto y coma antes del primer
billete incluso si no se dispensan monedas.
64
DOCUMENTO CONFIDENCIAL
en monedas, ya que los billetes han sido enviados a stacker, pero este no se
ha retirado
65
DOCUMENTO CONFIDENCIAL
Ejemplo 2. Consulta sobre información de software de una máquina
CashlogyPOS1500X-EU.
66
DOCUMENTO CONFIDENCIAL
En el ejemplo no se muestra la totalidad de módulos, en este ejemplo
(Cashlogy POS1500X) con el mismo formato nos daría información de todos
los hoppers, bulk, H2, H500, display y distribuidor.
Ejemplo 4. Consulta sobre toda la información de una máquina
CashlogyPOS1500X-EU.
Con el mismo formato que en los ejemplos anteriores, nos daría información
en este orden de General, Hardware y Software.
67
DOCUMENTO CONFIDENCIAL
- Cadena que se envía: #O#a#
• a será 1 si quiere que la pantalla se vea por delante del resto de
pantallas, 0 pantalla en segundo plano.
- La cadena que devuelve será:
• #a#
a. Código de error en la ejecución (Ver 6.2)
Ejemplo 1. Consulta de mantenimiento con pantallas de CashlogyConnector
(se muestran las pantallas anteriores)
68
DOCUMENTO CONFIDENCIAL
b. Número de billetes que faltan hasta el
mantenimiento si se ha enviado 0
• En caso de enviar #W#1#
▪ #a#b#
a. Código de error en la ejecución (Ver 6.2)
b. En caso de que se haya solicitado el reseteo del
contador (1), este parámetro se devolverá vacío.
Ejemplo 1. Mostrar mantenimiento sin pantallas.
69
DOCUMENTO CONFIDENCIAL
6.3.2.4.7 #L# Ver logs:
70
DOCUMENTO CONFIDENCIAL
- Cadena que se envía: #K#a#
• a será 0 si quiere que la pantalla se vea en segundo plano, 1 por
delante del resto de pantallas, 2 si no se desea ver la pantalla de
Cashlogy Connector.
En el caso en que se mande el parámetro con valor “2” las
monedas se pondrán a 0 sin pedir confirmación
- La cadena que devuelve será:
• #a#b#c#
a. Código de error en la ejecución (Ver 6.2)
b. Importe total disponible al ejecutar el comando.
c. Importe total disponible después de ejecutar el
comando.
72
DOCUMENTO CONFIDENCIAL
6.3.2.5.2 #?# ¿Error?
Comando que puede utilizar el software TPV para recibir los códigos de error
presentes en ese momento. En integraciones avanzadas o que no muestren
errores a usuario se recomienda consultar con una periodicidad de 1-2
segundos.
73
DOCUMENTO CONFIDENCIAL
Donde cada parámetro indica lo siguiente
Cadena enviada → #? ‘=Consulta de errores’#
Respuesta de Cashlogy Connector #0 ‘=Sin error en la ejecución’#Vacío
‘=sin errores’#
Al segundo siguiente se vuelve a consultar y de nuevo no hay errores, y al
siguiente segundo, la consulta devuelve los errores 8816 y 8910. Para saber
que error indican esos códigos deberá realizar la consulta del detalle de error
como se describe en el apartado siguiente.
Dónde:
74
DOCUMENTO CONFIDENCIAL
>#J# Finalizar admisión
#0#500# # 0 '=ejecución OK’#500 '=Importe admitido'#
75
DOCUMENTO CONFIDENCIAL
▪ a, Tipo del error. 0,1,2,o 3, ver apartado 6.1
Configuración.
▪ b, Título del error,
▪ c, Mensaje principal descriptivo del error
▪ d, Mensaje adicional del error
▪ e, Path del archivo de video con la descripción del
motivo y/o la resolución del error.
▪ f, Path del archivo de imagen descriptivo del error.
• #a#n||||||# si el número n enviado no es un código de error
válido
• #ER:BAD_DATA# si uno de los códigos de error enviados no
es un número válido
Dónde:
Parámetro Envío/respuesta Significado
envío #?#8816,8910# Consulta errores 8816 y 8910
a #0# Sin errores en la ejecución
n #8816| Código de error:8816
a |0| Tipo de error: 0 - warning
b |Error 8816| Título del error
d |Llame a su técnico o retire manualmente los billetes Mensaje adicional del error
del Reciclador 1.|
Path del archivo de video con
e |D:\cashlogy\CashlogyConnector\videos\CashlogyPOS la descripción del motivo y/o
1500\88a_Notes Recyclers Access.avi| la resolución del error.
76
DOCUMENTO CONFIDENCIAL
Path del archivo de imagen
f |D:\cashlogy\CashlogyConnector\videos\CashlogyPOS descriptivo del error.
1500\88a_Notes Recyclers Access-800x600.png#
n #8910| Código de error 2:8910
a |2| Tipo de error: 2
info error 2
INTEGRACIÓN COMPLETA
INICIALIZAR #I# 6.3.1.1.
FINALIZAR** #E# 6.3.1.2.
OPERACIONES DE COBRO
INCIAR ADMISION #B# 6.3.2.1.1.
77
DOCUMENTO CONFIDENCIAL
VER IMPORTE ADMITIDO #Q# 6.3.2.1.2.
FINALIZAR ADMISION #J# 6.3.2.1.3.
DISPENSAR #P# 6.3.2.1.4.
OPERACIONES DE CAMBIO
AÑADIR CAMBIOS AÑADIR CAMBIOS #A#2# 6.3.2.2.1.
RETIRAR EFECTIVO DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
AÑADIR CAMBIO #A#2# 6.3.2.2.1.
VER IMPORTE ADMITIDO #Q# 6.3.2.1.2.
DAR CAMBIO
FINALIZAR ADMISION #J# 6.3.2.1.3.
DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
RETIRAR STACKER RETIRAR STACKER #S#2# 6.3.2.2.5.
DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
AÑADIR CAMBIOS #A#2# 6.3.2.2.1.
CIERRE CAJA
VER IMPORTE ADMITIDO #Q# 6.3.2.1.2.
FINALIZAR ADMISION #J# 6.3.2.1.3.
REVISION DE CONTABILIDADES
EFECTIVO TOTAL #T# 6.3.2.3.2.
CANTIDAD DE UNA DENOMINACION (Integración no obligatoria) #X# 6.3.2.3.3.
CANTIDAD TODAS DENOMINACIONES #Y# 6.3.2.3.4.
NIVEL DE CADA DENOMINACION #GC# 6.3.2.3.5.
INFORMACION AUXILIAR (Integración no obligatoria) #GI# 6.3.2.3.6.
OPERACIONES DE MANTENIMIENTO
VACIADO COMPLETO #V#2# 6.3.2.4.3.
MANTENIMIENTO #W# 6.3.2.4.6.
CANCELAR OPERACIÓN #!# 6.3.2.4.1.
RESET DE LA MÁQUINA #Z# 6.3.2.4.2.
CONSULTA DE VERSIONES Y NÚMEROS DE SERIE (integración no
#GV# 6.3.2.4.4.
obligatoria)
PONER A CERO LAS MONEDAS (integración no obligatoria) #K#2# 6.3.2.4.8.
GESTION DE ERRORES
CONSULTA DE ERROR #?# 6.3.2.5.2
DETALLE DE ERROR #?#error1,error2…# 6.3.2.5.3
6.3.3.1 CONFIGURACION
78
DOCUMENTO CONFIDENCIAL
Seleccione Dll embebida = 1 en las opciones avanzadas del archivo de
configuración CashlogyConfig.exe por defecto en la ruta:
C:\Cashlogy\CashlogyConfig\ CashlogyConfig.exe
79
DOCUMENTO CONFIDENCIAL
Con esta configuración, si se mandara por error un comando que requiera una
pantalla de CashlogyConnector, la respuesta de CashlogyConnector sería
#ER:ILLEGAL#
82
DOCUMENTO CONFIDENCIAL
podrá aceptar billetes. Además en este proceso se seguirán las
siguientes pautas:
o Cada 200msg. se preguntará por la cantidad de ítems de cada
denominación. Se enviará el comando #Y# para conocer dichos
contadores tanto en Reciclador como en Stacker. Se mostrará
esta información al usuario.
o Cada segundo se consultara el estado de los errores del mismo
modo que en la operativa de cobro.
o Se finalizará el proceso con el comando #J# volviendo a
consultar por posibles errores.
- El proceso de retirar efectivo con el comando #U# es un proceso
síncrono, por lo tanto se tomaran las siguientes precauciones:
o Cuando termine, se preguntará por la cantidad de ítems de cada
denominación. Se enviará el comando #Y# para conocer dichos
contadores tanto en Reciclador como en Stacker. Se actualizará
la información mostrada a usuario.
o Al finalizar se procederá a la consulta de los errores.
- El proceso de retirada del stacker, se realizará con el parámetro b=2,
#S#2#. Es un proceso síncrono, por lo tanto se tomaran las siguientes
precauciones:
o CashlogyConnector responderá a este comando cuando el
proceso finalice, que será cuando la máquina detecte que el
stacker ha sido retirado y se ha vuelto a introducir, por lo tanto
se debe de crear un botón en el que el usuario pueda cancelar el
proceso (con el comando #!#).
o Al finalizar se enviará el comando #Y# para conocer los
contadores tanto en Reciclador como en Stacker. Se actualizará
la información mostrada a usuario.
- Si se crea una pantalla de BackOffice análoga al comando #G# de
CashlogyConnector, se recomienda tomar las siguientes precauciones:
o Al mostrar la ventana por primera vez, se preguntará por la
cantidad de ítems de cada denominación. Se enviará el comando
#Y# para conocer dichos contadores tanto en Reciclador como en
Stacker y se mostrará esta información al usuario.
o Permanecerá en reposo sondeando por los errores. Cada segundo
se enviará el comando #?# para conocer si se han producido o no
errores. En el caso de producirse, se obtendrá la información de
los mismos usando el comando #?#Error1,…,ErrorN#c#.
84
DOCUMENTO CONFIDENCIAL
6.3.3.6 MOSTRAR ERRORES
RECOMENDACIONES.
Como ya se ha comentado, la gestión de errores la debe implementar el
integrador. Por tanto, será necesario que tenga en cuenta varios aspectos:
- Sondear los errores cada segundo
- Cuando Visualizar los mismos.
Puede hacerlo de varias formas, cada una de ellas con sus ventajas y
sus inconvenientes. Puede optar por una visualización mostrando un
botón de error que aparece cuando hay un error y el usuario accede
para ver que error es y ver el video en caso de tenerlo asociado. Esta
forma es poco intrusiva, ya que solo muestra un botón X, pero el
usuario se puede llegar a habituar a su presencia y no prestarle ninguna
atención.
Un parámetro de la información de los errores es el tipo de error. Se
recomienda tenerlo en cuenta para agrupar los errores por persistencia
y urgencia en su visualización. Dependiendo de dicho valor, se puede
montar un sistema de visionado acorde a la importancia del error.
- Como reproducir los videos.
Si el error a visualizar tiene un video asociado deberá reproducirlo. Es
responsabilidad del integrador usar el control más adecuado en su TPV.
Dependiendo del sistema operativo, puede usar una tecnología u otra,
pero el uso de un WebBrowser puede ser una buena opción siempre y
cuando el MiniPC pueda servir ficheros .gif.
Si el sistema operativo donde instalará su TPV es Windows,
perfectamente puede usar la carpeta compartida del MiniPC para
reproducir los .avi alojados en él.
85
DOCUMENTO CONFIDENCIAL
A la larga, se debe evitar que el TPV necesite tener alojados los videos
en local, en una estructura de directorios clonada del MiniPC, para poder
reproducirlos.
Al hacer click en el icono, se presenta otra nueva pantalla que muestra una
lista detallada de alertas y/o errores:
86
DOCUMENTO CONFIDENCIAL
A continuación se muestran otros ejemplos de pantallas que reportan la
existencia de un error o incidencia:
• Dispositivo Ocupado:
• ERROR EN LA DEVOLUCIÓN:
Si se produce un error en la devolución de efectivo, se puede presentar
cualquiera de las pantallas siguientes:
87
DOCUMENTO CONFIDENCIAL
En caso de que en una devolución se deba devolver más de un billete y
pasan más de 2 minutos sin que retiremos el primero, se mostrará la
siguiente pantalla:
88
DOCUMENTO CONFIDENCIAL
En caso de que se retome la devolución tras la inserción de cambios o
cuando tiene que devolver varios billetes y se retira uno que ha estado
más de 2 minutos sin recogerse, se mostrará la siguiente pantalla:
89
DOCUMENTO CONFIDENCIAL
7 CHECKLIST INTEGRACIÓN.
90
DOCUMENTO CONFIDENCIAL
Cancelar pago antes de pagar, tras
Cancelar el pago en esos 2 puntos
pagar (al pedir añadir cambios)
Retirar manualmente las monedas de 10c del Hopper, hacer
Verificar que si hay vano en un
una venta en la que tenga que devolver alguna moneda de 10c,
Hopper/discriminador recalcula y
se debe recalcular y pagar con 5c, la venta debe terminar
paga con el siguiente
correctamente
Forzar que no pueda completar un Retirar las monedas de 1 y 2 cent manualmente, hacer venta
pago (quitando monedas) y no para que tenga que pagar. Mostrará error, no añadir cambios y
añadiendo cambio, comprobar verificar que la aplicación muestra aviso de pago incorrecto y
comportamiento muestre lo que falta por pagar
si
CASHLOGY CONNECTOR
REQUISITO
PRUEBA EXPLICACIÓN
INDISPENSABLE
lanzar automáticamente
verificar que la aplicación lanza el software Connector cuando
CashlogyConnector al arrancar
inicia
aplicación si
mantener el socket abierto mientras
No cerrar el socket entre transacciones
dure la conexión si
distintos usuarios con distintos Verificar que hay distintos usuarios, que ven más o menos
permisos BackOffice o registrar en botones en BackOffice en función de los permisos. Si no es así
contabilidad interna movimientos verificar que la contabilidad interna tiene en cuenta los
BackOffice movimientos de caja cuando se accede al BackOffice
si
permite adelantar pago verificar si está siempre en modo de admisión
muestra BackOffice si
admisiones y pagos
mostrar botón aceptar en cobros o verificar si en una venta corta automáticamente al llegar al Se recomienda corte
corte automático importe o hay que hacerlo manualmente automático
aceptar cobro manual ¿Tiene la posibilidad?
aceptar cobros parciales ¿Tiene la posibilidad?
Integración exprés o completa
APERTURA Y CIERRE DE CAJA
REQUISITO
PRUEBA EXPLICACIÓN
INDISPENSABLE
Apertura cierre de caja Verificar que tenga la opción
cuadre de caja tras inserción de Verificar que cuadre la caja, en el caso de tener contabilidad si (solo en el caso de
cambios interna tener contabilidad
propia)
91
DOCUMENTO CONFIDENCIAL
Detección de cajón de monedas
mostrar error con el cajón de monedas abierto
abierto
Detección de cajón de billetes
ídem de billetes
abierto
Detección de atascos en tren introducir un papel en H2 para provocar atasco, debe mostrar
monedas video e indicar error
Detección de atascos pago de bloquear un Hopper y hacer una venta en la que tenga que
monedas pagar dicho reciclador, debe mostrar el error
Detección de atascos en billetero ya probado, en el punto de mostrar videos
Desconexión de Hopper, billetero,
Desconectar RBH500, posteriormente un R1, comprobar que
bulk… y comprobar que lo indica el
muestra los errores el Connector
programa
La aplicación debe de mostrar aviso de niveles cuando alguna
Detección de Hopper vacíos/llenos moneda/billete este por debajo del mínimo o por encima del
máximo
COMANDOS SIN VENTANAS (INTEGRACION CON MINI PC)
REQUISITO
PRUEBA EXPLICACIÓN
INDISPENSABLE
Mostrar los errores tras finalizar Al menos tras finalizar un pago revisar y mostrar los errores
pagos (recomendable constantemente)
Mostrar los vídeos, verificar que en
Verificar que se muestran los videos (sólo de los errores que
atascos de puntos anteriores
indican que tienen videos)
muestra el video
Mostrar aviso para que se retire el stacker cuando se pulse
Retirada de stacker, mostrar aviso
retirar Stacker
Verificar que la aplicación Cashlogy
Verificar que Connector es lanzado con prioridad normal
monitor es lanzada al iniciar el
(tareas Windows)
MiniPC
Forzar el cierre del
Verificar que el CashlogyMonitor lo vuelve a lanzar
CashlogyConnector
Apagar MiniPC quitando Aplicación debe mostrar error de comunicación y MiniPC se
alimentación y reiniciar debe recuperar al iniciar
FUNCIONAMIENTO EN RED
REQUISITO
PRUEBA EXPLICACIÓN
INDISPENSABLE
8 EJEMPLOS.
En la aplicación de test CashlogyConnectorTest que acompaña la
documentación se proporciona un ejemplo completo con el uso de todos los
comandos.
Para ejecutarlo correctamente debemos lanzar previamente el programa
CashlogyConnector.exe. Y posteriormente entrar en la carpeta _Test, ejecutar
el proyecto, conectar e inicializar. Una vez conectado podrá comprobar todas
92
DOCUMENTO CONFIDENCIAL
las opciones de integración y consultar las cadenas enviadas y recibidas en el
logcom situado en la carpeta …\CashlogyConnector\logs\LogCom_fecha.txt.
93
DOCUMENTO CONFIDENCIAL
ANEXO 1 INDICE Y RESUMEN DE COMANDOS
Por otro lado se muestra en una tabla el significado de cada parámetro en los
diferentes comandos. Para conocer los posibles valores el integrador debe
consultar la sección 6 donde se explica en detalle cada comando.
94
DOCUMENTO CONFIDENCIAL
DISPENSAR POR
RETIRAR EFECTIVO #R# DENOMINACIÓN #U#
AÑADIR CAMBIO
#A#2#
AÑADIR CAMBIOS
CIERRE CAJA #F# #A#2#
95
DOCUMENTO CONFIDENCIAL
En una integración sin pantallas, necesaria en aquellas integraciones que usen
un MiniPC para conectar al dispositivo, será obligatorio integrar todos los
comandos indicados en la columna “sin pantallas”.
INTEGRACIÓN COMPLETA
INICIALIZAR #I# 6.3.1.1.
FINALIZAR** #E# 6.3.1.2.
OPERACIONES DE COBRO
INCIAR ADMISION #B# 6.3.2.1.1.
VER IMPORTE ADMITIDO #Q# 6.3.2.1.2.
FINALIZAR ADMISION #J# 6.3.2.1.3.
DISPENSAR #P# 6.3.2.1.4.
OPERACIONES DE CAMBIO
AÑADIR CAMBIOS AÑADIR CAMBIOS #A#2# 6.3.2.2.1.
RETIRAR EFECTIVO DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
AÑADIR CAMBIO #A#2# 6.3.2.2.1.
VER IMPORTE ADMITIDO #Q# 6.3.2.1.2.
DAR CAMBIO
FINALIZAR ADMISION #J# 6.3.2.1.3.
DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
RETIRAR STACKER RETIRAR STACKER #S#2# 6.3.2.2.5.
DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
AÑADIR CAMBIOS #A#2# 6.3.2.2.1.
CIERRE CAJA
VER IMPORTE ADMITIDO #Q# 6.3.2.1.2.
FINALIZAR ADMISION #J# 6.3.2.1.3.
REVISION DE CONTABILIDADES
EFECTIVO TOTAL #T# 6.3.2.3.2.
CANTIDAD DE UNA DENOMINACION (Integración no obligatoria) #X# 6.3.2.3.3.
CANTIDAD TODAS DENOMINACIONES #Y# 6.3.2.3.4.
NIVEL DE CADA DENOMINACION #GC# 6.3.2.3.5.
INFORMACION AUXILIAR (Integración no obligatoria) #GI# 6.3.2.3.6.
OPERACIONES DE MANTENIMIENTO
VACIADO COMPLETO #V#2# 6.3.2.4.3.
MANTENIMIENTO #W# 6.3.2.4.6.
CANCELAR OPERACIÓN #!# 6.3.2.4.1.
RESET DE LA MÁQUINA #Z# 6.3.2.4.2.
CONSULTA DE VERSIONES Y NÚMEROS DE SERIE (integración no
#GV# 6.3.2.4.4.
obligatoria)
PONER A CERO LAS MONEDAS (integración no obligatoria) #K#2# 6.3.2.4.8.
GESTION DE ERRORES
CONSULTA DE ERROR #?# 6.3.2.5.2
DETALLE DE ERROR #?#error1,error2…# 6.3.2.5.3
96
DOCUMENTO CONFIDENCIAL
INICIALIZAR LA MÁQUINA
ENVIO RESPUESTA
#I# #a#x.yy#
a Error en ejecución
x.yy Versión de Connector
FINALIZAR LA APLICACIÓN
ENVIO RESPUESTA
#E# #a#
a Error en ejecución
BACK OFFICE
ENVIO RESPUESTA
#G#a#b#c#d#e#f#g#h#i#j#k#l#m# #a#b#c#d#e#
a Botón estado a Error en ejecución
b Botón añadir cambios b Importe al entrar
c Boton recarga 1 céntimo c Importe al salir
d Botón retirada efectivo d Importe introducido
e Botón retirar stacker e Importe retirado
Importe no devuelto en
f Botón vaciado completo f cambio
g Botón dar cambio
h Botón cierre de caja
i Botón ver log
j Botón poner monedas a cero
97
DOCUMENTO CONFIDENCIAL
k Botones estadísticas
l Mostrar pantalla por delante
m Botón mantenimiento
ESTADO
ENVIO RESPUESTA
#D#a# #a#b#
a Mostrar pantalla por delante a Error en ejecución
b Importe total en el dispositivo
AÑADIR CAMBIOS
ENVIO RESPUESTA
#A#a# #a#b#
a Mostrar pantalla a Error en ejecución
b Importe introducido
RETIRAR EFECTIVO
ENVIO RESPUESTA
#R#a# #a#b#
a Mostrar pantalla por delante a Error en ejecución
b Importe retirado
RETIRAR STACKER
ENVIO RESPUESTA
#S#a# #a#b#
a Mostrar pantalla a Error en ejecución
b Importe retirado
DAR CAMBIO
ENVIO RESPUESTA
#H#a# #a#b#c#
a Mostrar pantalla por delante a Error en ejecución
b Importe introducido
c Importe retirado
98
DOCUMENTO CONFIDENCIAL
CIERRE / FONDO DE CAJA
ENVIO RESPUESTA
#F#a# #a#b#c#d#
a Mostrar pantalla por delante a Error en ejecución
b Importe al entrar
c Importe introducido
d Importe al salir
INICIALIZAR ADMISIÓN
ENVIO RESPUESTA
#B#a#b#c# #a#
a Mostrar segunda pantalla a Error en ejecución
b Posición X 2ª pantalla
c Posición Y 2ª pantalla
FINALIZAR ADMISIÓN
ENVIO RESPUESTA
#J# #a#b#
a Error en ejecución
b Importe introducido
DISPENSAR
ENVIO RESPUESTA
#P#a#b#c#d# #a#b#c#
a Importe a devolver a Error en ejecución
b Mostrar pantalla por delante b Importe retirado
c Mostrar pantalla c Importe introducido
d Devolver sólo monedas
99
DOCUMENTO CONFIDENCIAL
b Billetes a stacker b Items devueltos
c Mostrar pantalla por delante
d Mostrar pantalla
ESTADÍSTICAS ABSOLUTAS
ENVIO RESPUESTA
#M#a# #a#
a Mostrar pantalla por delante a Error en ejecución
ESTADÍSTICAS RELATIVAS
ENVIO RESPUESTA
#N#a# #a#
a Mostrar pantalla por delante a Error en ejecución
VACIADO COMPLETO
ENVIO RESPUESTA
#V#a#b# #a#b#
a Mostrar pantalla a Error en ejecución
b Sólo monedas b Importe retirado
100
DOCUMENTO CONFIDENCIAL
PONER A CERO LAS MONEDAS
ENVIO RESPUESTA
#K#a# #a#b#c#
a Mostrar pantalla a Error en ejecución
b Importe antes de ejecutar
c Importe tras ejecutar
VER LOGS
ENVIO RESPUESTA
#L#a# #a#
a Mostrar pantalla por delante a Error en ejecución
ERROR
ENVIO RESPUESTA
#?# #a#b#
a Error en ejecución
b Código(s) de error
DETALLE DE ERROR
ENVIO RESPUESTA
#?#err1,err2,…#c# #a#info_error1#info_error2#...#
err1 Códigos de error a Error en ejecución
c Ruta relativa videos e imágenes info_error1: n|a|b|c|d|e|f
n Código de error
a Tipo de error
b Título del error
c Mensaje principal
d Mensaje adicional
101
DOCUMENTO CONFIDENCIAL
e Path archivo video
f Path archivo imagen
MOSTRAR ERRORES
ENVIO RESPUESTA
#?#SHOW# o #?#SHOWALL# #a#b#
SHOW Recuperables o tras un minuto a Error en ejecución
SHOWALL Todos los errores b Errores visualizados
CANCELAR
ENVIO RESPUESTA
#!# #a#b#
a Ejecución
b Respuesta comando en curso
RESET
ENVIO RESPUESTA
#Z# #a#
a Error en ejecución
INFORMACIÓN AUXILIAR
ENVIO RESPUESTA
#GI# #a#b#c#
a Ejecución
b Matrícula país
b Set ítems
CONSULTA VERSIONES
ENVIO RESPUESTA
#GV# #a#b#
a Opción a consultar a Ejecución
b Versiones y números serie
102
DOCUMENTO CONFIDENCIAL