Empezar con FiscalBridge

Aprende a usar FiscalBridge API en 5 pasos simples. Estarás consultando información del SII en menos de 10 minutos.

1 · Registro y verificación

Para empezar a usar la API, primero necesitas crear una cuenta.

1. Visita la página de registro.
2. Completa el formulario con tus datos:
   • RUT (formato: 12.345.678-9).
   • Nombre completo.
   • Correo electrónico.
   • Contraseña segura (mínimo 8 caracteres, mayúscula, minúscula, número y símbolo).
3. Acepta los términos y condiciones.
4. Haz clic en Crear cuenta.
5. Revisa tu correo y haz clic en el enlace de verificación.

2 · Elegir plan

Al registrarte, obtienes automáticamente acceso al plan Trial por 10 días:

• 100 consultas cada 24 horas.
• 2 solicitudes por segundo.
• 10 días de prueba.
• Sin tarjeta de crédito.

Cuando estés listo para más consultas, puedes hacer upgrade a:

3 · Obtener API Token

Para usar la API necesitas un token de autenticación.

1. Inicia sesión en tu dashboard.
2. Ve a la página API Tokens en el menú lateral.
3. Haz clic en Crear nuevo token.
4. Completa el formulario:
   • Nombre descriptivo (ej. "Producción Backend").
   • Fecha de expiración (30, 60, 90 días o sin expiración).
5. Haz clic en Crear token.
6. Importante: copia y guarda el token inmediatamente. Solo se muestra una vez.

Ejemplo de formato del token:

sk_prod_d_54XikyD24746Yu0lq4_hqMLbp-OB3J0uYpKem4za8

Guárdalo en un lugar seguro (gestor de contraseñas, variables de entorno o un secrets manager). Nunca lo expongas en código cliente, repositorios públicos ni logs.

4 · Primera consulta

Ahora que tienes tu token, puedes hacer tu primera consulta. Aquí hay ejemplos en cuatro lenguajes; FiscalBridge sincroniza la pestaña activa entre todos los bloques del sitio, así que elige una vez y todos los snippets cambian.

import requests
 
API_BASE = "https://api.fiscalbridge.cl/api/v1"
API_TOKEN = "tu_token_aqui"
 
headers = {"X-API-Token": API_TOKEN}
 
response = requests.get(
  f"{API_BASE}/sii/contribuyente/12345678-9",
  headers=headers,
)
 
if response.status_code == 200:
  data = response.json()
  print(f"RUT: {data['rut']}")
  print(f"Razón Social: {data['razon_social']}")
else:
  print(f"Error: {response.status_code}")

Respuesta esperada:

{
  "success": true,
  "data": {
    "rut": "12.345.678-9",
    "razon_social": "Empresa Demo SpA",
    "nombre_fantasia": "Demo",
    "actividad_economica": "Servicios Informáticos"
  }
}

5 · Monitorear uso

Es importante monitorear tu uso para evitar exceder tu cuota.

• Dashboard principal: el widget Uso de Consultas muestra tus consultas disponibles en tiempo real.
• Mi Plan: detalles de tu suscripción, cuota total, próximo reset y estadísticas históricas.
• Headers HTTP: cada respuesta incluye los headers que te dicen cuántas consultas te quedan y cuándo se resetea la cuota.

Ejemplo de headers de respuesta:

X-RateLimit-Limit: 50
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1699564800

Conceptos clave

• Rate limiting (3 niveles) — Nivel 1: 100 req/15 min por IP. Nivel 2: throttling según plan (2-25 req/s). Nivel 3: cuota de 24 h según plan.
• Cuotas y reset — Tu cuota se resetea automáticamente cada 24 horas. Puedes ver el próximo reset en tu dashboard o en los headers HTTP.
• Seguridad — Nunca compartas tus API tokens. Úsalos solo en backend seguro. Rota tokens periódicamente. Revócalos si sospechas compromiso.

¿Qué sigue?

• Revisa la guía de ejemplos de código en Python, JavaScript, PHP y cURL.
• Lee las preguntas frecuentes.
• Si te quedaste sin saber qué pedirle a un LLM, mira Crea con FiscalBridge usando IA.