Cómo vincular el TPV "HIOPOS" y GSTOCK

Integración Gstock - HIOPOS: Guía de Configuración

Esta guía explica cómo generar las credenciales necesarias y cuál es el procedimiento oficial para activar el conector entre Gstock y tu TPV HIOPOS.

Notificación Importante sobre el Proceso

La integración con HIOPOS es un conector oficial, pero su activación no es automática. Sigue estas reglas:

Solicitud vía Distribuidor: La solicitud de integración debe realizarla siempre el distribuidor de HIOPOS del cliente, nunca el cliente final directamente.
Canal Oficial: El distribuidor del cliente debe contactar con IATSAE (desarrollador del conector) escribiendo a Luis Miguel Villamañán (luismiguel@hiopos.online).
Ventas Manuales: Una vez vinculados ambos sistemas, no es posible subir ventas de forma manual desde HIOPOS. Cualquier ajuste posterior debe solicitarse a través del distribuidor.

Requisito Previo: Contratación de la API

Para usar las APIs en tu licencia, es imprescindible contratar su uso:

Estado de Contratación: Debes tener activada la contratación de API pública en tu plataforma.
Coste: Aunque el módulo de API sea de pago por llamada, el uso específico para la carga de ventas es gratuito.

Paso 1: Generar Credenciales en Gstock

Para que el conector funcione, necesitas crear unas llaves de acceso (Client ID y Client Secret) por cada centro de coste.

Acceso: Entra en Gstock y ve a Configuración → Aplicaciones → De entrada de datos.
Crear Nueva: Haz clic en el botón + (Nuevo).
Configuración:
- Nombre de la conexión: Escribe un nombre identificativo (ej: "Conexión HIOPOS Centro X").
- Tipo: Selecciona REST.
- Centro: Selecciona el restaurante que vas a vincular.
  Recuerda: Si tienes varios centros, debes crear una credencial independiente para cada uno.
Asignar Permisos (Crítico):
- Tras crear la aplicación, haz clic en el botón Permisos.
- En la pestaña Ventas, busca la opción "Cargador de ventas" y marca el check de Cargar.
- Haz clic en Guardar.
Obtener Claves: Copia el CLIENT ID y el CLIENT SECRET.

Paso 2: Entrega de datos y Activación

Una vez tengas las credenciales de Gstock:

Contacta con tu distribuidor de HIOPOS.
Entrégale las credenciales (Client ID y Client Secret) generadas.
Tu distribuidor se encargará de contactar con IATSAE (luismiguel@hiopos.online) para finalizar la vinculación técnica en el sistema HIOPOS.

Resumen para el Distribuidor

Para agilizar el proceso, te recomendamos enviar un correo a tu distribuidor con este formato:

Estimado distribuidor HIOPOS, solicitamos la activación del conector oficial con Gstock desarrollado por IATSAE. Adjuntamos las credenciales necesarias para el Centro [Nombre del Centro]:
Client ID: [Insertar código]
Client Secret: [Insertar código]
Por favor, gestionen la activación con Luis Miguel Villamañán (luismiguel@hiopos.online).

Tip: No olvides que el paso de los Permisos es el que más errores genera. Si el distribuidor te dice que la conexión falla, lo primero que debes revisar es que el "Cargador de Ventas" esté activo en la pestaña de permisos de la aplicación.

Preguntas Frecuentes:

¿Tiene algún coste activar la API para cargar ventas? No. Aunque es necesario tener contratado el uso de las APIs en tu licencia para habilitar el módulo, la funcionalidad específica de carga de ventas es gratuita.
He generado las credenciales pero el TPV da error de conexión, ¿qué ocurre? El error más común es olvidar el paso de Asignar Permisos. Si no marcas el check de "Cargar" en la pestaña de Cargador de Ventas, la conexión será rechazada por falta de privilegios aunque las llaves sean correctas.
¿Puedo usar las mismas credenciales para todos mis restaurantes? No. Por seguridad y trazabilidad, es obligatorio generar una conexión única por cada centro de coste o restaurante.
En el caso de HIOPOS, ¿puedo subir ventas manualmente si la API falla? No. Una vez que Gstock y HIOPOS están vinculados mediante el conector oficial, la subida manual queda inhabilitada. Cualquier incidencia debe gestionarse a través de tu distribuidor de HIOPOS.
¿A quién debo pedir soporte si la integración con HIOPOS no funciona? La solicitud y el soporte técnico deben canalizarse a través de tu distribuidor de HIOPOS, quien a su vez contactará con IATSAE (el desarrollador del conector oficial).
¿Qué pasa si pierdo el Client Secret o creo que alguien lo ha visto? Por seguridad, el Client Secret no se puede recuperar. Debes eliminar la aplicación en Gstock y crear una nueva para generar un par de llaves totalmente nuevo.