Es fácil confundir tu certificado propio con el de la Solución Gratuita de la DIAN. Funcionan distinto, y en Frayi Doc-e se usan de forma distinta.
Qué es el certificado gratuito
- La Solución Gratuita es un servicio de la DIAN para facturadores de bajo volumen.
- Quien factura con ella puede obtener de la DIAN un certificado de firma digital sin costo.
- Ese certificado vive en los servidores de la DIAN. No se descarga como archivo .p12 o .pfx, así que no se puede cargar en la app.
Qué puedes hacer con él en Frayi Doc-e
| Uso | Con el certificado gratuito | Con tu certificado .p12 |
|---|---|---|
| Emitir eventos RADIAN | Sí, por el canal de token | Sí |
| API Oficial | No | Sí |
| Portal · Certificado | No | Sí |
| Consulta de terceros con la API Oficial | No | Sí |
Para usarlo en RADIAN, la app aprovecha la sesión de tu token DIAN. Cuando todo está listo, al registrar un evento eliges la opción Cert gratuito DIAN — automatizado. Ver eventos RADIAN.
Revisar el estado en la app
Ve a Configuración → General, a la sección del certificado gratuito DIAN. Ahí ves cuatro comprobaciones:
| Comprobación | Qué revisa |
|---|---|
| Ambiente: Producción | Que la app esté en Producción y no en Habilitación |
| Token DIAN activo | Que haya una sesión reciente de tu token |
| Solución Gratuita DIAN habilitada | Que tu cuenta DIAN tenga la Solución Gratuita activa |
| Certificado digital gratuito DIAN | Que la DIAN tenga un certificado gratuito asociado a tu cuenta |
Pulsa Re-validar mi cuenta para volver a comprobar. Si falta algo, pulsa Acompañamiento paso a paso.
Dejarlo listo, paso a paso
- Habilítate en la Solución Gratuita
Entra al portal de la DIAN con tu usuario y sigue el proceso de habilitación de facturación electrónica con la Solución Gratuita. El asistente de la app tiene enlaces al portal y a la documentación oficial.
- Confirma el certificado gratuito
Al habilitarte, la DIAN asocia el certificado gratuito a tu cuenta. Si aún no aparece, espera 1 o 2 días hábiles.
- Pon la app en Producción
En Configuración → General, en Ambiente activo, elige Producción. Hazlo cuando termines tus pruebas.
- Haz una consulta con tu token
En Consulta DIAN, usa Portal · Token. La app guarda esa sesión y la usa al emitir eventos hasta que cierres la app o cambies de token.
- Re-valida
Vuelve a Configuración → General y pulsa Re-validar mi cuenta. Cuando todo esté en verde verás «¡Listo para usar cert gratuito DIAN!».
Si necesitas un certificado propio
Para la API Oficial, Portal · Certificado o para firmar con tu propio archivo, necesitas un certificado .p12 o .pfx.
- Puedes comprarlo en frayi.co. Ver comprar un certificado digital.
- En Configuración → Certificados, Ver alternativas.
Cuando lo tengas, cárgalo en la app. Ver certificados.
Preguntas frecuentes
¿Puedo descargar el certificado gratuito para cargarlo en la app?
No. La DIAN no permite descargarlo. Por eso la app lo usa a través de tu token.
¿Sirve el certificado gratuito para la API Oficial?
No. La API Oficial necesita un certificado .p12 o .pfx cargado en la app.
La app dice que no detecta un token DIAN
Haz una consulta con Portal · Token en esta sesión de la app. La sesión se pierde al cerrar la app o al cambiar de token.
¿Funciona en el ambiente de Habilitación?
Para usar tu certificado gratuito real, la app debe estar en Producción.