Portal de desarrollador de Tributax
Tributax expone a integradores externos cinco consultas de contribuyente: identidades en RENAP, el RTU por NIT, y los tres catálogos —la correspondencia entre CUI y NIT, el RTU completo de un contribuyente y su estado de cumplimiento (omisos).
Esta documentación describe esa superficie y nada más. Los proveedores que Tributax consume por dentro para prestar el servicio no aparecen aquí: son otra audiencia y otro documento.
El modelo mental en un párrafo
Un integrador no tiene su propia API. Se autentica con las credenciales de su integración y
consulta registros: no opera por cuenta de ningún contribuyente, así que ninguna de estas cinco
rutas pide x-user-nit ni la aprobación de nadie.
De ahí salen las dos consecuencias que más sorprenden al integrar:
- Nunca envías
Authorization. Las credenciales de integración viajan en sus propios dos headers, y el servidor resuelve el resto. - Cada consulta se habilita por separado. Credenciales válidas no alcanzan: la consulta que quieres usar tiene que estar activa en tu integración, y la activa un administrador de Tributax.
Ambas se explican en Autenticación.
Los dos niveles de acceso
| Nivel | Qué envías | Para qué sirve |
|---|---|---|
| Público | nada | Nada de lo que documenta este portal |
| Integración | x-integracion-login + x-integracion-token | RENAP, RTU por NIT y los tres catálogos |
Por dónde empezar
- Entornos y límites — contra qué host pegar y cuántas peticiones caben.
- Autenticación — los dos headers y qué significa cada fallo.
- Consultas — las cinco, con su habilitación y su límite.
- Referencia de API — el contrato completo, navegable.
Cómo se escribió esto
El código manda. Ninguna página documenta una ruta que no exista hoy en el backend, y cada afirmación no obvia cita el archivo y la línea de donde sale. Las colecciones de Postman que circulaban antes de este portal se usaron como inventario de partida, no como contrato: diez de sus rutas ya no existen.
Un comando de paridad en el repositorio del backend falla cuando la especificación y las rutas reales se separan, así que esta documentación no puede quedarse atrás en silencio.
Qué no vas a encontrar aquí
- Facturación electrónica, alta de contribuyentes y todo lo que opera por cuenta de alguien. Existe en la API, pero no se ofrece como superficie de integrador: no se documenta aquí.
- Rutas administrativas, de contador o de empresa: son superficies internas.
- Los webhooks
betty/*: son esbozos con respuesta fija, sin persistencia. Documentarlos sería publicar una promesa falsa. - Los webhooks de proveedores de pago.
- Autoservicio de credenciales: hoy las crea un administrador de Tributax. Escríbenos (Contacto).
📄 Estado de verificación: contenido derivado del código del backend. Las páginas de esta sección no se han ejercido contra el entorno desplegado en esta entrega.