Volver al Blog
Integraciones y sistemas

Cómo integrar los pedidos online con el TPV de un restaurante sin duplicar órdenes

Una guía práctica para conectar los pedidos online con el TPV: mapear productos y modificadores, definir responsables, controlar reintentos, probar incidencias y desplegar la integración de forma gradual.

Publicado 5 min de lectura

Un cliente paga un pedido online. La pantalla de confirmación tarda en cargar y alguien pulsa «reintentar». Si la conexión con el TPV no distingue un pedido nuevo de uno ya enviado, cocina puede recibir dos órdenes. Si, por evitarlo, el sistema deja de reenviar cualquier pedido dudoso, el restaurante puede quedarse sin una orden que sí ha cobrado.

Integrar pedidos online con el TPV no consiste solo en trasladar datos de una pantalla a otra. Hay que acordar qué sistema registra cada evento, cómo se reconocen los pedidos repetidos y quién resuelve una discrepancia durante el servicio. Estas decisiones importan tanto como la conexión técnica.

Dibujar el recorrido antes de conectar sistemas

Empieza por seguir un pedido real desde la web o aplicación hasta su preparación. Identifica dónde se crea, cuándo se confirma el pago, en qué momento lo acepta el restaurante y qué evento lo envía a cocina. Anota también qué sucede con cancelaciones, cambios, pedidos programados y fallos de conexión.

El equipo debe decidir qué sistema es la referencia para cada dato. Por ejemplo, el catálogo puede gestionarse en el TPV o en una herramienta central, mientras que la plataforma online conserva el identificador y el estado de pago de la compra. No hace falta que un sistema sea dueño de todo; sí hace falta evitar que ambos cambien el mismo dato sin una regla clara.

Define asimismo el alcance de la primera versión. Si hay varios canales o locales, empezar por un solo canal y un local reduce las combinaciones que habrá que comprobar. Conviene dejar por escrito qué pedidos seguirán gestionándose manualmente durante la prueba y quién vigilará esa transición.

Mapear el menú como se vende, no solo como aparece

Un nombre parecido no garantiza que dos artículos sean equivalentes. El mapeo debe vincular cada producto online con un identificador válido del TPV e incluir tamaños, variantes, modificadores, suplementos y notas de preparación. Comprueba qué ocurre si una opción obligatoria no existe en uno de los sistemas o si un artículo deja de estar disponible.

Revisa además los importes y datos que necesita la operación: precio, descuentos, cargos de entrega, impuestos configurados, propinas cuando correspondan, forma de pago y tipo de servicio. La integración no debería recalcular importes de manera implícita ni enviar a cocina un pedido que parece completo pero ha perdido un modificador. Cuando hay una diferencia, es preferible marcar la orden para revisión que sustituir silenciosamente un producto.

Asigna responsables concretos: quién mantiene el catálogo, quién aprueba cambios en los mapeos y quién comprueba una incidencia en turno. Una tabla de equivalencias documentada, con fecha de actualización y casos que todavía requieren intervención, resulta más útil que depender de la memoria de una sola persona.

Evitar duplicados sin perder pedidos

Cada pedido necesita un identificador estable del canal de origen que acompañe a todos los intentos de entrega. La integración puede registrar la relación entre ese identificador y el número de orden del TPV. Antes de crear una orden, debe comprobar si ya existe esa relación. Este principio, conocido como idempotencia, permite repetir una solicitud sin crear otra venta por accidente.

La comprobación debe resistir situaciones menos evidentes: dos avisos casi simultáneos, un reintento después de una espera agotada o una respuesta del TPV que se pierde aunque la orden se haya creado. En este último caso, «no recibí confirmación» no significa necesariamente «no se creó». La acción segura es consultar el estado o llevar el caso a una cola de revisión, no insertar a ciegas otra orden.

Separar estados ayuda a operar: recibido, pendiente de validación, enviado al TPV, confirmado, rechazado o pendiente de revisión. La pantalla operativa debe mostrar el motivo del error y la siguiente acción posible. También conviene distinguir una cancelación de un pedido nuevo: modificar o anular una orden existente exige una regla distinta de la que crea órdenes.

Responsables y controles durante el servicio

La integración necesita una persona o equipo responsable de su funcionamiento técnico y un responsable operativo capaz de decidir qué hacer con las excepciones. Acuerda cómo se avisa al restaurante si falla un envío, quién verifica el TPV antes de introducir una orden manual y cómo se marca después esa intervención para que un reintento no la duplique.

Guarda un registro de eventos suficiente para reconstruir lo ocurrido: identificador de origen, intentos, respuestas, cambios de estado y acciones manuales. Limita el acceso a los datos y credenciales necesarios; evita exponer información del cliente en registros que no la necesitan. Para los casos inciertos, una revisión humana es mejor que una automatización que oculte el problema.

Probar las excepciones y desplegar poco a poco

Antes de operar en directo, prueba pedidos sencillos y otros con variantes, suplementos, descuentos y notas. Simula respuestas tardías, mensajes duplicados, pérdida de conexión y artículos sin correspondencia. Comprueba tanto lo que ve cocina como lo que figura en el TPV y en el canal online: los tres deben contar una historia coherente.

El despliegue puede empezar con un local, un canal y un conjunto acotado de productos, con supervisión en cada turno. Prepara una forma de detener nuevos envíos automáticos y volver temporalmente al procedimiento manual sin perder el registro de pedidos pendientes. Amplía el alcance solo cuando el equipo sepa detectar, resolver y documentar las incidencias habituales.

Para medir el resultado, compara pedidos recibidos con órdenes confirmadas en el TPV y revisa duplicados, pedidos pendientes, errores de mapeo e intervenciones manuales. Anota cuánto tardan en detectarse y resolverse las excepciones. Esas señales muestran dónde mejorar antes de añadir más canales o locales.

Si quieres revisar el recorrido de tus pedidos antes de conectar sistemas, Cibercoding puede ayudarte a delimitar una primera integración y sus controles.

Temas

  • Integraciones
  • Restaurantes
  • TPV
  • Pedidos online
  • Automatización