Documentación · Referencia · API v1 · versión 2026-10-22
Referencia de la API
Todas las operaciones de la API de Trevol, por recurso, con ejemplos de código en cURL y siete lenguajes.
La API de Trevol es REST con JSON, en https://api.trevol.si/v1. Esta referencia sale de la especificación OpenAPI 3.1 (versión 2026-10-22): una página por recurso y, en Objetos, cada esquema con sus campos. Antes de empezar, lee Llaves y entornos, Convenciones e Idempotencia.
General
| Método | Ruta | Qué hace |
|---|---|---|
GET |
/v1/health |
Salud |
GET |
/v1/company |
La empresa de la llave |
GET |
/v1/dian/acquirer |
Datos del adquiriente en la DIAN |
Facturas
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/invoices |
Emitir una factura |
GET |
/v1/invoices |
Listar (factura) |
POST |
/v1/invoices/preview |
Calcular una factura sin emitirla |
GET |
/v1/invoices/{id} |
Una factura |
PUT |
/v1/invoices/{id} |
Corregir una factura rechazada (mismo número) y reenviarla |
POST |
/v1/invoices/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/invoices/{id}/pdf |
Archivo pdf |
GET |
/v1/invoices/{id}/xml |
Archivo xml |
GET |
/v1/invoices/{id}/zip |
Archivo zip |
GET |
/v1/invoices/{id}/dian_response |
Archivo dian_response |
GET |
/v1/invoices/{id}/tacit_acceptance |
¿Procede ya la aceptación tácita (034) de esta factura? |
Notas crédito
Ver la página de Notas crédito
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/credit_notes |
Emitir una nota crédito |
GET |
/v1/credit_notes |
Listar (nota crédito) |
POST |
/v1/credit_notes/preview |
Calcular una nota crédito sin emitirla |
GET |
/v1/credit_notes/{id} |
Una nota crédito |
PUT |
/v1/credit_notes/{id} |
Corregir una nota crédito rechazada (mismo número) y reenviarla |
POST |
/v1/credit_notes/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/credit_notes/{id}/pdf |
Archivo pdf |
GET |
/v1/credit_notes/{id}/xml |
Archivo xml |
GET |
/v1/credit_notes/{id}/zip |
Archivo zip |
GET |
/v1/credit_notes/{id}/dian_response |
Archivo dian_response |
Notas débito
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/debit_notes |
Emitir una nota débito |
GET |
/v1/debit_notes |
Listar (nota débito) |
POST |
/v1/debit_notes/preview |
Calcular una nota débito sin emitirla |
GET |
/v1/debit_notes/{id} |
Una nota débito |
PUT |
/v1/debit_notes/{id} |
Corregir una nota débito rechazada (mismo número) y reenviarla |
POST |
/v1/debit_notes/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/debit_notes/{id}/pdf |
Archivo pdf |
GET |
/v1/debit_notes/{id}/xml |
Archivo xml |
GET |
/v1/debit_notes/{id}/zip |
Archivo zip |
GET |
/v1/debit_notes/{id}/dian_response |
Archivo dian_response |
Documento soporte
Ver la página de Documento soporte
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/support_documents |
Emitir un documento soporte |
GET |
/v1/support_documents |
Listar (documento soporte) |
POST |
/v1/support_documents/preview |
Calcular un documento soporte sin emitirlo |
GET |
/v1/support_documents/{id} |
Un documento soporte |
PUT |
/v1/support_documents/{id} |
Corregir un documento soporte rechazado (mismo número) y reenviarlo |
POST |
/v1/support_documents/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/support_documents/{id}/xml |
Archivo xml |
GET |
/v1/support_documents/{id}/dian_response |
Archivo dian_response |
Notas de ajuste del documento soporte
Ver la página de Notas de ajuste del documento soporte
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/support_document_adjustments |
Emitir una nota de ajuste del documento soporte |
GET |
/v1/support_document_adjustments |
Listar (nota de ajuste del documento soporte) |
POST |
/v1/support_document_adjustments/preview |
Calcular una nota de ajuste del documento soporte sin emitirla |
GET |
/v1/support_document_adjustments/{id} |
Una nota de ajuste del documento soporte |
PUT |
/v1/support_document_adjustments/{id} |
Corregir una nota de ajuste del documento soporte rechazada (mismo número) y reenviarla |
POST |
/v1/support_document_adjustments/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/support_document_adjustments/{id}/xml |
Archivo xml |
GET |
/v1/support_document_adjustments/{id}/dian_response |
Archivo dian_response |
Documento equivalente
Ver la página de Documento equivalente
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/equivalent_documents |
Emitir un documento equivalente |
GET |
/v1/equivalent_documents |
Listar (documento equivalente) |
POST |
/v1/equivalent_documents/preview |
Calcular un documento equivalente sin emitirlo |
GET |
/v1/equivalent_documents/{id} |
Un documento equivalente |
PUT |
/v1/equivalent_documents/{id} |
Corregir un documento equivalente rechazado (mismo número) y reenviarlo |
POST |
/v1/equivalent_documents/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/equivalent_documents/{id}/pdf |
Archivo pdf |
GET |
/v1/equivalent_documents/{id}/xml |
Archivo xml |
GET |
/v1/equivalent_documents/{id}/zip |
Archivo zip |
GET |
/v1/equivalent_documents/{id}/dian_response |
Archivo dian_response |
Notas de ajuste del documento equivalente
Ver la página de Notas de ajuste del documento equivalente
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/equivalent_document_adjustments |
Emitir una nota de ajuste del documento equivalente |
GET |
/v1/equivalent_document_adjustments |
Listar (nota de ajuste del documento equivalente) |
POST |
/v1/equivalent_document_adjustments/preview |
Calcular una nota de ajuste del documento equivalente sin emitirla |
GET |
/v1/equivalent_document_adjustments/{id} |
Una nota de ajuste del documento equivalente |
PUT |
/v1/equivalent_document_adjustments/{id} |
Corregir una nota de ajuste del documento equivalente rechazada (mismo número) y reenviarla |
POST |
/v1/equivalent_document_adjustments/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/equivalent_document_adjustments/{id}/pdf |
Archivo pdf |
GET |
/v1/equivalent_document_adjustments/{id}/xml |
Archivo xml |
GET |
/v1/equivalent_document_adjustments/{id}/zip |
Archivo zip |
GET |
/v1/equivalent_document_adjustments/{id}/dian_response |
Archivo dian_response |
Nómina electrónica
Ver la página de Nómina electrónica
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/payrolls |
Emitir una nómina electrónica |
GET |
/v1/payrolls |
Listar (nómina electrónica) |
POST |
/v1/payrolls/preview |
Calcular una nómina electrónica sin emitirla |
GET |
/v1/payrolls/{id} |
Una nómina electrónica |
PUT |
/v1/payrolls/{id} |
Corregir una nómina electrónica rechazada (mismo número) y reenviarla |
POST |
/v1/payrolls/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/payrolls/{id}/xml |
Archivo xml |
GET |
/v1/payrolls/{id}/zip |
Archivo zip |
GET |
/v1/payrolls/{id}/dian_response |
Archivo dian_response |
Notas de ajuste de nómina
Ver la página de Notas de ajuste de nómina
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/payroll_adjustments |
Emitir una nota de ajuste de nómina |
GET |
/v1/payroll_adjustments |
Listar (nota de ajuste de nómina) |
POST |
/v1/payroll_adjustments/preview |
Calcular una nota de ajuste de nómina sin emitirla |
GET |
/v1/payroll_adjustments/{id} |
Una nota de ajuste de nómina |
PUT |
/v1/payroll_adjustments/{id} |
Corregir una nota de ajuste de nómina rechazada (mismo número) y reenviarla |
POST |
/v1/payroll_adjustments/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/payroll_adjustments/{id}/xml |
Archivo xml |
GET |
/v1/payroll_adjustments/{id}/zip |
Archivo zip |
GET |
/v1/payroll_adjustments/{id}/dian_response |
Archivo dian_response |
Eventos RADIAN
Ver la página de Eventos RADIAN
| Método | Ruta | Qué hace |
|---|---|---|
POST |
/v1/radian_events |
Emitir un evento RADIAN |
GET |
/v1/radian_events |
Listar (evento RADIAN) |
GET |
/v1/radian_events/{id} |
Un evento radian |
POST |
/v1/radian_events/{id}/send |
Reenviar una pendiente o en error |
GET |
/v1/radian_events/{id}/xml |
Archivo xml |
GET |
/v1/radian_events/tacit_acceptance |
¿Procede ya la aceptación tácita (034) de esta factura? (por CUFE) |
Endpoints de webhooks
Ver la página de Endpoints de webhooks
| Método | Ruta | Qué hace |
|---|---|---|
GET |
/v1/webhook_endpoints |
Los endpoints de webhooks de la empresa y el ambiente |
POST |
/v1/webhook_endpoints |
Crear un endpoint de webhooks (máximo 5 por empresa y ambiente) |
GET |
/v1/webhook_endpoints/{id} |
Un endpoint |
PATCH |
/v1/webhook_endpoints/{id} |
Cambiar la URL, la descripción, los eventos o pausar y reactivar |
DELETE |
/v1/webhook_endpoints/{id} |
Borrar el endpoint (con sus entregas) |
POST |
/v1/webhook_endpoints/{id}/rotate_secret |
Rotar el secreto |
POST |
/v1/webhook_endpoints/{id}/test |
Mandar un evento webhook.test solo a este endpoint (debe estar activo) |
GET |
/v1/webhook_endpoints/{id}/deliveries |
Las entregas de este endpoint, de la más nueva a la más vieja |
Eventos
| Método | Ruta | Qué hace |
|---|---|---|
GET |
/v1/events |
Los eventos de 30 días de la empresa y el ambiente |
GET |
/v1/events/{id} |
Un evento |
POST |
/v1/events/{id}/resend |
Reenviar un evento a un endpoint (entrega manual nueva; el webhook-id es el mismo) |
Registro de peticiones
Ver la página de Registro de peticiones
| Método | Ruta | Qué hace |
|---|---|---|
GET |
/v1/requests |
El registro de peticiones de la empresa y el ambiente de la llave (30 días) |
Saldo
| Método | Ruta | Qué hace |
|---|---|---|
GET |
/v1/balance |
El saldo de la cuenta (lo comparten sus empresas) |
GET |
/v1/balance/transactions |
Los movimientos del saldo de la cuenta |
POST |
/v1/balance/top_ups |
Preparar una recarga del saldo (para el widget de Wompi) |