Clara API — Certificados y renovación

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

1Accede a Clara API

Accede a Configuración › Integraciones y abre la pestaña Clara API .

 

 

2Administra las credenciales del proyecto

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.

 

 

3Crea un proyecto nuevo

Haz clic en "Crear proyecto". El panel lateral "Nuevo proyecto" se abre a la derecha.

4Dale un nombre al proyecto

Usa un nombre que reconozcas después, por ejemplo "Integración ERP" o "Conciliación".

5Elige la validez

De 30 a 360 días (máximo). Si no hay un motivo específico, usa 360 días.

6Selecciona los permisos

Marca las acciones de escritura y lectura que necesita tu integración. Puedes elegir todas las de una categoría o solo algunos servicios.

 

 

7Crea el proyecto

Haz clic en "Crear". El panel muestra la fecha de vencimiento, los permisos y los tres archivos del certificado.

8Descarga los archivos

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:

1Crea un proyecto nuevo

Crea un proyecto nuevo con los mismos permisos. Puedes usar el atajo "Crear nuevo" del aviso.

2Descarga los archivos

Descarga los tres archivos del proyecto nuevo.

3Actualiza tu integración

Actualiza tu integración con las credenciales nuevas.

4Elimina el proyecto anterior

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

1Haz clic en el ícono de papelera

Haz clic en el ícono de papelera de la fila del proyecto.


2Lee el aviso

El proyecto se elimina de forma permanente y todas sus claves se desactivan; las apps o integraciones conectadas dejan de funcionar.


3Escribe el nombre del proyecto

Escribe el nombre completo del proyecto para confirmar. El botón "Eliminar" solo se habilita si el nombre coincide.


4Confirma

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. 💬

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0
¿Tiene más preguntas? Enviar una solicitud

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.