Clau.io en el POS - clientes, beneficios de lealtad, gift cards y pedidos del e-commerce

Aplica a Invu POS 6.10.1 en iPad, Android y Windows, con la integración de Clau.io activa.

Antes de empezar (administrador)

En el Panel Administrativo, entra a Configuración > Sistema > Configuraciones, toca Habilitar Botón de Guardar y elige Integraciones/Loyalty en el índice:

1. Llena los tres campos: URL de Integración CLAU.IO, API Key de CLAU.IO y App ID de CLAU.IO. Si falta uno, el POS no activa Clau. La URL debe terminar en /.
2. Opcional: activa Mostrar beneficios de lealtad automáticamente para que la pantalla de beneficios se abra sola al cobrar a un cliente de Clau.
3. Guarda con Guardar Cambios.
4. En cada POS, mantén presionado el logo de Invu y elige Actualizar Data para cargar la configuración.

Permisos: en Configuración > Usuarios y Roles > Roles de POS, da a cajeros o supervisores el permiso para aplicar beneficios de lealtad y, si van a asociar clientes, el de agregar cliente. Si el empleado conectado no tiene el permiso, el POS pide el PIN de alguien que sí lo tenga.

1. Buscar al cliente y asociarlo a la orden

1. Dentro de la orden, toca el encabezado (número o mesa). Se abre Información del Pedido.
2. Toca la fila del cliente (<No se ha añadido cliente> si aún no tiene).
3. En la lista Clientes, toca la lupa y luego el ícono de Clau (arriba a la derecha). Se abre Buscar Cliente en Clau.io.
4. Escribe el correo o el ID de lealtad del cliente y toca Buscar. También puedes usar Iniciar Escaneo para leer el QR del cliente con la cámara, o el ícono de NFC.
5. Al elegir al cliente, vuelves a Información del Pedido. Ciérrala con Hecho.

• En Buscar Cliente en Clau.io, todo lo que no sea un correo se busca como ID de lealtad. Un teléfono o una cédula no lo van a encontrar ahí: para buscar por teléfono o identificación, usa la búsqueda normal (Buscar Cliente), que también consulta a Clau.
• El ID de lealtad del POS corresponde al campo Texto Generico 5 de la ficha del cliente en Clau.
• Si el cliente no existe, créalo con + (Nuevo Cliente) en la lista Clientes. Al agregarlo a una orden, el POS lo registra en Clau automáticamente.
• Cliente de lealtad: debajo de la fila del cliente puedes elegir otro Cliente de lealtad, para que los puntos y beneficios vayan a otra persona sin cambiar el cliente de la factura.

2. Aplicar beneficios, códigos y puntos

1. Toca Pagar Orden.
2. En la pantalla de pago, toca Aplicar ofertas. Se abre Lealtad, con el nombre, el correo, los Puntos:, los Códigos:, el Intercambio de Puntos (los puntos en dinero) y la lista de regalos o beneficios del cliente.
   • Si la orden no tiene cliente, Aplicar ofertas abre primero Buscar Cliente en Clau.io.
3. Elige lo que quieras aplicar:
   • marca los regalos o beneficios de la lista;
   • toca Aplicar Código para ingresar un cupón o código de promoción;
   • toca Pagar con Puntos si el cliente quiere usar sus puntos.
4. Toca Hecho. Si te lo pide, ingresa el PIN de un empleado con permiso para aplicar beneficios.

Si Clau rechaza un código o un beneficio, aparece un mensaje de Error y no se aplica ningún beneficio de Clau en esa orden mientras el código siga ahí. Toca Eliminar Descuento y luego Hecho para quitarlo, y vuelve a elegir lo que sí aplica.

• Los beneficios de Clau no se aplican a una línea que ya tiene un descuento del POS. Si quieres que una línea reciba el beneficio de Clau, no le pongas un descuento manual.
• Los beneficios automáticos que Clau tenga configurados se aplican solos al tocar Pagar Orden.

Puntos al cerrar la orden

Al cerrar la orden, el POS envía la compra a Clau y el comprobante muestra Puntos por compra y Puntos Acumulados. Si Clau tarda más de 9 segundos en responder, el comprobante dice Pending. El POS no vuelve a enviar la compra: si los puntos no aparecen en Clau, escríbenos con el número de la orden.

3. Gift cards de Clau

Configuración (administrador):

• Para vender, activar o recargar tarjetas, crea ítems con Tipo de Ítem = Gift Card Clau - Compra, Gift Card Clau - Activar o Gift Card Clau - Recarga (Panel Administrativo > Menú).
• Para cobrar con gift card, crea un tipo de pago en Configuración > Pagos, Descuentos e Impuestos > Tipos de Pago con el Tipo de POS de GiftCards Clau. La casilla Usar como Pago (Desactivar para descuento) decide si el saldo usado cuenta como pago (marcada) o como descuento (desmarcada).

En el POS:

• Gift Card no encontrada al activar: la tarjeta no existe o ya está activa. Solo se pueden activar tarjetas inactivas en Clau.
• Gift Card Usada: ya usaste esa tarjeta en la misma orden.
• El monto de la tarjeta de regalo ha sido excedido, solo se han aplicado …: el saldo no alcanza; cobra el resto con otra forma de pago.
• Las reglas de cada tipo de tarjeta (uso único, una sola recarga) las aplica Clau, no el POS.

4. Pedidos del e-commerce de Clau

Requisito: en Configuración > Sistema > Configuraciones, sección Delivery del índice, elige la Caja Registradora de Delivery. Los pedidos solo llegan al POS que tiene abierta esa caja; en ese equipo aparece la pestaña Clau.io junto a Abiertas y Cerradas.

• El POS revisa pedidos nuevos cada 30 segundos y avisa con Nueva Orden (con sonido en iPad y Android; en Windows no suena).
• Si activaste Imprimir órdenes de Clau automáticamente, la comanda de los pedidos sin mesa se imprime sola.
• Si falta un pedido, mantén presionado el logo y elige Sincronizar Ordenes de Ecommerce: busca los pedidos de las últimas 24 horas (la revisión automática solo mira la última hora).
• Cambiar el estado del pedido en Clau: dentro de la orden, toca el logo de Invu, elige Clau.io y luego el estado (Recibida, Confirmada, Listo para retirar, En camino, Entregado, Cancelado…). Para que cambie solo con acciones del POS (comandar, cerrar, eliminar), configura Eventos de estado Clau en Integraciones/Loyalty.
• Si el pedido llega con modificadores incorrectos, el problema viene de cómo el pedido se creó en Clau: el POS muestra lo que recibió. Después de cambiar ítems o modificadores en Invu, sincroniza el catálogo con Clau (botón Sincronizar Información en Integraciones/Loyalty) y escríbenos si sigue pasando.

Problemas frecuentes

• No aparece el ícono de Clau en Buscar Cliente. Falta la URL, la API Key o el App ID, o el POS no tiene la configuración nueva: haz Actualizar Data.
• La pantalla Lealtad se queda cargando. Clau no respondió o no encontró al cliente. Revisa el internet y que el cliente esté bien asociado a la orden.
• Hecho muestra "Error desconocido". Puede faltar en tu cuenta el descuento que Invu usa para registrar los beneficios de Clau. Escríbenos.
• Pagar con Puntos no cambia. La tasa de puntos de tu programa en Clau está en 0.
• No aparece la pestaña Clau.io. Ese equipo no tiene abierta la Caja Registradora de Delivery.
• Sincronizar Información no muestra ningún mensaje. Es normal: al terminar solo desaparece el indicador de carga.