# Certificados digitales: cargar, asociar y proteger tu .p12

> Tu certificado digital (.p12 o .pfx) se carga en Configuración → Certificados con su clave. Frayi Doc-e lo guarda cifrado en tu computador, sin subirlo a la nube, y lo usa con la empresa de su mismo NIT. Lo necesitas para la API Oficial, Portal · Certificado y para firmar eventos RADIAN.

Página: https://frayi.co/documentacion/certificados-y-boveda/ · Categoría: Empresas y certificados · Actualizado el 18 de octubre de 2026 · Documentación de Frayi Doc-e (GRANFOGROUP S.A.S.).

Un certificado digital es tu firma electrónica guardada en un archivo, normalmente con extensión .p12 o .pfx. Lo emite una entidad de certificación acreditada por la ONAC y es la forma en que la DIAN reconoce que eres tú.

## Para qué lo usa Frayi Doc-e

- **API Oficial:** extraer documentos por CUFE, sin navegador ni captcha. [Ver API Oficial](https://frayi.co/documentacion/web-service-oficial/).
- **Portal · Certificado:** consultar periodos completos en el portal sin depender de un token que caduca. [Ver Portal · Certificado](https://frayi.co/documentacion/portal-certificado/).
- **Consulta de terceros con la API Oficial:** validar NIT firmando la consulta con tu certificado. [Ver consulta de terceros](https://frayi.co/documentacion/consulta-de-terceros/).
- **RADIAN:** firmar los eventos que emites ante la DIAN. [Ver RADIAN](https://frayi.co/documentacion/radian-eventos-y-orden/).

Portal · Token y Buzón Tributario no necesitan certificado.

## Cargar un certificado

1. **Ve a Configuración → Certificados**: Desde el menú lateral.
2. **Pulsa + Agregar certificado**: Se abre la ventana «Agregar certificado digital».
3. **Elige el archivo y escribe su clave**: El archivo .p12 o .pfx y la contraseña con la que lo recibiste.
4. **Pulsa Leer metadata**: La app muestra el titular, el NIT o la cédula, el emisor y la vigencia. Si está vencido, lo marca como **Vencido**.
5. **Ponle un alias**: Un nombre para reconocerlo, por ejemplo el de la empresa o el cliente.
6. **Pulsa Guardar certificado**: Queda guardado y listo para usar.

> **Nota:** En la app de escritorio el certificado se guarda **cifrado en tu computador** y ligado a él. Nunca se sube a la nube. En la tabla aparece con almacenamiento **Local**. En Windows, para entrar al portal con certificado, la app también lo agrega al almacén personal de certificados de tu usuario, que es donde el navegador de consulta lo busca.

## La tabla de certificados

En Configuración → Certificados ves cada certificado con su **Alias**, **NIT / CC**, **Titular**, **Emisor**, **Vigencia**, **Almacenamiento** y **Empresa**. Puedes buscar por alias, NIT o razón social.

En **Acciones** tienes:

- **Renombrar**, para cambiar el alias;
- **Eliminar**, para quitarlo de la app.

## Cómo se asocia a cada empresa

Cada certificado queda asociado a un NIT. Cuando trabajas con una empresa, la app elige el certificado cuyo NIT coincide y lo marca con una señal de verificación en las listas donde debas escogerlo. El criterio es un certificado por empresa.

Si el NIT no coincide o no se detectó, asígnalo a mano en la columna **Empresa** de la tabla. Esa es la empresa que usará el certificado al emitir eventos RADIAN.

## Eliminar un certificado

Al eliminarlo, las empresas asociadas pierden su referencia. Puedes volver a cargarlo cuando quieras. Para agregar o eliminar certificados necesitas el permiso **Gestionar certificados**, si eres miembro de un equipo. [Ver miembros y permisos](https://frayi.co/documentacion/miembros-y-permisos/).

> **Importante:** Cuida tu archivo .p12 y su contraseña. Si los pierdes, no hay forma de recuperarlos: tendrías que pedir la reexpedición a la entidad que emitió el certificado.

## Si no tienes certificado

- **Cómpralo en frayi.co.** Frayi gestiona certificados de firma digital emitidos por Camerfirma, para ti o para terceros. [Ver comprar un certificado digital](https://frayi.co/documentacion/comprar-certificado-digital/).
- **Revisa otras entidades.** En Configuración → Certificados, el botón **Ver alternativas** muestra otras entidades de certificación.
- **Certificado gratuito de la DIAN.** No se puede descargar ni cargar en la app, pero sirve para algunos eventos RADIAN por token. [Ver certificado gratuito DIAN](https://frayi.co/documentacion/certificado-gratuito-dian/).

## Preguntas frecuentes

### ¿Mi certificado se sube a la nube?

No. En la app de escritorio se guarda cifrado en tu computador.

### ¿Puedo usar el mismo certificado en dos computadores?

Sí, pero tienes que cargarlo en cada uno, porque queda ligado al computador donde lo guardas.

### La app no detecta el NIT del certificado

Algunos certificados de persona natural traen la cédula. Asígnalo a la empresa a mano en la columna **Empresa** de la tabla.

### Mi certificado viene en un token físico o en la nube

La app trabaja con certificados en archivo .p12 o .pfx. Si tu entidad te lo entregó en otro formato, sigue sus instrucciones o consulta con ella si puede entregarlo como archivo.

### ¿Qué pasa cuando el certificado vence?

La app lo marca como **Vencido**. Renuévalo con tu entidad y carga el archivo nuevo.

---

Más guías: https://frayi.co/documentacion/ (índice en Markdown: https://frayi.co/documentacion.md).
