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
01 · 02
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.
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.
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.
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.
Con el PDF y el XML en un ZIP, desde facturas@trevol.si y a nombre de tu empresa.
invoice.accepted e invoice.deliveredRecibido
Trevol revisa los datos antes de reservar el número.
Enviada a la DIAN
Firmada con el certificado de tu empresa.
Validada, o rechazada con sus reglas
Con su CUFE, o con el mensaje literal de la DIAN.
Archivos
PDF, XML y ZIP.
Correo
A tu cliente, desde facturas@trevol.si.
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.
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.delivery_terms.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.
Idempotency-Key durante 7 días devuelve la misma factura.tvl_test_, las pruebas van a la habilitación real de la DIAN y no se cobran.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
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.
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.
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.
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
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.
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.
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.
En la consulta de documentos electrónicos de la DIAN, con el CUFE que aparece en la factura.
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.
Emítela desde: App web · API · ContaPyme
91 · 92
Corrigen una factura validada, de Trevol o de otro software.
030 a 034
La aceptación tácita de tus facturas a crédito y los eventos de las que recibes.
POS y 9 tipos más
Para la venta de mostrador con tiquete POS.
Sin plan, sin mensualidad y con precios publicados. Empiezas con $ 2.000 de saldo y las pruebas de habilitación no se cobran.