Cómo Integrar el TPV "Shiji / Infrasys" con Gstock
Gstock está integrado con el sistema de Tpv “Shiji / Infrasys”
Es importante saber que la integración siempre será al panel de administración de Gstock, esto quiere decir que la integración es independiente al número de centros de coste que se tenga en Gstock.
Datos necesarios:
Cada centro de coste que vamos a integrar entre Shiji / Infrasys y Gstock necesita tener un número de referencia o ID, el cliente debe preguntar a Shiji / Infrasys por una referencia por centro, es probable que Shiji / Infrasys pida al cliente estas referencias. No hay problema, éstas pueden ser simplemente (ejemplo):
Centro de coste 1 (restaurante 1): ID “1”
Centro de coste 2 (restaurante 2): ID “2”
Centro de coste 3 (restaurante 3): ID “3”
Centro de coste 4 (restaurante 4): ID “4”
Las Id pueden ser alfanuméricas, no hay problema.
Con estas ID’s iremos en Gstock a la zona de administración desde el panel central:
En la opción “Centros de Coste” entramos y veremos los centros de coste y sus referencias. Editamos cada centro e introducimos cada ID en su respectivo centro, en el campo “Referencia”
Una vez tengamos las ID de cada centro correctamente registrada vamos a la opción del menú lateral “Aplicaciones” y luego “De entrada de datos”
Dentro de las aplicaciones de entrada, marcamos “Nueva”
Le ponemos un nombre a la aplicación, por ejemplo “Shiji / Infrasys” y es MUY IMPORTANTE seleccionar el panel central de Gstock (o el nombre que el cliente le haya puesto) , NO un centro de coste específico. A continuación damos a “Crear”
Volvemos a editar esta aplicación (Shiji / Infrasys) y entramos en “PERMISOS” y añadimos “CARGADOR DE VENTAS”
Ya hemos terminado, sólo nos queda contactar con el responsable de Shiji / Infrasys y facilitarle las credenciales que hemos creado y que nos confirmen el primer envío para poder comprobar que llegan bien las ventas.
ESTE SERÍA UN PROTOCOLO PARA EMPEZAR DESDE CERO:
Infrasys escribe a soporte@g-stock.es y notifica la próxima integración de un nuevo cliente, identificando:
Sociedad y nombre comercial
Listado de Centros o Outlets -que van a ser integrados- con sus respectivas referencias (normalmente 001, 002, etc)
Gstock contesta A INFRASYS:
Confirmando la existencia del cliente
Con el listado de cecos homólogo, incluyendo el emparejamiento uno a uno.
Si dos outlets de Infrasys se conectan a un mismo ceco de Gstock se deberá de indicar en la tabla
Gstock crea y aporta las credenciales principales para que Infrasys configure:
CLIENT-ID y CLIENT-SECRET
URL, que siempre es la misma: https://interface.g-stock.net/
Infrasys configura y realiza el primer envío, y notifica a Gstock para verificación
Gstock confirma recepción o informa de incidencias
Resumen y protocolo de integración (paso a paso)
En resumen:
Cuando un cliente multiceco (de momento todos lo son) integra ambas plataformas, hace falta que Shiji tenga un único client ID y Client Secret para foguear y conectar mediante Oauth a la CENTRAL de GSTOCK (no a cada centro).
Es decir, el client ID y client secret NO identifican a qué centro-Outlet van dirigidas las ventas, si no que simplemente sirven para identificar y loguear
Para que Gstock sepa a qué centro van dirigidas las ventas hace falta que previamente y mediante un email Infrasys nos diga qué referencia tiene cada centro, algo que sí lo solemos saber y que Gstock incluya, en el listado de Centros de Coste de la zona admin del cliente, la misma referencia, pero en el campo “REFERENCIA" (ojo, no en “ID" que no es editadle). Esto lo hacemos nosotros.
Que Infrasys mande, con cada petición HTTP este valor en la cabecera de cada envío para que Gstock discrimine y envíe las ventas al ceco de Gstock correspondiente. Este es el campo:
X-Center-Reference_Logged