Solución de Problemas

Última actualización: 15 de enero de 2025

Esta guía te ayudará a resolver los problemas más comunes durante el proceso de integración con DIAN.

Errores de Certificado Digital

Error: “Certificado no válido”

Causas posibles:

• Certificado expirado
• Password incorrecto
• Archivo corrupto

Soluciones:

1. Verifica la fecha de expiración del certificado
2. Confirma que el password es correcto (sensible a mayúsculas)
3. Descarga nuevamente el certificado del proveedor
4. Verifica que el archivo no esté dañado

Error: “Firma digital no válida”

Causas posibles:

• Certificado no corresponde al NIT
• Error en el proceso de firma

Soluciones:

1. Verifica que el certificado está a nombre de tu empresa
2. Confirma que el NIT del certificado coincide con el NIT configurado
3. Recarga el certificado en Cyclora

Errores de CUFE

Error: “CUFE inválido”

El CUFE (Código Único de Factura Electrónica) se calcula usando SHA-384 con un orden específico de campos.

Causas posibles:

• Orden incorrecto de campos en el cálculo
• Formato de fecha incorrecto
• Caracteres especiales en los valores

Soluciones:

1. Cyclora calcula el CUFE automáticamente - si recibes este error, contacta soporte
2. Verifica que los totales cuadren (subtotal + IVA = total)
3. Revisa que la fecha tenga el formato correcto

Orden de campos para CUFE

NumFac + FecFac + HorFac + ValFac + CodImp1 + ValImp1 +
CodImp2 + ValImp2 + CodImp3 + ValImp3 + ValTot +
NitOFE + NumAdq + ClTec + PIN + TipoAmb

Errores de Estructura XML

Error: “Estructura XML incorrecta”

Causas posibles:

• No cumple esquema UBL 2.1
• Campos obligatorios faltantes
• Formato de datos incorrecto

Soluciones:

1. Revisa el mensaje de error específico
2. Verifica que todos los campos obligatorios están completos
3. Confirma el formato de fechas (YYYY-MM-DD)
4. Verifica que los emails tengan formato válido

Campos Obligatorios

Errores de Numeración

Error: “Secuencia no consecutiva”

Causas posibles:

• Saltos en la numeración
• Factura anterior rechazada y no corregida
• Numeración duplicada

Soluciones:

1. Verifica el último número usado en DIAN
2. Usa el siguiente número consecutivo disponible
3. No saltes números aunque una factura sea rechazada

Error: “Prefijo no autorizado”

Causas posibles:

• Usando prefijo de habilitación en producción
• Prefijo no coincide con resolución DIAN

Soluciones:

1. En habilitación: usa prefijos SETT, NC, ND
2. En producción: usa el prefijo de tu resolución o sin prefijo
3. Verifica la configuración de resolución en Cyclora

Errores de Conexión

Error: “No se puede conectar con DIAN”

Causas posibles:

• Problemas de red
• Endpoint incorrecto
• Servicio DIAN no disponible

Soluciones:

1. Verifica tu conexión a internet
2. Confirma que el ambiente configurado es correcto
3. Intenta nuevamente en unos minutos
4. Verifica el estado del servicio DIAN

URLs de verificación

Errores de Totales

Error: “Totales no cuadran”

Causas posibles:

• Error en cálculo de IVA
• Redondeo incorrecto
• Descuentos mal aplicados

Soluciones:

1. Verifica: Subtotal × 0.19 = IVA (para IVA 19%)
2. Verifica: Subtotal + IVA = Total
3. Usa redondeo a 2 decimales consistente
4. Verifica descuentos antes de IVA

Fórmula correcta:

Subtotal = Σ(cantidad × precio_unitario)
IVA = Subtotal × tasa_iva
Total = Subtotal + IVA - Descuentos

Códigos de Respuesta DIAN

Contactar Soporte

Si no puedes resolver el problema:

1. Recopila información:

   • Mensaje de error completo
   • CUFE o número de factura
   • Fecha y hora del intento
   • Capturas de pantalla

2. Canales de soporte:

   • Email: support@cyclora.co
   • Chat en la aplicación
   • Portal de ayuda