FAQ

Preguntas Frecuentes sobre API SII

Respondemos las preguntas que la gente realmente busca sobre la API del SII chileno: qué es, cómo integrarla, requisitos técnicos, empresas que ofrecen el servicio y más.

Conceptos básicos

¿Qué es la interfaz de programación del servicio tributario chileno?

La API del SII (Interfaz de Programación de Aplicaciones del Servicio de Impuestos Internos de Chile) es un conjunto de endpoints que permiten a sistemas externos — ERPs, softwares contables, plataformas web — consultar y obtener datos tributarios de forma automática, sin necesidad de entrar al portal web del SII manualmente.

El SII no expone una API pública directa para desarrolladores. Servicios como Gears actúan como puente: nos conectamos al SII con las credenciales del contribuyente y entregamos los datos en JSON vía REST.

Con Gears puedes obtener: datos de contribuyentes por RUT, libro de compras y ventas, boletas de honorarios, declaraciones F22 y F29, comprobantes TGR y XML de DTE.

¿Qué servicios ofrecen las plataformas que utilizan la API del SII para facturación electrónica?
  • Consulta de contribuyentes: razón social, giro, actividades económicas, direcciones, representantes y timbrajes.
  • Descarga de LC/LV: detalle completo por período con datos reales del SII.
  • Gestión de BH: consultar boletas recibidas y emitir nuevas.
  • Declaraciones: F22 (Renta) y F29 (IVA).
  • Certificados: renta PDF y comprobantes TGR.
  • XML de DTE: descarga de XML originales del libro de compras.
  • B2B: Jumbo, Easy y Construmart para proveedores.

En Gears todo vía REST con JSON. Ver planes.

Integración

¿Cómo integrar la API del SII en un sistema contable chileno?
  1. Contrata un intermediario como Gears.
  2. Obtén tu API Key (ID + secreto).
  3. Desde tu sistema (Softland, Defontana, SAP, Dynamics, Odoo) haz llamadas HTTP.
  4. Programa consultas según tu ciclo contable.
  5. Procesa el JSON en tus tablas.

Ejemplo Python → Softland:

import requests

API_KEY = "***"
BASE = "https://api.gears.cl/api/v1/sii"

lc = requests.post(f"{BASE}/get_datos_sii_lc", json={
    "usu_sii": "12345678-9",
    "pass_sii": "clave_sii",
    "periodo": "2026-06", "tipo": "C"
}, headers={"X-API-Key": API_KEY}).json()

for linea in lc:
    cursor.execute("""
        INSERT INTO Compras (RutProveedor, Folio, Neto, IVA, Total)
        VALUES (?, ?, ?, ?, ?)
    """, linea["RUT"], linea["Folio"],
         linea["Neto"], linea["IVA"], linea["Total"])

Ofrecemos soporte técnico dedicado.

Cómo integrar un sistema de gestión con la plataforma fiscal.
  1. Evalúa qué datos necesitas (¿solo LC/LV? ¿BH? ¿F29?).
  2. Elige el plan (SII Básico o SII PRO).
  3. Implementa las llamadas HTTP desde tu sistema.
  4. Automatiza con tareas programadas (cron, jobs del ERP).

Ejemplos por sistema:

  • Softland: Python/C# → API → SQL Server
  • SAP: ABAP + cl_http_client
  • Dynamics 365: C# plugin o Power Automate
  • Odoo: módulo Python
  • Excel/Sheets: VBA o Google Apps Script

Requisitos técnicos

¿Cuáles son los requisitos técnicos para conectar un software con la API del SII?
RequisitoDetalle
ConexiónHTTPS saliente
LenguajeCualquiera (Python, C#, Java, PHP, JS)
API KeyID + secreto HMAC-SHA256
CredencialesRUT y Clave SII del contribuyente
CertificadoSolo para XML de DTE
FormatoJSON

No necesitas hardware especial ni servidores dedicados.

Guía para desarrolladores sobre la autenticación en servicios web tributarios.

Usamos HMAC-SHA256 con estos headers:

  • X-Api-Key-Id
  • X-Timestamp (Unix epoch)
  • X-Nonce (UUID único)
  • X-Signature (firma en Base64)
  • Content-Type

Cálculo:

canonical = METHOD + "\n" + PATH + "\n" +
            timestamp + "\n" + nonce + "\n" +
            SHA256(body)
signature = base64(HMAC-SHA256(secret, canonical))

Ejemplo Python:

import base64, hashlib, hmac, json, time, uuid, requests

key_id = "tu_key_id"
secret = base64.b64decode("tu_secreto_base64")
path = "/api/v1/sii/get_datos_sii"
body = json.dumps({"usu_sii":"12345678-9","pass_sii":"clave"},
    separators=(",",":"), ensure_ascii=False).encode()

timestamp = str(int(time.time()))
nonce = str(uuid.uuid4())
canonical = "\n".join(["POST", path, timestamp, nonce,
    hashlib.sha256(body).hexdigest()])
signature = base64.b64encode(
    hmac.new(secret, canonical.encode(), hashlib.sha256).digest()
).decode()

headers = {"X-Api-Key-Id":key_id, "X-Timestamp":timestamp,
    "X-Nonce":nonce, "X-Signature":signature,
    "Content-Type":"application/json"}
r = requests.post("https://api.gears.cl"+path, data=body, headers=headers)
print(r.json())

Documentación y recursos

¿Dónde puedo encontrar documentación oficial para usar la API del SII?

El SII no publica documentación oficial de API REST. Los portales del SII son para uso humano, no programático.

Para DTE hay documentación del formato XML, pero no cubre consultas como LC, situación tributaria o declaraciones.

Gears te entrega una API REST documentada con ejemplos, SDK y soporte.

Requisitos para acceder a la documentación técnica del sistema de impuestos.
  • DTE: manuales públicos en sii.cl. Sin registro.
  • Portal MisII: no hay documentación para acceso programático.
  • API Gears: documentación completa + ejemplos + soporte al contratar.

Empresas y soluciones en Chile

¿Qué empresas en Chile ofrecen soluciones basadas en la API del SII para pymes?
EmpresaEnfoque
GearsAPI consultas SII + TGR + Bancos + B2B
E-Clerk / TeneriaFacturación electrónica
DefontanaERP con módulo SII
NuboxFacturación + contabilidad cloud
Simple.clFacturación electrónica

Diferenciador Gears: API pura para desarrolladores, sin cambiar de ERP.

Empresas que ofrecen soluciones de facturación electrónica conectadas al ente recaudador.

Además: E-Cert, Tima, iDoc, E-Sii.

Estas se enfocan en emitir DTE. Gears se especializa en consultar datos del SII (LC, F22, F29, TGR).

¿Tienes más dudas?

Contáctanos para ayudarte con tu integración o contratar un plan. Escríbenos.