Saltar al contenido

01 · 02

Factura electrónica de venta. Nacional y de exportación, con el Anexo Técnico 1.9.

Trevol arma el XML, lo firma con el certificado de tu empresa, lo envía a la DIAN y te muestra su respuesta. Cuando la DIAN la valida, le entrega a tu cliente el PDF y el XML desde facturas@trevol.si.

Al crear tu cuenta recibes $ 2.000 de saldo de bienvenida.

Ejemplo con datos ficticios: la factura FE7354 por $ 1.190.000, validada por la DIAN, con su CUFE y su código QR.

Qué es la factura electrónica. El documento con el que vendes, validado por la DIAN antes de llegarle a tu cliente.

La factura electrónica de venta es un XML firmado por tu empresa que la DIAN valida. Lleva un código único, el CUFE, con el que cualquiera puede consultarla en la DIAN. Trevol la arma según el Anexo Técnico 1.9, la envía y se la entrega a tu comprador; quien la emite sigue siendo tu empresa.

  • Rechazada no es perdida.

    Si la DIAN la rechaza, ves la regla y su mensaje, la corriges y sale con el mismo número. Lo apartado vuelve a tu saldo.

  • Totales que cuadran.

    Trevol calcula impuestos, descuentos, cargos y redondeo según el Anexo 1.9. Por la API, POST /v1/invoices/preview te los muestra sin numerar ni enviar.

  • Entregada a tu cliente.

    Con el PDF y el XML en un ZIP, desde facturas@trevol.si y a nombre de tu empresa.

Todo lo que pide el Anexo 1.9. Desde la venta de mostrador hasta la exportación.

Tipos

  • Factura nacional (01)
  • Factura de exportación (02), con sus términos de entrega
  • Moneda extranjera, con tu tasa de cambio
  • De contado o a crédito, con varios medios de pago

Operaciones

  • AIU (09)
  • Mandatos (11)
  • Transporte de carga
  • Notarios, divisas y sector salud

Valores

  • Impuestos por línea, según el Anexo 1.9
  • Descuentos y cargos, por línea y del documento
  • Anticipos y retenciones, informativos como pide el Anexo
  • Redondeo

Lo que recibes

  • CUFE y código QR
  • PDF, XML y ZIP
  • La respuesta de la DIAN, con sus reglas
  • Webhooks invoice.accepted e invoice.delivered

¿Hay que corregirla? Con una nota crédito o débito

De tu sistema a la DIAN, y de vuelta. Seis pasos que ves en la app, en la consola y por webhook.

  1. 1

    Recibido

    Trevol revisa los datos antes de reservar el número.

  2. 2

    Enviada a la DIAN

    Firmada con el certificado de tu empresa.

  3. 3

    Validada, o rechazada con sus reglas

    Con su CUFE, o con el mensaje literal de la DIAN.

  4. 4

    Archivos

    PDF, XML y ZIP.

  5. 5

    Correo

    A tu cliente, desde facturas@trevol.si.

  6. 6

    Webhooks

    invoice.accepted e invoice.delivered, si usas la API.

Si la DIAN no contesta, Trevol termina la factura por su cuenta y te avisa: no tienes que crear otra para la misma venta. Los tiempos dependen de la DIAN.

Exportación y moneda extranjera.

La factura de exportación (02) lleva la moneda, tu tasa de cambio y los términos de entrega. La DIAN la valida en pesos, con su equivalente en la moneda extranjera; la tasa va en el XML.

  • InvoiceTypeCode 02 y PaymentExchangeRate en el XML.
  • Incoterm y condiciones de entrega en delivery_terms.
  • Validada en la prueba del 23 de octubre de 20261 contra la habilitación de la DIAN.

Exportación y operaciones especiales en la API

Ejemplo con datos ficticios: una factura de exportación en dólares, con su tasa de cambio de 3.950,00 pesos por dólar, dos líneas con su equivalente en pesos y un total de USD 1.080,00, o $ 4.266.000, validada por la DIAN.

Emítela desde tu software. Un POST con JSON; la respuesta trae la de la DIAN.

  • La misma Idempotency-Key durante 7 días devuelve la misma factura.
  • Con una llave tvl_test_, las pruebas van a la habilitación real de la DIAN y no se cobran.
  • Webhooks firmados con HMAC-SHA256, con reintentos.
Ejemplo
curl https://api.trevol.si/v1/invoices \
  -H "Authorization: Bearer $TREVOL_LLAVE" \
  -H "Idempotency-Key: 6f1c2a7e-0b3d-4c2a-9d0e-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "VENTA-2026-000123",
    "customer": {
      "document_type": "31",
      "document_number": "900373913",
      "name": "FICORP SAS",
      "person_type": "legal",
      "email": "facturas@ficorp.co",
      "municipality_code": "76001",
      "tax_responsibilities": ["O-13"]
    },
    "items": [{
      "code": "SA-LIC",
      "description": "Licencia anual",
      "quantity": "1",
      "unit_price": "150000",
      "taxes": [{"code": "01", "rate": "19"}]
    }],
    "payment": {
      "form": "credit",
      "term_days": 30,
      "methods": [{"code": "47"}]
    }
  }'
HTTP/1.1 201 Created
Location: /v1/invoices/inv_08cd6774e31e401c9fa0fbf92b3fbdc0
Request-Id: req_8f0bd4b74c070af09ae4e620

{
  "id": "inv_08cd6774e31e401c9fa0fbf92b3fbdc0",
  "object": "invoice",
  "environment": "test",
  "status": "accepted",
  "number": "SETP994307051",
  "prefix": "SETP",
  "external_id": "VENTA-2026-000123",
  "cufe": "52cede538652…",
  "qr": "NumFac: SETP994307051 …",
  "issued_at": "2026-10-21T22:09:36-05:00",
  "customer": { … },
  "items": [ … ],
  "totals": {
    "subtotal": "150000.00", "discounts": "0.00", "line_extension": "150000.00",
    "taxes": [{"code": "01", "name": "IVA", "rate": "19.00", "base": "150000.00", "amount": "28500.00"}],
    "total": "178500.00", …
  },
  "dian": {"status_code": "00", "message": "Procesado Correctamente.", "rules": []},
  "delivery": {"status": "pending", "pdf": false, "zip": false, "xml": true, "email": {"status": "pending", "to": null, "detail": null}}
}
curl https://api.trevol.si/v1/invoices \
  -H "Authorization: Bearer $TREVOL_LLAVE" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "EXP-77",
    "document_type": "02",
    "currency": {
      "code": "USD",
      "exchange_rate": "3950.12",
      "rate_date": "2026-10-21"
    },
    "delivery_terms": {"incoterm": "FOB", "conditions": "Puerto de Cartagena"},
    "customer": {
      "document_type": "50",
      "document_number": "US123456789",
      "name": "ACME INC",
      "country": "US",
      "city": "Miami",
      "region": "Florida",
      "postal_code": "33131",
      "address": "200 S Biscayne Blvd"
    },
    "items": [{
      "description": "Consultoría",
      "quantity": "1",
      "unit_price": "1000",
      "taxes": [{"code": "01", "excluded": true}]
    }],
    "payment": {"form": "credit", "term_days": 30}
  }'

POST /v1/invoicesExportación y operaciones especiales

Lo que pasa en la operación diaria. AIU, mandatos, rechazos y la DIAN que no contesta.

AIU y mandatos

La factura con AIU (operación 09) y la de mandato (11) se emiten con su tipo de operación. Las dos quedaron validadas en la prueba del 23 de octubre de 20261.

Operación AIU
09
Operación mandato
11
Resultado
Validadas
Rechazada no es perdida

Si la DIAN rechaza una factura, Trevol muestra la regla y el mensaje de la DIAN. La corriges con PUT en la API, o en la app, y sale con el mismo número. Lo apartado vuelve a tu saldo.

Se corrige con
PUT
Número
El mismo
Cobrado por el rechazo
$ 0
La DIAN no contesta

Con la versión 2026-10-22 de la API, si la DIAN no contesta, la respuesta es 202 processing y el resultado llega por consulta y por webhook. No creas otra factura para la misma venta.

Respuesta
202
Estado
processing
Aviso
webhook

Pagas cada factura que la DIAN valida. Sin mensualidad.

Cada documento se cobra cuando la DIAN lo valida, sin mensualidad. Facturas, notas, POS, documentos equivalentes y documentos soporte comparten el conteo del mes de tu cuenta.

$ 500 → $ 15

por documento validado, según el consumo de tu cuenta

Del 1 al 10: $ 500 c/u

Conector ContaPyme

Ver precios del conector

Cada factura se cobra cuando la DIAN la valida. Cada empresa lleva su propio conteo, sin cargo por empresa.

$ 700 → $ 17

por factura validada, según el consumo de cada empresa

De la 1 a la 10: $ 700 c/u

Las pruebas de habilitación no se cobran. Si la DIAN rechaza un documento, no pagas: lo apartado vuelve a tu saldo.

Preguntas sobre la factura electrónica. Dólares, rechazos y verificación.

¿Puedo facturar en dólares?

Sí, con tu tasa de cambio. La DIAN valida la factura en pesos, con su equivalente en la moneda extranjera; la tasa va en el XML.

¿Qué pasa si la DIAN rechaza un documento?

Al enviarlo se aparta su precio de tu saldo. Si la DIAN lo rechaza, lo apartado vuelve a tu saldo y el documento conserva su número: se corrige y se reenvía. Se cobra una sola vez, cuando la DIAN lo valida.

¿Cómo verifica mi cliente la factura?

En la consulta de documentos electrónicos de la DIAN, con el CUFE que aparece en la factura.

¿Puedo cambiar una factura ya validada?

No: una factura validada no se edita ni se borra. Se corrige con una nota crédito o débito que la referencia. Ver las notas crédito y débito.

Todas las preguntas

Después de emitir la factura. Corrígela, acéptala o emítela desde el canal que ya usas.

Emítela desde: App web · API · ContaPyme

Emite tu primera factura electrónica.

Sin plan, sin mensualidad y con precios publicados. Empiezas con $ 2.000 de saldo y las pruebas de habilitación no se cobran.

Cómo empezar

Cuenta, empresa y habilitación ante la DIAN, en tres pasos.

Ver los pasos

Documentación

La guía y la referencia de la API v1.

Leer la documentación

Notas

  1. Prueba de punta a punta del 23 de octubre de 2026 contra la habilitación de la DIAN, medida desde el cliente: 28 documentos de todas las familias. La mediana fue 1,9 s. Los tiempos dependen de la DIAN.