Crear credenciales de acceso para conexión TPV

Cómo generar credenciales API para integrar un TPV

Esta guía detalla el proceso para crear las credenciales (Client ID y Client Secret) necesarias para que un TPV externo o el extractor de Gstock puedan volcar datos de ventas de forma automática.

Pasos Previos

Antes de comenzar, asegúrate de estar en el Panel de Administración de Gstock y tener activada la contratación de API pública.

Configuración Paso a Paso

1. Acceso al módulo de aplicaciones

• Dirígete al menú superior Configuración.

   

• Selecciona Aplicaciones → De entrada de datos → Listado de aplicaciones.

  Open

  

   

2. Crear una nueva conexión

• Haz clic en el botón + Nueva situado en la esquina superior derecha.

• Configura los siguientes campos:

  1. Nombre: Texto libre para identificar la conexión (ej: "Conexión TPV Agora").

  2. Tipo: Selecciona REST.

  3. Centro permitido: Selecciona el restaurante o panel admin que se vinculará (según el TPV).

     Open

     

      

3. Generar credenciales y asignar permisos

Tras hacer clic en Guardar, el sistema generará automáticamente el Client ID y el Client Secret. ¡No cierres la ventana todavía!

• Haz clic en el botón azul Permisos que aparecerá a la derecha.

• En la pestaña de Ventas, localiza el módulo Cargador de Ventas.

• Marca el check de Cargar.

• Haz clic en Guardar. Sin este paso, la conexión será rechazada por el servidor aunque las claves sean correctas.

Resumen de datos para el técnico

Una vez finalizado el proceso, copia y entrega al técnico del TPV los siguientes datos que aparecen en la ficha de la aplicación:

Problemas comunes

• Error 401 (Unauthorized): Revisa que el Client Secret se haya copiado correctamente sin espacios.

• Error 403 (Forbidden): El Client ID es correcto pero has olvidado realizar el Paso 3 (Asignar Permisos).

• Las ventas no entran: Verifica que el NIF de la Razón Social en Gstock coincida con el configurado en el extractor del TPV.