Consultar Situación Tributaria del SII por API: Guía para KYC y Onboarding

Cuando tu plataforma necesita verificar si un proveedor tiene actividades vigentes, si un cliente puede emitir facturas o si un RUT pertenece a una empresa activa, la única fuente de verdad en Chile es el Servicio de Impuestos Internos. El problema: ese proceso manual tarda minutos por cada consulta. Con una API de situación tributaria SII puedes automatizar esa verificación en milisegundos y escalarla a miles de RUTs sin intervención humana.

Esta guía técnica explica qué es la situación tributaria en el contexto del SII, qué datos puedes extraer, por qué el scraping manual ya no es viable y cómo implementar la consulta tributaria de terceros vía API en casos reales de KYC, onboarding y validación de proveedores.

---

Qué es la situación tributaria en el SII

La situación tributaria de un contribuyente es el conjunto de datos registrados en el SII que describen su estado ante el fisco chileno. Incluye desde la razón social y el RUT hasta los giros económicos declarados, la fecha de inicio de actividades y si está habilitado para emitir documentos tributarios electrónicos (DTE).

El SII pone a disposición esta información a través de su portal público "Consultar Situación Tributaria de Terceros" (https://www2.sii.cl/stc/noauthz). También existe una guía oficial en https://www.sii.cl/como_se_hace_para/situacion_trib_terceros.html y una ficha de ChileAtiende en https://www.chileatiende.gob.cl/fichas/3130-situacion-tributaria-de-terceros que resume el proceso para ciudadanos.

La información es pública e irrestricta: cualquier persona o sistema puede consultar la situación tributaria de cualquier RUT sin autenticación previa. Eso la convierte en una fuente ideal para procesos de KYC, validación de proveedores y onboarding empresarial.

---

Qué datos entrega la consulta tributaria del SII

Una consulta completa al SII sobre un contribuyente puede retornar los siguientes campos:

Campo	Descripción	Ejemplo
razon_social	Nombre legal de la empresa o persona	EMPRESA EJEMPLO SPA
rut	RUT con dígito verificador	76123456-7
giros	Lista de actividades económicas declaradas	Consultoría informática (620100)
inicio_actividades	Fecha en que el contribuyente inició actividades	2020-05-15
termino_giro	Fecha de término de giro si aplica	null / 2024-11-30
direccion	Dirección fiscal registrada	Av. Providencia 1234, Santiago
region	Región del domicilio fiscal	Metropolitana
comuna	Comuna del domicilio fiscal	Providencia
autorizado_dte	Si está habilitado para emitir facturas electrónicas	true / false
actividades_economicas	Códigos de actividad económica (CAE)	[{codigo, descripcion, afecta_iva}]
tipo_contribuyente	Persona natural o jurídica	Persona Jurídica

Estos datos son suficientes para tomar decisiones automatizadas: si termino_giro tiene fecha, el contribuyente ya no está activo. Si autorizado_dte es falso, no puede emitir facturas electrónicas. Si los giros no corresponden al rubro declarado, es una señal de riesgo.

---

El proceso manual: por qué ya no escala

El portal del SII en https://www2.sii.cl/stc/noauthz permite buscar cualquier RUT ingresando el número y un captcha. El resultado es una página HTML con la información del contribuyente.

Para un analista que verifica uno o dos RUTs al día, eso es suficiente. Para cualquier proceso automatizado, el proceso manual presenta obstáculos que lo hacen inviable:

• Captchas. El portal exige resolución manual de captchas, lo que impide la automatización directa.
• HTML no estructurado. El resultado es una página web diseñada para visualización, no para consumo programático. Parsear HTML del SII es frágil: cualquier cambio en la estructura del portal rompe el scraper.
• Sin soporte para lotes. No existe forma nativa de consultar múltiples RUTs en una sola solicitud.
• Latencia variable. El portal público tiene tiempos de respuesta impredecibles y periodos de mantención frecuentes.
• Sin garantía de uptime. Los servicios del SII tienen ventanas de mantención programadas que cortan la disponibilidad.

Para plataformas que necesitan verificar decenas o cientos de RUTs por hora, el scraping manual deja de ser una opción realista. La alternativa es una API de contribuyente SII que resuelve todos estos problemas con una interfaz REST estándar.

---

Por qué una API es la solución correcta

Una API de situación tributaria SII actúa como intermediario entre tu sistema y el SII. Se encarga de resolver captchas, parsear HTML, gestionar reintentos ante errores y devolver la información en JSON estructurado. Tu sistema solo necesita enviar el RUT y procesar la respuesta.

Las ventajas concretas frente al proceso manual son:

• JSON estructurado. Cada campo tiene un nombre, tipo y semántica definida. No hay parsing de HTML.
• Procesamiento en lote. Puedes enviar múltiples RUTs en paralelo sin gestionar la concurrencia manualmente.
• Verificación en tiempo real. La latencia es predecible y suficiente para flujos sincrónicos de onboarding.
• Resiliencia. La API gestiona reintentos, timeouts y caídas parciales del SII sin exponerlos a tu aplicación.
• SLA documentado. A diferencia del portal público, una API comercial ofrece uptime garantizado y soporte ante incidentes.

---

Casos de uso por industria

Fintech y crédito: KYC y scoring tributario

Las plataformas de crédito empresarial en Chile necesitan verificar que el solicitante existe como contribuyente, tiene actividades vigentes y opera en el rubro declarado. La consulta tributaria via API contribuyente SII permite integrar esa verificación directamente en el flujo de solicitud.

Un solicitante con termino_giro activo es una señal de riesgo inmediata. La antigüedad desde inicio_actividades sirve como proxy de madurez del negocio. Los giros declarados permiten validar coherencia con el propósito del crédito.

Esta capa de información tributaria complementa el scoring tradicional con datos objetivos y verificables desde una fuente oficial, sin requerir documentación adicional al solicitante.

Marketplaces B2B: verificación de vendedores

Un marketplace B2B que opera en Chile necesita asegurarse de que sus vendedores tienen RUT activo, actividades vigentes y —si emiten documentos— autorización DTE. Sin esa verificación, el marketplace asume el riesgo de operar con contribuyentes en situación irregular.

Integrar la API en el proceso de alta de vendedores permite hacer esa verificación en segundos, sin fricción para el usuario y sin intervención manual del equipo de operaciones.

ERP y contabilidad: autocompletado de datos de terceros

Cuando un contador ingresa un nuevo proveedor o cliente en un ERP, normalmente transcribe manualmente los datos desde el portal del SII o desde documentos físicos. Ese proceso es lento y propenso a errores.

Con la API de consulta tributaria, el ERP puede autocompletar razón social, dirección, giros y estado tributario con solo ingresar el RUT. El flujo de alta de terceros pasa de minutos a segundos y los datos quedan validados desde la fuente oficial.

Compliance y debida diligencia: validación de contrapartes

Antes de firmar un contrato con un proveedor o socio comercial, los equipos de compliance necesitan verificar que la contraparte existe legalmente y tiene actividades vigentes. La consulta tributaria de terceros via API permite incluir esa verificación en los flujos de aprobación sin salir del sistema interno.

Esto es especialmente relevante para empresas que deben cumplir con normativas anti-lavado de activos (ALA) o que operan en sectores regulados donde la debida diligencia de contrapartes es obligatoria.

Facturación electrónica: validar receptor antes de emitir DTE

Antes de emitir una factura electrónica, es buena práctica confirmar que el RUT receptor existe, tiene actividades vigentes y —si es necesario— tiene autorización DTE. Una factura emitida a un RUT con término de giro puede generar problemas tributarios para el emisor.

La API de contribuyente SII permite hacer esa validación en el momento de ingresar el RUT receptor, antes de completar el documento. Puedes también revisar cómo cómo iniciar actividades en el SII para entender cuándo un contribuyente queda habilitado para operar.

---

Implementación con BaseAPI: código de ejemplo

El endpoint de Información del Contribuyente de BaseAPI permite consultar la situación tributaria de cualquier RUT chileno con una sola llamada REST.

const response = await fetch('https://api.baseapi.cl/sii/contribuyente', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    rut: '76123456-7'
  })
});

const contribuyente = await response.json();
// contribuyente.razon_social  → "EMPRESA EJEMPLO SPA"
// contribuyente.giros         → [{codigo: "620100", descripcion: "Consultoría informática"}]
// contribuyente.inicio_actividades → "2020-05-15"

La respuesta es un objeto JSON plano con todos los campos de la situación tributaria. No hay HTML que parsear ni sesiones que gestionar.

Estructura de respuesta JSON

{
  "rut": "76123456-7",
  "razon_social": "EMPRESA EJEMPLO SPA",
  "tipo_contribuyente": "Persona Jurídica",
  "inicio_actividades": "2020-05-15",
  "termino_giro": null,
  "autorizado_dte": true,
  "direccion": "Av. Providencia 1234",
  "comuna": "Providencia",
  "region": "Metropolitana",
  "giros": [
    {
      "codigo": "620100",
      "descripcion": "Consultoría informática",
      "afecta_iva": true
    }
  ]
}

Un campo termino_giro con valor null indica que el contribuyente tiene actividades vigentes. Si tiene fecha, el giro está terminado y el contribuyente ya no opera legalmente.

---

Buenas prácticas de integración

Caché inteligente

La situación tributaria de un contribuyente no cambia con frecuencia. Para la mayoría de los casos de uso, una caché de 24 a 72 horas es suficiente. Almacena el resultado indexado por RUT y la marca de tiempo de la consulta. Invalida la caché si el usuario reporta inconsistencias o si el proceso de negocio lo requiere.

Esto reduce costos de API significativamente en plataformas con alto volumen de consultas repetidas sobre los mismos RUTs.

Control de errores

El SII puede devolver respuestas de error por varias razones: RUT inválido, RUT sin registros, mantención del portal. Tu integración debe manejar al menos estos casos:

• RUT no encontrado: muestra mensaje claro al usuario antes de continuar el flujo.
• Error de SII (503): reintenta con backoff exponencial, máximo 3 intentos.
• RUT con término de giro: bloquea o escala el flujo según tu lógica de negocio.

Para entender cómo funciona el dígito verificador antes de enviar la consulta, revisa la guía para validar RUT en Chile con API: validar el formato localmente antes de llamar a la API evita errores prevenibles y reduce latencia.

Rate limiting y concurrencia

Si necesitas verificar lotes de RUTs, controla la concurrencia para no saturar el endpoint. Un límite de 5 a 10 solicitudes paralelas es un buen punto de partida. Usa una cola con procesamiento asíncrono para lotes grandes y registra el resultado de cada consulta para auditoría.

Logging para auditoría

En contextos de KYC y compliance, es importante registrar no solo el resultado de la consulta sino también el momento exacto en que se realizó y qué versión de los datos tenías al tomar la decisión. Guarda el JSON completo de respuesta junto con el timestamp de la consulta y el ID del proceso que la originó.

---

Cómo elegir el giro correcto antes de la consulta

Si tu flujo de onboarding incluye comparar el giro declarado por el usuario con el que figura en el SII, es útil entender la lógica detrás de los giros comerciales. La guía sobre giro comercial del SII explica cómo se clasifican las actividades económicas y cómo interpretar los códigos que devuelve la API.

Un mismatch entre el giro declarado en el formulario de onboarding y el giro registrado en el SII es una señal que puede escalar a revisión manual sin necesariamente bloquear el proceso.

---

Integración con flujos de automatización tributaria

La consulta de situación tributaria es frecuentemente el primer paso de un flujo más amplio. Una vez que tienes la razón social, los giros y la dirección del contribuyente, puedes continuar con:

• Consulta de RCV (Registro de Compras y Ventas) para ver el historial de transacciones.
• Consulta de DTEs emitidos para verificar actividad reciente.
• Validación de boletas de honorarios si el contribuyente es persona natural.

La guía para automatizar documentos tributarios detalla cómo encadenar estas consultas en un flujo unificado.

---

Conclusión

Consultar la situación tributaria del SII por API es el mecanismo más eficiente para verificar contribuyentes a escala en Chile. El proceso manual —portal web, captcha, HTML— no es viable en ningún flujo automatizado de KYC, onboarding o validación de proveedores.

Una API REST de contribuyente SII resuelve ese problema con una interfaz simple, respuesta JSON estructurada y la capacidad de procesar lotes sin gestión manual. Los datos que devuelve —razón social, giros, inicio de actividades, autorización DTE— son suficientes para tomar decisiones automatizadas con respaldo en fuente oficial.

Si tu plataforma verifica RUTs hoy de forma manual o con scraping frágil, el cambio a una API estructurada se amortiza rápidamente en tiempo de operaciones y reducción de errores. Revisa los planes y precios de BaseAPI para encontrar el volumen que se ajusta a tus necesidades.