Documentación

Instalar Xtarly Bridge (SICAR)

Guía paso a paso para instalar Xtarly Bridge en la computadora de SICAR y conectarla a Xtarly con un código, para que cada venta sume puntos o sellos sola.

Xtarly Bridge manda las ventas de SICAR a Xtarly para que tus clientas sumen puntos o sellos solas. Solo lee las ventas; para crear su propio usuario de solo lectura necesita, una vez, la contraseña de MySQL de SICAR. Se instala una vez y después trabaja solo. Te toma pocos minutos.

SICAR está en beta con acompañamiento. Si en el panel no ves el botón Descargar Xtarly Bridge, escríbenos y te mandamos el instalador. Qué hace la integración y cómo se liga cada venta a tu clienta: SICAR en el panel de integraciones.

Antes de empezar

  • Usa la computadora principal de SICAR: la que guarda la base de datos (si tienes varias cajas, es la que hace de servidor). Instálalo solo en esa y solo una vez.
  • Entra a Windows con una cuenta de administrador.
  • Ten a la mano una de estas dos cosas (las pide el paso 4):
    • la contraseña de root de MySQL de SICAR: es la que se puso al instalar SICAR. Si no la sabes, pídesela a quien te instaló SICAR (técnico o distribuidor); o
    • un usuario de solo lectura con su contraseña, que el técnico de SICAR puede crear para Xtarly.
  • Ten abierto Xtarly en el celular o en otra pestaña: en el paso 5 vas a necesitar un código.

1. Descarga el instalador

En Xtarly entra a Configuración → Integraciones → SICAR → Conectar y presiona Descargar Xtarly Bridge. Se descarga un archivo llamado XtarlyBridge-Setup-….exe. Junto al botón ves la versión y el tamaño del archivo.

Si el navegador avisa que el archivo no se descarga normalmente, elige Conservar (en Edge: los tres puntos junto al archivo → Conservar → Conservar de todos modos). El aviso sale porque el programa es nuevo, no porque tenga algo malo.

2. Ábrelo y deja que Windows lo ejecute

Abre el archivo con doble clic. Windows va a mostrar una pantalla azul que dice «Windows protegió su PC». Sale porque el programa todavía no está firmado digitalmente; es normal con programas nuevos:

  1. Presiona Más información.
  2. Revisa que diga XtarlyBridge-Setup y presiona Ejecutar de todas formas.

Después Windows pregunta si quieres permitir que esta aplicación haga cambios en el dispositivo (dirá que el editor es desconocido). Presiona Sí.

Si Windows no te deja abrirlo

  • Control inteligente de aplicaciones (Windows 11): si dice que bloqueó la aplicación y no aparece «Ejecutar de todas formas», Windows no deja abrir programas sin firma digital, como este. No lo desactives por tu cuenta: escribe a soporte de Xtarly y lo vemos contigo.
  • Antivirus: si tu antivirus borra el archivo, lo manda a cuarentena o no deja abrirlo, escribe a soporte de Xtarly antes de cambiar nada en el antivirus. Por ahora el programa no tiene firma digital y algunos antivirus desconfían de eso; no siempre se puede resolver desde aquí.

3. Bienvenida y búsqueda de SICAR

Presiona Siguiente. El instalador busca SICAR solo y te dice «Encontramos SICAR». Presiona Siguiente.

Si dice que no encontró SICAR: revisa que estés en la computadora principal, abre SICAR una vez y presiona Reintentar.

4. Acceso a la base de datos de SICAR

Xtarly Bridge solo lee las ventas de SICAR. Elige una opción:

  • «Tengo la contraseña de root de MySQL de SICAR»: escríbela y presiona Siguiente. Se usa una sola vez para crear un usuario que solo puede leer, y no se guarda.
  • «Ya tengo un usuario de solo lectura»: escribe el usuario y la contraseña que te dio el técnico.

El instalador prueba la contraseña en ese momento. Si dice que no entró, revisa mayúsculas y minúsculas o pídesela otra vez a quien instaló SICAR.

5. Escribe el código de Xtarly

En Xtarly, en Configuración → Integraciones → SICAR → Conectar, aparece un código de 8 letras y números (por ejemplo ABCD-2345). Escríbelo y presiona Siguiente.

El instalador te muestra el nombre de tu negocio y sucursal: si es el tuyo, presiona Sí. El código vence en 15 minutos y sirve una sola vez: si vence, genera otro en Xtarly.

Si dice que tu negocio llegó al tope de conexiones, desconecta en Xtarly una que ya no uses (o mejora tu plan) y presiona Siguiente otra vez: el código sigue sirviendo mientras no venza. Si dice que falta elegir la sucursal, genera un código nuevo eligiéndola.

6. Instalación

El instalador conecta el programa con SICAR y con Xtarly, lo copia y espera su primera señal. Tarda hasta un par de minutos. Al terminar verás «¡Listo!»; en unos minutos, Xtarly (Configuración → Integraciones → SICAR) dirá «Conectado».

Prueba: haz una venta y escribe en el botón Comentario de SICAR el celular de una clienta que ya esté en tu programa. En uno o dos minutos aparece en Xtarly.

Para que siga funcionando

  • Deja encendida la computadora principal de SICAR y con internet. Xtarly Bridge arranca solo con Windows, aunque nadie abra SICAR.
  • Si se apaga la computadora o se va el internet, las ventas siguen guardadas en SICAR y Xtarly Bridge las envía cuando vuelve la conexión. Si reinstalas SICAR o lo cambias de computadora, escribe a soporte de Xtarly antes.
  • No necesitas abrir nada ni dejar ventanas abiertas.

Si algo sale mal

  • Si el instalador dice que falta un paso, presiona Copiar diagnóstico. Te dice si copió el resumen (pégalo con Ctrl+V en un mensaje) y dónde dejó el archivo «Diagnostico Xtarly Bridge.txt» (normalmente en tu Escritorio). Mándale los dos a soporte de Xtarly. No llevan contraseñas, y los teléfonos y correos van ocultos.
  • Puedes volver a abrir el instalador cuando quieras: es seguro repetirlo. Si ya estaba instalado, lo repara sin perder nada; si algo falla a la mitad, deja funcionando lo que ya estaba.
  • Si tu antivirus bloquea Xtarly Bridge, escribe a soporte de Xtarly (ver «Si Windows no te deja abrirlo»).
  • Si el instalador avisa que Xtarly Bridge «está abierto en una ventana», ciérrala y presiona Reintentar.

Para quitarlo

Configuración de Windows → Aplicaciones → Xtarly Bridge → Desinstalar. Cuando pregunte si quieres borrar también la configuración, responde No (salvo que soporte te pida lo contrario): así, si lo vuelves a instalar, sigue exactamente donde se quedó.