{"section":"tracks","requestedLocale":"es","requestedSlug":"claves-de-api-para-integraciones","locale":"es","slug":"claves-de-api-para-integraciones","path":"docs/es/tracks/módulos-vtex-primeros-pasos/cuentas-y-permisos/claves-de-api-para-integraciones.md","branch":"main","content":"Para conectar tu tienda VTEX con sistemas externos (ERPs, herramientas de marketing, plataformas de gestión) utiliza **claves de API** para autenticar esas integraciones de forma segura.\n\nLas claves de API son credenciales que permiten que los sistemas externos accedan a las APIs de VTEX. Cada clave consta de:\n\n- **API Key**: identificador público de la clave.\n- **API Token**: contraseña secreta (se muestra solo una vez al crearlo).\n\nLas claves deben estar activas y tener [roles](https://help.vtex.com/es/docs/tutorials/roles) asociados que determinan los recursos a los que se puede acceder.\n\n## Tipos de claves\n\n| Tipo                                               | Descripción                                                                                                                 | Casos de uso                                                             | Documentación                                           |\n| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------- |\n| **Claves internas (generadas)** | Creadas en el Admin VTEX. Tienes control total para crear, editar roles, renovar y revocar. | Integraciones con ERP, automatizaciones internas, scripts personalizados | [Claves generadas](https://help.vtex.com/es/docs/tutorials/claves-generadas) |\n| **Claves externas (terceros)**  | Creadas por partners/aplicaciones. Solo controlas los roles en tu cuenta.                   | Aplicaciones de VTEX App Store, integraciones con partners certificados  | [Claves externas](https://help.vtex.com/es/docs/tutorials/claves-externas)   |\n\n## Gestionar claves de API\n\n**Gestionadas en:** _Configuración de la cuenta > Claves de API_\n\n**Qué puedes hacer:**\n\n- Ver todas las claves (internas y externas).\n- Crear claves internas.\n- Agregar claves externas.\n- Editar roles.\n- Activar/desactivar claves.\n- Renovar tokens.\n- Eliminar claves.\n- Exportar lista para auditoría.\n\n> ℹ️ Consulta [Claves de API](https://help.vtex.com/es/docs/tutorials/claves-de-api).\n\n## Principio de mínimo privilegio\n\nAsocia solo los roles estrictamente necesarios. Ejemplos:\n\n- Integración que **solo lee pedidos** → solo rol de lectura de pedidos\n- ERP que gestiona stock → solo roles de catálogo y logística\n\n## Renovación y alertas\n\nRenueva tokens periódicamente (3-6 meses para claves críticas). Configura [alertas automáticas](https://help.vtex.com/es/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api) para evitar vencimientos.\n\n> ⚠️ El token de API se muestra solo una vez al crearlo. Guárdalo de forma segura.\n\n## Requisitos de permisos\n\nRol [User Administrator - RESTRICTED](https://help.vtex.com/es/docs/tutorials/roles-de-usuario-predefinidos) o un rol personalizado con los recursos:\n\n- View API Keys\n- Edit API Keys\n- Renew API Token\n- Edit API Keys settings\n\n## Mejores prácticas\n\n- Usa nombres descriptivos.\n- Aplica mínimo privilegio.\n- Guarda los tokens de forma segura (nunca en el código fuente).\n- Renueva periódicamente.\n- Audita y elimina claves innecesarias.\n- Revócala de inmediato si está comprometida.\n- Nunca utilices código del lado del cliente para integraciones.\n- No compartas tokens por email, chat o tickets.\n\n> ℹ️ Consulta [Buenas prácticas para el uso de claves de API](https://help.vtex.com/es/docs/tutorials/buenas-practicas-claves-de-api).\n\n## Más información\n\n- [Claves de API](https://help.vtex.com/es/docs/tutorials/claves-de-api)\n- [Buenas prácticas para el uso de claves de API](https://help.vtex.com/es/docs/tutorials/buenas-practicas-claves-de-api)\n- [Claves generadas](https://help.vtex.com/es/docs/tutorials/claves-generadas)\n- [Claves externas](https://help.vtex.com/es/docs/tutorials/claves-externas)\n- [Renovar token de API](https://help.vtex.com/es/docs/tutorials/renovar-token-de-api)\n- [Configurar alerta para renovar tokens de API](https://help.vtex.com/es/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api)\n- [Exportar claves de API](https://help.vtex.com/es/docs/tutorials/exportar-claves-de-api)\n- [Roles](https://help.vtex.com/es/docs/tutorials/roles)\n- [Recursos de License Manager](https://help.vtex.com/es/docs/tutorials/recursos-del-license-manager)\n- [API authentication using application keys](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) (para desarrolladores)"}