Rappi, DiDi y domicilios¶
Qu3ntas recibe los pedidos de plataformas de domicilio directamente en tu sistema: aparecen en la cocina como cualquier otro pedido y se contabilizan automáticamente.
Plataformas soportadas¶
| Plataforma | Etiqueta en cocina |
|---|---|
| Rappi | Naranja |
| DiDi Food | Azul |
| Otra | Configurable |
¿Cómo funciona por dentro?¶
El flujo de un pedido de plataforma tiene tres pasos:
1. La plataforma envía el pedido¶
Cuando un cliente pide por Rappi o DiDi, la plataforma envía un webhook (una notificación automática) al servidor de Qu3ntas con los datos del pedido.
2. El pedido se guarda en el buzón¶
El webhook guarda el pedido crudo en un buzón intermedio (base de datos Turso en la nube) y responde 200 OK de inmediato.
¿Por qué un buzón?
Tu base de datos de Qu3ntas es local (en tu equipo). Si el local está sin internet o con la app cerrada, una plataforma que no recibe respuesta deja de enviar pedidos o los cancela. El buzón en la nube resuelve esto: siempre responde OK y guarda el pedido para cuando la app lo recoja.
3. La app recoge el pedido¶
La app revisa el buzón periódicamente. Cuando encuentra un pedido nuevo:
- Lo descarga y lo normaliza al formato de Qu3ntas (cada plataforma manda los datos distinto)
- Crea una orden local con tipo "domicilio" y origen "plataforma"
- Registra la comisión que retiene la plataforma
- Envía la orden a la cocina automáticamente
- El pedido aparece con la etiqueta de la plataforma correspondiente
Configurar la integración¶
Paso 1: Obtener las credenciales¶
Necesitas tener una cuenta de restaurante activa en la plataforma (Rappi Aliados, DiDi Food Partners, etc.).
Paso 2: Registrar el webhook¶
- Ve a Plataformas en el menú lateral de Qu3ntas
- Copia la URL del webhook que se muestra:
https://qu3ntas.com/api/plataformas-webhook?plataforma=rappi&secret=TU_SECRETO
- Registra esa URL en el portal de aliados de la plataforma como tu endpoint de pedidos
Paso 3: Configurar el secreto¶
El secreto es una contraseña compartida que valida que el pedido viene realmente de la plataforma y no de un tercero:
- Genera un secreto seguro
- Configúralo en Ajustes → Plataformas en Qu3ntas
- Ponlo como variable de entorno
PLATAFORMAS_WEBHOOK_SECRETen el servidor
Seguridad
El secreto viaja por HTTPS (cifrado). Cada petición que llega sin el secreto correcto se rechaza con error 401.
Gestionar pedidos¶
En la cocina¶
Los pedidos de plataformas aparecen en la pantalla de cocina con:
- La etiqueta de la plataforma (Rappi naranja, DiDi azul)
- El nombre del cliente y dirección de entrega
- El teléfono de contacto
- Los productos con modificadores
Se preparan igual que cualquier otro pedido: marcar ítems como listos y entregar cuando el repartidor recoja.
En la pantalla de mesas¶
Los pedidos de plataforma aparecen en la sección "Pedidos sin mesa" con:
- Etiqueta de la plataforma
- Referencia del pedido (el ID que asignó la plataforma)
- Estado del domicilio (en preparación, en camino, entregado)
Comisiones¶
Cada plataforma retiene una comisión sobre el valor del pedido. Qu3ntas registra esta comisión al ingerir el pedido para que se refleje en tus reportes financieros.
La comisión se congela al momento de recibir el pedido (no cambia si la plataforma actualiza sus tarifas después).
| Dato | Dónde se ve |
|---|---|
| Monto de comisión | En el detalle de la orden y en los reportes |
| Plataforma | Etiqueta en cocina, mesas y facturas |
| Referencia | ID de la plataforma para conciliación |
Domicilios propios¶
Además de las plataformas, puedes gestionar domicilios propios (pedidos que llegan por WhatsApp, teléfono o la carta digital):
- Desde Mesas, toca + Domicilio
- Se crea una orden con tipo "domicilio"
- Completa los datos del cliente:
- Nombre
- Teléfono
- Dirección de entrega
- Repartidor asignado
- Agrega los productos y envía a cocina
Estados del domicilio¶
| Estado | Significado |
|---|---|
| En preparación | La cocina está preparando el pedido |
| En camino | El repartidor salió con el pedido |
| Entregado | El cliente recibió el pedido |
Health check¶
La URL del webhook también acepta peticiones GET como verificación de disponibilidad. Los portales de aliados suelen hacer esto al registrar la URL para confirmar que responde:
GET /api/plataformas-webhook → {"ok": true, "servicio": "plataformas-webhook"}
Preguntas frecuentes¶
- ¿Qué pasa si mi local está cerrado y llega un pedido?
- El pedido se guarda en el buzón en la nube. Cuando abras la app y te conectes a internet, el pedido aparece automáticamente. Ten en cuenta que las plataformas tienen tiempos máximos de respuesta — si no aceptas a tiempo, la plataforma puede cancelarlo.
- ¿Puedo rechazar un pedido de plataforma?
- Sí, desde la pantalla de cocina o mesas puedes rechazar un pedido (por ejemplo, si un producto está agotado). El rechazo se comunica según los procedimientos de cada plataforma.
- ¿Los pedidos de plataforma generan factura electrónica?
- Depende de tu configuración. Si tienes facturación DIAN activa, los pedidos se pueden facturar como cualquier otra venta.
- ¿Se sincronizan los precios con las plataformas?
- No automáticamente. Los precios en Rappi y DiDi se gestionan desde sus portales de aliados. Si cambias un precio en Qu3ntas, actualízalo también en la plataforma.