Integración de Omniwallet con Stockagile

Conecta tu programa de fidelización de Omniwallet con tu sistema de gestión y punto de venta Stockagile. Esta guía explica qué hace la integración, cómo funciona y cómo configurarla paso a paso, incluido el canjeo de saldo del cliente directamente en caja.

¿Qué hace la integración?

La integración entre Omniwallet y Stockagile sincroniza tu operativa de venta con tu programa de puntos, en ambos sentidos:

• Las ventas en tienda física generan puntos en Omniwallet. Cada venta registrada en el TPV de Stockagile se envía a Omniwallet y suma puntos al cliente según las reglas de tu Programa de puntos. Las ventas que entran a Stockagile desde el ecommerce no generan puntos a través de esta integración, porque Omniwallet ya se integra directamente con el ecommerce y obtiene la información del pedido desde ahí. De este modo se evita duplicar la acumulación.
• Los clientes nuevos se sincronizan automáticamente. Cuando se da de alta un cliente en Stockagile, se crea también en Omniwallet, de modo que empieza a acumular desde su primera compra.
• El saldo de fidelización es visible y utilizable en el punto de venta. Stockagile muestra el saldo disponible del cliente (sus puntos convertidos a saldo canjeable) y permite aplicarlo como descuento directamente al cobrar.

En la práctica, el cliente compra en tu tienda física o en tu ecommerce, acumula puntos sin hacer nada extra, y puede gastar ese saldo en su siguiente compra sin salir del flujo habitual de caja.

¿Cómo funciona?

La conexión se apoya en dos canales que trabajan de forma complementaria:

1. Omniwallet → Stockagile (conexión por API con token). Stockagile usa un token de Omniwallet para consultar y mostrar el saldo del cliente y para aplicar su canjeo en la venta. Es lo que hace que en caja aparezca el saldo disponible y el botón para aplicarlo.
2. Stockagile → Omniwallet (webhooks). Stockagile notifica a Omniwallet cuando ocurre un evento relevante mediante webhooks. Se configuran dos: Cliente Creado (para dar de alta clientes nuevos en Omniwallet) y Venta Creada/Actualizada (para registrar las ventas de tienda física y acumular los puntos correspondientes). Los pedidos de ecommerce no se acumulan por esta vía: se gestionan a través de la integración directa de Omniwallet con tu ecommerce, evitando así contar dos veces la misma compra.

El saldo que ve el dependiente en Stockagile corresponde a los puntos del cliente en Omniwallet convertidos a euros según la regla de canje definida en tu Programa de puntos.

Configuración

La configuración tiene dos partes: primero conectas Stockagile dentro de Omniwallet, y después creas en Stockagile los webhooks que avisan a Omniwallet.

Parte 1 — Conectar Stockagile en Omniwallet

Paso 1. Pide tu token a Stockagile. Envía un correo al equipo de desarrollo de Stockagile para que te faciliten tu token de API.

Paso 2. Configura el token en Omniwallet.

1. Ve a Integraciones → ERP & TPV en Omniwallet.
2. Haz clic en Stockagile.
3. Pega la URL de la API: https://api.stockagile.com/public/api/v2/
4. Pega el token que te facilitó Stockagile.
5. Activa el interruptor y pulsa Guardar.

Importante: La URL debe ser HTTPS; en caso contrario dará error. Si el token no es correcto, la conexión fallará.

Parte 2 — Crear los webhooks de Omniwallet en Stockagile

Paso 1. Genera un token en Omniwallet.

1. Ve a Integraciones → Claves API y haz clic en Generar token.
2. Puedes elegir que el token sirva solo para Stockagile o para todas las integraciones.

Paso 2. Abre la configuración de webhooks en Stockagile.

1. Entra en Stockagile, haz clic en tu perfil y luego en Configuración.
   
   
   
   
2. Baja hasta encontrar la sección Webhooks.
   
   
   
   

Paso 3. Crea el webhook "Cliente Creado".

1. Haz clic en Nuevo webhook.
2. En Tipo de Webhook, selecciona Cliente Creado.
3. En la cabecera HTTP, copia lo siguiente sustituyendo tus datos:

{
  "Accept": "application/vnd.api+json",
  "Content-Type": "application/vnd.api+json",
  "X-omniwallet-account": "TU_SUBDOMINIO",
  "Authorization": "Bearer TU_TOKEN_DE_OMNIWALLET"
}

4. En X-omniwallet-account, pon tu subdominio.
5. En Authorization: Bearer, pega el token que generaste en Omniwallet.
6. En la URL, añade la siguiente: https://api.omniwallet.cloud/sta/contact-registered
   
   

Paso 4. Crea el webhook "Venta Creada/Actualizada". Repite exactamente los mismos pasos que en el Paso 3, pero seleccionando el tipo Venta Creada/Actualizada y la URL https://api.omniwallet.cloud/sta/points-record-registered

Canjeo de puntos en el punto de venta

Una vez configurada la integración, el cliente puede gastar su saldo acumulado directamente al pagar en Stockagile.

Requisito imprescindible

Para que el canjeo funcione, el canje de puntos debe estar activado en Omniwallet, en Programa de puntos. Si esta opción no está habilitada, el saldo no podrá aplicarse en la venta y el canjeo no funcionará.

Flujo de canjeo paso a paso

1. Busca al cliente en Stockagile. Desde la pantalla de venta, localiza al cliente que va a realizar la compra.
2. Asígnalo a la venta. Al vincular el cliente a la venta en curso, Stockagile carga su saldo de fidelización disponible.
3. Aplica el saldo acumulado. Aparecerá la opción Aplicar saldo con el importe disponible (por ejemplo, Aplicar saldo 6,95 €). Al pulsarla, ese saldo se descuenta del total de la venta.
4. Cobra la venta. Finaliza el cobro con el total ya ajustado tras aplicar el saldo.

Seguimiento del saldo del cliente

En la ficha de Fidelización del cliente dentro de Stockagile puedes consultar en todo momento su estado:

• Saldo disponible: saldo que el cliente puede usar en este momento.
• Saldo total acumulado: total acumulado a lo largo de su historial.
• Saldo total usado: total que ya ha canjeado en compras.
• Compras hechas con acumulación de saldo: número de compras en las que ha generado saldo.

Además, la pestaña Registro de movimientos muestra el detalle de cada cambio de saldo (origen, fecha, tipo de movimiento, saldo inicial, importe y saldo final), lo que permite auditar fácilmente cómo se ha generado y consumido el saldo de cada cliente.

Resumen de requisitos

• Token de Stockagile solicitado a su equipo de desarrollo.
• URL de la API en formato HTTPS y token correctos en Omniwallet (Integraciones → ERP & TPV → Stockagile).
• Token de Omniwallet generado en Integraciones → Claves API.
• Webhooks Cliente Creado y Venta Creada/Actualizada creados en Stockagile con la cabecera HTTP correcta.
• Canje de puntos activado en Omniwallet (Programa de puntos) para poder aplicar el saldo en caja.