Guía de la integración con Chowly

Chowly es un agregador externo de pedidos en línea que conecta las plataformas de entrega a domicilio (DoorDash, Uber Eats, Grubhub, etc.) con Katalyst POS. La integración maneja dos flujos principales:

1. Sincronización del menú (salida): Katalyst envía tu menú a Chowly para que las plataformas de entrega muestren los artículos y precios correctos.
2. Recepción de pedidos (entrada): Cuando un cliente hace un pedido en una plataforma de entrega, Chowly lo envía a Katalyst, que crea automáticamente un pedido para llevar (Takeout), una cuenta (Check) y un pago (Payment).

Requisitos previos

Antes de poder usar la integración, debe cumplirse lo siguiente:

• Chowly debe estar activado para el restaurante. Comunícate con el soporte de Katalyst para activar Chowly en tu restaurante.
• Debe configurarse una clave de API de Chowly para cada centro de ingresos que vaya a recibir pedidos o enviar menús. Chowly te da esta clave durante la incorporación.

Cómo activar la integración (administración/configuración)

1. Activa Chowly para el restaurante

Comunícate con el soporte de Katalyst para activar Chowly en tu restaurante.

2. Configura la clave de API por centro de ingresos

La clave de API vincula un centro de ingresos específico con el sistema de Chowly. Para configurarla:

1. Inicia sesión en la app Restaurant Management.
2. Ve a Kitchen Hub → Chowly Sync (sincronización con Chowly).
3. Selecciona el centro de ingresos en el menú desplegable.
4. Ingresa la clave de API en el campo "Set API key" (configurar clave de API).
5. Haz clic en Add Key to Revenue Center (agregar clave al centro de ingresos).

La clave guardada se muestra oculta (por ejemplo, abcd****) como confirmación.

Sincronización del menú

Cómo funciona

Cuando se ejecuta una sincronización del menú, Katalyst envía a Chowly todos los artículos del menú activos asignados al centro de ingresos seleccionado, organizados en tus secciones del menú, y registra el resultado en el historial de sincronizaciones.

Qué se incluye en el menú

Solo se incluyen los artículos que cumplen todos estos criterios:

• El artículo está activo y disponible en el POS
• El artículo está asignado al centro de ingresos
• El artículo es un artículo del menú estándar (los artículos abiertos no se envían)
• El artículo no se ha eliminado

Los grupos de modificadores se incluyen solo si:

• El grupo está activo para pedidos en línea
• El nombre del grupo tiene al menos 2 caracteres

Las opciones de modificadores se incluyen solo si:

• La opción está activa
• El nombre del modificador tiene al menos 2 caracteres

Las categorías del menú se incluyen solo si:

• La categoría está activa
• La categoría no se usa para artículos abiertos
• La categoría no se ha eliminado

Disponibilidad de las secciones del menú

Cada sección principal del menú que se envía a Chowly incluye un horario de disponibilidad, que se define en la categoría del menú:

1. Available daily (disponible todos los días): La sección está disponible todos los días, con el horario para llevar del centro de ingresos, o en un horario específico si la sección no está configurada para todo el día.
2. Repeat on selected days (repetir en los días seleccionados): La sección está disponible solo en los días de la semana seleccionados.
3. Ninguno está configurado: La sección se excluye por completo de la sincronización.

Si una sección no tiene un horario de disponibilidad válido, no aparecerá en el menú de Chowly.

Cómo iniciar una sincronización del menú

Manual (interfaz):

1. Ve a Kitchen Hub → Chowly Sync.
2. Selecciona el centro de ingresos correcto.
3. Haz clic en Execute synchronization (ejecutar sincronización).
4. Espera a que termine el indicador de carga; la lista del historial de sincronizaciones se actualizará automáticamente.

Programada (automática):

Katalyst revisa si hay cambios en el menú cada 5 minutos y sincroniza automáticamente cualquier centro de ingresos cuyo menú haya cambiado desde la última revisión. Si el menú no cambió, no se envía nada.

Cómo ver el historial de sincronizaciones

La página Chowly Sync muestra las últimas 20 sincronizaciones del centro de ingresos seleccionado, con la fecha y hora y un enlace al archivo del menú que se envió. Esto te sirve para verificar qué se envió realmente a Chowly.

Pedidos entrantes

Cómo se procesa un pedido entrante

Cuando Chowly envía un pedido a Katalyst:

1. Revisión de la función: Si Chowly no está activado para el restaurante, el pedido no se acepta.
2. Revisión de duplicados: Si ya se recibió el mismo pedido, el duplicado se ignora.
3. Asignación del pedido: Cada artículo del pedido de Chowly se empata con su artículo del menú en Katalyst. Si un artículo no se puede empatar, el pedido se rechaza.
4. Se crea el pedido para llevar: Se crea un pedido para llevar (Takeout) con los datos del cliente, la hora programada para recoger o entregar y la lista de artículos.
5. Se crea la cuenta: Se crea una cuenta en línea vinculada al pedido para llevar. Los montos (subtotal, impuestos, propinas) vienen de Chowly.
6. Se crea el pago: Se registra un pago como pagado externamente, ya sea con tarjeta o en efectivo.
7. Aprobación automática: Si el centro de ingresos tiene configurada la aprobación automática, el pedido para llevar pasa automáticamente a preparación.

Etiquetado del origen del pedido

Las cuentas y los pagos que crea Chowly se etiquetan con Chowly como origen del pedido, junto con la plataforma de entrega específica (por ejemplo, DoorDash).

Pedidos a domicilio

Si el pedido de Chowly es a domicilio, el pedido para llevar se marca como pedido que necesita entrega, se guarda en él la dirección de entrega y cualquier cargo de entrega se registra como tarifa de entrega tanto en el pedido para llevar como en la cuenta.

Cómo quitar la clave de API

Para desconectar Chowly de un centro de ingresos:

Desde la interfaz:

1. Ve a Kitchen Hub → Chowly Sync.
2. Selecciona el centro de ingresos.
3. Haz clic en Delete API key (eliminar clave de API).

Esto elimina la clave por completo. Las sincronizaciones del menú se detendrán para ese centro de ingresos y los pedidos entrantes fallarán.

Solución de problemas