CashlogyConnector Manual - Integracion - v2.3

CASHLOGY
CONNECTOR
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,
Mayo 2016 V1 relaciones a comandos sin
pantallas y MiniPC, y anexos 1 y 2
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
Octubre 2018 V2.2 Modificado Check list certificación
Abril 2019 V2.3 Modificada configuración. Comando
#W#modificado. Añadido comando
#INFO#
El contenido de este manual puede sufrir modificaciones sin previo aviso, debido a
modificaciones, mejoras o actualizaciones.
La información contenida es válida excepto posibles errores de impresión.
CashlogyConnector no se responsabiliza de los daños o pérdidas que puedan
ocurrir por el uso de estas instrucciones.
CashlogyConnector no se responsabiliza de las pérdidas o exigencias por parte de terceros
2
que puedan ocurrir por el uso de este equipo.
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: __________________________________________________ 21
6.3 COMANDOS. _________________________________________________________ 22
6.3.1 INTEGRACIÓN EXPRÉS. _______________________________________________________ 23
6.3.1.1 #I# Comando de Inicializar la máquina: _____________________________________ 23
6.3.1.2 #E# Finalizar la aplicación CashlogyConnector: _______________________________ 24
6.3.1.3 #C# Cobrar: ___________________________________________________________ 24
6.3.1.4 #G# BackOffice: ________________________________________________________ 29
6.3.2 INTEGRACIÓN AVANZADA O PERSONALIZADA: ____________________________________ 33
6.3.2.1 COBRO ANTICIPADO ____________________________________________________ 34
6.3.2.1.1 #B# Inicializar admisión: ______________________________________ 35
6.3.2.1.2 #Q# Consulta importe admitido: ______________________________ 35
6.3.2.1.3 #J# Finalizar admisión: ________________________________________ 36
6.3.2.1.4 #P# Dispensar: ________________________________________________ 36
6.3.2.2 OPERACIONES DE CAMBIO Y CAJA _________________________________________ 38
6.3.2.2.1 #A# Añadir cambios: __________________________________________ 39
6.3.2.2.2 #H# Dar cambio: ______________________________________________ 41
6.3.2.2.3 #R# Retirar efectivo: __________________________________________ 44
3
6.3.2.2.4 #U# Dispensar por denominación:_____________________________ 46
6.3.2.2.5 #S# Retirar Stacker: __________________________________________ 47
6.3.2.2.6 #F# Cierre / fondo de caja: ____________________________________ 50
6.3.2.2.7 #1# Recarga manual 1 céntimo: ______________________________ 52
6.3.2.3 REVISION DE CONTABILIDADES ____________________________________________ 54
6.3.2.3.1 #D# Estado: ___________________________________________________ 54
6.3.2.3.2 #T# Cantidad total de efectivo: ________________________________ 56
6.3.2.3.3 #X# Cantidad de una determinada denominación: ____________ 56
6.3.2.3.4 #Y# Cantidad de todas las denominaciones: ___________________ 57
6.3.2.3.5 #GC# Nivel de cada denominación ____________________________ 57
6.3.2.3.6 #GI# Información auxiliar de cada denominación ______________ 58
6.3.2.3.7 #M# Estadísticas Absolutas: ___________________________________ 59
6.3.2.3.8 #N# Estadísticas Relativas: ____________________________________ 60
6.3.2.4 OPERACIONES DE MANTENIMIENTO _______________________________________ 61
6.3.2.4.1 #!# Cancelar __________________________________________________ 62
6.3.2.4.2 #Z# Reset _____________________________________________________ 63
6.3.2.4.3 #V# Vaciado completo: ________________________________________ 63
6.3.2.4.4 #GV# Consulta de versiones y números de serie. _____________ 66
6.3.2.4.5 #O# Mantenimiento (con pantallas) ___________________________ 68
6.3.2.4.6 #W# Mantenimiento sin pantallas: ____________________________ 69
6.3.2.4.7 #L# Ver logs: __________________________________________________ 71
6.3.2.4.8 #K# Poner a cero todas las monedas: _________________________ 71
6.3.2.4.9 #INFO# Obtener información resolución incidencias: __________ 72
6.3.2.5 CONSULTA DE ERRORES _________________________________________________ 73
6.3.2.5.1 #?#SHOW# Mostrar errores. __________________________________ 73
6.3.2.5.2 #?# ¿Error? ____________________________________________________ 75
6.3.2.5.3 #?#error# Detalle de error ____________________________________ 77
6.3.3 INTEGRACIÓN COMPLETA O SIN PANTALLAS ______________________________________ 79
6.3.3.1 CONFIGURACION _______________________________________________________ 80
6.3.3.2 OPERACIONES DE COBRO ________________________________________________ 82
6.3.3.3 OPERACIONES DE CAMBIO. _______________________________________________ 84
6.3.3.4 REVISIÓN DE CONTABILIDADES. ___________________________________________ 85
6.3.3.5 OPERACIONES DE MANTENIMIENTO _______________________________________ 86
6.3.3.6 MOSTRAR ERRORES _____________________________________________________ 87
6.4 PANTALLAS DE INFORMACIÓN DE ERRORES: _______________________________ 88
7 CHECKLIST INTEGRACIÓN. _____________________________________________ 92
8 EJEMPLOS. _________________________________________________________ 94
ANEXO 1 INDICE Y RESUMEN DE COMANDOS __________________________ 96
4
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.
A partir de ahora, en este manual se utilizará el término TPV

para referirse a un entorno de terminal de punto de venta.
El objetivo de este manual consiste en proporcionar toda la información

necesaria para la correcta comprensión del funcionamiento básico del
CashlogyConnector, con el fin de potenciar su funcionamiento al máximo
posible.
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.
2.1 PRODUCTOS COMPATIBLES.

- CASHLOGY. Dispositivo que permite una gestión sencilla y eficiente del
efectivo, aportando fiabilidad y seguridad en todas las transacciones
relacionadas con el manejo de dinero en efectivo tanto con monedas
como con billetes.
- CASHLOGY POS1500X. Dispositivo Cashlogy que además dispone de
un Sistema Operativo interno Windows que permite la conexión con
TPVs con cualquier Sistema Operativo
- AZKOYEN RBH500. Dispositivo que permite la gestión sencilla y
eficiente de billetes permitiendo el almacenamiento y recirculación de
los billetes.
- AZKOYEN RCH8. Dispositivo que permite la gestión sencilla y eficiente
de monedas permitiendo la recirculación y almacenamiento de estas.
5
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.
3 DESCRIPCIÓN DEL FUNCIONAMIENTO.

El módulo CashlogyConnector funciona bajo el modo cliente servidor. El
ejecutable se instala en memoria y atiende en un puerto TPC/IP determinado.
El programa TPV ejecuta un comando, enviando una cadena de texto al
módulo CashlogyConnector invocando la IP y el puerto en el que atiende las
peticiones. A continuación permanece a la escucha para recibir la respuesta de
CashlogyConnector.
La cadena que recibe el programa le proporciona los datos solicitados y un
código de error.
4 REQUISITOS MÍNIMOS DEL DISPOSITIVO TPV

Para garantizar el correcto funcionamiento del software CashlogyConnector, es
necesario que el TPV sobre el que se instala y ejecuta cumpla un mínimo de
requisitos técnicos:
✓ Microprocesador: Via C7 1800MHz (1core)
✓ RAM: 2 Gbyte (4GB recomendados)
✓ Sistema mínimo: Embedded POSReady 2009 2.0 SP3
6
5 ARQUITECTURA.
5.1 FUNCIONAMIENTO.
Aplicación T.P.V.
CashlogyConnector
(Socket) IP , Puerto
Dispositivo Azkoyen a
integrar
El módulo servidor CashlogyConnector se está ejecutando y atiende las

peticiones de la aplicación T.P.V. en la IP y puerto determinados.
Este módulo se debe ejecutar antes o en el arranque de la aplicación T.P.V.
En caso de instalar CashlogyMonitor, CashlogyConnector.exe

se ejecutará automáticamente en el arranque y se asegurara
de que siempre este en ejecución. Por lo tanto, antes de
lanzar la aplicación asegúrese de que no esté ya lanzado ya
que en ese caso el puerto estará ya ocupado.
Cuando la aplicación T.P.V. necesita que el dispositivo realice una operación,

(cobrar, devolución, informar de su estado, etc.) desde el código de la
aplicación se envía una cadena de texto, con el código de comando y los
parámetros necesarios, a la dirección IP y puerto en el que atiende
CashlogyConnector.
CashlogyConnector ejecutará el código necesario para realizar la operación
demandada y presentará, en caso de que sea necesario, las pantallas de
diálogo con el empleado de caja o con el cliente.
Cuando termina el proceso, CashlogyConnector devolverá al programa T.P.V.,
una cadena con los parámetros necesarios (importe recibido, etc.) y un código
de error que informará si el dispositivo ha funcionado correctamente, para que
7
el programa T.P.V. pueda actuar en consecuencia. (Ver apartado 8
EJEMPLOS).
5.2 DIFERENTES ARQUITECTURAS.
5.2.1 TPV Windows.

El dispositivo debe de ir conectado a un TPV Windows a través de su
puerto RS232 o del puerto USB. Este TPV además del software de
gestión deberá de tener instalado el software CashlogyConnector y el
driver del dispositivo.
5.2.2 Conexión a Cashlogy POS1500X o un MiniPC.
Gracias a la arquitectura de CashlogyConnector, en la que la conexión

entre el software TPV y CashlogyConnector se realiza via TCP/IP se
podrá realizar la integración de Cashlogy Connector en TPVs con
sistemas operativos que no sean Windows. Para ello, se puede utilizar
un PC Windows auxiliar, al que llamaremos MiniPC, que estará
conectado a la máquina y que permitiría, en caso de que fuera
necesario, el poder trabajar desde un TPV no conectado al dispositivo.
En este MiniPC instalaremos CashlogyConnector y estará conectado al
software TPV a través de una red local.
*_Esquema válido para cualquier dispositivo compatible con

CashlogyConnector.
Los requisitos mínimos recomendados de este MiniPC son:

➢ CPU 1,5GHz (2 cores)
➢ Memoria RAM 4 GB
➢ Disco duro 60GB (estado sólido)
➢ 1 Puerto Ethernet
➢ 2 puertos USB
➢ 1 Puerto serie(opcional)
➢ Windows Embedded POSready 7
8
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.
Para realizar la conexión deberá de integrar todos los comandos

obligatorios de la columna “sin pantallas” de la tabla del anexo 1, con
especial atención a los comandos de errores ya que los vídeos y
mensajes a usuario de CashlogyConnector deberán ser mostrados en el
TPV remoto.
5.3 MODELOS DE INTEGRACIÓN.

Podemos optar por tres estrategias para integrar un dispositivo en el software
TPV mediante CashlogyConnector:
5.3.1 Integración exprés:

Utilizaremos únicamente el comando COBRAR (para realizar las
funciones básicas del cobro) y el comando BACKOFFICE, para las otras
funciones, (añadir fondo de caja, cambiar billetes por monedas, cierre
de caja, etc.). Solamente usando estos comandos y gestionándolos
correctamente junto con los comandos INICIALIZAR y FINALIZAR le
permitirán tener una correcta integración con CashlogyConnector.
La integración exprés permite integrar el programa T.P.V. con un
dispositivo en un tiempo record garantizando la seguridad de las
diferentes funcionalidades. Las funciones programadas en
CashlogyConnector, resuelven los casos de uso que se presentan en los
procesos de cobro, pago, cierres de caja, etc., aportando las pantallas
necesarias al usuario sin que el programador tenga que realizar
pruebas, ajustes y verificaciones de funcionamiento extra.
5.3.2 Integración Completa o sin pantallas de

CashlogyConnector.
En este modo de integración avanzada, el programador puede utilizar
todos los comandos disponibles (consultar apartado 6.3 para conocerlos
en detalle) integrándolos en el código del programa T.P.V.
El programador puede utilizar cada una de las funciones implantadas en
el módulo BackOffice, integrándolas por separado en su aplicación
T.P.V., además, todas las funcionalidades necesarias pueden ser
integradas sin mostrar las pantallas propias de Connector, y el
integrador tiene acceso a toda la información sobre posibles errores
para poder integrarlas en su aplicación.
9
5.3.3 Integración avanzada o personalizada:
El programador tiene la opción de personalizar todos los comandos de
CashlogyConnector, e incluso mostrar sus propios errores, o puede
solamente personalizar una serie de comandos y dejar las pantallas de
CashlogyConnector para el resto de comandos. En este manual, se
explicará en todos los comandos en los que CashlogyConnector muestra
pantallas, los comandos alternativos para no mostrarlas o los
parámetros de aquellos comandos que permiten ambas opciones.
5.4 CONEXIÓN E INSTALACIÓN.

El dispositivo debe de funcionar conectado a un PC con sistema operativo
Windows. Este PC, como se ha expuesto en la sección 5.3, puede ser el T.P.V
donde estará instalado también el software de gestión, o un MiniPC
intermedio. La conexión a este PC se realizará mediante conexión RS232 o
USB.
Para realizar la instalación, realice los siguientes pasos (consulte el manual
técnico de su dispositivo para más información):
i. Ejecutar CashlogySetupWizard X.X.X
Este instalador será proporcionado por Azkoyen y se podrá descargar desde

la página web sat.cashlogy.com. Asegúrese a la hora de hacer la
instalación que dispone de la última versión.
ii. Seleccionar idioma, aceptar el acuerdo de licencia, seleccionar la

carpeta de destino (se recomienda dejar la carpeta por defecto)
iii. Seleccionar los productos a instalar,

• Cashlogy, permite elegir entre el cajón automático
CashlogyPOS1500, o los productos para monedas Azkoyen RCH8
o para billetes Azkoyen RBH500, así como la divisa en la que se
va a trabajar.
• OPOS common controls. Drivers OPOS necesarios para la
conexión.
10
• 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
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
vi. Configurar CashlogyConnector. (ver sección 6.1, configuración)
12
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)
5.4.1 Conexión e instalación en un MiniPC
El MiniPC debe de llevar instalado el software correspondiente de

CashlogyConnector y los drivers del dispositivo. Para poder realizar
dicha instalación deberá conectar una pantalla al MiniPC, o conectarse a
través de la red utilizando el escritorio remoto de Windows o cualquier
otra aplicación para poder conectar a equipos en red.
En este MiniPC deberá de estar instalado el driver correspondiente del

dispositivo, CashlogyConnector, Cashlogy Monitor, y el servicio de logs
de Azkoyen. Para ello deberá de ejecutar el archivo
CashlogySetupWizard vX.XX suministrado por Azkoyen y seguir los
pasos explicados en la sección 5.4, conexión e instalación” de este
manual.
En la configuración de CashlogyConnector
(C:\Cashlogy\CashlogyConnector\CashlogyConenctorConfig.exe) deberá
seleccionar el modo de pantalla “Sin pantalla”
De esta manera nos aseguramos que ninguna pantalla de

CashlogyConnector se va a mostrar, aunque el software TPV se lo pida,
ya que en ese caso CashlogyConnector devolverá error #ER:ILLEGAL#
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
13
integrador deberá recoger estos videos y mostrarlos en el TPV al
usuario.
Una vez realizada la conexión e integración con el software, se

recomienda trabajar siguiendo estas pautas:
• Establecer la conexión con CashlogyConnector a través del
socket usando la dirección IP del MiniPC (Cashlogy Monitor
habrá ejecutado previamente CashlogyConnector)
• Enviar el comando #I# una vez establecida la conexión, y
esperar su respuesta que puede tardar aproximadamente un
minuto en aquellos dispositivos que usan billetes, ya que es el
tiempo que necesita para iniciar y realizar su test de
hardware.
• Al salir del software TPV, cerrar el socket pero no lanzar el
comando de finalizar #E#.
En caso de que se modifique la configuración del driver o de

CashlogyConnector en este MiniPC, deberá reiniciar el MiniPC.
En caso de que el equipo no arrancara y no conectara a la red, se

recomienda realizar varios intentos de iniciar, y en caso de que el error
persista conectar una pantalla al MiniPC para comprobar el error.
5.5 RECOMENDACIONES DE CONEXIÓN

A continuación se enumera una serie de pautas para una correcta conexión
con Cashlogy Connector.
- 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
14
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.
Se recomienda mantener la conexión socket siempre

establecida mientras el software TPV este en ejecución.
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:
Donde seleccionamos el idioma de CashlogyConnector y la máquina con la que

vamos a trabajar.
15
En esta pantalla encontramos tres pestañas diferentes:
- General. Donde configuramos los parámetros generales de
CashlogyConnector.
- Monedas y billetes. Podremos configurar los diferentes billetes y
monedas a utilizar
- Pantalla errores y otros. Para configuración de la pantalla, errores y
resto de configuraciones.
Además, siempre tenemos acceso a los botones de Grabar configuración,
restaurar los valores por defecto o iniciales, salir y “Cambiar
configuración”. Pulsando este último 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.
GENERAL
▪ 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”
16
▪ “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 de CashlogyConnector. Se recomienda
para optimizar recursos no guardar más de 10 días este tipo de logs.
▪ El campo “Permitir Cobro manual”, le indica a CashlogyConnector si
en la pantalla de cobro acepta el cobro manual (marcado) o no lo
acepta (no marcado) Este parámetro podrá ser modificado por el
software POS. (ver apartado 6.3.1.3).
▪ “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 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.
MONEDAS Y BILLETES
En la ventana “Monedas y billetes” guarda la información relativa a los

billetes y monedas con los que trabajará CashlogyConnector:
17
▪ “Denominación”, descripción del billete o moneda.
▪ “Valor” Valor de la moneda o billete en la unidad menor (céntimos).
▪ “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.
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.
PANTALLA, ERRORES Y OTROS
18
▪ “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#, apartado 6.3.2.5.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 en el
comando #C#, ver apartado 6.3.1.3.
▪ “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.
▪ “Ver totales en la pantalla de cambios”. Mediante este parámetro
se configurara la opción de mostrar al usuario o no hacerlo la cantidad
de billetes y monedas disponibles en los recicladores de billetes y
19
monedas al usar la opción “Añadir cambios” (#A#). Ver apartado
6.3.2.2.1.
▪ “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#)
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.
▪ “Mostrar mensaje coger devolución”. Tras una devolución muestra
un recordatorio a usuario de que debe recoger su cambio.
▪ “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 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 reciclador fuera de servicio.
o Tipo 1. Error de primer nivel (usuario). Por ejemplo, atasco de
billete en admisión
o Tipo 2. Error de segundo nivel (usuario-técnico). Por ejemplo,
atasco de billete en transporte.
o Tipo 3. Error fatal. Todo error que impide cualquier
funcionalidad, por ejemplo problemas de conexión.
▪ “Mostrar fondo en” mostrara un fondo de pantalla explicativo de
como introducir monedas y billetes. Esta imagen se presentará en la
pantalla principal, secundaria o ambas según configuremos. Se puede
20
configurar también que en la segunda pantalla este siempre por encima
del resto de aplicaciones.
▪ “Mostrar video en” mostrara un video explicativo de como introducir
monedas y billetes. Este video se presentará en la pantalla principal,
secundaria o ambas según configuremos.
▪ “Fichero de video”. Ruta del archivo que CashlogyConnector usará
como video explicativo, por defecto:
“Videos\CashlogyPOS1000\Admission.avi”
▪ “Posición de la ventana secundaria”. En twips indicaremos la
posición X e Y de la ventana secundaria para las configuraciones
anteriores. (1 twip=15 pixels). Esta configuración no es válida para la
segunda pantalla en cobros ya que en ese caso viene determinada por
la información enviada en el comando #C# (ver apartado 6.3.1.3)
Cuando hayamos ajustado los valores de los parámetros a nuestro modelo de

trabajo, pulsaremos “Grabar”, para salvar los cambios.
A partir de la próxima inicialización, el módulo CashlogyConnector utilizará
estos parámetros, para operar cada vez que sea llamado por la aplicación
T.P.V. (Es recomendable reiniciar el equipo para asegurarse que
CashlogyConnector se reinicia).
6.2 CÓDIGOS DE ERROR:

CashlogyConnector puede devolver los siguientes códigos a la respuesta de
cada comando.
Estos códigos no hacen relación a un posible estado de error

de la máquina, sino que devuelven si la ejecución del
comando ha sido ok. Para consultas de error de la máquina
consulte el comando error #?# o el apartado 6.4.
▪ #0# si no hay error en la ejecución del comando.

▪ #WR:xxxx#: En caso de avisos (la máquina funcionará
correctamente)
o #WR:LEVEL# Monedas o billetes fuera de límite.
o #WR:CANCEL# Cashlogy Connector devuelve esta cadena
cuando el usuario cancela una operación.
21
Estos casos concretos de error, no deben tratarse como un
error crítico sino más bien como una alarma o aviso, ya que
estas incidencias no causan una parada de la máquina, sino
que permiten seguir operando con el dispositivo.
▪ #ER:xxxx#: En caso de errores en la ejecución del comando.

o #ER:GENERIC# La comunicación con el dispositivo está
fallando o ha habido un error en la devolución.
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..
Se divide la explicación de los comandos entre los diferentes tipos de

integración y según su función para una lectura más ágil. Así mismo, en el
Anexo 1 se encuentra un resumen de todos los comandos, su función y los
diferentes parámetros tanto de envío como de respuesta.
Todas las cifras serán expresadas en la unidad mínima de

moneda, en el caso de Euros, céntimos de euro. Las cifras
que figuran en las cadenas que devuelve se presentan a modo
de ejemplo, en los casos reales presentará los importes
correspondientes a cada operación.
22
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.
6.3.1 INTEGRACIÓN EXPRÉS.

La integración exprés es el método más sencillo de realizar una integración
con Cashlogy Connector, con solo integrar cuatro comandos la aplicación
puede estar perfectamente integrada. Así mismo, una vez terminada, se
puede hacer una integración más personalizada añadiendo nuevos comandos
sin tener que modificar lo realizado anteriormente.
Los comandos que se deben de integrar son los siguientes:

INTEGRACIÓN EXPRESS
NOMBRE COMANDO SECCION MANUAL
INICIALIZAR #I# 6.3.1.1.
FINALIZAR #E# 6.3.1.2.
BACK OFFICE #G# 6.3.1.4.
COBRAR #C# 6.3.1.3.
6.3.1.1 #I# Comando de Inicializar la máquina:

Comando necesario para inicializar el dispositivo, se deberá ejecutar solo una
vez en el inicio para inicializar la máquina. Cashlogy y Azkoyen RBH500
23
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:
6.3.1.2 #E# Finalizar la aplicación CashlogyConnector:

Este comando deberá enviarse al cerrar el software TPV para cerrar la
aplicación CashlogyConnector.exe y finalizar la conexión con el cajón
automático.
- Cadena que se envía: #E#
- Devuelve:
• #0# indicando que la ejecución fue OK.
• #ER:BUSY# si el comando no se puede realizar porque hay
otro comando en curso.
Ejemplo:
6.3.1.3 #C# Cobrar:

Comando para realizar el cobro de una operación en el que el software TPV
indicará el importe a cobrar y será CashlogyConnector quien gestionara el
cambio en función del importe introducido. CashlogyConnector tendrá el
control de toda la operación mostrando al usuario sus propias pantallas.
- Cadena que se envía: #C#a#b#c#d#e#f#g#h#i#j#k# donde
a. Número de operación.
b. Código de caja.
c. Importe que tiene que cobrar (no admite valores negativos).
d. 1 si quiere ver la segunda pantalla, 0 si no quiere verla.
e. Posición X de la segunda pantalla en twips. Si no ve la
segunda pantalla, 0.
24
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#
25
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.
La función cobro no admite cobros negativos, siempre cogerá el valor

absoluto.
• CashlogyConnector puede presentar información al cliente en una
segunda pantalla del T.P.V. El programador la solicitará enviando
en la cadena el parámetro correspondiente, así como las posiciones
X e Y de colocación (parámetros e y f).
• El programador puede decidir entre realizar un cobro “con
confirmación” o un cobro “automático”.
En el cobro “con confirmación” se presentará el botón [ACEPTAR]
para que el proceso espere, aunque se haya introducido más importe
del solicitado, a que sea el usuario el que decida terminar la
admisión de efectivo pulsando el botón [ACEPTAR].
En el cobro “automático”, CashlogyConnector terminará la
operación de aceptación de efectivo y comenzará la devolución en
cuanto el importe recibido sea igual o superior al importe solicitado y
no presentará el botón [ACEPTAR] (parámetro g)
• El programador también puede decidir si se puede aceptar un
importe inferior al solicitado para completar el cobro, bien con otro
medio o derivando a un proceso de crédito. (Aceptar cobros parciales
o no). (parámetro h)
• En las pantallas de cobro es posible presentar una opción de COBRO
MANUAL, que permitiría anotar la entrada de efectivo en la
contabilidad sin realizar esta introducción física en el mismo. (Por
ejemplo en el caso de un cliente que entrega un billete
completamente deteriorado, que no debe ser introducido en la
máquina, sino que se guarda en una caja de seguridad)
Se configurara mediante el parámetro k, o si se deja vacío será en
la configuración de CashlogyConnector (ver apartado 6.1) donde se
establecerá si en la pantalla de cobro se presenta el botón [COBRO
MANUAL] o si por el contrario no se presenta esta opción.
26
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.
Al recibir la respuesta de CashlogyConnector además de

comprobar el código de error, debemos verificar que el importe
introducido (manual y automáticamente) menos el importe
devuelto, coincide con el importe que tenía que cobrar. Si no
coincide es que se ha producido un problema, que
CashlogyConnector no ha podido resolver o que el usuario ha
cancelado la operación
Se deberá comprobar si el usuario ha introducido cambios

durante la operación
Ejemplo 1 :
Donde cada parámetro indica lo siguiente

Cadena enviada → #C#1#1#1000#0#0#0#0#1#1#0#0#
#C’=Comando a cobrar’#1’=Número de operación’#1’= Código de
caja’#1000’=Importe a cobrar’#0’=Sin segunda pantalla’#0’=Posición X de
segunda pantalla’#0’=Posición Y de segunda pantalla’#0’=Sin botón
aceptar’#0’=Sin cobros parciales’#1’=Pantalla siempre por delante’#0’=Sin
céntimos manuales’#0=’Sin cobro manual’#
Respuesta de Cashlogy Connector  #0#2000#1000#0#0#
#0’=Sin error en ejecución’#2000’=importe admitido’#1000’=Importe
devuelto ’#0’No ha habido cobro manual’#0’No se han añadido cambios en la
operación#
La pantalla obtenida sería:
27
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.
Cadena enviada → #C#TB232#Caja 7#499#1#17000#1500#0#0#1#0##
#C’=Comando a cobrar’#TB232’=Número de operación’#Caja 7’= Código de

caja’#499’=Importe a cobrar’#1’=Con segunda pantalla’#17000’=Posición X
de segunda pantalla’#1500’=Posición Y de segunda pantalla’#0’=Sin botón
aceptar’#0’=Sin cobros parciales’#1’=Pantalla siempre por delante’#0’=Sin
céntimos manuales’#’=Vacío. Cobro manual determinado en
CashlogyConnectorConfig’#
Respuesta de Cashlogy Connector  #WR:LEVEL#1000#501#0#25#
#WR:LEVEL’=Sin error en ejecución pero aviso de que algunas monedas o
billetes están fuera de límite. Se debe decir a usuario que revise contabilidad o
mostrar que ítems estan fuera de limties con la información del comando
#GC#’#1000’=importe admitido’#501’=Importe devuelto’#0’No ha habido
cobro manual’#25’Se ha añadido 25 en cambios en la operación#
Al no tener inicialmente cambios cuando se ha hecho el pago, al usuario le ha

aparecido la siguiente pantalla:
28
Error en el cambio 1
De las tres opciones planteadas:

- Cancelar la operación (se hubiera devuelto todo el importe
introducido y la respuesta de connector hubiera sido:
#WR:CANCEL#1000#1000#0#0#
- Aceptar, no se hubiera devuelto nada y el software debe sacar un
mensaje indicando que debe devolverse el cambio manualmente
(501). La respuesta de Connector hubiera sido:
#ER:GENERIC#1000#0#0#0#"
- Añadir cambios. En este ejemplo el usuario ha utilizado esta opción,
al pulsar en añadir cambio la máquina se ha puesto en admisión y el
usuario ha podido introducir monedas. La respuesta ha sido:
#WR:LEVEL#1000#501#0#25#
6.3.1.4 #G# BackOffice:

Comando que aglutina en un solo menú todas las funciones de BackOffice del
dispositivo en el que, dependiendo del tipo de usuario se podrán mostrar las
opciones que el software TPV considere oportunas. También estas funciones
pueden ser llamadas directamente por el software TPV proporcionando mayor
control. En las siguientes secciones de este manual se explicará una a una
cada función.
29
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.
En la integración de este comando se deberá tener en cuenta

diferentes niveles de acceso según el usuario ya que habrá
usuarios que podrán acceder a todas o la mayoría de las
funciones, y otros que solo deberán tener acceso a pocas o una
(dar cambio).
Por ello el programador deberá de mandar diferentes
parámetros en las cadenas enviadas para mostrar esta pantalla
dependiendo del usuario
- Cadena que se envía: #G#a#b#c#d#e#f#g#h#i#j#k#l#m#

a. 1 si quiere ver la opción: “Estado de Cashlogy”, 0 si no quiere
verla.
b. 1 si quiere ver la opción: “Añadir cambios”, 0 si no quiere
verla.
c. 1 si quiere ver la opción: “Recarga manual 1 céntimo”, 0 si no
quiere verla.
d. 1 si quiere ver la opción: “Retirada de efectivo”, 0 si no quiere
verla.
e. 1 si quiere ver la opción: “Retirar stacker”, 0 si no quiere
verla.
f. 1 si quiere ver la opción: “Forzar vaciado”, 0 si no quiere
verla.
g. 1 si quiere ver la opción: “Dar cambio”, 0 si no quiere verla.
h. 1 si quiere ver la opción: “Cierre / Fondo de caja”, 0 si no
quiere verla.
i. 1 si quiere ver la opción: “Ver log”, 0 si no quiere verla.
j. 1 si quiere ver la opción de “Poner las monedas a cero”
30
k. 1 si quiere ver la opción de ver las estadísticas absolutas y
relativas
l. 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 tendrá que ponerle 0 para poder
realizar las pruebas. Cuando está funcionando directamente
con la máquina debería ponerle 1)
m. 1 si se quiere ver la opción mantenimiento.
- La cadena que devuelve será:

• #a#b#c#d#e#f#
b. Efectivo total disponible en el dispositivo al entrar en la
pantalla de BackOffice.
c. Efectivo total disponible en el dispositivo al salir de la
pantalla de BackOffice.
d. Efectivo total que ha sido introducido mientras se
estuvo en la pantalla de BackOffice.
e. Efectivo total que ha sido retirado mientras se estuvo
en la pantalla de BackOffice.
f. Si en un proceso de dar cambios no se ha podido
devolver parte debido a un error se especifica en este
parámetro. El parámetro indicará el importe que ha
quedado pendiente de devolver.
En el apartado de integración personalizada se mostrará como poder llamar a
estos comandos individualmente en lugar de con este comando de Connector
Ejemplo 1. Usuario con todos los permisos hace varias operaciones de
entrada y salida de efectivo.
Cadena enviada → #G#1#1#1#1#1#1#1#1#1#1#1#1#1# ‘Se muestran

todas las opciones’
Respuesta Cashlogy Connector  #WR:LEVEL#8295#9015#2840#2120#0#
Donde #WR:LEVEL’=Ejecución Ok aunque se debe revisar el estado de
algunos billetes o monedas que están fuera de límite’#8295’=Efectivo al
entrar en Back Office’#9015’=Efectivo al salir de Back Office’#2840’=Efectivo
introducido por el usuario durante esta operación’#2120’=Efectivo retirado
por el usuario durante esta operación’#0’=Importe que no se ha podido
devolver por errores de la máquina’#
31
El desarrollador debe asegurarse que la resta del importe al
finalizar menos el importe al inicio, es igual al importe
introducido menos el retirado.
La pantalla mostrada al usuario con todas las funciones será:
Ejemplo 2. Usuario con permisos restringidos hace una operación de cambio:
Cadena enviada → #G#0#1#0#0#0#0#1#0#0#0#1#1#0# ‘Solo se

muestran los parámetros b (añadir cambio), g (dar cambio), k (ver
estadísticas) y quiere la pantalla de Connector por delante (parámetro l)’
Respuesta Cashlogy Connector  #WR:LEVEL#9015#9015#500#500#0#
Donde #0’=Ejecución Ok’#9015’=Efectivo al entrar en Back Office
’#9015’=Efectivo al salir de Back Office’#500’=Efectivo introducido por el
usuario durante esta operación’#500’=Efectivo retirado por el usuario durante
esta operación’#0’=Importe que no se ha podido devolver por errores de la
máquina’#
La pantalla mostrada al usuario será:
32
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#
33
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
CIERRE CAJA #F#
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…#
6.3.2.1 COBRO ANTICIPADO

Como alternativa al uso del comando #C# visto en el apartado 6.3.1.3 donde
el software le indica a Cashlogy Connector la cantidad a cobrar y este realiza
la devolución según el importe aceptado, el desarrollador de software puede
usar la siguiente combinación de comandos para tener un mayor control y
34
poder ofrecer sus propias pantallas además de permitir la introducción de
efectivo antes incluso de finalizar el ticket para de esta manera agilizar el
proceso.
- #B#: Inicializar admisión
- #Q#. Consulta importe admitido
- #J#. Finalizar admisión
- #P# Pago o devolución
6.3.2.1.1 #B# Inicializar admisión:
Comando que permite la admisión de monedas y billetes y en combinación con

los comandos de ver importe admitido, finalizar admisión y dispensar, permite
hacer cobros con un mayor control del software TPV y pantallas
personalizadas.
- Cadena que se envía: #B#a#b#c#
a. 1 si quiere ver la segunda pantalla, 0 si no quiere
verla.
b. Posición X de la segunda pantalla en twips. Si no ve
la 2ª pantalla, 0.
c. Posición Y de la segunda pantalla en twips. Si no ve
la 2ª pantalla, 0.
• #a#
Una vez iniciada la admisión sólo se podrán enviar los comandos ver importe
admitido (Q), finalizar admisión (J), cantidad de una denominación (X),
cantidad de todas las denominaciones (Y), error (?), reset (Z) y cancelar (!).
La introducción de efectivo mediante el comando #B# sólo

podrá realizarse si previamente hay cambio en la máquina.
Para introducir monedas o billetes cuando esta está vacía
debe utilizarse el comando #A# “Añadir cambio”.
6.3.2.1.2 #Q# Consulta importe admitido:

Permite saber el importe recibido desde que se ha habilitado el dispositivo
para el cobro. Se recomienda ejecutarlo cada 200 o 250 mili segundos.
- Cadena que se envía: #Q#
• #a#b#
35
b. Importe que ha recibido desde que se habilitó.
6.3.2.1.3 #J# Finalizar admisión:

Cuando el software TPV considere oportuno, este comando finaliza el estado
de admisión.
- Cadena que se envía: #J#
• #a#b#
b. Importe que ha cobrado mientras estaba habilitado.
El software TPV debe revisar el importe cobrado en este

comando igual que lo hace en #Q#, ya que entre la última
consulta al comando #Q# y la finalización de la admisión el
usuario ha podido introducir más monedas o billetes.
Entre iniciar y finalizar cobro los únicos comandos que se

podrán enviar serán los comandos ver importe admitido (Q),
finalizar admisión (J), cantidad de una denominación (X),
cantidad de todas las denominaciones (Y), error (?), reset (Z) y
cancelar (!).
Una vez finalizada la admisión, si se vuelve a consultar los

comandos ver importe admitido (Q) y finalizar admisión (J),
CashlogyConnector devuelve el importe admitido en la última
operación mientras no se ejecute otro comando.
En caso de que el programador, una vez ejecutado el
comando de finalizar admisión (J) y recibida su respuesta
quisiera que en las siguientes consultas la respuesta fuera 0,
deberá activar el modo estricto colocando un archivo llamado
“_CmdsQJEstrictos.*” en la carpeta de CashlogyConnector.
6.3.2.1.4 #P# Dispensar:

Mediante este comando el dispositivo devolverá el importe solicitado por el
software TPV con la cantidad de monedas y billetes óptima según el caso.
- Cadena que se envía: #P#a#b#c#d#
a. Importe que quiere que devuelva.
b. 1 si quiere que la pantalla se vea por delante del resto de
pantallas, 0 pantalla en segundo plano.
36
c. 1 si quiere que se vea una pantalla mientras se está
realizando el pago, 0 en caso contrario.
d. 1 si se quiere que se devuelvan solo monedas.
• #a#b#c#
b. Importe que ha devuelto
c. 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.

comprobar el código de error, debemos verificar que el
importe solicitado coincide con el importe devuelto. Si no
CashlogyConnector no ha podido resolver.
Ejemplo 1. Ticket a cobrar de 854
#B '=iniciar admision'#1 '=ver 2ª pantalla'#17000

> 11:01:52.930,#B#1#17000#1500#
'=X 2ª pantalla'#1500 '= Y 2ª pantalla'#
< 11:01:55.320,#0# Ejecución comando = OK

> 11:01:55.520,#Q# Consulta importe admitido
< 11:01:55.530,#0#0# #0 '=ejecución OK'#0 '=Importe admitido'#
------------------------------
------------------------------
> 11:02:38.880,#J# Finalizar admisión
#P '=Dispensar'#150 '=importe a dispensar#0
> 11:03:04.220,#P#150#0#0#0# '=pantalla 2º plano'#0 '=Sin pantalla al pagar'#0
'=No devolver solo con monedas'#
#0 '=Ejecución OK'#150 '=Importe devuelto#0
< 11:03:06.560,#0#150#0# '=importe añadido como cambio durante la
operación'#
37
Entre la última consulta #Q# y la finalización de la admisión han entrado 2
céntimos más que se deben de tener en cuenta al hacer la devolución.
Ejemplo 2. Ticket a cobrar de 150
> 11:03:51.490,#B#0# #B '=iniciar admision'#0 '=no ver 2ª pantalla'#
< 11:03:52.710,#WR:LEVEL# Ejecución comando = OK pero aviso de que algunas

monedas o billetes están fuera de límite.
#WR:LEVEL '=ejecución OK con aviso de nivel'#0
< 11:03:55.200,#WR:LEVEL#0#
'=Importe admitido'#
# WR:LEVEL '=ejecución OK con aviso de nivel'#500
< 11:04:43.250,#WR:LEVEL#500#
> 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#
#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
Para consultar que monedas están por encima o debajo de

sus niveles, consulte los comandos de contabilidad, en
concreto el comando #GC# GetCapacity
6.3.2.2 OPERACIONES DE CAMBIO Y CAJA
Los siguientes comandos se utilizarán para realizar retiradas de efectivo,

operaciones de cambios y cierres de caja. En la tabla siguiente se muestran
las cinco operaciones que son de obligatoria integración, ya sea dentro del
comando de BakOffice #G# (Ver Integración Express), mostrando el comando
con pantallas de CashlogyConnector, o su alternativa con pantallas propias del
software como se resume en la columna derecha de la tabla siguiente.
38
COMANDOS MOSTRANDO PANTALLA DE CASHLOGY COMANDOS SIN MOSTRAR PANTALLA DE
CONNECTOR CASHLOGY CONNECTOR

AÑADIR CAMBIOS #A# VER IMPORTE ADMITIDO #Q# o #Y#
DISPENSAR POR
RETIRAR EFECTIVO #R# #U#
DENOMINACIÓN
AÑADIR CAMBIO #A#2#
DAR CAMBIO #H# FINALIZAR ADMISION #J#
DISPENSAR POR
#U#
DENOMINACIÓN
RETIRAR STACKER #S# RETIRAR STACKER #S#2#
DISPENSAR POR
#U#
DENOMINACIÓN
CIERRE CAJA ##
6.3.2.2.1 #A# Añadir cambios:

Este comando permitirá la introducción de monedas y billetes para ser
utilizados como cambios en posteriores operaciones. En el primer uso y
cuando la máquina está vacía, será necesario introducir cambio utilizando este
comando antes de ningún otro que implique la introducción de monedas y
billetes.
39
Esta pantalla se presenta cuando enviamos el comando: #A#a# (si a=2 no se
muestra pantalla)
Según entran las monedas y billetes en el dispositivo, nos las irá mostrando
en la pantalla.
Cuando hemos terminado de añadir monedas y billetes, pulsamos el botón
[SALIR]. CashlogyConnector devuelve una de las posibles cadenas.
En caso de que se haya configurado el parámetro “show ítems in change
window” a 0, no se mostrarán las cantidades disponibles, y la pantalla
mostrada será la siguiente:
- 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)
• En caso que enviemos #A#0# o #A#1#
▪ #a#b#
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)
40
Las pantallas que se muestran en este manual son ejemplos
tomados de CashlogyPOS1500 Euro. En los dispositivos que
solo utilizan monedas no se mostrarán los billetes y viceversa
Ejemplo 1. Añadir cambios con pantalla de CashlogyConnector

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
Al enviar el parámetro 2 (no mostrar pantalla) el software debe de ir

consultando periódicamente (recomendado cada 200ms) con el comando #Q#
el importe introducido. Además, se debe crear una pantalla con un botón que
llame al comando #J# (finalizar admisión) para finalizar la introducción de
cambio por parte del usuario, la respuesta a este comando será el importe
introducido (160 en el ejemplo)
Además si se quiere mostrar en pantalla las diferentes monedas y billetes
introducidas en tiempo real, debe mandarse el comando #Y# para ir
refrescando esta información.
6.3.2.2.2 #H# Dar cambio:

Este comando se utilizará para introducir un importe y devolver el mismo
importe en diferentes denominaciones. Se podrá utilizar tanto para dar cambio
a clientes como para introducir/vaciar monedas o billetes de una denominación
que esté casi llena o casi vacía, manteniendo el mismo importe como fondo de
caja.
41
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).
42
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.
- Cadena que se envía: #H#a#

• a será 1 si quiere que la pantalla se vea por delante del resto
de pantallas, 0 pantalla en segundo plano.
• #a#b#c#
b. Importe que ha introducido
c. Importe que ha devuelto
• #WR:CANCEL#b#c#
a. Ejecución cancelada
b. Importe introducido
43
c. Importe devuelto

comprobar el código de error, debemos verificar que el
importe introducido coincide con el importe devuelto. Si no
CashlogyConnector no ha podido resolver.
Ejemplo 1. Dar cambios con pantalla de CashlogyConnector

Cadena enviada → #H ‘=Comando dar cambio’#1’=Mostrar pantalla de
Respuesta de Cashlogy Connector  #0 ‘=Sin error en ejecución’#1000
‘Importe introducido por el usuario’#1000 ‘= Importe devuelto’#
Ejemplo 2. Dar cambios sin pantalla de CashlogyConnector
El comando #H# Dar cambio siempre mostrará pantalla de Cashlogy
Connector con lo que si el desarrollador quiere personalizar su propia pantalla
deberá realizar una secuencia como la del ejemplo usando los comandos
#A#2#, #Q# (para ver la cantidad o #Y# para ver en tiempo real la
contabilidad de cada moneda y billete), #J# y #U# (ver sección de cada
comando para mayor comprensión)
6.3.2.2.3 #R# Retirar efectivo:

Este comando permite la retirada tanto de monedas como de billetes siendo el
usuario quien en la pantalla de CashlogyConnector determinará cuantas
unidades retirará de cada denominación. Los billetes por defecto irán a stacker
si el usuario no desactiva la casilla que marca que sean enviados ahí.
(Azkoyen RCH8 no dispone de stacker)
44
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#b#
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.

Cadena enviada → #R ‘=Comando retirar efectivo’#1’=Mostrar pantalla de
Respuesta de Cashlogy Connector  #0 ‘=Sin error en ejecución’#420 ‘=
Importe retirado’#
45
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.
Este comando no debe utilizarse para dar cambio en ventas

ya que en caso de error en un devolvedor el importe no será
devuelto. Debe utilizarse el comando #P#, ya que en dicho
comando si un devolvedor no pudiera dar el importe,
CashlogyConnector recalculará para devolver el importe
total mediante otros devolvedores.
- Cadena que se envía: #U#a#b#c#d#

a. 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.
b. 1 si los billetes van a Stacker y 0 si salen por boca.
c. 1 si quiere que la pantalla se vea por delante del resto de
d. 1 si quiere ver la pantalla de pago, 0 si no.

• #a#b#
b. Cadena de denominaciones indicando las cantidades
devueltas realmente (deberá coincidir con las
cantidades mandadas si no ha habido error y se usará el
mismo formato) ATENCIÓN, si el billete va a stacker
devuelve 0
• #ER:BAD_DATA#
▪ La cadena de denominaciones no sea correcta:
o (Caracteres incorrectos, denominaciones
inexistentes, no separación (;) entre monedas y
billetes)
o #WR:LEVEL#
▪ No hay cantidad suficiente de alguna denominación.
Ejemplo 1. Se quiere dispensar 1 moneda de 10, 5 monedas de 2, 1 billete de
5 y 1 billete de 10 que irían a stacker
46
Cadena enviada #U#10:1,200:5;500:1,1000:1#1#1#0# donde #U
‘=Comando dispensar por denominación’ #10:1,200:5;500:1,1000:1
‘=dispensar 1 moneda de 10, 5 monedas de 200, 1 billete de 500 y 1 billete
de 1000’ #1 ‘=Enviar los billetes a stacker’ #1 =Mostrar pantalla de
CashlogyConnector en primer plano’#0 ‘=No mostrar pantalla de
CashlogyConnector en la devolución’#
CashlogyConnector devolvería la siguiente cadena:
#0#1:0,2:0,5:0,10:1,20:0,50:0,100:0,200:5;500:0,1000:0,2000:0,5000:0,1
0000:0,20000:0,50000:0#
ATENCIÓN, si el billete va a stacker devuelve 0
Ejemplo 2. Se quiere retirar un billete de 500 y uno de 1000
---> #U#;500:1,1000:1#0#1#0#
<--- #0#1:0,2:0,5:0,10:0,20:0,50:0,100:0,200:0;500:1,1000:1,2000:0,
5000:0,10000:0,20000:0,50000:0#
El parámetro a comienza por el símbolo “;” ya que no se dispensan monedas y
500 es un billete. El siguiente parámetro indica que se dispensen (no a
stacker). El proceso finaliza OK, ambos billetes son dispensados
Ejemplo 3. Se quiere retirar un billete de 500 y uno de 1000
CashlogyConnector devuelve ER:BAD_DATA porque no se ha puesto el símbolo

“;” y 500 es billete.
Ejemplo 4. Se quiere retirar un billete de 500 y uno de 1000 (no a stacker)
---> #U#;500:1,1000:1#0#1#0#
<--- #0#1:0,2:0,5:0,10:0,20:0,50:0,100:0,200:0;500:0,1000:0,2000:0,
5000:0,10000:0,20000:0,50000:0#
Ninguno de los dos billetes ha sido devuelto, puede tratase de un error del
devolvedor o por no disponer de cambio. Debería de mostrarse un mensaje al
usuario indicando que no se ha podido realizar la devolución y consultar el
error y/o la contabilidad.
6.3.2.2.5 #S# Retirar Stacker:

Opción no disponible en Azkoyen RCH8
47
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.
Para recaudar los billetes del almacén (Stacker) utilizamos el comando:

#S#a# (a=2 no mostrará las pantallas de CashlogyConnector)
CashlogyConnector presenta esta pantalla informando del importe total de los
billetes depositados en el Stacker.
Para retirarlo pulsamos el botón [CONFIRMAR LA RETIRADA DEL STACKER] y
seguidamente lo retiramos y recogemos los billetes.
Una vez retirado el programa pone a cero el importe.
Pulsamos [SALIR] y el programa nos devuelve una cadena de caracteres.
Si el usuario recoge los billetes sin utilizar este comando, el

valor de los billetes en el stacker no se reinicializará, pudiendo
llegar a originar un error si el stacker alcanzara su capacidad
máxima en esta contabilidad.
- Cadena que se envía: #S#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 CashlogyConnector.
48
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
• #a#b#
b. Importe que se ha retirado en el stacker.
Ejemplo 1. Retirar stacker mostrando las pantallas de CashlogyConnector

Cadena enviada → #S ‘=Comando retirar stacker’#1’=Mostrar pantalla de
Importe retirado’#
Ejemplo 2. Retirar stacker sin mostrar 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.
49
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.
Esta pantalla permite cerrar la caja y dejar una cantidad determinada de

billetes y monedas en los recicladores como fondo de caja para hacer las
devoluciones necesarias en las operaciones de cobro y pago.
Desde el programa T.P.V. enviamos la cadena: #F#a#
La columna “Cant. Actual” informa de la cantidad de billetes o monedas que
tiene almacenadas para cada denominación (en rojo, aquellas que están en
situación de casi vacío). La columna “Cant. Recic.” informa la cantidad
contenida en los recicladores y la columna “Cant. Staker” presenta los billetes
que tiene en el almacén (Stacker).
Al pie de cada columna presenta la valoración de las monedas y billetes.
“Importe fondo de caja”. El usuario podrá escribir una cantidad fija a
mantener como fondo de caja, y el software calculará como dejar ese importe
priorizando mantener las monedas/billetes más pequeños. Estas cantidades
podrán ser modificadas por el usuario antes de procesar el fondo de caja.
Si además marca la opción “Recaudar solo billetes”, mantendrá el fondo de
caja mas aproximado al definido en “importe fondo de caja” manteniendo
todas las monedas en la máquina.
50
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.
- Cadena que se envía: #F#a#

• #a#b#c#d#
b. Valoración total de dinero que tiene almacenado antes
del fondo de caja.
c. Importe que se ha añadido en cambios
51
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.

Cadena enviada → #F ‘=Comando cierre fondo de caja’#1’=Mostrar pantalla
de CashlogyConnector en primer plano’#
Importe inicial’#75 ‘=importe añadido como cambio’ #5000 ‘=Importe
almacenado en la máquina al finalizar la operación incluido el stacker’#
Ejemplo 2, sin mostrar pantallas de CashlogyConnector
Para realizar esta función sin pantallas de CashlogyConnector, deberá
combinar las funciones #Y# consulta de contabilidad, #A#2# + #Q# + #J#
añadir cambios, y dispensar por denominación #U#
6.3.2.2.7 #1# Recarga manual 1 céntimo:

Esta función sólo es válida para Cashlogy POS20, modelo ya obsoleto, y se
utilizará para rellenar el Hopper auxiliar de 1 céntimo.
52
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#
53
• #a#b#
b. Importe añadido en monedas de 1 céntimo
6.3.2.3 REVISION DE CONTABILIDADES
Los siguientes comandos se utilizarán para realizar diferentes consultas del

estado del efectivo. En la tabla siguiente se muestran las operaciones que son
de obligatoria integración, ya sea dentro del comando de BakOffice #G# (Ver
Integración Express), mostrando el comando con pantallas de
CashlogyConnector, o su alternativa con pantallas propias del software como
se resume en la columna derecha de la tabla siguiente.

EFECTIVO TOTAL #T#

CANTIDAD DE UNA
#X#
DENOMINACION
CANTIDAD TODAS
ESTADO CASHLOGY #D# #Y#
DENOMINACIONES
NIVEL DE CADA
#GC#
DENOMINACION
INFORMACION AUXILIAR #GI#
Además, CashlogyConnector dispone de un comando integrable dentro de la

aplicación o del menú BackOffice que muestran estadísticas sobre el uso de las
diferentes monedas y billetes.
6.3.2.3.1 #D# Estado:
Presenta en una pantalla de CashlogyConnector los billetes y monedas con los

que puede operar el dispositivo, e informa de la cantidad de cada
denominación que está almacenada en ese momento en el dispositivo, tanto
en los dispositivos recicladores como en el stacker.
54
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#
de pantallas o 0 para pantalla en segundo plano.
o #a#b#
b. Valoración total de dinero que tiene la máquina
Ejemplo 1. Estado de la contabilidad con pantalla de CashlogyConnector
Al enviar el comando se presentara la pantalla anterior, y al salir Connector

responderá donde cada parámetro indica lo siguiente
Cadena enviada → #D ‘=Comando Estado Cashlogy’#1’=Mostrar pantalla de
Respuesta de Cashlogy Connector  #WR:LEVEL ‘=Aviso de que algún ítem
esta fuera de nivel’#11528 ‘Importe total en efectivo’#
55
6.3.2.3.2 #T# Cantidad total de efectivo:
Comando para consultar a CashlogyConnector el importe total del efectivo
almacenado.
- Cadena que se envía: #T#
• #a#b#c#
b. Efectivo total almacenado en los recicladores.
c. Efectivo total almacenado en el stacker.
Ejemplo 1. Estado de la contabilidad sin pantalla de CashlogyConnector

Cadena enviada → #T ‘=Comando Total efectivo’#
esta fuera de nivel’#5528 ‘Importe total en efectivo en recicladores’#6000
‘Importe total en el stacker’#
6.3.2.3.3 #X# Cantidad de una determinada denominación:

Comando para consultar a CashlogyConnector la cantidad total almacenada de
una determinada denominación.
- Cadena que se envía: #X#a#
a. Valor de la moneda o billete de la que quiere saber cuántas
unidades hay (en céntimos).
• #a#b#c#
b. Número de monedas o billetes que hay en los
recicladores del valor solicitado.
c. Número de monedas o billetes que hay en el stacker del
valor solicitado.
• Se devolverá #ER:BAD_DATA# si se introduce una
denominación de moneda o billete que no existe.
Ejemplo 1. Cantidad de una determinada denominación

56
Cadena enviada → #X ‘=Comando cantidad de una denominación’#1000
‘Cantidad total de 1000’#
esta fuera de nivel’#1 ‘Número de unidades de 1000 en los recicladores’#1
‘Número de unidades de 1000 en el stacker’#
6.3.2.3.4 #Y# Cantidad de todas las denominaciones:

Comando para consultar a CashlogyConnector la cantidad total almacenada de
cada denominación.
- Cadena que se envía: #Y#
• #a#b#c#
b. Separados por comas, número de monedas o billetes
que hay en los recicladores de cada valor (en céntimos).
Se usará punto y coma para separar monedas de
billetes.
c. Separados por comas, número de monedas (siempre
serán cero) o billetes que hay en el stacker de cada
valor (en céntimos). Se usará punto y coma para
separar monedas de billetes.
Ejemplo 1. Cantidad de todas las denominaciones

Cadena enviada → #Y ‘=Comando total de todas las denominaciones’#

esta fuera de nivel’#1:42,2:28….200:5;500:0,1000:1…. ’42 monedas de 1,
28 de 2,….5 monedas de 200 ; 0 billetes de 500, 1 billete de 1000 en
recicladores….’#1:0…. ; 500:0,1000:1…. ‘0 monedas de 1, ….; 0 billetes de
500, 1 billete de 1000 ….’#
6.3.2.3.5 #GC# Nivel de cada denominación

Comando para consultar a CashlogyConnector el nivel de llenado de cada
denominación respecto a su capacidad total
- Cadena que se envía: #GC#
• #a#b#c#
a. Código de error en la ejecución
57
b. Separados por comas, estado del nivel de llenado de
monedas o billetes que hay en los recicladores de cada
valor (en céntimos). La respuesta será en céntimos
cada valor seguido de dos puntos y su estado siendo
este las siguientes posibilidades:
OK-0, Vacío-11, CasiVacío-12, Lleno-21 o CasiLleno-22
Se usará punto y coma para separar monedas de
billetes.
c. Separados por comas, porcentaje de llenado de cada
denominación respecto a su capacidad total. Se usará
punto y coma para separar monedas de billetes.
Ejemplo 1. Nivel de llenado de cada denominación

Cadena enviada → #GC ‘=Comando nivel de llenado de cada denominación’#

esta fuera de nivel’
#1:0 ‘moneda de 1 estado OK ,2:12 ‘moneda de 2 estado Casi Vacío’… ;
500:11 ‘500 estado vacío’,1000:12 ‘1000 estado casi vacío’….Stacker:0
‘Stacker estado OK’
#1:11’Nivel llenado 1:11% de la capacidad total’,2:9 ‘nivel llenado 2, 9%...#
6.3.2.3.6 #GI# Información auxiliar de cada denominación

Comando para consultar a CashlogyConnector información auxiliar de cada
denominación con el cual se obtendrá información sobre el tipo de divisa e
información sobre la posibilidad de aceptar, dispensar o ambas.
- Cadena que se envía: #GI#
• #a#b#c#
b. Matricula del país de la programación
c. Separados por comas, set de ítems y funcionalidad de
cada uno de ellos, donde 1 será ítem depositable, 2
dispensable y 3 ítem que puede ser depositado y
dispensado. Se usará punto y coma para separar
monedas de billetes.
58
Ejemplo 1. Información auxiliar en CashlogyPOS1500EU

Cadena enviada → #GI ‘=Comando información auxiliar’#
Respuesta de Cashlogy Connector  #0 ‘=Sin error en la ejecución’

#EUR ‘divisa=Euro’ #1:3 ‘1 céntimos dispensable y depositable’…; 500:3
‘500 dispensable y depositable’…,5000:1 ‘5000 depositable’#
6.3.2.3.7 #M# Estadísticas Absolutas:

Este comando mostrará en pantalla una estadística de las monedas y billetes
introducidas y devueltas desde la instalación.
Mediante el botón imprimir se imprimirá un ticket en la impresora

predeterminada con un resumen de monedas y billetes que se han depositado
y dispensado desde la fecha en que se muestra en la pantalla hasta la fecha
en que se leen.
El botón exportar datos permitirá exportarlos a una carpeta que se creará en
el directorio en el que se ha instalado el programa. Al pulsar el botón se
mostrará la siguiente pantalla:
59
- Cadena que se envía: #M#a#
• a será 1 si quiere que la pantalla se vea por delante del resto de
• #a#
6.3.2.3.8 #N# Estadísticas Relativas:

Este comando mostrará en pantalla una estadística de las monedas y billetes
introducidas y devueltas desde el último reset del contador situado en dicha
pantalla.
60
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#
6.3.2.4 OPERACIONES DE MANTENIMIENTO

Los siguientes comandos se utilizarán para realizar diferentes operaciones de
mantenimiento. En la tabla siguiente se muestran todas las posibles
operaciones de mantenimiento que pueden estar integradas dentro del menú
BackOffice (comando #G#), directamente mostrando pantallas de
CashlogyConnector o su alternativa sin mostrarlas.

VER LOGS #L# Sin alternativa
PONER A CERO LAS MONEDAS #K#1# PONER A CERO LAS MONEDAS #K#2#
61
Además, CashlogyConnector dispone de los siguientes comandos que también
pueden ser integrados sin mostrar pantallas de CashlogyConnector.
COMANDOS SIN MOSTRAR PANTALLA DE CASHLOGY CONNECTOR
CONSULTA DE VERSIONES Y NÚMEROS DE SERIE #GV#
6.3.2.4.1 #!# Cancelar
El software podrá en todo momento cancelar la operación que se está

ejecutando. Este comando será siempre prioritario y detendrá la operación que
se esté desarrollando. Si un billete/moneda ya ha empezado a ser
dispensado/admitido, el dispositivo terminará dicha operación.
Este comando podrá ser usado para cancelar los siguientes comandos
solamente:
- #D#, Estado
- #S#, Retirar Stacker
- #M#, Estadísticas absolutas
- #N#, Estadísticas relativas
- #L#, Ver logs
- #B#, Inicializar admisión
- #A#2#, Añadir cambios (solamente con el parámetro b=2, cuando
no se muestra la pantalla de CashlogyConnector)
- #?#, Todos los comandos relativos a errores.
- #O#, Mantenimiento (con pantallas).
- #K#, Poner a cero las monedas.
Durante la ejecución de estos comandos podrá ser enviado en todo momento,
en el resto de comandos devolverá BUSY
- Cadena que se envía: #!#
- La cadena que devuelve puede ser una de las siguientes:
• #0# No había comando en curso
• #WR:CANCEL#RespuestaComandoEnCurso#
• #ER:BUSY# El cmd no se puede cancelar
Ejemplo 1. Cancelación durante un proceso de admisión
62
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#
6.3.2.4.2 #Z# Reset

Este comando reinicializará el sistema y podrá ser lanzado por el software POS
en cualquier momento incluso en estado “busy”.
- Cadena que se envía: #Z#
• #a#
Ejemplo 1. Reset durante un proceso de admisión
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
6.3.2.4.3 #V# Vaciado completo:

Este comando permite el vaciado completo del dispositivo. Este buscará
monedas y/o billetes independientemente de la cantidad que haya en la
contabilidad, asegurándose que quede totalmente vacío.
63
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.
- Cadena que se envía: #V#a#b#c#

a. 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.
b. 1 si se quiere devolver sólo monedas, 0 para devolver
monedas y billetes, y vacío (#V#1##) para dar la posibilidad
al usuario a elegir entre ambas opciones.
64
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.

• #a#b#
b. Importe total que ha entregado en el vaciado
incluyendo el efectivo en el stacker sólo si éste se ha
retirado, si no, solo devolverá el importe devuelto en
monedas. Tras el vaciado, Cashlogy Connector
preguntará si desea retirar el stacker.
Ejemplo 1. Vaciado completo con pantalla de CashlogyConnector
Al enviar el comando se presentara la pantalla anterior, y al salir Connector

responderá donde cada parámetro indica lo siguiente
Cadena enviada → #V ‘=Comando vaciado completo’#1’=Mostrar pantalla de
CashlogyConnector en primer plano’#vacío: deja la opción a usuario de
marcar solo monedas o vaciar monedas y billetes’#
esta fuera de nivel’#8760 ‘Importe total vaciado’#
Ejemplo 2. Vaciado completo sin pantalla de CashlogyConnector. En la
máquina inicialmente en este ejemplo hay 5038, 4538 en monedas y 500 en
billetes.
Cadena enviada → #V ‘=Comando vaciado completo’#2’=No mostrar pantalla

de CashlogyConnector’#0: vaciar monedas y billetes’#
esta fuera de nivel’#4538 ‘Importe total vaciado’#
Como se ve, aunque había 5038 en la máquina y se ha pedido devolver

monedas y billetes, la respuesta al comando solo han sido los 4538 que había
65
en monedas, ya que los billetes han sido enviados a stacker, pero este no se
ha retirado
Por ello, tras un vaciado en integración sin pantallas, se debe

de dar la posibilidad de vaciar el stacker al usuario mostrando
un mensaje en pantalla. Si el usuario acepta vaciar el stacker,
se mandara el comando #S#2# (ver apartado 6.3.2.2.5.)
Ejemplo 3. Vaciado completo del reciclador de 1000 sin pantalla de

CashlogyConnector.
Cadena enviada → #V ‘=Comando vaciado completo’#2’=No mostrar pantalla

de CashlogyConnector’#vacio: elegir entre monedas y billetes’#;1000
‘=vaciar reciclador de billetes de 1000’#
esta fuera de nivel’#0 ‘Importe total vaciado (los billetes han ido a stacker)’#
6.3.2.4.4 #GV# Consulta de versiones y números de serie.

Comando para consultar a CashlogyConnector sobre las versiones y números
de serie del hardware de la máquina.
- Cadena que se envía: #GV#a#
• Donde el parámetro a será una de las siguientes opciones:
▪ General. Para consultar información general y número
de serie de la máquina
▪ Software. Para consultar información sobre versiones
de CashlogyConnector y Dll.
▪ Hardware. Para consultar información sobre números
de serie y versiones de firmware de los diferentes
módulos que integran la máquina
▪ All. Para consultar toda la información (General,
software y hardware)
• #a#b#
b. En formato JSON se muestra la información solicitada
como se puede ver en los siguientes ejemplos:
Ejemplo 1. Consulta sobre información general de una máquina
CashlogyPOS1500X-EU.
66
Ejemplo 2. Consulta sobre información de software de una máquina
Ejemplo 3. Consulta sobre información de hardware de una máquina

67
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
Con el mismo formato que en los ejemplos anteriores, nos daría información
en este orden de General, Hardware y Software.
6.3.2.4.5 #O# Mantenimiento (con pantallas)

Este comando permitirá al usuario desde una pantalla de CashlogyConnector
reinicializar el contador de aviso de mantenimiento de la máquina e indicar
que se ha hecho limpieza de correas.
68
- Cadena que se envía: #O#a#
• #a#
Ejemplo 1. Consulta de mantenimiento con pantallas de CashlogyConnector
(se muestran las pantallas anteriores)

Cadena enviada → #O ‘=Consulta mantenimiento’#1’=Ver pantallas de
CashlogyConnector por delante del resto’#
Respuesta de Cashlogy Connector  #0 ‘=Sin error en la ejecución’#
6.3.2.4.6 #W# Mantenimiento sin pantallas:

Comando que permite consultar o reinicializar el contador de mantenimiento
sin mostrar pantallas de CashlogyConnector.
- Cadena que se envía: #W#a#
o a será 0 Si se desea consultar el número de ciclos que quedan
hasta el mantenimiento (la cadena que debe devolver Connector
es ese valor), 1 si se desea resetear el contador de ciclos y 2 si
desea informar que se ha hecho una limpieza o cambio de
correas.

• En caso de enviar #W#0#
▪ #a#b#
69
b. Número de billetes que faltan hasta el
mantenimiento si se ha enviado 0
• En caso de enviar #W#1# o #W#2#
▪ #a#b#
b. En caso de que se haya solicitado el reseteo del
contador, este parámetro se devolverá vacío.
Ejemplo 1. Mostrar mantenimiento sin pantallas.

Cadena enviada → #W ‘=Consulta mantenimiento (sin pantallas)#0’=consulta
billetes faltantes’#
Respuesta de Cashlogy Connector  #0 ‘=Sin error en la ejecución’#5
‘=faltan 5 billetes para la realización del mantenimiento’#
Cadena enviada → #W ‘=Consulta mantenimiento (sin pantallas)#1’=reset
mantenimiento’#
Respuesta de Cashlogy Connector  #0 ‘=Sin error en la ejecución’#”Vacío”
‘=ejecución del comando’#
Es obligatoria la integración de este comando o el

anterior en su software TPV.
Para la integración sin pantallas se recomienda consultar este

comando una vez al día (#W#0#), y en caso de que la
respuesta sea menor de 10, mostrar un mensaje en pantalla al
usuario recordándole que debe de realizar un mantenimiento de
usuario, con las opciones de realizar el mantenimiento más
adelante (se volvería a sacar el mensaje al día siguiente) o la
opción de resetear el contador porque ya se ha realizado el
mantenimiento (#W#1#) y (#W#2#). En esta última opción se
recomienda mostrar un mensaje para confirmar que se ha
realizado el mantenimiento.
70
6.3.2.4.7 #L# Ver logs:
Esta pantalla permite analizar con el máximo detalle el funcionamiento del

programa T.P.V. y el dispositivo mostrando una pantalla de CashlogyConnector
con los siguientes registros:
1.- El LOG de transacciones.
2.- El LOG de comunicación.
3.- El LOG de errores.
- Cadena que se envía: #L#a#
• #a#
6.3.2.4.8 #K# Poner a cero todas las monedas:

Este comando permite al usuario borrar la contabilidad de monedas, aunque
se recomienda el uso del comando “vaciado” para asegurar que no haya
monedas.
71
- 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
• #a#b#c#
b. Importe total disponible al ejecutar el comando.
c. Importe total disponible después de ejecutar el
comando.
6.3.2.4.9 #INFO# Obtener información resolución incidencias:
Mediante este comando, se obtendrá links a manuales y videos para obtener

información sobre resolución de incidencias.
72
- Cadena que se envía: #INFO#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 caso de haber enviado el parámetro a=0 o a=1
• En caso de haber enviado el parámetro a=2
b. Separados por “|” los diferentes links, ejemplo:
6.3.2.5 CONSULTA DE ERRORES
En una integración mostrando pantallas de CashlogyConnector,

CashlogyConnector mostrara mensajes de error y videos de ayuda para
resolver incidencias y realizar operaciones de mantenimiento. Por ello no es
necesario realizar la integración de los comandos de consulta de error en
integración avanzada o personalizada. Si aun así se desea realizar la
integración, para consultar los errores de la máquina utilizaremos los
siguientes comandos:
6.3.2.5.1 #?#SHOW# Mostrar errores.
En caso de que en la configuración de CashlogyConnector, se haya decidido

que CashlogyConnector no muestre directamente los errores, (ver apartado
6.1, parámetro “ver errores de tipo 0,1,2,3”), este comando permitirá al
software TPV mostrar errores al usuario creados por CashlogyConnector
cuando así lo estime oportuno, sin necesidad de crear sus propios mensajes y
llamadas a los videos de error de CashlogyConnector con los datos obtenidos
en el comando “Detalle del error”.
- Cadenas que se envían, pueden ser dos:
• #?#SHOW#,
• #?#SHOWALL#
73
Ciertos errores son mostrados por CashlogyConnector con una determinada
frecuencia en lugar de en cada operación (por ejemplo avisos de suciedad),
SHOWALL permitirá mostrar de nuevo todos los errores aunque no haya
transcurrido este tiempo, SHOW solamente mostrará aquellos errores que no
han sido mostrados en este tiempo o son fácilmente recuperables por el
usuario (por ejemplo, puerta abierta).
• #a#b#
b. Número de errores visualizados.
• #ER:BUSY#, CashlogyConnector está ocupado.
• #ER:ILLEGAL#, CashlogyConnector no está inicializado
Ejemplo 1. Mostrar todos los errores

Cadena enviada → #? ‘=Consulta de errores’#SHOWALL’=Mostrar todos los
errores’#
Respuesta de Cashlogy Connector  #0 ‘=Sin error en la ejecución’#1 ‘=Un
error mostrado’#
El usuario en la ejecución de este comando recibirá mensajes de error como el

del siguiente ejemplo, o si el error tuviera asociado un video de ayuda también
lo mostraría:
74
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.
En la integración de los diferentes comandos de

CashlogyConnector debe de tener en cuenta que la
comunicación se hace de manera síncrona, con lo que siempre
debe de esperar a la respuesta del comando anterior para
mandar el siguiente.
- Cadena que se envía: #?#

• #a#b#
b. Código de error (si son varios códigos los que se están
dando se devolverán todos separados por comas, ej:
#0#1100,1400#
Ejemplo 1. Consulta de error
75
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.
Ejemplo 2. Consulta de error durante un proceso de cobro, importe a cobrar

5000. ESTE EJEMPLO SE TRATA DE UN ERROR GRAVE QUE NO SE DEBE
DE COMETER.
Dónde:
> #B#0# #B '=iniciar admision'#0 '=no ver 2ª pantalla'#

< #0# Ejecución comando = OK
>#?# Consulta de error
< #0## #0 '=ejecución OK'#Vacío '=sin error’#
>#Q# Consulta importe admitido
< #0#500# #0 '=ejecución OK'#500 '=Importe admitido'#
>#?# Consulta de error
Consulta importe admitido sin esperar la respuesta de comando anterior, lo
>#Q#
cual es erróneo.
< #ER:BUSY# Respuesta al comando #Q# enviado sin esperar respuesta comando anterior.
Respuesta al comando #?# que todavía estaba en ejecución
< #0#6210#
#0 '=ejecución OK'#6210 '=error 6210’#
76
>#J# Finalizar admisión
#0#500# # 0 '=ejecución OK’#500 '=Importe admitido'#
#P '=Dispensar'#1210 '=importe a dispensar#0 '=pantalla 2º plano'#0 '=Sin

>#P#1210#0#0#0#
pantalla al pagar'#0 '=No devolver solo con monedas'#
# 0 '=Ejecución OK ‘#1210 '=Importe devuelto#0 '=importe añadido como

< #0#1210#0#
cambio durante la operación'#
En este ejemplo se han cometido dos errores graves:

- No se ha tenido en cuenta que el proceso es síncrono y se han
enviado comandos sin esperar la respuesta del anterior, y no se ha
gestionado la respuesta ER:BUSY.
- Se ha creído que la respuesta al comando de consulta de importe
admitido #Q# era 6210, lo cual era la respuesta al comando de
consulta de error #?# y por ello se ha solicitado finalizar la admisión
sin haber llegado todavía al importe a cobrar, y además al calcular el
importe a pagar no se ha tomado como importe admitido la
respuesta al comando #J# sino a lo que se creía era la última
consulta #Q#
6.3.2.5.3 #?#error# Detalle de error

Con este comando se podrá obtener información sobre uno o varios códigos de
error en concreto.
- Cadena que se envía: #?#error1,error2,…#c#
• Siendo a,b,… los diferentes códigos de error proporcionados
por el comando #?#
• El segundo parámetro si es 1, Connector devuelve de forma
relativa las rutas de los videos o imágenes. Se usará en el
caso de que estos no estén en la ruta por defecto, o se
encuentren en otro PC (integraciones con MiniPC). Si no se
envía parámetro, se envía vacío, o 0, Connector devolverá la
ruta completa por defecto.
• #a# info_error_1#info_error_2#...#
• Info_error_n, Para cada código de error, se enviaran 7
campos separados por | (barra vertical) de la forma
n|a|b|c|d|e|f:
▪ n, es el código del error (para confirmación por el
software TPV de que la información es para el error
esperado)
77
▪ 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
El formato del video e imagen se puede configurar en

CashlogyConnector_config (ver apartado 6.1
“Configuración” – formato de imagen/video)
Ejemplo 1: Consulta de los errores obtenidos en el ejemplo del apartado

anterior.
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
|Reciclador 1 funcionando en "Modo de

info error 1
Autoprotección". Mensaje principal descriptivo

c Usted puede seguir trabajando con la máquina del error
aunque no podrá hacer la recaudación del Reciclador
1. |
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.
78
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
b |Error 8910| Título del error

|Dispositivo de billetes no comunica. Compruebe la Mensaje principal descriptivo
c
correcta conexión del mismo.| del error
Mensaje adicional del error y
d|e|f| |||# ruta (no tiene ni video ni
imágenes asociadas)
Ejemplo 2. Misma consulta con rutas relativas.
En el archivo CashlogyConnector_Config.exe podrá configurar el formato en el

que desea recibir las rutas de los videos e imágenes (avi, jpg, png) Ver
apartado 6.1 de este manual
Ejemplo 3. Consulta de un código de error inexistente
6.3.3 INTEGRACIÓN COMPLETA O SIN PANTALLAS

Este modo de integración, permite una integración total de
CashlogyConnector en el software TPV, sin mostrar ninguna pantalla de
CashlogyConnector. Además, al ser la comunicación via socket TCP/IP, podrá
realizar la integración desde un dispositivo conectado en red con el PC
Windows donde esta CashlogyConnector. Esta arquitectura le permitirá
realizar integraciones con Sistemas Operativos diferentes a Windows.
En la siguiente tabla se muestra un resumen de los comandos que se deben

integrar:
INTEGRACIÓN COMPLETA
FINALIZAR** #E# 6.3.1.2.
INCIAR ADMISION #B# 6.3.2.1.1.
79
VER IMPORTE ADMITIDO #Q# 6.3.2.1.2.
FINALIZAR ADMISION #J# 6.3.2.1.3.
DISPENSAR #P# 6.3.2.1.4.
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.
DAR CAMBIO
DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
RETIRAR STACKER RETIRAR STACKER #S#2# 6.3.2.2.5.
AÑADIR CAMBIOS #A#2# 6.3.2.2.1.
CIERRE CAJA
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.
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
Para asegurar que no se muestra ninguna pantalla de CashlogyConnector en el

PC Windows, ya que este puede ser un MiniPC sin pantalla o ir integrado en la
máquina (CashlogyPOS1500X) se debe de realizar la siguiente configuración:
Seleccione el modo de trabajo sin pantallas en el archivo de configuración de

CashlogyConnector, por defecto en la ruta:
C:\Cashlogy\CashlogyConnector\ Cashlogyconnector_Config.exe
80
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
Es necesaria la configuración de ambas propiedades, ya que de

lo contrario, si solo se configurara una de ellas la máquina no
comunicaría correctamente.
81
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#
6.3.3.2 OPERACIONES DE COBRO

Para realizar operaciones de cobro sin pantallas de CashlogyConnector, deberá
de usar la combinación de los siguientes comandos tal y como se explica en el
apartado 6.3.2.1 de este manual.
- #B#: Inicializar admisión

- #Q#. Consulta importe admitido
- #J#. Finalizar admisión
- #P# Pago o devolución
Para llevar a cabo el proceso de cobro de una forma correcta se recomienda

usar los siguientes comandos:
- Preguntar errores al iniciar el proceso. 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#1#.
- Iniciar la admisión. Se enviará el comando #B#0#0#0# para iniciar de
forma asíncrona (se obtendrá respuesta a dicho comando
inmediatamente) el proceso de admisión.
- Se enviarán periódicamente los siguientes comandos:
o Cada 200msg. se preguntará por la cantidad introducida usando
el comando #Q#. Se refrescarán los importes introducido y
pendiente.
o Cada segundo se preguntará por los errores. 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#1#. La gestión de
errores se explicará en un punto independiente más adelante.
Aunque la respuesta es inmediata, se debe esperar la

respuesta a cada consulta antes de enviar el siguiente
comando, para no recibir como respuesta BUSY
- El sondeo anterior se prolongará hasta que se introduzca suficiente

crédito como para satisfacer el importe a cobrar, o bien, se cancele el
proceso.
- Si se cancela el proceso, se para el proceso de admisión enviando el
comando #J#. En la respuesta a este comando se informa de la
cantidad introducida final que puede ser diferente de la respuesta al
82
último comando #Q# (por ejemplo, si se cancela el proceso con
monedas o billetes en curso de admisión). Se refrescarán los importes
introducido, pendiente y a devolver.
o Podemos tener dos escenarios:
▪ Sin crédito introducido:
➢ La ventana se cerrará y volveremos a la pantalla
principal sin cerrar la venta.
▪ Con crédito introducido:
➢ Se devuelve la cantidad introducida usando el
comando #P#CantidadAdmitida#0#0#. Proceso
síncrono que no responderá hasta que termine la
devolución.
➢ Cuando termine, se preguntará por los errores. 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#1#.
principal sin cerrar la venta.
- Si se admite crédito por encima del importe a cobrar (o se introduce
importe exacto), se para el proceso de admisión enviando el comando
#J#. En la respuesta a este comando se informa de la cantidad
introducida final que puede ser diferente de la respuesta al último
comando #Q# (por ejemplo, si se para el proceso con monedas o
billetes en curso de admisión). Se refrescarán los importes introducido,
pendiente y a devolver.
o Podemos tener dos escenarios:
▪ Si la cantidad introducida es igual al importe a cobrar, y
por tanto, no hay que devolver nada:
➢ Se preguntará por los errores. 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#1#. La gestión de errores se
explicará en un punto independiente más adelante.
principal cerrando la venta.
▪ Si es superior al importe a cobrar:
➢ Se preguntará por los errores. 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
83
#?#Error1,…,ErrorN#1#. La gestión de errores se
explicará en un punto independiente más adelante.
➢ Se dispensa la cantidad “A devolver” usando el
comando #P#CantidadDevolver#0#0#. Proceso
síncrono que no responderá hasta que termine la
devolución.
➢ Cuando termine, se preguntará por los errores. 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#1#. La gestión de
errores se explicará en un punto independiente más
adelante.
principal.
6.3.3.3 OPERACIONES DE CAMBIO.
Para realizar las diferentes operaciones de cambio con el dispositivo, deberán

de ser integradas las combinaciones de comandos tal y como se muestra en la
tabla siguiente donde también puede ver la correspondiente sección de este
manual donde se explica cada comando.
COMANDOS SIN MOSTRAR PANTALLA DE

OPERACIÓN A REALIZAR SECCION DEL MANUAL
CASHLOGY CONNECTOR

DISPENSAR POR
RETIRAR EFECTIVO #U# 6.3.2.2.4.
DENOMINACIÓN
DAR CAMBIO FINALIZAR ADMISION #J# 6.3.2.1.3.
DISPENSAR POR
#U# 6.3.2.2.4.
DENOMINACIÓN
DISPENSAR POR
#U# 6.3.2.2.4.
DENOMINACIÓN
CIERRE CAJA
- El proceso de añadir cambios se realizará con la función #A#2# y no

con el comando #B# ya que de lo contrario, si la máquina está vacía no
84
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
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
- 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#.
6.3.3.4 REVISIÓN DE CONTABILIDADES.

Para realizar las diferentes operaciones de revisión de contabilidades, deberán
de ser integrados los comandos descritos en la tabla siguiente donde también
85
puede ver la correspondiente sección de este manual donde se explica cada
comando.
COMANDOS SIN MOSTRAR PANTALLA DE CASHLOGY CONNECTOR SECCION DEL MANUAL

6.3.3.5 OPERACIONES DE MANTENIMIENTO
Para realizar las diferentes operaciones de mantenimiento, deberán de ser

integrados los comandos descritos en la tabla siguiente donde también puede
ver la correspondiente sección de este manual donde se explica cada
comando.
CONSULTA DE VERSIONES Y NÚMEROS DE SERIE (integración no 6.3.2.4.4.

#GV#
obligatoria)
- El proceso de vaciado completo, se realizará con el parámetro b=2,

#V#2#. 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
o Al finalizar se procederá a la consulta de los errores.
86
6.3.3.6 MOSTRAR ERRORES
En la integración sin pantallas, será obligatorio dar la información sobre los

errores de la máquina y mostrar los videos o imágenes de ayuda para resolver
los errores.
Para ello deberá de integrar los siguientes comandos siguiendo las

indicaciones descritas en este manual en su sección correspondiente.
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.
87
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.
6.4 PANTALLAS DE INFORMACIÓN DE ERRORES:

En caso de que durante la ejecución de alguno de los comandos se detectara
alguna alerta o error en el dispositivo, en la parte superior de la pantalla
correspondiente a ese comando se mostrará uno de los siguientes iconos:
Si se detecta una alerta, se mostrará el icono:
Si se trata de un error, se mostrará el icono:
Si hay falta o exceso de cambio:
Al hacer click en el icono, se presenta otra nueva pantalla que muestra una
lista detallada de alertas y/o errores:
88
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:
89
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:
90
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:
Si mientras se está ejecutando algún proceso, la máquina detecta algún

error, le presentará una pantalla con un texto descriptivo del error y cómo
actuar mediante un texto, imagen o vídeo explicativos.
Estos mensajes de error pueden ser configurados, activados o

desactivados por un usuario avanzado mediante el programa
CashlogyConnector_Config en la opción “Ver pantalla de error”.
91
7 CHECKLIST INTEGRACIÓN.
Una vez finalizado el proyecto de integración, será necesario pasar el proceso

de certificación de la integración en el fabricante.
Para ello se deberá hacer llegar al fabricante el instalable o bien el equipo
preinstalado. Durante el proceso de certificación se seguirá el checklist
mostrado a continuación por lo que se aconseja que el integrador lo haya
comprobado y realizado previamente de manera intensa. En Azkoyen RBH500
se realizará el test solamente en lo referente a billetes y en Azkoyen RCH8 las
pruebas referentes a monedas
IMPORTANTE: La relación de pruebas a las que se someterá al software será:
VENTAS
REQUISITO
PRUEBA EXPLICACIÓN
CERTIFICACIÓN
Verificar si se usa botón propio para añadir cambios que se usa
Añadir cambios con comando #A#
comando #A# Obligatorio
Realizar varias compras intentando que se devuelva distintas
Realización de pagos con monedas cantidades de monedas billetes verificando que coincide la
y billetes devolución, verificar si tiene contabilidad propia que se ha
contabilizado todo Obligatorio
Realizar una venta de 11,12€ pagando con billete de 50€. La

Duración de ventas duración de esta operación desde que se recibe la orden de
pago hasta que finaliza debe ser inferior a 16,8 segundos.
Obligatorio
Vaciar mediante BackOffice u otro apartado del programa
monedas de 1 y 2 céntimos totalmente y hacer una venta, en la
No tener cambios para terminar una
que tenga que devolver alguna de esas monedas. Mostrará
venta
ventana de añadir cambios. Añadir cambios y verificar que la
venta termina ok Recomendado
llenar los Hopper de 1 y 2 céntimos vaciados y verificar que

Llenar Hopper, y comprobar que
funciona correctamente y no se queda ningún error de cambio
pague bien
en la aplicación
Obligatorio
Usa comandos #C# o #P# para ventas. En caso de error en un

Error al devolver, termina el pago
devolvedor, usando estos comandos Cashlogy recalcula el
correctamente por otro medio
pago para pagar con otro ítem.
Obligatorio
Cancelar la venta tras haber insertado dinero. Tiene que
devolver el dinero introducido.
Cancelar operaciones
Cancelar la venta antes de introducir dinero.
En ambos casos la venta debe permanecer abierta. Obligatorio
Retirar manualmente las monedas de 1 y 2 céntimos. Realizar
una venta en la que tiene que devolver alguna de estas
Forzar que no pueda completar un
monedas. La devolución no finalizará y se enviará un error
pago (quitando monedas) y no
ER:GENERIC. No añadir cambio y comprobar que la aplicación
añadiendo cambio, comprobar
muestra error de pago incompleto, indicando el importe que
comportamiento
falta por devolver. La venta debe de cerrarse ya que se ha
introducido dinero, ha sido un error en la devolución. Obligatorio
Abonos Permite realizar abonos.
Recomendado
CASHLOGY CONNECTOR
92
REQUISITO
PRUEBA EXPLICACIÓN
CERTIFICACIÓN
Lanzar automáticamente
verificar que la aplicación lanza el software Connector cuando
CashlogyConnector al arrancar
inicia
aplicación Obligatorio
Mantener el socket abierto mientras
No cerrar el socket entre transacciones
dure la conexión Obligatorio
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 Obligatorio
Permite adelantar pago verificar si está siempre en modo de admisión Personalizable
Consulta importe admitido en modo En pago anticipado, consulta comando #Q# al menos cuatro
pago anticipado veces por segundo. Obligatorio
Muestra menú Back Office Personalizable
Permite la operación “Dar cambios” ya sea dentro del menú
Tiene función “dar cambios” back office de Connector, en acceso directo usando pantallas
de Connector, o usando pantallas propias. Recomendado
Muestra la contabilidad de la máquina ya sea dentro del menú
Tiene función “estado de Cashlogy” back office de Connector, en acceso directo a la función Estado
(muestra contabilidad) de Cashlogy usando pantallas de Connector, o usando
pantallas propias. Obligatorio
Tiene la opción “retirar efectivo” ya sea dentro del menú back
Tiene función “retirar efectivo” office de Connector, en acceso directo usando pantallas de
Connector, o usando pantallas propias. Recomendado
Tiene la opción “retirar stacker” ya sea dentro del menú back
Tiene función “retirar stacker” office de Connector, en acceso directo usando pantallas de
Connector, o usando pantallas propias. Obligatorio
Tiene la opción de recaudar ya sea dentro del menú back office
Tiene función “cierre de caja” de Connector, en acceso directo usando pantallas de
(recaudación) Connector, o usando pantallas propias, en cuyo caso los
billetes deben de ir a stacker. Obligatorio
Tiene la opción “vaciado completo” ya sea dentro del menú
Tiene función “vaciado completo” back office de Connector, en acceso directo usando pantallas
de Connector, o usando pantallas propias. Obligatorio
Tiene la opción “mantenimiento” ya sea dentro del menú back
Tiene función “mantenimiento” office de Connector, en acceso directo usando pantallas de
Connector, o usando pantallas propias. Obligatorio
verificar si en una venta corta automáticamente al llegar al
Mostrar botón aceptar en cobros o
importe o hay que hacerlo manualmente. Se recomienda que
corte automático
cierre al llegar al importe. Recomendado
Aceptar cobro manual ¿Tiene la posibilidad? Recomendado
Aceptar cobros parciales ¿Tiene la posibilidad? Recomendado
Integración exprés o completa Personalizable
COMPROBACIÓN DE ERRORES
REQUISITO
PRUEBA EXPLICACIÓN
CERTIFICACIÓN
Mostrar errores por pantalla Mostrar errores Connector Obligatorio
Mostrar aviso tras fallo conexión
Muestra aviso cuando no hay conexión
Cashlogy Obligatorio
Mostrar errores tras pagos
Muestra el error
incorrectos Obligatorio
Mostrar videos tras atascos, por ejemplo, introducir un objeto
Mostrar vídeos en sensor de monedas bloqueando el paso e introducir
monedas para que se atasquen. Debe aparecer el vídeo Obligatorio
Detección puerta de monedas
mostrar error con la puerta de monedas abierta
abierta Recomendado
93
Detección puerta de billetes abierta mostrar error con la puerta de billetes abierta Obligatorio
Desconexión de cualquier módulo y
comprobar que lo indica el Desconectar un módulo y comprobar que muestra los errores
programa Obligatorio
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 Obligatorio
COMANDOS SIN VENTANAS (INTEGRACION COMPLETA)
REQUISITO
PRUEBA EXPLICACIÓN
INDISPENSABLE
Mostrar los errores tras finalizar
Tras finalizar un pago revisar y mostrar los errores
pagos Obligatorio
Comprobar errores cada segundo.
Enviar comando #?# una vez por segundo y comprobar errores.
Comando #?# Recomendado
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 Obligatorio
Mostrar aviso para que se retire el stacker cuando se pulse
Retirada de stacker, mostrar aviso
retirar Stacker Obligatorio
Verificar que la aplicación Cashlogy
Verificar que Connector es lanzado con prioridad normal
monitor es lanzada al iniciar el
(tareas Windows)
MiniPC Obligatorio
Forzar el cierre del
Verificar que el CashlogyMonitor lo vuelve a lanzar
CashlogyConnector Obligatorio
Apagar MiniPC quitando Aplicación debe mostrar error de comunicación y MiniPC se
alimentación y reiniciar debe recuperar al iniciar Obligatorio
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
las opciones de integración y consultar las cadenas enviadas y recibidas en el
logcom situado en la carpeta …\CashlogyConnector\logs\LogCom_fecha.txt.
94
Así mismo se proporciona un ejemplo en VB de cómo debe realizarse la
comunicación:
Conexión con CashlogyConnector:
▪ Winsock1.Connect "127.0.0.1", 8092
Llamada a la función de “Inicializar”
▪ Winsock1.SendData "#I#"
Llamada a la función “Ver estado”:
▪ Winsock1.SendData "#D#1#”
Cuando recibe la información del CashlogyConnector:
▪ Private Sub Winsock1_DataArrival(ByVal bytesTotal As Long)
▪ Dim datos As String
▪ Winsock1.GetData datos
▪ End Sub
95
ANEXO 1 INDICE Y RESUMEN DE COMANDOS
En este anexo se muestra un resumen de los diferentes comandos con el

número de apartado donde se explica su función en este manual. Así mismo,
se hace una relación entre los comandos que muestran pantallas de Cashlogy
Connector y los que no muestran pantallas.
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.
Para hacer una integración exprés, es obligatorio la implementación de al

menos los comandos #I#, #E#, #C#, y #G#, en este último al menos un
usuario deberá de tener acceso a todas las funcionalidades.
INTEGRACIÓN EXPRESS
NOMBRE COMANDO SECCION MANUAL
FINALIZAR #E# 6.3.1.2.
BACK OFFICE #G# 6.3.1.4.
COBRAR #C# 6.3.1.3.
El desarrollador de software podrá personalizar la integración implementando

individualmente los comandos de back office que estime oportuno, y utilizando
los comandos sin pantallas para crear su propio interfaz siguiendo este cuadro.
INTEGRACION AVANZADA O PERSONALIIZADA
(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#
INCIAR ADMISION #B#
VER IMPORTE ADMITIDO #Q#
COBRAR #C#
DISPENSAR #P#
AÑADIR CAMBIOS #A# AÑADIR CAMBIOS
#A#2#
#G#
DISPENSAR POR
RETIRAR EFECTIVO #R# DENOMINACIÓN #U#
96
AÑADIR CAMBIO
#A#2#
VER IMPORTE ADMITIDO

#Q#
DAR CAMBIO #H#
FINALIZAR ADMISION
#J#
DISPENSAR POR
DENOMINACIÓN #U#
RETIRAR STACKER #S# RETIRAR STACKER

#S#2#
DISPENSAR POR
DENOMINACIÓN #U#
AÑADIR CAMBIOS
CIERRE CAJA #F# #A#2#

#Q#
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
#G# VER LOGS #L# Sin alternativa
PONER A CERO LAS PONER A CERO LAS MONEDAS
#K#1# #K#2#
MONEDAS (integración no obligatoria)
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…#
97
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
FINALIZAR** #E# 6.3.1.2.
INCIAR ADMISION #B# 6.3.2.1.1.
DISPENSAR #P# 6.3.2.1.4.
RETIRAR EFECTIVO DISPENSAR POR DENOMINACIÓN #U# 6.3.2.2.4.
DAR CAMBIO
CIERRE CAJA
CONSULTA DE VERSIONES Y NÚMEROS DE SERIE (integración no
#GV# 6.3.2.4.4.
obligatoria)
GESTION DE ERRORES
98
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#
COBRAR (CON PANTALLAS)

ENVIO RESPUESTA
#C#a#b#c#d#e#f#g#h#i#j#k# #a#b#c#d#e#
a Número de operación a Error en ejecución
b Código de caja b Importe cobrado automático
c Importe a cobrar c Importe devuelto
d Mostrar segunda pantalla d Importe cobrado manual
e Posición X 2ª pantalla e Cambios añadidos.
f Posición Y 2ª pantalla
g Ver botón aceptar
h Aceptar cobro parcial
i Mostrar pantalla por delante
j Introducción centimos manual
k Botón cobro manual
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
99
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
RECARGA MANUAL 1 CÉNTIMO

ENVIO RESPUESTA
#1#a# #a#b#
RETIRAR EFECTIVO
ENVIO RESPUESTA
#R#a# #a#b#
b Importe retirado
RETIRAR STACKER
ENVIO RESPUESTA
#S#a# #a#b#
b Importe retirado
DAR CAMBIO
ENVIO RESPUESTA
#H#a# #a#b#c#
c Importe retirado
100
CIERRE / FONDO DE CAJA
ENVIO RESPUESTA
#F#a# #a#b#c#d#
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

ENVIO RESPUESTA
#Q# #a#b#
FINALIZAR ADMISIÓN
ENVIO RESPUESTA
#J# #a#b#
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
DISPENSAR POR DENOMINACION

ENVIO RESPUESTA
#U#a#b#c#d# #a#b#
a Items a devolver a Error en ejecución
101
b Billetes a stacker b Items devueltos
c Mostrar pantalla por delante
d Mostrar pantalla
IMPORTE TOTAL EN CASHLOGY

ENVIO RESPUESTA
#T# #a#b#c#
b Importe en recicladores
c Importe en stacker
CANTIDAD DE UNA DENOMINACIÓN

ENVIO RESPUESTA
#X#a# #a#b#c#
a Denominación a consultar a Error en ejecución
b Cantidad en recicladores
c Cantidad en stacker
CANTIDAD DE TODAS LAS DENOMINACIONES

ENVIO RESPUESTA
#Y# #a#b#c#
b Cantidad en recicladores
c Cantidad en stacker
ESTADÍSTICAS ABSOLUTAS
ENVIO RESPUESTA
#M#a# #a#
ESTADÍSTICAS RELATIVAS
ENVIO RESPUESTA
#N#a# #a#
VACIADO COMPLETO
ENVIO RESPUESTA
#V#a#b# #a#b#
b Sólo monedas b Importe retirado
102
PONER A CERO LAS MONEDAS
ENVIO RESPUESTA
#K#a# #a#b#c#
b Importe antes de ejecutar
c Importe tras ejecutar
MANTENIMIENTO (CON PANTALLAS)

ENVIO RESPUESTA
#O#a# #a#
MANTENIMIENTO (SIN PANTALLAS)

ENVIO RESPUESTA
#W#a# #a#b#
a Consulta o reset a Error en ejecución
b Billetes faltantes o reset
VER LOGS
ENVIO RESPUESTA
#L#a# #a#
ERROR
ENVIO RESPUESTA
#?# #a#b#
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
103
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#
NIVEL DE CADA DENOMINACIÓN

ENVIO RESPUESTA
#GC# #a#b#c#
a Ejecución
b Nivel llenado
c Porcentaje llenado
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
104

CashlogyConnector Manual - Integracion - v2.3

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

CashlogyConnector Manual - Integracion - v2.3

Cargado por

Copyright:

Formatos disponibles

CASHLOGY

La información contenida es válida excepto posibles errores de impresión.

CashlogyConnector no se responsabiliza de los daños o pérdidas que puedan

ocurrir por el uso de estas instrucciones.

CashlogyConnector no se responsabiliza de las pérdidas o exigencias por parte de terceros

A partir de ahora, en este manual se utilizará el término TPV

El objetivo de este manual consiste en proporcionar toda la información

2.1 PRODUCTOS COMPATIBLES.

3 DESCRIPCIÓN DEL FUNCIONAMIENTO.

4 REQUISITOS MÍNIMOS DEL DISPOSITIVO TPV

El módulo servidor CashlogyConnector se está ejecutando y atiende las

En caso de instalar CashlogyMonitor, CashlogyConnector.exe

Cuando la aplicación T.P.V. necesita que el dispositivo realice una operación,

5.2 DIFERENTES ARQUITECTURAS.

5.2.1 TPV Windows.

5.2.2 Conexión a Cashlogy POS1500X o un MiniPC.

Gracias a la arquitectura de CashlogyConnector, en la que la conexión

*_Esquema válido para cualquier dispositivo compatible con

Los requisitos mínimos recomendados de este MiniPC son:

Para realizar la conexión deberá de integrar todos los comandos

5.3 MODELOS DE INTEGRACIÓN.

5.3.1 Integración exprés:

5.3.2 Integración Completa o sin pantallas de

5.4 CONEXIÓN E INSTALACIÓN.

Este instalador será proporcionado por Azkoyen y se podrá descargar desde

ii. Seleccionar idioma, aceptar el acuerdo de licencia, seleccionar la

iii. Seleccionar los productos a instalar,

vi. Configurar CashlogyConnector. (ver sección 6.1, configuración)

5.4.1 Conexión e instalación en un MiniPC

El MiniPC debe de llevar instalado el software correspondiente de

En este MiniPC deberá de estar instalado el driver correspondiente del

De esta manera nos aseguramos que ninguna pantalla de

Al estar trabajando desde un TPV en el que CashlogyConnector no está

Una vez realizada la conexión e integración con el software, se

En caso de que se modifique la configuración del driver o de

En caso de que el equipo no arrancara y no conectara a la red, se

5.5 RECOMENDACIONES DE CONEXIÓN

Se recomienda mantener la conexión socket siempre

Donde seleccionamos el idioma de CashlogyConnector y la máquina con la que

▪ En el campo “Nombre” se presenta el nombre de la máquina. Este

En la ventana “Monedas y billetes” guarda la información relativa a los

Cuando hayamos ajustado los valores de los parámetros a nuestro modelo de

6.2 CÓDIGOS DE ERROR:

Estos códigos no hacen relación a un posible estado de error

▪ #0# si no hay error en la ejecución del comando.

▪ #ER:xxxx#: En caso de errores en la ejecución del comando.

Se divide la explicación de los comandos entre los diferentes tipos de

Todas las cifras serán expresadas en la unidad mínima de

6.3.1 INTEGRACIÓN EXPRÉS.

Los comandos que se deben de integrar son los siguientes:

6.3.1.1 #I# Comando de Inicializar la máquina:

6.3.1.2 #E# Finalizar la aplicación CashlogyConnector:

6.3.1.3 #C# Cobrar:

La función cobro no admite cobros negativos, siempre cogerá el valor

Al recibir la respuesta de CashlogyConnector además de

Se deberá comprobar si el usuario ha introducido cambios

Donde cada parámetro indica lo siguiente

Cadena enviada → #C#TB232#Caja 7#499#1#17000#1500#0#0#1#0##

#C’=Comando a cobrar’#TB232’=Número de operación’#Caja 7’= Código de

Al no tener inicialmente cambios cuando se ha hecho el pago, al usuario le ha

De las tres opciones planteadas:

6.3.1.4 #G# BackOffice:

En la integración de este comando se deberá tener en cuenta