# Trevol > Trevol es una plataforma de facturación y documentos electrónicos ante la DIAN (Colombia). Su API REST permite emitir facturas, notas crédito y débito, documento soporte, documentos equivalentes, nómina electrónica y eventos RADIAN, con llaves de pruebas (tvl_test_, habilitación de la DIAN) y de producción (tvl_live_), Idempotency-Key obligatoria, errores application/problem+json y webhooks firmados con Standard Webhooks. Cada página de la documentación existe también en Markdown (agrega `.md` a su dirección). La especificación OpenAPI 3.1 está en https://platform.trevol.si/openapi.json y un servidor MCP de solo lectura en https://platform.trevol.si/mcp (herramientas buscar_docs y leer_pagina). ## Inicio - [Documentación de la API](https://platform.trevol.si/docs.md): Emite facturas, notas, documento soporte, documentos equivalentes, nómina y eventos RADIAN ante la DIAN desde tu propio software, con la API de Trevol. ## Empezar - [Empezar](https://platform.trevol.si/docs/empezar.md): Crea una llave de pruebas y emite tu primera factura contra la habilitación real de la DIAN, en cURL o en siete lenguajes. - [Llaves y entornos](https://platform.trevol.si/docs/llaves.md): Cada llave es de una sola empresa y un solo ambiente: pruebas contra la habilitación de la DIAN (tvl_test_) o producción (tvl_live_), con permisos e IP permitidas. - [SDK y herramientas](https://platform.trevol.si/docs/sdks.md): SDK de Trevol en Node.js, Python, PHP, Java, C#, Go y Ruby, colecciones de Postman, Insomnia y Bruno, y la especificación OpenAPI. - [Descargas](https://platform.trevol.si/docs/descargas.md): Descarga las colecciones de Postman, Insomnia y Bruno de la API de Trevol y la especificación OpenAPI 3.1. ## Conceptos - [Convenciones](https://platform.trevol.si/docs/convenciones.md): Formatos, identificadores, fechas, decimales y códigos de la API de Trevol. - [Idempotencia](https://platform.trevol.si/docs/idempotencia.md): Repetir una petición con la misma Idempotency-Key devuelve la misma respuesta sin volver a emitir; cómo usar external_id y qué hacer tras un reinicio. - [Estados y respuestas](https://platform.trevol.si/docs/respuestas.md): Qué responde la API cuando la DIAN valida, rechaza o no contesta (201, 202, 402, 422, 503) y cómo continuar sin duplicar documentos. - [Reintentos](https://platform.trevol.si/docs/reintentos.md): Qué errores se reintentan, con qué espera y cómo lo hacen los SDK de Trevol; cuándo reintentar con cURL. - [Límites](https://platform.trevol.si/docs/limites.md): Límites de uso de la API de Trevol por llave y por empresa, y qué hacer cuando se superan. - [Paginación](https://platform.trevol.si/docs/paginacion.md): Las listas de la API de Trevol usan cursores (starting_after); los SDK ofrecen iteradores que recorren todas las páginas. - [Versiones](https://platform.trevol.si/docs/versiones.md): Las versiones de la API de Trevol (2026-10-21 y 2026-10-22), cómo se elige la de una llave y qué cambia entre ellas. - [Archivos](https://platform.trevol.si/docs/archivos.md): Descargar el PDF, el XML, el ZIP y la respuesta de la DIAN de un documento, y entender cuándo están listos. ## Documentos - [Facturas](https://platform.trevol.si/docs/facturas.md): Emitir una factura electrónica por la API de Trevol, corregirla si la DIAN la rechaza, consultarla y descargar sus archivos. - [Notas crédito y débito](https://platform.trevol.si/docs/notas.md): Corregir una factura validada con una nota crédito (1 a 6) o débito (1 a 4) por la API de Trevol. - [Documento soporte](https://platform.trevol.si/docs/documento-soporte.md): Documento soporte (05) en adquisiciones a no obligados a facturar y su nota de ajuste (95) por la API de Trevol. - [Documento equivalente](https://platform.trevol.si/docs/documento-equivalente.md): Tiquete POS (20) y los otros nueve documentos equivalentes electrónicos, con su nota de ajuste, por la API de Trevol. - [Nómina electrónica](https://platform.trevol.si/docs/nomina.md): Nómina electrónica (102) y su nota de ajuste (103, Reemplazar y Eliminar) por la API de Trevol. - [Eventos RADIAN](https://platform.trevol.si/docs/eventos-radian.md): Acuse de recibo, reclamo, recibo del bien, aceptación expresa y aceptación tácita de facturas por la API de Trevol. - [Operaciones especiales](https://platform.trevol.si/docs/operaciones-especiales.md): Facturas de exportación, en moneda extranjera, con AIU, mandatos, transporte de carga, notarios, divisas y sector salud por la API de Trevol. - [Saldo y recargas](https://platform.trevol.si/docs/saldo.md): Consultar el saldo prepago de Trevol, ver sus movimientos y preparar una recarga con Wompi por la API. ## Webhooks - [Webhooks](https://platform.trevol.si/docs/webhooks.md): Avisos firmados (Standard Webhooks) cuando un documento se valida, se rechaza, queda en error o se entrega; cómo crearlos, verificarlos, reintentos y rotación del secreto. - [Tipos de evento](https://platform.trevol.si/docs/webhooks/eventos.md): Los 50 tipos de evento que Trevol manda a tus webhooks, agrupados por documento, con cuándo se emite cada uno. ## Integrar - [Backend intermediario](https://platform.trevol.si/docs/backend-intermediario.md): Cómo usar Trevol desde una aplicación web (Next.js, Nuxt, SvelteKit, Angular) sin exponer la llave en el navegador. - [Para IA](https://platform.trevol.si/docs/ia.md): Cada página de la documentación en Markdown, llms.txt, llms-full.txt, la especificación OpenAPI y un servidor MCP de solo lectura. ## Referencia - [Referencia de la API](https://platform.trevol.si/docs/api.md): Todas las operaciones de la API de Trevol, por recurso, con ejemplos de código en cURL y siete lenguajes. - [General](https://platform.trevol.si/docs/api/general.md): Las operaciones de General de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Facturas](https://platform.trevol.si/docs/api/invoices.md): Las operaciones de Facturas de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Notas crédito](https://platform.trevol.si/docs/api/credit-notes.md): Las operaciones de Notas crédito de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Notas débito](https://platform.trevol.si/docs/api/debit-notes.md): Las operaciones de Notas débito de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Documento soporte](https://platform.trevol.si/docs/api/support-documents.md): Las operaciones de Documento soporte de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Notas de ajuste del documento soporte](https://platform.trevol.si/docs/api/support-document-adjustments.md): Las operaciones de Notas de ajuste del documento soporte de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Documento equivalente](https://platform.trevol.si/docs/api/equivalent-documents.md): Las operaciones de Documento equivalente de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Notas de ajuste del documento equivalente](https://platform.trevol.si/docs/api/equivalent-document-adjustments.md): Las operaciones de Notas de ajuste del documento equivalente de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Nómina electrónica](https://platform.trevol.si/docs/api/payrolls.md): Las operaciones de Nómina electrónica de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Notas de ajuste de nómina](https://platform.trevol.si/docs/api/payroll-adjustments.md): Las operaciones de Notas de ajuste de nómina de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Eventos RADIAN](https://platform.trevol.si/docs/api/radian-events.md): Las operaciones de Eventos RADIAN de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Endpoints de webhooks](https://platform.trevol.si/docs/api/webhook-endpoints.md): Las operaciones de Endpoints de webhooks de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Eventos](https://platform.trevol.si/docs/api/events.md): Las operaciones de Eventos de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Registro de peticiones](https://platform.trevol.si/docs/api/requests.md): Las operaciones de Registro de peticiones de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Saldo](https://platform.trevol.si/docs/api/balance.md): Las operaciones de Saldo de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código. - [Objetos](https://platform.trevol.si/docs/api/objetos.md): Todos los objetos de la API de Trevol con sus campos, tipos y cuáles son obligatorios. ## Errores - [Errores](https://platform.trevol.si/docs/errores.md): Catálogo de errores de la API de Trevol: códigos estables, estado HTTP, cuándo pasan y si se reintentan. Formato application/problem+json (RFC 9457). - [Reglas de la DIAN](https://platform.trevol.si/docs/errores/reglas-dian.md): Las reglas de validación de la DIAN que Trevol traduce al español, con el área del pedido donde se corrigen y cómo corregirlas. ## Cambios - [Registro de cambios](https://platform.trevol.si/docs/cambios.md): Qué cambió en cada versión de la API de Trevol (2026-10-21, 2026-10-22), a quién afecta y cómo migrar, y los cambios que no estrenan versión. ## Opcional - [Especificación OpenAPI 3.1](https://platform.trevol.si/openapi.json): la API completa en JSON.