Panel de integraciones POS

El panel Integraciones con tu punto de venta te permite conectar tu POS directamente desde el dashboard, sin escribir código. Una vez conectado, cada venta que registra tu POS llega a Xtarly y suma puntos o sellos al cliente automáticamente.

Lo encuentras en Configuración → Integraciones dentro de tu organización.

Cómo conectar tu POS

1. Abre Configuración → Integraciones y busca tu POS por nombre en el catálogo.
2. Haz clic en Conectar.
3. Según el POS, autoriza con un clic (OAuth) o pega las credenciales que te pide el formulario (token, o clave y secreto de la API de tu POS).
4. Si tu POS soporta webhooks, Xtarly los registra automáticamente o te muestra una URL única para pegar en la configuración de tu POS.
5. Listo: el POS aparece como Conectado y en la sección Ventas recibidas verás llegar cada cobro con su estado.

Conectar con un clic (OAuth)

Algunos POS permiten autorizar sin copiar credenciales. Mercado Pago es el caso más común: haz clic en Conectar con Mercado Pago, autoriza con tu cuenta y regresas al panel ya conectado. Si el panel te muestra el botón Conectar con… para tu POS, ese es el camino corto; siempre queda disponible la opción «Prefiero pegar mi token» para hacerlo a mano.

POS con conector automático

Hoy hay 15 conectores automáticos en el catálogo, además de la integración nativa con XtarlyPOS.

* Las terminales de pago (Mercado Pago, Clip, SumUp) y Epos Now no envían la identidad del pagador. Para acreditar esas ventas usa el match por QR (abajo); mientras tanto quedan como «Sin asignar».

† En Bsale el enlace con tu clienta es el teléfono de su ficha de cliente: Bsale no tiene campo de nota libre en el documento, así que un ticket a Público en General o a una ficha sin teléfono se registra pero no acredita puntos a nadie.

SICAR (con Xtarly Bridge, beta)

SICAR Punto de Venta es un sistema de escritorio: vive en una PC de tu negocio y no tiene una API en internet a la que Xtarly pueda conectarse. Por eso la integración funciona con Xtarly Bridge, un programa nuestro que se instala en la PC servidor de SICAR (la que guarda la base de datos), lee las ventas y las envía a Xtarly.

1. En Configuración → Integraciones, abre SICAR Punto de Venta y haz clic en Conectar (no pide credenciales).
2. Xtarly te muestra tu enlace de vinculación. Descarga Xtarly Bridge (te mandamos el instalador durante la beta) e instálalo en la PC servidor de SICAR.
3. Pega el enlace en el asistente de Xtarly Bridge. A partir de ahí, las ventas cobradas en SICAR llegan a la sección Ventas recibidas.

Qué necesitas saber antes de empezar:

• Cómo ligar la venta a la clienta. Escribe el celular, el correo o escanea la tarjeta de la clienta en el botón Comentario de la venta. En efectivo también puedes usar la referencia del cobro. Con tarjeta o transferencia, la referencia es del banco: usa Comentario. No hace falta dar de alta a la clienta en SICAR, y lo demás que escribas en el Comentario no se envía a Xtarly. Que el botón Comentario llegue a Xtarly lo confirmamos contigo con tu primera venta real durante la beta, igual que la tarjeta real con tu lector.
• Prioridad: la tarjeta gana; después, el celular o correo del Comentario; después, el de la referencia del cobro; y si no hay nada, el cliente asignado en SICAR con teléfono o correo.
• Solo acredita a quien ya está en tu programa. Si el celular o correo no corresponde a ninguna clienta de tu programa, o la venta no tiene a nadie, se registra como «Sin asignar» y no acredita a nadie. Si la cajera teclea mal un número y ese número es de otra clienta, la compra se le acredita a ella: confirma el número antes de cobrar.
• Las cancelaciones posteriores no descuentan puntos. Si una venta se cancela en SICAR después de haberse enviado, los puntos se ajustan a mano. Una venta cancelada antes de enviarse no acumula.
• La PC servidor debe estar encendida y con internet para que las ventas lleguen a Xtarly.

Cómo saber si Xtarly Bridge sigue conectado

La conexión de SICAR en Configuración → Integraciones muestra el estado de Xtarly Bridge y la hora de la Última señal:

Debajo, el Diagnóstico te dice la versión de Xtarly Bridge, en qué PC corre, si se ejecuta como servicio de Windows o en una ventana abierta, cuántas ventas tiene por enviar y cuándo leyó SICAR por última vez.

Cada cuánto llegan las ventas

• Con webhook: la venta llega a Xtarly en cuanto tu POS la avisa, casi al instante.
• Sin webhook (o mientras se activa): Xtarly revisa tus ventas cada 10 minutos — cada 15 en Alegra, CleanCloud y Epos Now. Es el único camino en Clover, Epos Now, Odoo POS, Poster, SumUp y Toast, que no usan webhooks, y el camino principal en Bsale, donde el aviso automático hay que pedirlo por correo a Bsale.
• Shopify es el caso contrario: funciona solo por webhook, sin revisión periódica.

No pierdes ventas por no configurar el webhook: solo llegan un poco después.

Cuándo empieza a contar cada conector: Clover, Toast y Lightspeed cuentan desde el momento en que conectas y no importan las ventas anteriores; Bsale empieza a leer desde el día anterior. En Lightspeed eso incluye las ventas a plazos o a cuenta abiertas antes de conectar, aunque se terminen de pagar después.

Qué monto genera puntos

La propina no genera puntos; el impuesto sí. Cuando tu POS separa la propina del cobro (Square, Clover y Toast lo hacen), Xtarly acredita solo la compra. En los sistemas que no reportan la propina por separado, se acredita el total tal como lo entrega el POS.

Match por QR: acredita ventas de pagos anónimos

Cuando el cobro no trae la identidad del cliente, hay una forma sencilla de acreditarlo:

1. Al cobrar, pide al cliente su tarjeta de lealtad (el QR de su tarjeta Wallet).
2. Escanea ese QR en el campo de nota o referencia del cobro en tu POS.
3. Xtarly detecta el código dentro de la venta y le abona sus puntos o sellos automáticamente.

En Ventas recibidas cada cobro muestra su estado — Acumulada, Sin asignar, Duplicada o Error — y, cuando se acreditó, cómo se emparejó: por teléfono, por correo, vía QR escaneado en el POS o por señales detectadas en los datos del cobro.

Varias cuentas del mismo POS

Si cobras con más de una cuenta del mismo sistema —tres comercios de Clover, dos restaurantes de Toast, dos tiendas de Shopify, dos cuentas de Poster— puedes conectarlas todas. En la tarjeta del POS ya conectado usa Conectar otra sucursal (Clover y Shopify) o Conectar otra cuenta (el resto), y vuelve a la lista con ← Todas las conexiones.

• Cada conexión se liga a su sucursal. Si tu negocio tiene más de una sucursal, al agregar una segunda conexión se te pide cuál le corresponde: sus ventas se acreditan ahí.
• Ponle el nombre con el que la reconoces. El campo Nombre para identificarla (por ejemplo «Sucursal Centro») es opcional y sirve para distinguirlas en la lista.
• Desconectas una sin tocar las demás. El aviso de desconexión te dice exactamente qué cuenta deja de enviar ventas; las otras siguen recibiendo.
• La tarjeta del catálogo muestra Conectado · N, con el número de cuentas conectadas.

Autorizar dos veces la misma cuenta no crea una conexión nueva: el panel te avisa que esa cuenta ya está conectada en este negocio y te pide autorizar una distinta.

Sucursales: en qué tienda cae cada venta

Si tienes más de una sucursal, la pestaña Sucursales de la conexión te deja asignar cada tienda o terminal de tu POS a una sucursal de Xtarly. Las ventas ya recibidas y las futuras quedan registradas en esa sucursal, así que tu analítica por sucursal cuadra con la realidad.

• Las tiendas o terminales aparecen solas conforme llega la primera venta de cada una; mientras no las asignes salen como Sin asignar.
• Al asignar una, Xtarly te dice cuántas ventas anteriores se reasignaron con ese cambio.
• Sucursal por defecto es a dónde van las ventas que llegan sin tienda ni terminal identificable.

Detalles a tomar en cuenta

• Bsale: el token de acceso no se genera desde tu panel, se pide a Bsale por correo. Si tu cuenta es de México o Perú, escríbelo en el campo de país: cada país usa un servidor distinto. Las notas de crédito, devoluciones y cotizaciones no suman puntos.
• Clover: cada sucursal es un comercio distinto, con su propio ID y su propio token — se conectan una por una y conviven en el panel, cada una ligada a su sucursal. Clover reserva los tokens de API para pruebas y pide tokens OAuth en producción; la app en su App Market está en trámite, así que si tu Clover es de producción escríbenos y te ayudamos a conectarla.
• Toast: necesitas suscripción RMS Essentials o superior y el permiso 8.4 Manage Integrations. Al crear la credencial marca orders:read, guest.pi:read y restaurants:read — sin guest.pi:read los pedidos llegan sin teléfono ni correo del comensal y no se le puede abonar a nadie. Solo acreditan las cuentas cerradas y pagadas, y cada local se conecta con su propio GUID, como una conexión más dentro del mismo negocio.
• Lightspeed: los tokens personales solo existen en el plan Plus y solo los crea un usuario administrador.
• Odoo: en Odoo Online la API externa solo está disponible en el plan Custom; en self-hosted y Odoo.sh siempre funciona.
• CleanCloud: la API requiere plan Grow o Grow+, y el webhook se da de alta a mano desde tu cuenta.
• SICAR (beta): requiere instalar Xtarly Bridge en la PC servidor de SICAR y lo instalamos contigo. Para ligar la venta, la cajera escribe el celular, el correo o escanea la tarjeta de la clienta en el botón Comentario de la venta; en efectivo también sirve la referencia del cobro, y con tarjeta o transferencia la referencia es del banco. Si no se escribe nada, acumula el cliente asignado en SICAR con teléfono o correo. La tarjeta tiene prioridad, y la venta solo acredita si esa clienta ya está en tu programa (si no, queda «Sin asignar»). El botón Comentario y la tarjeta real con tu lector los confirmamos contigo durante la beta. Las cancelaciones posteriores no descuentan puntos: se ajustan a mano. Disponible desde el plan Shared, como los demás conectores. Más detalle.
• Mercado Pago + XtarlyPOS: si cobras con la terminal desde XtarlyPOS, esa venta ya entra por el POS (con cliente y sucursal) y el conector la descarta — no se duplica. Los cobros por link desde el celular sí siguen entrando por el conector.

¿Tu POS no está en la lista?

• Si aparece con la etiqueta Próximamente, deja tu interés con Avísame cuando esté listo y te notificaremos al activar el conector.
• Si no aparece, elige Otro / mi POS no está en la lista. Xtarly funciona junto a cualquier POS por la vía universal: tus clientes muestran su tarjeta (QR o teléfono) al pagar y registras la venta con la app cashier o la API de socio.

Desconectar un POS

Desde la tarjeta del POS conectado, haz clic en Desconectar. Dejamos de recibir ventas y borramos las credenciales guardadas; el historial de ventas ya recibidas se conserva.