Referencia de API
Tributax expone una sola API a integradores externos. Su contrato completo —parámetros, esquemas de request y response, y los códigos de error de cada operación— está en la referencia interactiva:
| API | Para qué | Base URL | Autenticación | Referencia |
|---|---|---|---|---|
| Consultas de Tributax | RENAP por CUI, RTU por NIT y los tres catálogos (CUI/NIT, RTU y omisos) | https://api.tributax.app · https://dev.api.tributax.app | Headers de integración (x-integracion-login, x-integracion-token) | Abrir la referencia |
Cinco operaciones sobre cinco rutas. Las guías de este portal explican cómo lograr algo; la referencia dice qué campos hay. Empieza por Autenticación y usa la referencia cuando necesites el detalle de una operación concreta.
Probar desde el navegador
La referencia se renderiza como una consola en vivo: elige una operación, completa los parámetros y envía la petición. Los dos headers de integración aparecen como campos de autenticación, y una vez rellenos se aplican a todas las operaciones.
:::warning La consola apunta a desarrollo
El servidor por defecto es https://dev.api.tributax.app, a propósito. Si seleccionas
https://api.tributax.app en el desplegable de servidores, cada «Send Request» es una consulta
real: cuenta para tus límites y consume del saldo de tu integración.
:::
La especificación en crudo
El JSON de OpenAPI 3.1 es descargable:
Sirve para generar un cliente, cargarlo en Postman o Insomnia, o alimentar tus propias pruebas de contrato.
Dónde vive y por qué no se desincroniza
La fuente de verdad es server/openapi/tributax-integrator.json, en el mismo repositorio que
el código que describe. Así, el cambio de una ruta y el cambio de su documentación caen en el
mismo pull request en lugar de en dos repositorios y dos momentos distintos.
Una comprobación automática de paridad recorre los routers reales y los compara con las rutas del spec. Falla si el spec declara una ruta que no existe, y también si existe una ruta que el spec no declara y que nadie ha excluido por escrito, una por una y con su razón. Ese segundo caso es el importante: es el que impide que una ruta nueva se quede sin documentar en silencio, y el que deja registrado por qué una ruta que existe no se ofrece.
Qué no está en la referencia
La emisión de DTE, el alta de contribuyentes y todo lo que opera por cuenta de un contribuyente: existen en la API, pero desde el 2026-09-23 no se ofrecen como superficie de integrador. Tampoco las rutas internas de administración, contador o empresa, ni los webhooks.
📄 Estado de verificación: la especificación se escribió leyendo el código de la API y una prueba de paridad comprueba que sigue coincidiendo. Las operaciones no se han ejercido contra el entorno desplegado en esta entrega.