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.
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.
La referencia completa del endpoint, con ejemplos de respuesta, está en la documentación de la API.
El nombre legal de la empresa, tal como debe ir en la factura.
El RUT de la empresa con su dígito verificador.
El correo de la empresa, cuando está disponible.
Cada actividad registrada en el SII, con su código y su nombre. De aquí sale el giro de la factura.
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.
El id de la empresa en Tupana, para usarlo en otros endpoints de la API.
El usuario escribe un RUT y tu formulario se llena solo con razón social, giro y direcciones.
Si la empresa tiene actividad económica, normalmente le corresponde una factura (33 o 34); si es consumidor final, una boleta (39).
Una empresa puede tener varias sucursales. Muestras la lista y tu usuario elige la que va en el documento.
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.
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.
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.
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.
GET https://api.tupana.ai/v2/master-entities/?rut= con el RUT de la empresa y el encabezado Authorization: Api-Key con tu key.
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.
El giro sale de las actividades económicas registradas en el SII, que vienen con su código y nombre en la respuesta.
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.
No. Consultas los datos tributarios de cualquier RUT con tu propia API key.
Sí. Creas una key de sandbox gratis en Tupana Developers y pruebas la API sin tarjeta.