Cómo integrar el TPV SIMPHONY de Oracle (Micros)

Esta integración se ha realizado en diciembre de 2023 utilizando la documentación original de Oracle:

Oracle® Hospitality Enterprise Back
Office
Standard Export User Guide
Release 1.19
E90896-22
January 2023

Gstock no garantiza un correcto funcionamiento de la integración usando versiones anteriores a la aquí detallada, para uso con anteriores versiones contacten a su distribuidor Oracle.

Estas son las características técnicas que deben ser comentadas con el distribuidor de Oracle del cliente solicitante de esta integración.

Para ejecutar la integración es necesario:

1. Contactar a ambas partes, a ser posible con un correo electrónico en común con las tres partes. Por parte de Gstock el correo es:

   • integration@gstock.app

2. Gstock facilitará los datos del SFTP en el que Simphony va a entregar los ficheros Json de cada día de venta. Estos datos serán:

   1. URL del SFTP

   2. Credenciales (usuario y contraseña)

   3. Puerto usado

   4. Ruta de entrega

3. Que el administrador del sistema Simphony en el cliente configure la exportación diaria del fichero Json con las ventas diarias. A modo orientativo, ha de utilizar una funcionalidad de Simphony llamada “Export”, “Reports & Analytics”, que se configurará para ser exportada mediante un fichero tipo “Json” y entregado a un SFTP de Gstock. Recomendamos configurar una hora de madrugada para un mejor rendimiento en la subida, entre las 3:00 y las 8:00 a ser posible.

   • Como comentario, Gstock utilizará, de todos los tipos de bloques que contiene el Json, los tipos GLID, CHDR, CMI Y CDSC

   • El administrador Simphony facilitará a Gstock una ID por cada Ceco (Gstock) o Revenue Center (Simphony) para que Gstock gestione la entrega de cada fichero en cada Ceco.

     • En Simphony a este campo se le llama “Revenue Center Number”

     • Gstock usará estos códigos para registrarlos en una zona no accesible a usuarios.

     • Siempre habrá un identificador por ceco.

     • Simphony podrá entregar los ficheros de todos los cecos en el mismo SFTP, Gstock los reconocerá por la ID del campo “Revenue Center Number” y los entregará a su correspondiente Ceco de Gstock. No es relevante el nombre del fichero, el nombre creado por Simphony es correcto.

   • Gstock creará distintas codificaciones de cada PLU de Simphony (la id Simphony de cada articulo de venta) dependiendo del “Revenue Center” (por ejemplo restaruante o delivery) y también dependiendo del tipo de venta (Terraza, Sala, etc). La id de cada PLU en Gstock es el resultado de concatenar:

     • "Revenue Center Number"_"Order Type Number"_"Menu Item Number"

     • un ejemplo de PLU sería: “101_2_1023456”, donde “101” sería en Revenue Center, “2” sería el type de venta, y “1023456” sería el ID de PLU en Simphony.

     • ¿Porqué Gstock hace esta codificación?

       • Es porque a menudo una receta para el mismo plato es distinta dependiendo de si es a domicilio, para la barra, etc, y así damos la opción al cliente para vincular cada PLU por su centro y tipo a una u otra receta que contenga, por ejemplo, material de packaging específico, o tamaño de las raciones.

Una vez integrados, se puede proceder a vincular los PLU’s a Recetas o productos.