Facturación electrónica · Colombia

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
Documentos

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.

    CUFE
  • Notas crédito y débito

    Corrige o anula una factura ya aceptada, con la referencia que exige la DIAN.

    CUDE
  • Documento soporte

    Compras a quienes no están obligados a facturar, con su nota de ajuste.

    Res. 000167/2021
  • Nómina electrónica

    Devengados y deducciones de cada empleado, con notas de ajuste para reemplazar o eliminar.

    Res. 000013/2021
Cómo funciona

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.

  1. Envías el documento

    Un POST con los datos del pedido. El external_id evita duplicados aunque repitas la petición.

  2. Numeramos y firmamos

    Al enviarlo tomamos el siguiente número de tu rango, calculamos el CUFE y firmamos el XML con tu certificado.

  3. Lo enviamos a la DIAN

    Un worker lo transmite y reintenta si la DIAN no responde, sin que tengas que hacer nada.

  4. 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

Seguridad

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.

Planes

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.

    PlanDocumentosPrecio
    Inicial100$45.000
    Mini500$99.000
    Básico1.200$139.000
    Emprendedor3.000$189.000
    Pro8.000$279.000
  • Empresas

    Para una empresa con NIT.

    PlanDocumentosPrecio
    Empresa 1010.000$339.000
    Empresa 2020.000$459.000
    Empresa 5050.000$999.000
    Empresa 100100.000$1.749.000
    Empresa 200200.000$2.990.000
    Empresa 500500.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.

    PlanDocumentosPrecio
    Casa 55.000$154.000
    Casa 1010.000$280.000
    Casa 3030.000$441.000
    Casa 5050.000$595.000
    Casa 150150.000$1.575.000
    Casa 300300.000$3.000.000
    Casa 500500.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.
Desarrolladores

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.
Leer la documentación
Webhook · document.accepted
// 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.