API para consultar el RUT de una empresa: razón social, actividades y direcciones del SII

Con la API de Tupana envías un RUT y recibes la razón social, el correo, las actividades económicas con su código y las direcciones registradas en el SII, con su comuna, ciudad y código de sucursal. Sirve para autocompletar el formulario de clientes de tu sistema y emitir la factura con los datos correctos, sin que nadie los tipee.

Un RUT de entrada, los datos tributarios de salida

La consulta es una llamada GET autenticada con tu API key. Si Tupana ya tiene los datos de esa empresa, responde de inmediato. Si no, los obtiene del SII y los guarda para las próximas consultas. Mientras los busca, la API responde 202 con estado processing y el encabezado Retry-After, para que vuelvas a preguntar en unos segundos.

  1. Crea tu API key: En Tupana Developers creas una key. La de sandbox es gratis y no necesita tarjeta.
  2. Consulta el RUT: GET https://api.tupana.ai/v2/master-entities/?rut=76543210-1 con el encabezado Authorization: Api-Key y tu key.
  3. Usa la respuesta: Precargas la razón social, eliges la dirección y la actividad del receptor y sigues con la emisión.

La referencia completa del endpoint, con ejemplos de respuesta, está en la documentación de la API.

Los campos de la respuesta

name · Razón social

El nombre legal de la empresa, tal como debe ir en la factura.

tax_id · RUT

El RUT de la empresa con su dígito verificador.

email · Correo

El correo de la empresa, cuando está disponible.

activities · Actividades económicas

Cada actividad registrada en el SII, con su código y su nombre. De aquí sale el giro de la factura.

addresses · Direcciones

Cada dirección con su comuna y ciudad, el código de sucursal del SII, el teléfono si existe y cuál es la casa matriz.

id · Identificador

El id de la empresa en Tupana, para usarlo en otros endpoints de la API.

Para qué la usan los equipos que integran con Tupana

Autocompletar clientes

El usuario escribe un RUT y tu formulario se llena solo con razón social, giro y direcciones.

Elegir el documento correcto

Si la empresa tiene actividad económica, normalmente le corresponde una factura (33 o 34); si es consumidor final, una boleta (39).

Elegir la dirección de la factura

Una empresa puede tener varias sucursales. Muestras la lista y tu usuario elige la que va en el documento.

Emitir sin rechazos

Con los datos del SII en el receptor, la factura llega con la razón social y el giro correctos. Luego emites por la API de factura electrónica.

Además: la nómina de empresas del SII, gratis por API

Si lo que necesitas es el perfil de una empresa más que sus datos para facturar, la API también expone la nómina pública de empresas que publica el SII cada año, desde 2020. Según la documentación, se consulta gratis con cualquier API key, de sandbox o de producción.

  • Tramo de ventas, tamaño y número de trabajadores.
  • Fecha de inicio de actividades y si la empresa sigue activa.
  • Tipo de contribuyente, sector, subsector y rubro.
  • Región, provincia y comuna.
  • Historia año a año, para ver si una empresa creció de tramo.

La nómina cubre personas jurídicas y sus datos son tributarios y preliminares: el SII no garantiza su exactitud. El detalle está en bases de datos gratuitas.

Lo que conviene saber

  • Los datos vienen del SII y se guardan en Tupana: no es una consulta en tiempo real en cada llamada.
  • Si el RUT no existe en el SII, la respuesta vuelve con los campos vacíos, no con un error. Tu interfaz debe manejar ese caso.
  • La consulta no reemplaza una verificación de identidad o de riesgo: entrega datos tributarios, no comerciales.
  • La API de Tupana para developers es un producto aparte de los planes web, con sus propios precios en developers.tupana.ai/pricing.

La misma consulta desde tu asistente de IA

Si trabajas con Claude, Cursor o ChatGPT, el servidor MCP de Tupana puede buscar una empresa por RUT y completar los datos de un cliente con la información del SII mientras armas una factura, sin escribir código.

Preguntas frecuentes

¿Qué endpoint uso para consultar un RUT?

GET https://api.tupana.ai/v2/master-entities/?rut= con el RUT de la empresa y el encabezado Authorization: Api-Key con tu key.

¿Qué datos devuelve la consulta?

Razón social, RUT, correo, actividades económicas con código y nombre, y direcciones con comuna, ciudad, código de sucursal del SII y teléfono si existe.

¿La API devuelve el giro?

El giro sale de las actividades económicas registradas en el SII, que vienen con su código y nombre en la respuesta.

¿Por qué la API respondió 202?

Porque Tupana está obteniendo los datos de esa empresa desde el SII. Vuelve a consultar después del tiempo que indica el encabezado Retry-After.

¿Necesito las claves del SII de la empresa que consulto?

No. Consultas los datos tributarios de cualquier RUT con tu propia API key.

¿Puedo probar sin pagar?

Sí. Creas una key de sandbox gratis en Tupana Developers y pruebas la API sin tarjeta.

Sigue leyendo