Cyclora

Set de Pruebas DIAN

Última actualización: 15 de enero de 2025

Para cambiar de estado “Registrado” a “Habilitado” en DIAN, debes completar exitosamente el set de pruebas.

Requisitos del Set de Pruebas

Debes enviar exitosamente y consecutivamente:

DocumentoCantidadDescripción
Factura Electrónica2Facturas de venta con diferentes datos
Nota Crédito1Anulación parcial o total de factura
Nota Débito1Corrección que aumenta valor de factura

¿Necesito una Empresa Real?

Respuesta Corta

  • Para REGISTRO en DIAN: SÍ necesitas empresa real con NIT válido
  • Para PRUEBAS en HABILITACIÓN: NO necesitas datos reales del comprador
  • Para PRODUCCIÓN: SÍ necesitas todo real

Pruebas en Ambiente de HABILITACIÓN

En el ambiente de habilitación puedes usar datos ficticios del comprador:

  • NO necesitas: Datos reales del comprador
  • Puedes usar: Nombres, emails, documentos ficticios
  • SÍ necesitas: Estructura correcta (formato válido)

Ejemplo de datos ficticios válidos:

<Buyer>
  <Name>Juan Pérez (Prueba)</Name>
  <Email>prueba@test.com</Email>
  <DocumentType>CC</DocumentType>
  <DocumentNumber>1234567890</DocumentNumber>
</Buyer>

Validaciones DIAN en Habilitación

El web service de DIAN valida:

  1. Estructura XML: Cumple esquema UBL 2.1
  2. Firma Digital: Certificado válido y firma verificable
  3. CUFE: Cálculo correcto SHA-384
  4. Secuencia: Numeración consecutiva
  5. Totales: Cálculos matemáticos correctos
  6. Campos obligatorios: Todos presentes y con formato válido
  7. Datos del vendedor: NIT, razón social, dirección deben ser reales

Datos del Comprador

En ambiente de habilitación, DIAN NO valida si los datos del comprador son reales. Solo verifica el formato.

Generar Pruebas en Cyclora

Opción 1: Dashboard de Testing

  1. Ir a ConfiguraciónFacturación
  2. Click en botón “Generar Set de Pruebas DIAN”
  3. El sistema genera automáticamente:
    • ✅ 2 facturas con datos ficticios
    • ✅ 1 nota crédito referenciando factura #1
    • ✅ 1 nota débito referenciando factura #2
  4. Envía documentos a DIAN
  5. Muestra resultados de validación en tiempo real

Opción 2: Generar Facturas de Prueba desde Ventas

  1. Crear venta de vehículo, componente o servicio
  2. En el drawer de facturación:
    • Marcar checkbox “Factura de Prueba (DIAN)”
    • Usar datos ficticios del comprador
    • Usar rangos de numeración de prueba (SETT1, SETT2, etc.)
  3. Generar y enviar factura
  4. Repetir para notas crédito y débito

Seguimiento del Set

En Portal DIAN

  1. Acceder a “Habilitación”“Estado de Documentos”
  2. Ver estado de cada documento:
    • 🟢 Aprobado: Documento válido
    • 🔴 Rechazado: Revisar errores
    • 🟡 En proceso: DIAN validando

En Cyclora

El dashboard de facturación muestra:

  • Documentos enviados
  • Estado DIAN en tiempo real
  • Errores específicos si hay rechazo
  • Progreso del set (1/4, 2/4, 3/4, 4/4)

Errores Comunes y Soluciones

ErrorCausaSolución
CUFE inválidoCálculo incorrecto del CUFEVerificar orden de campos en cálculo SHA-384
Firma digital no válidaCertificado expirado o corruptoRenovar certificado o verificar password
Estructura XML incorrectaNo cumple esquema UBL 2.1Revisar generación de XML según anexo técnico
Secuencia no consecutivaSaltos en numeraciónUsar siguiente número disponible
Totales no cuadranError en cálculo de IVAVerificar fórmula: subtotal × 0.19 = IVA
Comprador sin emailCampo requerido vacíoAgregar email válido (puede ser ficticio)

Consejo

Si recibes un rechazo, revisa el mensaje de error detallado en el portal DIAN y corrige antes de reenviar.

¿Qué pasa después del Set de Pruebas?

Una vez completado el set de 4 documentos exitosamente:

  1. DIAN valida automáticamente tu set de pruebas
  2. Tu estado cambia de “Registrado” a “Habilitado”
  3. El RUT se actualiza automáticamente con responsabilidad de facturador
  4. Recibes confirmación por email
  5. Puedes cambiar a ambiente de producción