En Colombia, la factura electrónica de venta funciona con validación previa: la DIAN valida el documento antes de que sea válido para tu cliente. Hacerlo manualmente ralentiza la operación; hacerlo por API, integrado en tus workflows, hace que cada venta se facture y valide sola. En esta guía repasamos qué necesitas, cómo es el flujo con el CUFE y cómo automatizarlo con Floogos, donde emitir ante la DIAN es un nodo dentro de tu proceso.
Nota: este artículo es una guía técnica general, no asesoría fiscal. Valida siempre los requisitos vigentes con la DIAN o tu contador.
- Autoridad
- DIAN
- CUFE
- f1e2d3c4b5a6
- Impuesto
- IVA 19%
- Entrega
- XML + PDF
Conceptos clave en 30 segundos
Reúne lo que necesitas
Antes de emitir por API, ten en regla tu habilitación y tus datos:
- Estar habilitado como facturador electrónico ante la DIAN
- Resolución de numeración vigente (el rango de folios autorizado)
- NIT y datos fiscales del emisor
- Credenciales del proveedor tecnológico / API que uses para emitir
💡 Consejo: completa primero la habilitación en el ambiente de pruebas de la DIAN. Es un requisito antes de facturar en producción.
Arma la factura (UBL 2.1 + CUFE)
Con los datos de la venta se construye el XML estándar y su identificador único:
- Emisor, adquirente y detalle de los ítems
- Impuestos (IVA 19% u otros según el caso) y totales
- Numeración dentro de tu resolución vigente
- Cálculo del CUFE que identifica de forma única la factura
💡 Consejo: la numeración debe estar dentro del rango de tu resolución. Emitir fuera de rango es una causa habitual de rechazo.
Valida ante la DIAN
El paso que da validez: la DIAN valida el documento antes de que llegue al cliente.
- Envías la factura firmada a la DIAN para su validación previa
- La DIAN responde con la aceptación (o el motivo del rechazo)
- Con la validación, la factura ya surte efectos fiscales
- Se conserva el XML validado como documento oficial
💡 Consejo: guarda siempre el XML con la respuesta de validación. Es tu respaldo ante cualquier revisión.
Entrega al adquirente
Cierras el ciclo entregando la factura en el formato que corresponde:
- Envía el XML validado y la representación gráfica (PDF con código QR)
- Hazlo por email o por el canal habitual del cliente
- Registra el CUFE en tu ERP, tienda o base de datos
- Actualiza el estado del pedido/factura en tu sistema
💡 Consejo: la representación gráfica debe incluir el CUFE y el QR. Automatizar su envío evita reclamos por facturas que no llegan.
Notas de crédito y débito
Para ajustar o anular, se usan notas asociadas a la factura, no se "borra" nada:
- Nota crédito para devoluciones, descuentos o anulaciones
- Nota débito para cargos adicionales
- Cada nota referencia la factura original y su CUFE
- También se validan ante la DIAN
💡 Consejo: define desde el inicio cómo gestionas devoluciones. Las notas mal emitidas son una fuente típica de descuadres.
Cómo lo automatizas con Floogos
En Floogos, el flujo completo cabe en un workflow. El nodo de facturación de Colombia se encarga del XML, el CUFE y la validación ante la DIAN; tú conectas el disparador y los datos:
- 1Un disparador inicia el proceso (una venta, un formulario, un pedido en tu ERP)
- 2El workflow toma los datos y arma la factura UBL 2.1 con su CUFE
- 3El nodo de Colombia valida ante la DIAN y recibe la aceptación
- 4Otro nodo envía el XML y el PDF con QR al cliente y archiva el comprobante
- 5Se registra el CUFE y se actualiza el estado, con trazas e insights por ejecución
💡 La credencial se configura una vez y se reutiliza. Al ser un workflow, puedes emitir en lote, reintentar rechazos y notificar errores automáticamente, además de emitir notas crédito/débito con el mismo enfoque.
Preguntas frecuentes
¿Qué es la validación previa de la DIAN?
Es el modelo colombiano en el que la DIAN valida la factura electrónica antes de que surta efectos ante el adquirente. Floogos envía la factura a validar y recibe la respuesta automáticamente dentro del workflow.
¿Qué necesito para empezar a facturar por API?
Estar habilitado ante la DIAN, tener una resolución de numeración vigente, tus datos fiscales (NIT) y las credenciales del proveedor/API. Con eso, el nodo de Colombia ya puede emitir y validar.
¿Qué es el CUFE?
El Código Único de Factura Electrónica, un identificador único de cada comprobante que se calcula al armar la factura y aparece en la representación gráfica junto al código QR.
¿Cómo anulo o corrijo una factura?
No se elimina: se emite una nota crédito (para devoluciones, descuentos o anulaciones) o una nota débito (para cargos adicionales), referenciando la factura original, y también se validan ante la DIAN.
La factura electrónica de venta en Colombia no tiene por qué frenar tu operación. Con la emisión por API y la validación previa integradas en tus procesos, cada venta se factura, se valida ante la DIAN, se entrega al cliente y se archiva, con CUFE y trazabilidad completa. Floogos convierte todo eso en un nodo de tu workflow; tú te ocupas de vender, no del papeleo.
Fuentes oficiales
Guía de carácter técnico y general, no asesoría fiscal. Requisitos verificados con las fuentes oficiales; contrasta siempre la normativa vigente con la DIAN o tu contador.