Emite ante la DIAN con una llamada a la API
FactuROA genera el XML UBL 2.1, calcula el CUFE, firma con tu certificado, lo envía a la DIAN y te avisa por webhook. Tú solo mandas el pedido.
- Anexo técnico 1.9
- Firma XAdES-EPES
- Sin huecos en la numeración
Todo lo que la DIAN te pide, en una sola integración
Cada documento sale con su XML firmado, la respuesta de la DIAN, el AttachedDocument y una representación gráfica en PDF con QR (y el logo de tu empresa, si lo subes).
Factura de venta
Impuestos, retenciones, descuentos, cargos, anticipos e impuestos a bolsas, IBUA e ICUI.
CUFENotas crédito y débito
Corrige o anula una factura ya aceptada, con la referencia que exige la DIAN.
CUDEDocumento soporte
Compras a quienes no están obligados a facturar, con su nota de ajuste.
Res. 000167/2021Nómina electrónica
Devengados y deducciones de cada empleado, con notas de ajuste para reemplazar o eliminar.
Res. 000013/2021
Tu sistema no espera a la DIAN
La API responde de inmediato y el envío corre en segundo plano, con reintentos. Cuando la DIAN contesta, te enteras.
Envías el documento
Un
POSTcon los datos del pedido. Elexternal_idevita duplicados aunque repitas la petición.Numeramos y firmamos
Al enviarlo tomamos el siguiente número de tu rango, calculamos el CUFE y firmamos el XML con tu certificado.
Lo enviamos a la DIAN
Un worker lo transmite y reintenta si la DIAN no responde, sin que tengas que hacer nada.
Te avisamos
Webhook firmado con HMAC, PDF con QR y correo al adquiriente con el ZIP del Anexo.
Estados del documento: pendingsubmittedacceptedorejectedcon el motivo de la DIAN
Tu certificado es tuyo y nadie más lo ve
Los secretos se cifran con llaves de AWS KMS propias de cada cuenta. Ni en la base de datos ni en los registros hay un secreto en claro.
Cifrado por sobre
Certificado .p12, contraseña y clave técnica cifrados con AES-256-GCM y una llave de datos por cuenta.
Cuentas aisladas
Row Level Security en Postgres: una cuenta no puede leer los documentos de otra, ni por error.
API keys con vencimiento
Una llave por sistema o ambiente. Se pueden deshabilitar, revocar y rotar; solo guardamos su huella SHA-256.
Numeración sin huecos
El número se asigna al enviar a la DIAN. Si la DIAN rechaza el documento, ese número lo toma el siguiente.
Webhooks firmados
Cada aviso lleva una firma HMAC-SHA256 con marca de tiempo. Solo HTTPS y nunca a redes privadas.
Varios certificados y rangos
Cada cuenta maneja sus certificados y sus rangos de numeración por tipo de documento.
Pagas por documentos al año, no por mes
Cada plan dura un año desde el pago o hasta usar todos sus documentos. El cupo sirve para cualquier documento: facturas, notas, documento soporte, POS, nómina y eventos RADIAN. Los rechazados por la DIAN no consumen.
Personas naturales
Para quien factura con su cédula.
Plan Documentos Precio Inicial 100 $45.000 Mini 500 $99.000 Básico 1.200 $139.000 Emprendedor 3.000 $189.000 Pro 8.000 $279.000 Empresas
Para una empresa con NIT.
Plan Documentos Precio Empresa 10 10.000 $339.000 Empresa 20 20.000 $459.000 Empresa 50 50.000 $999.000 Empresa 100 100.000 $1.749.000 Empresa 200 200.000 $2.990.000 Empresa 500 500.000 $5.900.000 Casas de software
Una bolsa compartida entre todos tus clientes, sin cobro por empresa. Se aprueba con el RUT y la web de tu empresa; pide al menos tres clientes activos en los primeros tres meses.
Plan Documentos Precio Casa 5 5.000 $154.000 Casa 10 10.000 $280.000 Casa 30 30.000 $441.000 Casa 50 50.000 $595.000 Casa 150 150.000 $1.575.000 Casa 300 300.000 $3.000.000 Casa 500 500.000 $4.900.000
- Precios anuales en pesos colombianos. Incluyen el correo al adquiriente y la custodia de los documentos por cinco años.
- El certificado de firma digital no está incluido: te guiamos para conseguirlo con una entidad acreditada por la ONAC.
- ¿Más de 500.000 documentos al año? Escríbenos y armamos un plan a tu medida.
Hecha para conectarse a tu software
FactuROA es una API entre sistemas: tu POS, ERP o tienda en línea factura sin que nadie entre a un portal.
- OpenAPI 3 descargable. Ábrelo en Postman o Insomnia para probar los endpoints y genera clientes en tu lenguaje.
- Errores con código estable. Mensajes en español o inglés; tu código decide por el
code. - Montos exactos. Valores como texto decimal, sin redondeos sorpresa.
- Reportes listos. Impuestos y nómina por periodo para tu contador.
// X-Facturoa-Signature: t=1762700400,v1=9c1e…
{
"event": "document.accepted",
"sent_at": "2026-11-09T15:00:00Z",
"data": {
"id": "0199a3…",
"external_id": "pedido-77",
"document_type": "invoice",
"full_number": "FE1024",
"status": "accepted",
"payable_amount": "11900.00",
"document_key": "3f9a1c7e…"
}
}
// GET /documents/{id}/pdf → representación gráfica
// GET /documents/{id}/xml → XML firmado¿Listo para facturar desde tu sistema?
Te creamos la cuenta, te entregamos la API key y te acompañamos en la habilitación ante la DIAN.