Saltar al contenido principal
Resumir con IA
ChatGPTClaude

La integración con el TPV

En resumen

Cuando el TPV y el club no coinciden, en la mayoría de los casos del año la causa estaba en el lado del TPV: una integración activa con la clave de API vacía, un ID de sucursal distinto por cada app del integrador, una devolución que anula la compra pero no el pago, o una sucursal nueva que no está en la Lista de sucursales. El club no puede ver el intercambio entre el TPV y la plataforma; el integrador sí, y ese intercambio es lo que tu proveedor necesita para investigar.

Comprueba primero​

  1. Configuración, Conectividad: la integración que usa tu TPV es la que tiene clave. Una integración que se deja activa con la clave borrada sigue enviando y falla en cada llamada; desactívala, no borres solo la clave. Consulta Conectividad.
  2. Configuración, Lista de sucursales: cada sucursal que envía ventas está en la lista, con el Branch ID que envía el TPV. Una sucursal nueva que no está ahí es invisible en los informes, los favoritos y los filtros por sucursal. Consulta Lista de sucursales.
  3. El miembro en el ticket: ¿se identificó al miembro antes de cerrar la compra, o solo en el pago?

Causas y soluciones​

Las compras llegan sin el miembro​

El TPV identificó al miembro en el pago pero envió la compra en sí sin él. La compra cae en la fila General Membership de los informes y no genera nada. El integrador corrige el orden de las llamadas; para el miembro, tu proveedor puede abonar la compra a mano con el número de pedido.

Se consumieron créditos y el ticket no muestra descuento​

Otra app del integrador (una app de pedidos, un kiosco) envió un pago con los créditos del miembro para ese pedido, y el TPV muestra el importe completo pagado. Envía el número de pedido, la hora, la sucursal y el miembro; el integrador ve qué app envió el pago.

Una devolución no devolvió los créditos​

Anular una compra y anular su pago son dos operaciones. Una integración que anula solo la compra deja los créditos gastados. El integrador añade la anulación del pago; hasta entonces tu proveedor devuelve los créditos a mano si se lo pides.

Cada app envía un ID de sucursal distinto​

Un restaurante apareció como varias sucursales porque el TPV, la app de pedidos y el kiosco del integrador enviaban identificadores distintos para él. El integrador los unifica en un ID por sucursal, y después se refresca la Lista de sucursales.

Los miembros registrados por el TPV o por una app de pedidos sin los campos de consentimiento no pueden recibir mensajes ni canjear hasta que terminan de registrarse en la app. El integrador envía los campos de condiciones y RGPD con el registro; la plataforma entonces manda al miembro un SMS con un enlace para completar la ficha.

"Error 3" u otro código en el TPV​

El código que muestra la app del TPV es del propio TPV. Una captura de él no le dice a nadie qué se envió. Pide al integrador la petición y la respuesta que hay detrás (la dirección llamada, el cuerpo, el código HTTP), con la hora y la sucursal, y envía eso.

Cuándo escribir a tu proveedor​

Escribe con el número de pedido, la hora, la sucursal, el teléfono o el email del miembro y, para los errores, la petición y la respuesta que te dé el integrador. Consulta Cómo pedir ayuda.