La funcionalidad Aplicaciones a medida de Tiendanube te permite generar claves de acceso (tokens) directamente desde el administrador de tu tienda, sin necesidad de convertirte en Partner Tecnológico ni usar soluciones intermediarias. Con esas claves, podés conectar sistemas propios a los datos de tu tienda a través de la API: desde sincronizar el stock y los pedidos con tu ERP o sistema de gestión, hasta enviar datos de ventas a Power BI, Looker o Google Sheets, o automatizar la actualización masiva de precios y productos con scripts internos.
Helpjuice Success Callout Title
Esta funcionalidad está disponible únicamente para los planes Escala y Tiendanube Evolución.
¿Qué es y cómo funciona "Aplicaciones a medida"?
Una aplicación a medida es una clave de acceso privada de tu tienda. A diferencia de las aplicaciones de la Tienda de Aplicaciones, públicas y desarrolladas por Partners de Tiendanube, una aplicación a medida:
- La creás vos, desde el administrador de tu tienda.
- No es visible para otros comerciantes ni aparece en la Tienda de Aplicaciones.
- Genera un token de acceso exclusivo para autenticar tus integraciones.
- Te permite elegir exactamente qué permisos tendrá ese token.
¿Para qué se pueden usar las aplicaciones a medida?
Algunos casos de uso frecuentes:
- Integración con ERP propio: sincronizar productos, pedidos y stock con el sistema interno de tu empresa.
- Conexión con herramientas de BI: enviar datos de ventas a Power BI, Looker, Metabase o planillas de cálculo.
- Automatizaciones internas: scripts que importan o exportan pedidos, actualizan precios en lote, etc.
- Integraciones personalizadas: herramientas desarrolladas por tu equipo que todavía no existen en la Tienda de Aplicaciones.
- Acceso para desarrolladores: darle a un desarrollador la posibilidad de consumir la API de tu tienda sin compartir el login del panel.
¿Cómo crear una aplicación a medida y acceder al token?
1. Pasos para crear una aplicación a medida
1. Ingresar desde tu administrador de Tiendanube a "Aplicaciones a medida" ubicada en el menú lateral.
2. Hacer clic en el botón "Crear aplicación a medida" si es la primera vez que accedés, o hacer clic en el botón "+ Crear" si ya contás con aplicaciones creadas.
3. Completar los datos de la nueva aplicación:
Identificación: escribir un nombre que identifique la integración (por ejemplo: "Integración ERP", "Script de reportes", "Conexión Power BI").
Perfiles de acceso: elegir los permisos que necesita la integración. Podés dar acceso total o seleccionar permisos granulares para cada recurso (productos, pedidos, clientes, stock, etc.).
Helpjuice Warning Callout Title
Evitá seleccionar "Acceso total" a menos que sea estrictamente necesario. Lo recomendable es otorgar solo los permisos que la integración va a usar, siguiendo el principio de mínimo privilegio.
4. Hacer clic en "Guardar". El token de acceso se generará automáticamente y aparecerá listado en la sección de la aplicación.
2. Obtener y guardar el token de acceso
Helpjuice Success Callout Title
El token de acceso funciona bajo el modelo de visualización única: solo podés verlo completo una vez. Por eso, es importante seguir estos pasos con atención.
1. Luego de guardar la aplicación, hacer clic en el token recién creado en el listado.
2. Hacer clic en el botón "Revelar".
3. El token completo queda visible en pantalla.
Helpjuice Success Callout Title
Una vez que cerrás esta pantalla, el token queda permanentemente enmascarado y solo se muestran los últimos 4 dígitos (por ejemplo: ••••••1A2B). Si lo perdés, no puede recuperarse: tendrás que revocarlo, crear uno nuevo y reconfigurar la integración.
4. Podés elegir cómo guardarlo o compartirlo haciendo clic en:
- Copiar token: copiá el token al portapapeles para pegarlo directamente en tu herramienta o sistema.
- Compartir token: generá un link de un solo uso para enviárselo de forma segura a un desarrollador o colaborador.
5. Una vez copiado o compartido, guardarlo en un lugar seguro: un gestor de contraseñas, una variable de entorno, o la herramienta de gestión de secretos que uses.
Helpjuice Info Callout Title
El link de "Compartir token" es de un solo uso y expira después de ser abierto. Es la forma más segura de pasarle el token a otro miembro del equipo sin enviarlo directamente por chat o email.
3. Usar el token de acceso
Con el token en mano, podés autenticar cualquier solicitud a la API de Tiendanube desde tu integración, script o sistema externo.
Helpjuice Warning Callout Title
Para consultar los endpoints disponibles, los parámetros y ejemplos de uso, accedé a la documentación oficial de la API de Tiendanube.
Si necesitás que un desarrollador se encargue de configurar la integración, podés delegarle el acceso a las aplicaciones a medida sin darle acceso completo al panel. Para eso, ir a "Configuración > Usuarios y notificaciones" y asignarle el permiso "Aplicaciones a medida".
¡Listo! Tu aplicación a medida está creada y el token está listo para conectar tu integración. Recordá guardar el token en un lugar seguro antes de cerrar la pantalla de visualización.
Helpjuice Info Callout Title
Para aprender a actualizar permisos, rotar tokens o delegar la gestión a un desarrollador, consultá el tutorial ¿Cómo gestionar las aplicaciones a medida en Tiendanube?
Buenas prácticas para las aplicaciones a medida
Helpjuice Success Callout Title
Las aplicaciones a medida generan claves de acceso que conectan sistemas externos a tu tienda. Mantené esas claves confidenciales en todo momento.
-
Principio de mínimo privilegio: otorgá solo los permisos estrictamente necesarios para cada integración. Si una herramienta solo necesita leer pedidos, no le des acceso a clientes ni a productos.
-
Una aplicación por integración: evitá reutilizar la misma clave para usos distintos. Así podés revocar o renovar un acceso específico sin afectar el resto de tus integraciones.
-
Nunca compartas el token como si fuera un link: tratalo como una contraseña. No lo pegues en chats, emails ni documentos compartidos. Usá el botón "Compartir token" o un gestor de contraseñas.
-
No lo subas a repositorios públicos: si tu equipo usa GitHub u otro sistema de control de versiones, asegurate de que el token esté excluido y nunca quede expuesto en el código.
-
Rotación periódica: renová el token cada 90 o 180 días como buena práctica, aunque no haya indicios de que fue comprometido.
- Revisá los accesos activos regularmente: desactivá las aplicaciones que ya no estén en uso. Cada clave activa es una superficie de ataque potencial.
Preguntas frecuentes sobre la creación de aplicaciones a medida
¿Cuántas aplicaciones a medida puedo crear?
No hay límite de cantidad. Se recomienda crear una aplicación por integración para facilitar la gestión y poder revocar accesos de forma individual cuando sea necesario.
¿Otras personas o tiendas pueden ver mis aplicaciones a medida?
No. Las aplicaciones a medida son privadas de tu tienda y no aparecen en ningún lugar público de Tiendanube.
¿Necesito saber programar para crear una aplicación a medida?
Para crear la aplicación e instalarla, no. Pero para conectar el token a una integración externa generalmente necesitás a alguien con conocimientos técnicos. Por eso podés delegar la gestión de aplicaciones a un desarrollador de tu equipo sin darle acceso completo al panel.
¿Hay límites de solicitudes a la API?
Sí. Cada aplicación a medida tiene un límite de 2 solicitudes por segundo, con un buffer de 40 solicitudes, igual que las apps de la Tienda de Aplicaciones.
¿Qué pasa con el token si cambio el propietario de la tienda?
El token sigue funcionando con normalidad. La aplicación permanece vinculada a la tienda, no a la persona propietaria.