Cómo integrar información del SII mediante una API REST en Chile

La integración de información tributaria se ha convertido en una necesidad para empresas que buscan automatizar sus procesos contables, validar proveedores, evaluar clientes y desarrollar aplicaciones financieras.

En Chile, el Servicio de Impuestos Internos (SII) concentra una parte importante de la información tributaria utilizada por las empresas. Sin embargo, incorporar esos datos a un ERP, CRM o plataforma propia puede representar un desafío técnico.

Una API REST permite conectar aplicaciones empresariales con información tributaria de forma estructurada, automatizando consultas que tradicionalmente requieren intervención manual.

En esta guía explicamos cómo funciona una integración con datos del SII, qué información es posible consultar y cómo utilizar la API de Check Auditor para incorporar estas capacidades a tu software.

¿Qué es una API del SII?

Una API (Application Programming Interface) es una interfaz que permite que dos sistemas intercambien información mediante solicitudes programáticas.

En el contexto tributario, una API puede permitir que una aplicación consulte antecedentes disponibles de un contribuyente y los incorpore a sus propios procesos.

Por ejemplo, un sistema de gestión empresarial podría necesitar verificar la información tributaria de un proveedor antes de incorporarlo a su base de datos.

En lugar de solicitar antecedentes manualmente, el sistema puede realizar una consulta a una API y procesar la respuesta.

Es importante distinguir entre los servicios electrónicos oficiales del SII y las APIs desarrolladas por proveedores tecnológicos que facilitan el acceso e integración de información tributaria.

Check Auditor proporciona una API propia para integrar información relacionada con el SII. No constituye una API oficial del organismo tributario.

¿Qué información del SII se puede integrar?

Dependiendo del servicio habilitado, los permisos y las autorizaciones correspondientes, es posible trabajar con distintas categorías de información.

1. Datos generales de empresas

Permiten identificar y validar información tributaria de un contribuyente, como:

• RUT y razón social.

• Actividades económicas.

• Inicio de actividades.

• Domicilio tributario.

• Régimen tributario.

Esta información es especialmente útil para la incorporación de clientes y proveedores, la validación de registros y la actualización de bases de datos empresariales.

2. Registro de Compras y Ventas

El Registro de Compras y Ventas (RCV) contiene información de documentos tributarios asociados a las operaciones comerciales de un contribuyente.

Mediante una integración autorizada, estos antecedentes pueden utilizarse para automatizar procesos contables, conciliaciones, análisis de operaciones y controles administrativos.

3. Formularios tributarios

Las declaraciones tributarias entregan antecedentes relevantes para la gestión y el análisis financiero de una empresa.

Entre los formularios que contempla la oferta de integración de Check Auditor se encuentran:

• Formulario 29 (F29): declaración mensual asociada al IVA y otros impuestos.

• Formulario 22 (F22): declaración anual de impuesto a la renta.

• Formulario 50 (F50): declaración y pago de determinados impuestos.

La disponibilidad de cada formulario y de sus campos depende de la integración contratada y del acceso autorizado.

4. Documentos tributarios electrónicos

Los documentos tributarios electrónicos, como facturas y notas de crédito, permiten respaldar operaciones comerciales y automatizar procesos de revisión.

Una API puede facilitar el uso de datos como tipo de documento, folio, RUT de la contraparte, fecha y montos, de acuerdo con la información efectivamente disponible.

¿Cómo funciona una integración mediante API REST?

Una integración REST utiliza solicitudes HTTP para intercambiar información entre aplicaciones.

El proceso puede resumirse en cinco pasos:

1. Autenticación: tu aplicación se identifica ante la API mediante una credencial.

2. Identificación: el sistema determina la empresa cuya información está autorizada a consultar.

3. Solicitud: se ejecuta una petición HTTP al endpoint correspondiente.

4. Respuesta: la API devuelve los datos disponibles en un formato que tu software pueda interpretar, normalmente JSON.

5. Procesamiento: la aplicación utiliza la información para completar registros, alimentar análisis o ejecutar reglas de negocio.

La principal ventaja es que la información puede incorporarse directamente al software que ya utiliza la empresa.

Tutorial: cómo conectar tu aplicación con Check Auditor API

A continuación, veremos un ejemplo básico utilizando la API de Check Auditor.

Paso 1. Obtener tu API Key

Para comenzar, necesitas una cuenta con acceso habilitado a la integración.

Desde el módulo de integraciones de Check Auditor puedes consultar tu API Key, que será utilizada para autenticar las solicitudes.

Esta credencial debe mantenerse protegida y utilizarse exclusivamente desde entornos seguros, como el backend de tu aplicación.

Paso 2. Identificar la empresa autorizada

La API utiliza identificadores de empresas para determinadas operaciones.

Es importante distinguir el RUT tributario del identificador interno de la empresa en Check Auditor. No todos los endpoints reciben directamente un RUT.

Antes de consultar información, verifica que la empresa esté registrada o vinculada correctamente, con los permisos necesarios.

Paso 3. Realizar una solicitud HTTP

La documentación de Check Auditor incluye el endpoint de datos generales:

GET /api/v1/sii/sessions

Un ejemplo de consulta es:

curl --request GET \
  "https://app.checkauditor.com/api/v1/sii/sessions?id=ID_EMPRESA" \
  --header "API-KEY: TU_API_KEY" \
  --header "Accept: application/json"

Debes reemplazar ID_EMPRESA por el identificador correspondiente y TU_API_KEY por tu credencial de acceso.

La documentación también describe una operación POST /api/v1/sii/sessions destinada a establecer la conexión o sesión con el SII. La secuencia necesaria depende del estado de conexión de la empresa y de la configuración de su cuenta.

Paso 4. Procesar la respuesta

Una respuesta con datos generales puede contener información como la siguiente:

{
  "rut": "76.000.000-X",
  "business_name": "EMPRESA DEMOSTRACIÓN SPA",
  "first_name": null,
  "last_name_paternal": null,
  "last_name_maternal": null
}

Ejemplo demostrativo. Los campos y la estructura efectiva pueden variar según el endpoint utilizado.

En este caso, la aplicación podría utilizar el RUT y la razón social para completar el registro de una empresa y contrastarlo con la información declarada durante su incorporación.

El resultado también podría alimentar un proceso interno de validación o quedar asociado a una ficha de cliente o proveedor.

Paso 5. Incorporar la información a tu sistema

Una vez obtenida la respuesta, puedes incorporar los datos a diferentes aplicaciones:

• Un ERP puede actualizar información tributaria de proveedores.

• Un CRM puede enriquecer registros empresariales.

• Una plataforma de compras puede apoyar sus controles de incorporación.

• Un sistema financiero puede utilizar antecedentes autorizados como insumo para un análisis.

• Un software contable puede integrar registros y declaraciones disponibles.

Para sistemas que ejecutan muchas consultas, es recomendable incorporar control de errores, registro de operaciones, políticas de reintento y mecanismos que eviten consultas duplicadas.

Puedes encontrar los endpoints y parámetros disponibles en la documentación oficial de Check Auditor.

Casos de uso de una API del SII

Automatización del onboarding de proveedores

Cuando una empresa incorpora un nuevo proveedor, normalmente necesita recopilar y validar antecedentes tributarios.

Una integración permite incorporar verificaciones automáticas al proceso, reducir la digitación manual y mantener información estructurada.

Evaluación financiera de clientes

En operaciones de crédito comercial, el análisis de antecedentes tributarios puede complementar otros indicadores financieros.

Por ejemplo, la información autorizada de declaraciones y movimientos puede apoyar una evaluación de capacidad económica.

Sin embargo, ningún antecedente tributario individual permite determinar por sí solo la solvencia de una empresa.

Integración con sistemas contables

La automatización del acceso a registros de compras, ventas y formularios puede reducir tareas repetitivas y apoyar procesos de conciliación o cierre contable.

Esto permite concentrar el trabajo humano en la revisión de diferencias, validación y análisis.

Plataformas de compliance y due diligence

Los antecedentes tributarios pueden complementar la evaluación de terceros.

Al relacionarlos con información comercial, societaria, judicial y de insolvencia, las empresas pueden contar con un análisis más completo de sus contrapartes.

¿Cómo utilizar inteligencia artificial con datos tributarios?

Una de las aplicaciones más interesantes de las APIs es su integración con agentes de inteligencia artificial.

Un agente de IA puede consumir información estructurada de una API y utilizarla para responder preguntas, elaborar resúmenes y detectar antecedentes que requieren revisión.

Por ejemplo, una empresa podría implementar un asistente que responda:

“¿Qué antecedentes tributarios deberíamos revisar antes de otorgar crédito comercial a este proveedor?”

El agente podría solicitar información autorizada mediante la API, identificar declaraciones disponibles, comparar períodos y entregar una síntesis de los hallazgos.

Para que este proceso sea confiable, la IA debe trabajar sobre información obtenida de fuentes verificables, identificar los datos utilizados y señalar cuando no cuenta con antecedentes suficientes.

La interpretación automatizada debe complementar, y no reemplazar, los controles tributarios y financieros realizados por profesionales.

Seguridad y protección de la información tributaria

No toda la información tributaria de una empresa es pública.

El acceso a documentos, declaraciones y antecedentes reservados puede requerir autorización del contribuyente, representación válida o mecanismos específicos de acceso.

El SII dispone, por ejemplo, de carpetas tributarias electrónicas que el propio contribuyente puede generar y compartir con terceros autorizados.

Al desarrollar una integración, es recomendable aplicar las siguientes medidas:

• Mantener las credenciales de API exclusivamente en el backend.

• Utilizar HTTPS para las comunicaciones.

• Verificar los permisos de acceso a cada empresa.

• Evitar almacenar contraseñas tributarias innecesariamente.

• Registrar las consultas relevantes para mantener trazabilidad.

• Aplicar controles de acceso y políticas de conservación de datos.

• Respetar las autorizaciones y finalidades para las cuales se obtuvo la información.

Una API facilita la integración tecnológica, pero no elimina las obligaciones de confidencialidad, seguridad y tratamiento adecuado de los datos.

Preguntas frecuentes sobre APIs del SII

¿Existe una API REST pública del SII para consultar toda la información de una empresa?

El SII dispone de servicios electrónicos e integraciones para determinadas operaciones, pero no debe asumirse que existe una API REST pública y universal que permita consultar todos los antecedentes tributarios de cualquier RUT sin restricciones.

El acceso depende del servicio, la naturaleza de los datos y las autorizaciones correspondientes.

¿Puedo consultar información tributaria de cualquier empresa con su RUT?

El RUT permite identificar al contribuyente, pero no otorga automáticamente acceso a toda su información.

Algunos antecedentes pueden ser consultables públicamente, mientras otros requieren autorización o representación.

¿Puedo integrar una API del SII con mi ERP o CRM?

Sí. Una API REST puede conectarse con aplicaciones desarrolladas en diferentes tecnologías y lenguajes, siempre que se cumplan los requisitos técnicos y de acceso.

¿Qué necesito para utilizar la API de Check Auditor?

Necesitas una cuenta con el servicio habilitado, tu API Key y los identificadores y permisos exigidos por el endpoint que quieras utilizar.

Integra información tributaria en tu software con Check Auditor

La automatización de información tributaria permite construir procesos empresariales más eficientes, reducir tareas manuales e incorporar datos verificables a los sistemas de gestión.

Con la API de Check Auditor, desarrolladores y empresas pueden conectar aplicaciones con servicios de información relacionados con el SII, utilizando una interfaz diseñada para la integración empresarial.

Ya sea para validar proveedores, enriquecer registros, automatizar procesos contables o desarrollar soluciones de inteligencia artificial, una integración estructurada permite aprovechar mejor la información disponible.

¿Quieres integrar información del SII en tu aplicación?

Conoce las capacidades de nuestra API de datos empresariales, revisa la documentación para desarrolladores o solicita una demostración para evaluar la integración más adecuada para tu empresa.