Cambios
La API no expone versión en la URL. Los cambios aditivos —un campo nuevo en una respuesta, un endpoint nuevo, un valor nuevo en un enumerado— no rompen una integración existente y no se anuncian con antelación. Los incompatibles se anuncian aquí y se comunican directamente a las integraciones activas.
2026-09-23 · El portal documenta solo las consultas
Esta documentación pasa a describir únicamente las cinco consultas de contribuyente: RENAP, RTU por NIT y los tres catálogos. Las guías de facturación electrónica y de alta de contribuyentes se retiran, y la Referencia de API deja de declarar esas operaciones.
No cambia nada de la API. Esas rutas siguen existiendo y siguen funcionando igual para quien ya las usa; lo que cambia es qué ofrece Tributax como superficie de integrador. Si tu integración depende de alguna de ellas, escríbenos desde Contacto antes de tu próximo despliegue.
También en esta entrega, sobre las consultas que quedan:
- Los tres catálogos responden con un contrato propio de Tributax, en camelCase y con la misma forma sin importar cómo publique sus datos la fuente. Antes la respuesta salía tal como venía.
- Un campo nuevo,
actualizado, para pedir el dato en el momento en vez de la copia almacenada. - El consumo se cobra de un saldo prepago por integración: si se agota, los catálogos responden
402. Ver Saldo y cobro.
2026-09-02 · Publicación inicial del portal
Primera versión de esta documentación. No cambia nada de la API: describe lo que ya existía.
Qué trajo
- Autenticación con el orden de evaluación de los fallos.
- Consultas RENAP y RTU con su habilitación por integración y su límite propio.
- Catálogo de errores con los mensajes transcritos del código.
- Guías de facturación y de alta de contribuyentes, retiradas en la entrega del 2026-09-23.
Lo que corrigió respecto a las colecciones de Postman que circulaban
Diez rutas de esas colecciones ya no existían, nueve rutas vivas no estaban en ninguna, y varios nombres de campo estaban mal. El detalle de esas divergencias pertenecía a superficies que este portal ya no documenta.
Cómo se mantiene honesto
La especificación OpenAPI vive en el mismo repositorio que el código que describe, y un comando de paridad falla cuando declaran superficies distintas: una ruta que se ofrece a integradores no puede quedarse sin documentar en silencio, y una que se retira queda registrada por escrito. Los mensajes del catálogo de errores tienen su propia prueba, que falla si alguien los cambia en el backend sin actualizar esta página.
Antes de este portal
La documentación era un export de Postman de 24 colecciones que se enviaba por correo. Diez de sus rutas ya no existían y nueve rutas vivas no estaban en ninguna colección. Esa es la razón de ser de este sitio.
📄 Estado de verificación: el inventario de divergencias se levantó comparando las colecciones contra el código del backend.