Preguntas frecuentes

Las respuestas más buscadas sobre FiscalBridge, agrupadas por categoría. La tabla de contenidos a la derecha te lleva directo a la categoría que te interesa; cada pregunta tiene un enlace permalink (#) auto-generado por Fumadocs si necesitas compartirla.

General

¿Qué es FiscalBridge?

FiscalBridge es una plataforma SaaS que proporciona acceso programático a la API del SII (Servicio de Impuestos Internos) de Chile. Permite a desarrolladores y empresas consultar información tributaria, situación de contribuyentes, actividades económicas y más, a través de una API REST moderna y fácil de usar.

¿Cómo funciona el trial gratuito de 10 días?

Al registrarte obtienes automáticamente 10 días de prueba gratuita con el plan Trial que incluye 100 consultas cada 24 horas y un límite de 2 solicitudes por segundo. No requiere tarjeta de crédito y puedes cancelar en cualquier momento. Después de 10 días, debes elegir un plan de pago para continuar usando el servicio.

¿Puedo cancelar mi suscripción en cualquier momento?

Sí, puedes cancelar tu suscripción en cualquier momento desde la página Mi Plan en tu dashboard. La cancelación es inmediata y no se realizan cobros adicionales. Tendrás acceso al servicio hasta el final del período de facturación actual.

¿Los datos están actualizados en tiempo real?

En la Fase 1 (MVP), la API simula respuestas del SII con datos de ejemplo para permitir la integración y pruebas. En la Fase 2, implementaremos la integración directa con el SII para obtener datos reales y actualizados. Te notificaremos cuando esta funcionalidad esté disponible.

¿Qué es el SII y por qué necesito esta API?

El SII (Servicio de Impuestos Internos) es la entidad chilena encargada de la administración tributaria. FiscalBridge te permite acceder programáticamente a información pública del SII sin necesidad de scraping o procesos manuales, ideal para validación de RUTs, verificación de contribuyentes y automatización de procesos tributarios.

¿FiscalBridge guarda mis consultas?

Sí, guardamos logs de todas las consultas realizadas con fines de facturación, análisis de uso y soporte técnico. Los logs incluyen: timestamp, endpoint consultado, parámetros (RUT consultado), código de respuesta y latencia. Estos logs se mantienen por 90 días y luego se eliminan automáticamente. No compartimos ni vendemos esta información a terceros.

Autenticación

¿Cuál es la diferencia entre JWT y API Token?

JWT (JSON Web Token) se usa para autenticación en el frontend web y expira en 15 minutos (con refresh token de 30 días). Los API Tokens son claves permanentes (hasta su revocación o expiración configurada) diseñadas para integraciones backend-to-backend. Recomendamos usar API Tokens para aplicaciones y servicios automatizados.

¿Cómo renuevo mi token de acceso?

Los JWT se renuevan automáticamente usando el refresh token. Si usas API Tokens, estos no expiran automáticamente a menos que configures una fecha de expiración al crearlos. Puedes crear, listar y revocar API Tokens desde la página API Tokens en tu dashboard.

¿Por qué mi token expiró?

Los JWT de acceso expiran después de 15 minutos por seguridad. Los API Tokens solo expiran si configuraste una fecha de expiración (30, 60, 90 días) al crearlos. Para evitar interrupciones, monitorea la fecha de expiración de tus tokens y crea nuevos antes de que expiren.

¿Puedo tener múltiples API tokens?

Sí, puedes crear hasta 10 API tokens activos simultáneamente. Esto te permite usar diferentes tokens para diferentes aplicaciones o entornos (desarrollo, staging, producción). Cada token puede tener su propia fecha de expiración o ser permanente.

¿Qué hago si perdí mi API token?

Por seguridad, los API tokens solo se muestran una vez al momento de crearlos. Si perdiste un token, debes revocarlo y crear uno nuevo desde la página API Tokens. Asegúrate de guardar el nuevo token en un lugar seguro (gestor de contraseñas, variables de entorno, secrets manager).

Rate limiting

¿Qué significa "429 Too Many Requests"?

El error 429 indica que superaste uno de los límites de tasa: (1) Límite global de IP (100 req/15min), (2) Throttling por plan (2-25 req/segundo), o (3) Cuota de 24 horas agotada. El header X-RateLimit-Reset te indica cuándo podrás hacer nuevas solicitudes.

¿Cómo funcionan los 3 niveles de rate limiting?

Nivel 1: Límite global por IP (100 solicitudes cada 15 minutos). Nivel 2: Throttling según tu plan (2-25 req/segundo). Nivel 3: Cuota de 24 horas según tu plan (50-10.000+ consultas). Se validan en ese orden y el sistema resetea automáticamente cada período.

¿Cuándo se resetea mi cuota de 24 horas?

Tu cuota se resetea automáticamente cada 24 horas desde tu primera consulta del día. Puedes ver tu próximo reset y consultas disponibles en el dashboard. El sistema registra el campo proximo_reset y lo valida en cada solicitud.

¿Qué pasa si excedo mi cuota 10 veces?

Después de 10 excesos de cuota, tu cuenta se bloquea automáticamente por 3 días como medida de protección del sistema. El campo fecha_desbloqueo indica cuándo se reactivará. Un proceso automatizado con Celery Beat desbloquea las cuentas después del período de suspensión.

¿Puedo solicitar aumento temporal de cuota?

Sí, si necesitas temporalmente más consultas, contacta a soporte técnico (soporte@fiscalbridge.cl) con tu caso de uso. Para aumentos permanentes, considera hacer upgrade a un plan superior. El plan Enterprise ofrece cuotas personalizadas.

¿El rate limiting es por usuario o por IP?

Hay dos controles: (1) Por IP: límite global de 100 solicitudes cada 15 minutos (protección contra abuso). (2) Por usuario: throttling y cuota según tu plan. Si múltiples usuarios comparten una IP, el límite por IP se comparte entre todos.

¿Cómo veo mi cuota disponible?

Puedes ver tu cuota disponible en: (1) Dashboard principal (widget Uso de Consultas), (2) Página Mi Plan (sección de estadísticas), (3) Headers de respuesta HTTP (X-RateLimit-Limit, X-RateLimit-Remaining). El sistema actualiza estos valores en tiempo real.

Planes y precios

¿Cómo funciona la prorrateación al hacer upgrade?

Cuando haces upgrade, calculamos el monto proporcional del tiempo no usado en tu plan actual y lo descontamos del nuevo plan. Por ejemplo, si pagas $29.990 mensual y haces upgrade a los 15 días, se te acredita ~$15.000 al nuevo plan. El cálculo es: (días_restantes / días_totales_mes) × precio_plan.

¿Puedo hacer downgrade a un plan menor?

Actualmente solo permitimos upgrades (cambiar a un plan superior). Los downgrades no están disponibles en la Fase 1. Si necesitas reducir tu plan, puedes cancelar tu suscripción actual y crear una nueva con el plan deseado al finalizar el período de facturación.

¿Qué incluye cada plan?

Trial: $0, 100 consultas/24h, 2 req/s, 10 días. Starter: $29.990, 500/24h, 5 req/s. Professional: $79.990, 2.000/24h, 10 req/s, soporte prioritario. Business: $149.990, 10.000/24h, 25 req/s, SLA 12h. Enterprise: precio personalizado, cuota ilimitada, SLA 4h, soporte dedicado.

¿Hay descuentos por pago anual?

Actualmente solo ofrecemos facturación mensual. Los descuentos por pago anual estarán disponibles en una fase posterior. Síguenos en nuestras redes sociales o suscríbete al newsletter para recibir notificaciones de nuevas ofertas y promociones.

¿El plan Enterprise es negociable?

Sí, el plan Enterprise es completamente personalizable. Contáctanos en soporte@fiscalbridge.cl para discutir tus necesidades específicas: cuota personalizada, SLA dedicado, soporte 24/7, on-premise deployment, webhooks personalizados y más. Creamos una propuesta ajustada a tu caso de uso.

Pagos

¿Qué métodos de pago aceptan?

Aceptamos pagos a través de Transbank Webpay Plus, que permite pagar con: tarjetas de crédito Visa/Mastercard/American Express, tarjetas de débito y transferencia bancaria. Transbank es el procesador de pagos más seguro y confiable de Chile, certificado PCI-DSS.

¿Cómo funciona Transbank Webpay Plus?

Al confirmar tu pago, serás redirigido a la pasarela segura de Transbank donde ingresarás los datos de tu tarjeta. Transbank procesa el pago y te redirige de vuelta a FiscalBridge. Recibimos una notificación del resultado y activamos automáticamente tu suscripción si el pago es exitoso.

¿Emiten boleta o factura?

Sí, emitimos boleta electrónica o factura según tu tipo de cuenta. Si eres empresa y necesitas factura, asegúrate de completar tus datos tributarios en Configuración → Datos de facturación. Las facturas se generan automáticamente y se envían a tu correo electrónico dentro de 24 horas del pago.

¿Puedo usar cupones de descuento?

Sí, puedes aplicar cupones de descuento al momento de registrarte o hacer upgrade. Los cupones pueden ser de porcentaje (ej. 25% descuento) o monto fijo (ej. $10.000 descuento). Ingresa el código en el campo Cupón antes de proceder al pago. Los cupones tienen fecha de expiración y límite de usos.

Problemas comunes

Mi cuenta está bloqueada, ¿qué hago?

Las cuentas se bloquean automáticamente después de 10 excesos de cuota en 24 horas. El bloqueo dura 3 días y se levanta automáticamente. Puedes ver la fecha de desbloqueo en tu dashboard. Si necesitas desbloqueo urgente, contacta a soporte (soporte@fiscalbridge.cl) explicando tu caso.

No recibí el correo de verificación

Verifica tu carpeta de spam/correo no deseado. Si no lo encuentras, espera 5 minutos (el envío puede tomar tiempo) y luego solicita un nuevo correo desde el banner de verificación en tu dashboard. Si el problema persiste, contacta a soporte con tu correo electrónico registrado.

Error 401 Unauthorized — ¿Qué significa?

El error 401 indica que no estás autenticado o tu token es inválido/expirado. Soluciones: (1) Verifica que estás enviando el header X-API-Token con tu token correcto, (2) Verifica que tu token no haya expirado, (3) Si usas JWT, renueva tu access token usando el refresh token, (4) Crea un nuevo API token si perdiste el anterior.

Error 403 Forbidden — Cuenta bloqueada

El error 403 indica que tu cuenta está bloqueada por exceder la cuota 10 veces. Revisa tu dashboard para ver la fecha de desbloqueo. Mientras tanto, revisa tu código para implementar rate limiting correcto: (1) Cachea respuestas cuando sea posible, (2) Implementa retry con exponential backoff, (3) Monitorea tus headers X-RateLimit-* para evitar excesos.

¿Por qué no puedo hacer login?

Posibles causas: (1) Contraseña incorrecta: usa Olvidé mi contraseña para resetearla, (2) Correo no verificado: verifica tu email antes de hacer login, (3) Cuenta bloqueada: contacta a soporte, (4) Problemas técnicos: limpia cookies/cache del navegador o intenta desde modo incógnito. Si el problema persiste, contacta a soporte@fiscalbridge.cl.

¿No encontraste lo que buscabas?

• Revisa la guía de inicio para un recorrido completo de la API.
• Mira los ejemplos de código en Python, JavaScript, PHP y cURL.
• Si nada de esto cubre tu caso, escribe a soporte@fiscalbridge.cl o entra al formulario de soporte (requiere sesión iniciada).