# Documentación de la API

> Emite facturas, notas, documento soporte, documentos equivalentes, nómina y eventos RADIAN ante la DIAN desde tu propio software, con la API de Trevol.

Fuente: https://platform.trevol.si/docs

Con la API de Trevol emites **facturas electrónicas, notas crédito y débito, documento soporte, documentos equivalentes (POS), nómina electrónica y eventos RADIAN** ante la DIAN desde tu propio software. Tú mandas los datos en JSON; Trevol valida, calcula los impuestos y los totales, numera, firma, envía a la DIAN y entrega el PDF y el correo en los documentos que los llevan.

Las llaves de pruebas (`tvl_test_…`) emiten contra la **habilitación real de la DIAN**: sin validez legal y sin costo. Cuando tu integración funcione, creas una llave de producción (`tvl_live_…`).

> **Los SDK se publican pronto:** Hay SDK en Node.js, Python, PHP, Java, C#, Go y Ruby, y colecciones para Postman, Insomnia y Bruno. Los SDK todavía no están publicados: mientras tanto usa cURL o la [especificación OpenAPI](/openapi.json). Los ejemplos de cada página están en cURL por ahora.

## Empieza aquí

| Quiero…                                      | Ve a                                     |
| -------------------------------------------- | ---------------------------------------- |
| Emitir mi primera factura en pruebas         | [Empezar](/docs/empezar)                 |
| Crear una llave y entender los entornos      | [Llaves y entornos](/docs/llaves)        |
| Instalar un SDK o importar una colección     | [SDK y herramientas](/docs/sdks)         |
| Enterarme cuando la DIAN valida un documento | [Webhooks](/docs/webhooks)               |
| Entender qué responde la API en cada caso    | [Estados y respuestas](/docs/respuestas) |
| Evitar documentos duplicados al reintentar   | [Idempotencia](/docs/idempotencia)       |
| Resolver un error                            | [Errores](/docs/errores)                 |

## Qué puedes emitir

| Documento                                                         | Guía                                                                               | Referencia                                                                     |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Factura de venta, exportación y operaciones especiales            | [Facturas](/docs/facturas), [Operaciones especiales](/docs/operaciones-especiales) | [Facturas](/docs/api/invoices)                                                 |
| Notas crédito y débito                                            | [Notas crédito y débito](/docs/notas)                                              | [Notas crédito](/docs/api/credit-notes), [Notas débito](/docs/api/debit-notes) |
| Documento soporte (05) y su nota de ajuste (95)                   | [Documento soporte](/docs/documento-soporte)                                       | [Documento soporte](/docs/api/support-documents)                               |
| Tiquete POS (20), otros nueve documentos equivalentes y su ajuste | [Documento equivalente](/docs/documento-equivalente)                               | [Documento equivalente](/docs/api/equivalent-documents)                        |
| Nómina electrónica (102) y su ajuste (103)                        | [Nómina electrónica](/docs/nomina)                                                 | [Nómina](/docs/api/payrolls)                                                   |
| Eventos RADIAN 030 a 034                                          | [Eventos RADIAN](/docs/eventos-radian)                                             | [Eventos RADIAN](/docs/api/radian-events)                                      |
| Saldo y recargas                                                  | [Saldo](/docs/saldo)                                                               | [Saldo](/docs/api/balance)                                                     |

## Herramientas

- **[La consola](https://platform.trevol.si)**: crea llaves y webhooks, mira el registro de peticiones y el consumo, y prueba la API con el Playground.
- **[Referencia de la API](/docs/api)**: cada operación con sus parámetros, su cuerpo y ejemplos de código.
- **[`openapi.json`](/openapi.json)**: la especificación OpenAPI 3.1 completa.
- **[Para IA](/docs/ia)**: cada página en Markdown, `llms.txt` y un servidor MCP de solo lectura.
- **[Registro de cambios](/docs/cambios)**: qué cambió en cada versión de la API.