Ir al contenido principal
tribai.co
Volver al Inicio

Tribai para desarrolladores

Integra el Estatuto Tributario colombiano, el calendario fiscal y el asistente tributario con citas verificadas en tu propio producto: API REST + widget embebible.

1. Crea tu API key

Con tu sesión de Tribai activa, crea una key con POST /api/v1/keys. Hay dos tipos: api (endpoints REST) y widget (asistente embebido — restringe los allowedOrigins a tus dominios). La key se muestra una sola vez.

curl -X POST https://tribai.co/api/v1/keys \
  -H "Content-Type: application/json" \
  --cookie "<sesión Tribai>" \
  -d '{"name": "Mi integración", "keyType": "api"}'

2. API REST v1

Autenticación con header Authorization: Bearer tribai_sk_live_…. Rate limit y cuota mensual según tu plan; las respuestas incluyen headers de uso.

curl https://tribai.co/api/v1/articulo/206 \
  -H "Authorization: Bearer tribai_sk_live_..."
EndpointDescripción
GET/api/v1/articulo/{slug}Artículo del Estatuto Tributario con texto vigente, modificaciones y metadata. Acepta '206' o 'art-206'.
GET/api/v1/calendarioCalendario fiscal 2026: vencimientos por impuesto y últimos dígitos del NIT.
GET/api/v1/indicadoresIndicadores tributarios vigentes: UVT, SMLMV, tasas de interés moratorio, TRM.
POST/api/widget/sessionAbre una sesión del widget (Authorization: Bearer). CORS según allowed_origins de la key.
POST/api/widget/chatConsulta del asistente desde el widget: streaming con citas y fuentes verificadas.

3. Widget embebible

Un custom element (<tribai-consultor>, Shadow DOM, sin dependencias) que monta el asistente tributario en tu sitio: streaming, progreso del pipeline y fuentes citadas. Usa una key tipo widget con tus dominios en allowedOrigins.

<script src="https://tribai.co/widget/tribai-consultor.js" defer></script>

<tribai-consultor
  api-key="tribai_sk_live_..."
  agent-name="Asistente Tributario"
  mode="launcher"
  primary-color="#2563eb">
</tribai-consultor>
AtributoDescripción
api-keyAPI key tipo widget (tribai_sk_live_…). Obligatorio.
mode"launcher" (burbuja flotante, default) o "inline" (embebido en el layout).
agent-nameTítulo visible en el encabezado del panel.
primary-colorColor de acento (hex). Default #2563eb.
agent-idIdentificador opcional del agente configurado para tu cuenta.
backend-urlOverride del backend. Default https://tribai.co.

¿Listo para integrar?

Crea tu cuenta gratis, genera tu primera key y haz tu primera consulta en minutos. Para límites enterprise o un agente con tu propio tono, escríbenos a info@tribai.co.