Manual de Uso de Integración con Pedidos Ya

© 2024 Napse. Todos los derechos reservados.

En el siguiente documento veremos cómo se realiza la creación de un pedido, el envío del mismo, y el tratamiento que se le da para que cambie de estado según los pasos establecidos.
Trabajamos con un PLUGIN desarrollado por NAPSE para integrarse con Pedidos Ya.

Aplicaciones Utilizadas:

1. Go (aplicación de Pedidos YA)
2. WinScp (para conectas4e a entorno LINUX)
3. Bridge POS (v7.5 en adelante) 

Funcionalidad de la integración

• Hacia el canal de delivery:
• Publicar artículos (para una tienda, con su precio, categoría/menú y stock actual)
• Actualizar estado del pedido al delivery (por medio de la novedad enviada por Bridge hacia Rabbit)
• Del canal hacia Bridge (por medio de plugin):
• Recibir pedido y enviarlo para su creación a Bridge
• Guardar el pedido para luego poder manejar las actualizaciones de estado al canal

Iniciar el plugin instalado en un entorno LINUX

Para empezar a operar con este plugin, si el mismo se encontrara instalado en LINUX, lo primero que debemos hacer, es a través de WINSCP, conectarnos a la IP en la cual se aloja el plugin, para poder ejecutarlo.

1. Abrir WinScp

2. Agregamos una nueva pestaña para poder conectarnos la IP en la cual está el Plugin.

Los datos de conexión en el caso de DEMO 7 son:

• IP: 172.171.248.244
• Usuario: stsadmin
• Contraseña: Nosotros123**

3.Una vez conectados, debemos dirigirnos hacia el directorio datadrive/plugins/delivery.

4. Dentro del directorio datadrive/plugins/delivery, desde el menú superior hacemos clic en Commands/Open in PuTTY, lo cual nos abrirá la consola poder ejecutar el plugin.

5. Nos debemos loguear nuevamente, con la contraseña Nosotros123** (en esta parte del proceso, la contraseña no tiene cursor por lo cual se la agrega "sin poder verla" en pantalla.

6. Una vez logueados en la consola, debemos dirigirnos al directorio:

/datadrive/plugins/delivery

7. Una vez dentro de esa ruta, escribimos: pm2 start ecosystem.config.js

Aplicación GO de Pedidos Ya

8. Con el plugin activo, lo siguiente es Ejecutar la aplicación GO de Pedidos Ya, en la cual vamos a poder observar las ordenes enviadas a través de la página de delivery (complemento en pruebas iniciales) 

Link de descarga de GO: https://9cgo.link/win-next
Instalamos la aplicación, la ejecutamos, y nos logueamos con los siguientes datos:
Usuario: petrobras_5239

• Esto nos facilitará las pruebas iniciales 

Contraseña: KC86{[zf2023

• Imagen de la aplicación donde se podrán ver los pedidos

Portal de PEDIDOS Ya de la integración 

Login

9. Una vez con el Plugin activo, y la aplicación Go ejecutándose, nos dirigimos a el siguiente link para empezar a enviar pedidos desde la página de Pedidos Ya: https://www.pedidosya.cl/restaurantes/santiago/petrobras-prueba-integracion-01d32821-73bb-41fc-a322-4d5350e48e82-menu

Ingresamos la dirección de entrega, la cual es: Cerro Colorado 5413, Las Condes, Santiago, Región Metropolitana, Chile (esta se encuentra dentro del área de cobertura de la tienda) 

Luego nos va a mostrar una ventana de Login, en la cual seleccionamos el método de ingreso:

Generar pedido desde el portal PEDIDOS Ya de la integración 

Una vez que realizamos el LOGIN en la página de la integración y con la dirección ingresada, seleccionamos el artículo, la cantidad deseada, y hacemos clic en el botón "Continuar"

En la siguiente pantalla, seleccionamos la dirección de entrega, y continuamos:

Seleccionamos el método de Pago, y continuamos:

En la pantalla siguiente nos muestra el resumen de nuestro pedido, le damos Continuar:

Nos confirma que nuestro pedido fue enviado, y hacemos clic en "Ver mi pedido":

En la siguiente ventana nos va a indicar el estado de nuestro pedido:

Pedido recibido en la aplicación GO

En simultáneo, en la aplicación Go, nos sonará una alerta indicando que ingreso un pedido:

Hacemos clic en la alerta, y nos abre el detalle del pedido. Como se puede observar, es el pedido que enviamos desde la Página. Número del pedido: 978389370.

Operación en BRIDGE en la gestión de pedidos

Flujo de estado del pedido para PEDIDOS YA

• Antes de ver cómo va cambiando de estado nuestro pedido en el POS, vale dejar aquí debajo, cual es el Flujo de Estado (WorkFlow Steps) que actualmente tiene asignado el plugin de Pedidos Ya.

BRIDGE POS - Surtido en el POS de un pedido

• Nos dirigimos al Punto de Venta, e ingresamos en la opción: PEDIDOS

Hacemos clic en "Buscar", y podemos observar el pedido que enviamos: 978389370.

• Seleccionando con doble clic en el mismo, vamos a ir dándole tratamiento al pedido para que avance y cambie de estado.
• Como cliente se informarán los datos definidos por configuración para un cliente GENERICO para el canal. De este modo no se creará un cliente por cada pedido, sino que se se informará en el área INFORMACION ADICIONAL como datos de contacto a los del cliente que realizó el pedido con su nombre, apellido, dirección, teléfono e email. 
  Primero lo confirmamos:

• Surtimos el pedido:

• Se selecciona la cantidad de unidades de cada artículo a surtir del pedido

Finalizamos el surtido: al tener un único medio de pago asociado, el pedido se asociará con este sin tener que ser seleccionado por el operador. 

Vemos como queda en "Listo para Retirar":

A medida que vayamos pasando de estado nuestro pedido, vamos a poder observar como en la página de Pedidos Ya, el mismo va cambiando de estado:

Hacemos clic en "Entregado":

Y vemos como queda en el Estado Final: Entregado

Publicaciones 

Pre requisito, desde BMC

• Contar con  un conjunto de artículos asociado a un canal/tienda desde Bridge Manager Central

Una vez creado el conjunto para el canal/ tienda se podrá publicar el mismo a demanda

Ejemplo de conjunto 

Creación - edición del conjunto

• Se podrá asociar el canal (delivery)
• La o las tiendas en las cuales se querrá publicar el conjunto para el delivery
• Se podrá asociar los artículos mediante la carga de un archivo csv de artículos

• Carga de productos y categorías para publicar (el código de categoría del delivery a publicar)

• Al descargar el csv modelo se podrá ver:

Publicar un producto desde BMC

A continuación se podrá ver en el diagrama de actividades el flujo de una publicación desde BRIDGE hacia PEDIDOS YA

Operatoria de publicación desde BRIDGE

• Ingresar en BMC, en el sidebar Opciones de Menú, hacer clic en Omni > Publicaciones

Una vez en Publicaciones por canal, desplegar el select Canal a publicar, seleccionar el canal Pedidos YA y hacer clic en la lupita para buscar. 

Previamente se armó un conjunto de artículos para ser usado por Pedidos YA. En este módulo se listarán como Productos asociados.

El detalle de cada ítem contiene:

• Checkbox de selección (para indicar artículos a publicar)
• Tienda (a la cual se publica)
• Código (SKU)
• GTIN (código asociado al artículo. Aplica para PEDIDOS YA)
• Descripción
• Categoría departamental (categoría asociada al artículo)
• Nombre de la categoría (categoría a publicar en el portal del delivery) 
• Atributos (estos son solo descriptivos ya que no se publican)
• Precio Unitario (precio de lista que le corresponde al artículo para el canal/tienda o del maestro)
• Stock mínimo para el canal (de la tienda sino del maestro) 
• Stock actual (por tienda) 
• Imágenes

BM/API/Publicaciones automáticas

• Se cuenta con un job el cual permite actualizar los productos en la pagina de Pedidos YA en casos de que haya cambiado el precio de un artículo o se haya modificado el stock
• El job “Publicación de novedades de ítems por canal” se ejecuta en Bridge Manager Central cada una hora (configuración default pudiendo modificarse)

• El job toma de aquellos canales cuya definición es “Publicación automática” = si

• Toma los artículos del conjunto del canal y los compara con las ultimas publicaciones del mismo (tabla setItemChannelPublish)
• Compara los precios y el stock mínimo por canal (si tiene la tienda definida, sino el valor del maestro de artículos centralizado).
• Se envía actualización del artículo:

• si el precio difiere de la ultima publicación al precio de cuando se ejecuta el job
• si el stock está por debajo del stock mínimo para canales de la tienda o de central, se envía como deshabilitado
• si el stock está por arriba del stock mínimo para canales y la última publicación se encontraba informado como deshabilitado, se envía una actualización como habilitado

BM/Monitoreo de integraciones

• Se podrá descarga logs del plugin desde Bridge Manager Central, desde el menú Monitoreo/Monitor de integraciones

• Se accederá a una pantalla con el listado de los plugins que reporten su actividad
• En el caso del plugin de PEDIDOS YA se envía una notificación cada 5 minutos

• Al seleccionar el botón “Detalle” se podrá acceder a la descarga de logs para un determinado día seleccionado.

• Al seleccionar el botón “Descargar” se podrá obtener el archivo log del plugin con la fecha indicada. El mismo se guarda en el directorio configurado como descarga del browser.

Surtido del pedido en el POS

A continuación se podrá ver un diagrama de actividades de la operatoria de pedidos desde el portal de PEDIDOS YA hacia BRIDGE y su surtido y facturación en el POS. 

VER: BRIDGE OMNI - Manual: Surtido en POS - Napse - P&D - Linx Share