Saipos

Saipos es un sistema de gestión para restaurantes, bares y operaciones de entrega a domicilio, con funciones de pedidos, punto de venta, inventario, finanzas y emisión de impuestos.

La integración con Falaê consulta los datos de ventas de la tienda en Saipos para registrar clientes, registrar y actualizar sus registros de compras y enviar la encuesta de satisfacción a través de los canales configurados en Falaê. Para conectar la tienda, necesita un token API de Saipos Data y una encuesta registrada en Falaê.

Antes de empezar

• Accede a la pantalla Integraciones en Falaê con un perfil autorizado para configurar la integración. El perfil Cajero no puede realizar esta configuración.
• Contar con una encuesta registrada en la empresa o sucursal que se integrará.
• Solicite un token de API de datos de Saipos con acceso solo a la tienda que desea conectarse.
• Para enviar las encuestas, mantenga configurado y habilitado al menos un canal de envío en Falaê: correo electrónico, WhatsApp o SMS.

El acceso a la API de datos está sujeto a un cargo adicional por parte de Saipos. Consulta las condiciones de contratación y quién será el responsable del pago en documentación oficial de Data API.

Cómo configurar la integración

1. Solicitar el token a Saipos

1. Abra el formulario de solicitud de token de API de datos indicado en la documentación oficial de Saipos.
2. Complete la solicitud para la tienda que se integrará con Falaê y solicite acceso exclusivo a los datos de esa tienda.
3. Espere a que Saipos libere el token. La documentación indica una devolución dentro de hasta un día hábil, por correo electrónico.
4. Tenga a mano el token recibido para completar la configuración en Falaê.

El campo Falaê Token recibe la clave proporcionada por Saipos para consultar la API de datos. Si ya tienes una clave para otra integración, confirma con Saipos que corresponde a este acceso y a la tienda correcta.

2. Configurar Saipos en Falaê

1. Accede a la pantalla Integraciones en Falaê.
2. En el campo Buscar integración, busca Saipos y abre la tarjeta de integración, en la categoría TPV.
3. Si administras una cadena de tiendas, busca la sucursal deseada en la lista y abre su configuración.
4. En el campo Token, pegue el token de API de datos recibido de Saipos para esa tienda.
5. En el campo Encuesta, selecciona la encuesta de satisfacción que deseas vincular. La lista solo muestra encuestas de la empresa o sucursal seleccionada.
6. Haga clic en Configurar integración y espere la confirmación.
7. Verifique que la pantalla muestre Integración configurada.

El botón Configurar integración está deshabilitado mientras falte el token o la encuesta. Si la empresa no tiene ninguna encuesta registrada, cree una encuesta y vuelva a abrir la configuración.

3. Verificar importación y envío

1. Realice un seguimiento de una venta reciente no cancelada registrada en Saipos con el nombre y número de teléfono válidos del cliente. Para comprobar el envío por correo electrónico, el cliente también debe tener una dirección de correo electrónico proporcionada en la venta.
2. Espere a que Falaê consulte automáticamente los datos.
3. Verifique en Falaê si el cliente fue registrado o localizado y si el registro de compra fue registrado con el valor de venta.
4. Consultar recepción de la encuesta a través del canal habilitado para la empresa o sucursal.

La confirmación de la configuración indica que el token y la encuesta fueron registrados en Falaê. La verificación de importación y envío confirma que el flujo con los datos de la tienda funciona.

Cómo funciona la integración

1. Los datos de ventas y clientes se registran en el sistema Saipos.
2. Con la integración habilitada, Falaê consulta periódicamente la API de Saipos Data, utilizando el token informado. Cada consulta busca ventas cuya última actualización en Saipos ocurrió entre 72 y 4 horas antes de la consulta.
3. Falaê verifica si la venta ya tiene registro de compra en la empresa o sucursal configurada. Si ya existe, actualiza el valor, fecha y vigencia del mismo registro de compra, según datos de Saipos, sin duplicar el registro ni reenviar la encuesta. Esta actualización ocurre incluso cuando la venta regresa sin el número de teléfono del cliente.
4. Para una venta que aún no ha sido importada, no ha sido cancelada y tiene el número de teléfono del cliente, Falaê registra o localiza al cliente utilizando los datos disponibles, como nombre, número de teléfono y correo electrónico. Luego registra el registro de compra, con el valor total y fecha de venta, vinculado al cliente y la empresa o sucursal configurada.
5. Al registrar este nuevo registro de compra, dependiendo de las opciones de envío habilitadas, Falaê reenvía la encuesta vía correo electrónico, WhatsApp o SMS. El envío por correo electrónico también depende de que el cliente tenga este contacto.
6. El cliente accede a la encuesta recibida y responde sobre su experiencia.

Si se cancela una venta en Saipos, el registro de compra ya registrado en Falaê se marca como no válido, preservando el historial. Una venta que ya ha sido cancelada antes de la primera importación no genera un registro de compra ni envía una encuesta.

La ventana de consulta le permite recuperar cambios y ventas disponibles tarde. En periodos de mayor procesamiento, Saipos informa que los datos solo podrán estar disponibles el día siguiente (D+1), retraso cubierto por la ventana de 72 horas. La importación depende de que los datos estén disponibles en la API y dentro del periodo consultado. Consulte Guía de Saipos sobre la actualización de datos.

Las ventas actualizadas hace menos de 4 horas aún no están incluidas en la consulta. Espere las siguientes consultas para verificar la importación o actualizar el registro de compras.

Preguntas y mantenimiento

No aparece ninguna encuesta para seleccionar. ¿Qué hacer?

Crea una encuesta en la empresa o sucursal que estás configurando y vuelve a abrir la integración. En esta selección no aparecen las encuestas de otras sucursales.

¿Puedo conectar más de una sucursal?

Sí. Configura cada sucursal por separado en Falaê, usando un token exclusivo de la tienda correspondiente y una encuesta de esa sucursal.

Saipos también proporciona tokens con acceso a múltiples tiendas, pero para este flujo de configuración, use un token por tienda. La API de datos no ofrece filtrado por tienda; un token de cadena de tiendas puede devolver ventas de varias sucursales en la misma consulta. Consulte la guía oficial sobre tokens y tiendas.

¿El cliente necesita tener teléfono en Saipos?

Para importar una venta por primera vez y registrar o localizar al cliente, sí, incluso cuando el canal elegido para enviar la encuesta sea el correo electrónico. Mantén el registro de cliente cumplimentado en Saipos con los contactos que quieras utilizar.

Para actualizar o invalidar un registro de compra ya registrado no es necesario el teléfono. Falaê reconoce la venta por su número en la misma empresa o sucursal y actualiza el registro sin reenviar la encuesta.

Aparece el registro de compra, pero no llega la encuesta. ¿Qué comprobar?

Verifique si el canal deseado está configurado y habilitado en Falaê para esa empresa o sucursal. Comprueba también que el número de teléfono es correcto y, en el envío por correo electrónico, que este contacto ha sido informado en Saipos. La configuración de integración no habilita automáticamente los canales de envío.

Si el problema continúa, solicite ayuda al soporte de Falaê, informando la sucursal, el número de venta y la fecha de registro.

Configuré la integración, pero no aparecen ventas. ¿Qué comprobar?

Confirma que el token sea de la API de datos, que esté liberado y que corresponda a la tienda configurada. Para la primera importación, verifique si hay ventas que no hayan sido canceladas con el número de teléfono del cliente. Considere el posible retraso en la puesta a disposición de los datos por parte de Saipos y espere una consulta en la que la última actualización de venta tenga al menos 4 horas de antigüedad y esté dentro del plazo de 72 horas.

Si el token se canceló o la tienda se canceló en Saipos, es posible que la consulta ya no proporcione los datos esperados. Para verificar el acceso o solicitar una nueva clave, comuníquese con Soporte de Saipos para socios. Para investigar la importación en Falaê, informar al soporte de la sucursal y del período de venta que no apareció.

¿La configuración importa todo el historial de ventas?

La configuración habilita consultas automáticas en base a la fecha de la última actualización de venta en Saipos, dentro de una ventana de 72 a 4 horas antes de cada consulta. Una venta creada hace más tiempo puede ingresar al flujo si se actualizó dentro de ese período. La configuración no representa una solicitud para importar todo el historial de la tienda. Si necesita recuperar un período anterior, consulte con el soporte de Falaê sobre la posibilidad de importar.

¿Cómo intercambiar el token o la encuesta vinculados?

Abra la configuración de la sucursal, haga clic en Cancelar integración y configure nuevamente con el token y la encuesta deseados. Para reemplazar una clave cancelada, espere a que Saipos libere el nuevo token antes de realizar la nueva configuración.

¿Cómo desconectar la integración?

1. Acceda a Integraciones en Falaê y abra Saipos.
2. Si gestionas una cadena de tiendas, abre la configuración de la sucursal que quieres desconectar.
3. Haga clic en Cancelar integración y espere el mensaje Integración desconectada correctamente.

La cancelación desactiva la integración de la sucursal en Falaê y elimina las credenciales y el enlace a la encuesta utilizados en este flujo.

Para revocar la clave de acceso o rescindir el contrato de API de datos en Saipos, solicite la cancelación directamente a Saipos utilizando el formulario de cancelación de token. Desconectarse de Falaê no cancela el token ni el cargo de Saipos.

Si el botón cancelar está deshabilitado por falta de permiso, solicite permiso a un administrador para ver las integraciones. El perfil Cajero no puede cancelar integraciones.