En este artículo aprenderás a generar, renovar y eliminar los certificados de tu Clara API desde Self Service, sin abrir un caso y sin depender del soporte. La sección Clara API te permite administrar los certificados que autentican tus integraciones: cada proyecto genera su propio par de claves (pública y privada) y sus credenciales de cliente. Aquí está el flujo completo: crear, renovar a tiempo y eliminar cuando ya no lo necesites.
Antes de comenzar
|
Perfil de administrador Solo un usuario Admin puede crear y eliminar proyectos. El perfil Contador puede ver la lista y el detalle, pero no puede generar ni eliminar certificados. |
|
API habilitada La sección está disponible con la API activa, en el plan Free o en un plan de pago. En el plan Free tienes 500 solicitudes; cuando se agotan, la sección se bloquea y no podrás generar certificados nuevos hasta cambiar de plan. |
|
Permisos definidos Define lo que necesita tu integración: lectura, escritura o ambas, y por servicio. Los permisos del panel son los únicos disponibles en Self Service; si necesitas otro, solicítalo al soporte. |
Genera tu certificado
Accede a Configuración › Integraciones y abre la pestaña Clara API .
Haz clic en "Administrar credenciales del proyecto" . Verás todos los proyectos de la empresa, quién los creó, la fecha de vencimiento y el estado.
Haz clic en "Crear proyecto". El panel lateral "Nuevo proyecto" se abre a la derecha.
Usa un nombre que reconozcas después, por ejemplo "Integración ERP" o "Conciliación".
De 30 a 360 días (máximo). Si no hay un motivo específico, usa 360 días.
Marca las acciones de escritura y lectura que necesita tu integración. Puedes elegir todas las de una categoría o solo algunos servicios.
Haz clic en "Crear". El panel muestra la fecha de vencimiento, los permisos y los tres archivos del certificado.
Descarga los tres archivos y cierra el panel. El botón "Cerrar" solo se habilita cuando terminas las descargas.
Descarga única. Los certificados no quedan disponibles después de cerrar la ventana. Si pierdes los archivos, tendrás que crear un proyecto nuevo.
Archivos que descargas
| Archivo | Qué es | Para qué sirve |
|---|---|---|
| Clave pública | Archivo .txt que cambias el nombre a .crt | Cifrado y verificación |
| Clave privada | Archivo .txt que cambias el nombre a .key | Descifrado y firma |
| Credenciales de cliente | JSON con Client ID, Client Secret y permisos | Autenticar tu integración |
Nota: guarda los tres archivos en un lugar seguro y no los compartas por canales abiertos. El certificado por sí solo no autentica: cada solicitud necesita el certificado mTLS y un token generado con el Client ID y el Client Secret.
Renueva antes del vencimiento
Cuando faltan 30 días o menos para que un proyecto venza, aparece un aviso amarillo sobre la lista de credenciales. El aviso indica qué proyecto es y cuántos días faltan. Para renovar sin interrumpir el servicio:
Crea un proyecto nuevo con los mismos permisos. Puedes usar el atajo "Crear nuevo" del aviso.
Descarga los tres archivos del proyecto nuevo.
Actualiza tu integración con las credenciales nuevas.
Confirma que todo funciona y, solo entonces, elimina el proyecto anterior.
Nota: la renovación no es automática. Si el certificado vence, las llamadas a la API dejan de autenticarse hasta que actualices las credenciales.
Filtra tus proyectos
En Credenciales del proyecto encuentras cualquier certificado:
|
Buscar por proyecto Escribe el nombre directamente. |
|
Agregar filtro › Creado por Selecciona uno o varios usuarios. |
|
Agregar filtro › Estado Activa, Por vencer o Vencida. |
|
Ordenamiento Ordena por fecha de vencimiento con la flecha del encabezado. |
Los filtros aplicados aparecen como etiquetas sobre la tabla. Quítalos con la "x" de cada etiqueta.
Elimina un proyecto
Haz clic en el ícono de papelera de la fila del proyecto.
El proyecto se elimina de forma permanente y todas sus claves se desactivan; las apps o integraciones conectadas dejan de funcionar.
Escribe el nombre completo del proyecto para confirmar. El botón "Eliminar" solo se habilita si el nombre coincide.
Esta acción no se puede deshacer.
Monitorea el desempeño
En la pestaña Insights de la API ves el resumen mensual de tu consumo:
|
Solicitudes restantes Cuántas siguen disponibles en el período (500 en el plan Free). |
|
Total de solicitudes Cuántas hiciste y cómo se comparan con el mes anterior. |
|
Tasa de éxito El porcentaje de llamadas que respondieron correctamente. |
El detalle por servicio muestra las solicitudes y la tasa de éxito de cada uno. Puedes filtrar por intervalo de tiempo y por proyecto, y buscar un servicio específico.
Preguntas frecuentes
|
¿Necesito un plan de pago para generar un certificado? No para emitirlo. En el plan Free tienes 500 solicitudes. Cuando se agotan, la sección se bloquea y no podrás generar certificados nuevos hasta cambiar de plan. |
|
¿Cuánto dura un certificado? De 30 a 360 días. Recomendamos 360 y renovar antes del vencimiento. |
|
¿Puedo volver a descargar los archivos? No. La descarga es única y los certificados salen del panel al cerrar la ventana. Si pierdes los archivos, crea un proyecto nuevo. |
|
¿Qué pasa si el certificado vence? Las llamadas a la API dejan de autenticarse. No hay renovación automática: debes crear uno nuevo y actualizar la integración. |
|
¿Cómo renuevo sin interrumpir el servicio? Crea el proyecto nuevo, descarga los archivos, actualiza la integración y confirma. Después elimina el proyecto anterior. |
|
¿Puedo tener varios proyectos? Sí. Lo recomendado es uno por integración o por ambiente (producción, pruebas). |
|
¿Puedo cambiar los permisos de un proyecto existente? No. Los permisos se definen al crear el proyecto y no se pueden editar después. Si necesitas otros, crea un proyecto nuevo. |
|
¿Qué puede hacer el perfil Contador? Puede consultar la lista y el detalle de los proyectos, pero no puede generar ni eliminar certificados. Eso queda solo para administradores. |
|
¿Y si necesito un permiso que no aparece en el panel? Los permisos del panel son los únicos disponibles en Self Service. Si necesitas otro, solicítalo al soporte. |
¿Tienes preguntas sobre una columna o un valor de tu exportación?
Escríbenos a contacto@clara.com o contáctanos desde el chat de la plataforma. 💬
Comentarios
Inicie sesión para dejar un comentario.