Configuración en Cyclora
Última actualización: 15 de enero de 2025
Una vez obtenidos el Software ID y PIN del portal DIAN, debes configurarlos en tu cuenta de Cyclora.
Nota
Esta configuración la realiza cada empresa cliente en su propia cuenta de Cyclora. No hay variables de entorno que configurar.
Acceder a Configuración de Facturación
- Ingresa a tu cuenta en app.cyclora.co
- Ve a Configuración → Facturación
- Selecciona la pestaña “DIAN Colombia”
Datos a Configurar
1. Datos Fiscales de la Empresa
| Campo | Descripción | Ejemplo |
|---|---|---|
| NIT | Número de identificación tributaria | 900123456 |
| Dígito de verificación | DV del NIT | 7 |
| Razón social | Nombre legal de la empresa | Mi Empresa S.A.S. |
| Dirección fiscal | Dirección registrada en RUT | Calle 123 #45-67 |
| Municipio | Ciudad de la dirección fiscal | Bogotá D.C. |
| Departamento | Departamento de la dirección | Cundinamarca |
| Teléfono | Teléfono de contacto | 3001234567 |
| Correo para notificaciones | facturacion@miempresa.com |
2. Credenciales DIAN
| Campo | Descripción | Origen |
|---|---|---|
| Software ID | Identificador único del software | Portal DIAN |
| PIN del Software | Código de 7 caracteres | Definido por ti en DIAN |
| Ambiente | Habilitación o Producción | Según tu estado en DIAN |
3. Certificado Digital
| Campo | Descripción |
|---|---|
| Archivo certificado | Archivo .p12 o .pfx |
| Password del certificado | Contraseña del certificado |
| Fecha de expiración | Fecha de vencimiento |
Paso a Paso
Paso 1: Configurar Datos Fiscales
- Completa todos los campos de información fiscal
- Asegúrate de que coincidan exactamente con tu RUT
- Click en “Guardar”
Paso 2: Ingresar Credenciales DIAN
- Software ID: Copia el identificador del portal DIAN
- PIN: Ingresa el PIN de 7 caracteres que definiste
- Ambiente: Selecciona “Habilitación” si aún no has completado el set de pruebas
Seguridad
El PIN se almacena de forma encriptada en nuestra base de datos. Nunca se expone en texto plano.
Paso 3: Cargar Certificado Digital
- Click en “Cargar certificado”
- Selecciona tu archivo
.p12o.pfx - Ingresa el password del certificado
- Selecciona la fecha de expiración
- Click en “Guardar”
Paso 4: Verificar Configuración
- Click en botón “Probar Conexión DIAN”
- El sistema intentará conectar con el web service de DIAN
- Si es exitoso, verás un mensaje de confirmación
- Si hay error, revisa las credenciales y certificado
Configuración de Numeración
Rangos de Prueba (Habilitación)
Durante la fase de habilitación, DIAN asigna rangos automáticos:
| Tipo | Prefijo | Rango |
|---|---|---|
| Facturas | SETT | 1 - 9999 |
| Notas Crédito | NC | 1 - 999 |
| Notas Débito | ND | 1 - 999 |
Rangos de Producción
En producción tienes dos opciones:
- Numeración Libre: Sin resolución DIAN específica
- Con Resolución: Si tienes resolución DIAN autorizada
Para configurar resolución:
- Número de resolución
- Fecha de resolución
- Prefijo autorizado
- Rango desde
- Rango hasta
- Fecha de vigenciaAlmacenamiento de Configuración
Multi-tenant
Cyclora almacena la configuración de cada empresa de forma independiente. Tu configuración está aislada y segura.
La configuración se almacena en:
- Base de datos:
billing.billing_configs(configuración general) - Base de datos:
billing.billing_config_co(configuración específica Colombia) - Storage seguro: Certificados encriptados en Cloudflare R2
Verificación Final
Antes de continuar, verifica:
- Datos fiscales completos y correctos
- Software ID ingresado
- PIN ingresado
- Certificado cargado y vigente
- Ambiente configurado como “Habilitación”
- Prueba de conexión exitosa