Cómo configurar la API de FUDO en Tanteado
En unos 10 minutos conectás tu FUDO con Tanteado: las ventas cerradas con el DNI o celular del cliente suman sellos en su tarjeta de Apple Wallet o Google Wallet.
Antes de empezar, necesitás:
- FUDO con Plan Pro o superior.
- Acceso de administrador en FUDO, para habilitar la API y crear usuarios.
- Tu cuenta de Tanteado con el programa de sellos ya creado.
- 1
Habilitá la API Pública en FUDO
- La API de FUDO está disponible desde el Plan Pro. Con otro plan, FUDO te muestra la pantalla para actualizarlo.
- En FUDO entrá a Aplicaciones externas > API Pública General.
- Contestá para qué vas a usar la API (por ejemplo: "Programa de fidelización con Tanteado") y confirmá. La API queda marcada en verde.
- 2
Creá un usuario para Tanteado
- En Administración > Usuarios creá un usuario nuevo, por ejemplo "Tanteado". Te conviene uno exclusivo: si algún día querés cortar el acceso, lo desactivás sin tocar a tu equipo.
- Dale un rol que pueda ver las ventas y los clientes. Tanteado solo lee; no crea ni modifica nada en FUDO.
- 3
Copiá la API Key y generá el API Secret
- Abrí ese usuario en modo edición. Ahí aparece la API Key: copiala.
- Tocá Establecer para generar el API Secret, copialo y confirmá con Aceptar.
- Importante: FUDO muestra el API Secret una sola vez. Si lo perdés no se recupera; tenés que generar uno nuevo y volver a cargarlo en Tanteado.
- 4
Cargá las credenciales en Tanteado
- En tu panel de Tanteado entrá a Integraciones y buscá la tarjeta FUDO (fu.do).
- Tildá Habilitar integración con Fudo y pegá la API Key y el API Secret.
- Tocá Probar conexión. Si sale "Conexión con Fudo verificada correctamente", tocá Guardar cambios de Fudo.
- 5
Identificá al cliente en cada venta
- Para que la venta sume, Tanteado tiene que saber de quién es la tarjeta. Hay dos formas, y podés usar las dos:
- Cliente registrado en FUDO: asociá la venta a un cliente que tenga cargado el DNI (o CUIT), el celular o el email. Tienen que coincidir con los que el cliente usó al sacar su tarjeta de Tanteado.
- Comentario de la venta: el mozo o cajero escribe el DNI o el celular en el comentario, por ejemplo "dni 30111222" o "cel 1155554444". Para esto tiene que estar tildada la opción Sumar automáticamente al detectar DNI o celular en comentarios.
- Si no querés que una venta sume, escribí "no sumar" en el comentario.
- 6
Sincronizá las ventas
- Tocá Sincronizar ventas ahora en la tarjeta de FUDO. Tanteado revisa las últimas 50 ventas cerradas y suma los sellos de las que tienen un cliente identificado.
- Podés sincronizar todas las veces que quieras: cada venta suma una sola vez, nunca se duplica.
- Solo cuentan las ventas cerradas. Las que siguen en curso o se cancelaron no suman.
Si algo no anda
“FUDO rechazó la API Key o el API Secret”
Revisá que hayas copiado las dos sin espacios de más. Si no estás seguro del Secret, generá uno nuevo desde Administración > Usuarios y volvé a cargarlo.
“El usuario de FUDO no tiene permiso para ver ventas”
Las credenciales andan, pero el rol del usuario no alcanza. Editá el usuario en FUDO y dale permiso sobre ventas y clientes.
“No se encontró ningún cliente con los identificadores proporcionados”
La venta tenía un DNI o celular, pero no coincide con ninguna tarjeta de tu programa. Pasa cuando el cliente todavía no sacó su tarjeta o la sacó con otro número.
“La sincronización termina bien pero no suma sellos”
Las ventas revisadas no tenían cliente asociado ni DNI o celular en el comentario. Probá con una venta de prueba que tenga "dni" y tu número en el comentario.
Seguridad
El API Secret es como una contraseña: no lo mandes por chat ni lo compartas. Si creés que se filtró, generá uno nuevo en FUDO (el anterior deja de funcionar) y actualizalo en Tanteado. Para cortar el acceso del todo, desactivá el usuario de Tanteado en FUDO.
