Saltar a contenido

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:

  1. Lo descarga y lo normaliza al formato de Qu3ntas (cada plataforma manda los datos distinto)
  2. Crea una orden local con tipo "domicilio" y origen "plataforma"
  3. Registra la comisión que retiene la plataforma
  4. Envía la orden a la cocina automáticamente
  5. 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

  1. Ve a Plataformas en el menú lateral de Qu3ntas
  2. Copia la URL del webhook que se muestra:
https://qu3ntas.com/api/plataformas-webhook?plataforma=rappi&secret=TU_SECRETO
  1. 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:

  1. Genera un secreto seguro
  2. Configúralo en Ajustes → Plataformas en Qu3ntas
  3. Ponlo como variable de entorno PLATAFORMAS_WEBHOOK_SECRET en 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):

  1. Desde Mesas, toca + Domicilio
  2. Se crea una orden con tipo "domicilio"
  3. Completa los datos del cliente:
    • Nombre
    • Teléfono
    • Dirección de entrega
    • Repartidor asignado
  4. 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.