Documentación

API Reference

Base URL: https://sii.vimaj.cl

Endpoints disponibles

Endpoint	Plan	Clave SII	Descripción
`/contribuyente`	Todos	No	Nombre, giro, actividades, domicilio
`/verificar-dte`	Todos	No	Verificar existencia y estado de un DTE
`/pre-iva`	Todos	Sí	Propuesta F29 / IVA determinado
`/rcv/resumen`	Todos	Sí	Totales RCV compras y ventas
`/libro-compras`	Detalle+	Sí	RCV Compras documento a documento
`/libro-ventas`	Detalle+	Sí	RCV Ventas documento a documento
`/honorarios/emitidas`	Detalle+	Sí	BHE emitidas del periodo
`/honorarios/recibidas`	Detalle+	Sí	BHE recibidas del periodo
`/remuneraciones`	Detalle+	Sí	Libro de Remuneraciones Electrónico
`/boletas/iniciar`	Detalle+	Sí	Iniciar descarga async de boletas
`/boletas/job`	Detalle+	No	Consultar estado del job de boletas
`/f22`	Full	Sí	Declaración de Renta anual (F22)
`/carpeta-tributaria`	Full	Sí	Carpeta Tributaria completa (JSON)
`/f29-datos`	Full	Sí	F29 estructurado (códigos, folio, monto)
`/f29`	Full	Sí	PDF del F29 en base64 o por email
`/carpeta-tributaria-pdf`	Full	Sí	PDF Carpeta Tributaria

Autenticación

La mayoría de los endpoints requieren dos headers. Los endpoints marcados Clave SII: No en la tabla anterior (/contribuyente y /verificar-dte) usan datos públicos del SII y solo necesitan el token Bearer.

Header	Descripción
`Authorization`	`Bearer <token>` — token entregado al contratar
`X-Clave-Tributaria`	Clave tributaria SII del RUT consultado. Nunca se almacena.

GET /pre-iva

Propuesta F29 del período solicitado. Devuelve el IVA determinado, desglose de débitos/créditos y clasificación del estado de la declaración.

Parámetros de query

Parámetro	Formato	Ejemplo
`rut`	`12345678-9`	`77222182-7`
`periodo`	`YYYY-MM`	`2026-08`

Ejemplo de request

curl https://sii.vimaj.cl/pre-iva?rut=77222182-7&periodo=2026-08 \
  -H "Authorization: Bearer sii_abc123..." \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta exitosa (200)

{
  "rut": "77222182-7",
  "periodo": "2026-08",
  "clasificacion": "pendiente",
  "monto_a_pagar": 1250000,
  "texto": "Propuesta F29 disponible",
  "folio": null,
  "tipopropuesta": 40,
  "detalle": {
    "total_debitos": 2100000,
    "total_creditos": 850000,
    "remanente_anterior": 0,
    "iva_determinado": 1250000,
    "ppm_neto": 85000,
    "total_a_pagar_f29": 1335000,
    "retenciones_renta": null
  }
}

Valores de clasificacion:

Valor	Significado
`pendiente`	No declarado, propuesta completa disponible (incluye PPM)
`pendiente_sin_ppm`	No declarado, PPM no confirmado en el asistente del SII
`ya_declarado`	Período ya declarado/pagado

GET /rcv/resumen

Totales del RCV (compras y ventas) agrupados por tipo de documento para el período indicado. Disponible en todos los planes.

Parámetros de query

Parámetro	Formato	Ejemplo
`rut`	`12345678-9`	`77222182-7`
`periodo`	`YYYY-MM`	`2026-08`

Ejemplo de request

curl https://sii.vimaj.cl/rcv/resumen?rut=77222182-7&periodo=2026-08 \
  -H "Authorization: Bearer sii_abc123..." \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta exitosa (200)

{
  "rut": "77222182-7",
  "periodo": "2026-08",
  "compras": [
    {
      "rsmnTipoDocInteger": 33,
      "dcvNombreTipoDoc": "Factura de Proveedor Electrónica",
      "dcvTipoIngresoDoc": "DET_ELE",
      "rsmnMntNeto": 5000000,
      "rsmnMntIVA": 950000,
      "rsmnMntExe": 0,
      "rsmnMntTotal": 5950000,
      "rsmnTotDoc": 12
    }
  ],
  "ventas": [
    {
      "rsmnTipoDocInteger": 33,
      "dcvNombreTipoDoc": "Factura Electrónica",
      "dcvTipoIngresoDoc": "DET_ELE",
      "rsmnMntNeto": 8000000,
      "rsmnMntIVA": 1520000,
      "rsmnMntExe": 0,
      "rsmnMntTotal": 9520000,
      "rsmnTotDoc": 20
    }
  ]
}

Cuando dcvTipoIngresoDoc es RESUMEN (boletas y otros), no hay detalle descargable por documento — usar /libro-compras o /libro-ventas solo descargará los tipos marcados como DET_ELE.

GET /libro-compras Plan Detalle

Libro de Compras (RCV) del período. Detalle por documento.

Parámetros

Parámetro	Formato	Ejemplo
`rut`	`12345678-9`	`77222182-7`
`periodo`	`YYYY-MM`	`2026-08`

Ejemplo de respuesta (200)

{
  "rut": "77222182-7",
  "periodo": "2026-08",
  "documentos": [
    {
      "tipo_dte": 33,
      "folio": 12045,
      "fecha_emision": "2026-08-05",
      "rut_contraparte": "76543210-K",
      "razon_social_contraparte": "Proveedor Ejemplo SpA",
      "monto_neto": 1000000,
      "monto_iva": 190000,
      "monto_exento": 0,
      "monto_total": 1190000
    }
  ]
}

GET /libro-ventas Plan Detalle

Mismo formato que /libro-compras, pero para el Libro de Ventas.

GET /carpeta-tributaria Plan Full

Datos estructurados de la Carpeta Tributaria Electrónica: actividades económicas, representantes legales, conformación de sociedad, socios y accionistas.

Parámetros de query

Parámetro	Formato	Ejemplo
`rut`	`12345678-9`	`77222182-7`

Ejemplo de request

curl https://sii.vimaj.cl/carpeta-tributaria?rut=77222182-7 \
  -H "Authorization: Bearer sii_abc123..." \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta exitosa (200)

{
  "rut": "77222182-7",
  "info_contribuyente": {
    "razon_social": "Empresa Ejemplo SpA",
    "inicio_actividades": "2010-03-15",
    "domicilio": "Av. Providencia 1234, Santiago"
  },
  "actividades_economicas": [
    { "codigo": 620100, "descripcion": "Actividades de tecnología de la información", "afecta_iva": true }
  ],
  "representantes_legales": [...],
  "conformacion_sociedad": [...],
  "socios_accionistas": [...]
}

GET /f29-datos Plan Full

Datos estructurados del Formulario 29 (declarado o propuesto). Retorna todos los códigos del F29, el monto a pagar y el estado de la declaración. No depende de Carpeta Tributaria.

Parámetros de query

Parámetro	Requerido	Formato	Ejemplo
`rut`	Sí	`12345678-9`	`77222182-7`
`periodo`	Sí	`YYYY-MM`	`2026-08`

Ejemplo de request

curl "https://sii.vimaj.cl/f29-datos?rut=77222182-7&periodo=2026-08" \
  -H "Authorization: Bearer sii_abc123..." \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta exitosa (200)

{
  "rut": "77222182-7",
  "periodo": "2026-08",
  "estado": "declarado",
  "folio": "9876543",
  "monto_a_pagar": 1250000,
  "codigos": {
    "89": 1250000,
    "62": 125000,
    "538": 8500000,
    "503": 7500000
  },
  "tipopropuesta": 1
}

Valores de `estado`

Valor	Significado
`declarado`	El período ya fue declarado en el SII
`pendiente`	Hay propuesta disponible pero aún no declarada
`sin_datos`	El período no tiene datos en el SII

GET /f29 Plan Full

PDF del Formulario 29 del período en base64. Si se entrega el parámetro email, el PDF se envía al correo indicado y la respuesta confirma el envío.

Parámetros de query

Parámetro	Requerido	Formato	Ejemplo
`rut`	Sí	`12345678-9`	`77222182-7`
`periodo`	Sí	`YYYY-MM`	`2026-08`
`email`	No	email válido	`contador@empresa.cl`

Respuesta sin email (200)

{
  "rut": "77222182-7",
  "periodo": "2026-08",
  "encontrado": true,
  "compacto_base64": "JVBERi0xLjQKJeLjz9MK..."
}

Respuesta con email (200)

{
  "rut": "77222182-7",
  "periodo": "2026-08",
  "encontrado": true,
  "enviado_a": "contador@empresa.cl"
}

GET /carpeta-tributaria-pdf Plan Full

Genera y descarga el PDF de la Carpeta Tributaria Electrónica.

⚠ Acción irreversible: cada llamada crea un registro de acceso con vigencia de 365 días en el SII y puede enviar correos al contribuyente. Utilizar solo cuando sea necesario.

Parámetros de query

Parámetro	Requerido	Descripción	Ejemplo
`rut`	Sí	RUT del contribuyente (`12345678-9`)	`77222182-7`
`rut_receptor`	Sí	RUT numérico (sin puntos ni guión) de quien recibe	`12345678`
`dv_receptor`	Sí	Dígito verificador del receptor	`9`
`mail_receptor`	Sí	Correo donde el SII notifica la carpeta	`receptor@empresa.cl`
`enfin_codigo`	No	Código de institución financiera (null → `000` = Otra Institución)	`001`
`nombre_institucion`	No	Nombre libre de la institución receptora	`Banco Ejemplo`

Ejemplo de request

curl "https://sii.vimaj.cl/carpeta-tributaria-pdf?rut=77222182-7&rut_receptor=12345678&dv_receptor=9&mail_receptor=receptor@empresa.cl" \
  -H "Authorization: Bearer sii_abc123..." \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta exitosa (200)

{
  "rut": "77222182-7",
  "encontrado": true,
  "codigo_repositorio": 987654,
  "clave_carpeta": "ABC123XYZ",
  "carpeta_base64": "JVBERi0xLjQKJeLjz9MK..."
}

POST /boletas/iniciar Plan Detalle

Inicia la descarga asíncrona de boletas electrónicas (tipo 39/41) del período. El SII genera el archivo en background — retorna inmediatamente un jobId que se usa para consultar el estado.

⚠ Las boletas son procesadas de forma diferida por el SII. El resultado puede tardar entre 1 y 60 segundos. Usa GET /boletas/job para hacer polling hasta que status sea done.

Parámetros de query

Parámetro	Requerido	Formato	Descripción
`rut`	Sí	`12345678-9`	RUT de la empresa
`periodo`	Sí	`YYYY-MM`	Período a consultar
`tot_doc`	No	número	Total esperado de docs (0 = sin filtro)

Ejemplo de request

curl -X POST "https://sii.vimaj.cl/boletas/iniciar?rut=77222182-7&periodo=2026-08&tot_doc=0" \
  -H "Authorization: Bearer sii_abc123..." \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta exitosa (202)

{
  "jobId": "bol_093ff07e35bf4e3abf8f06d6d67d7725",
  "status": "pending"
}

GET /boletas/job Plan Detalle

Consulta el estado de un job iniciado con POST /boletas/iniciar. Hacer polling cada 3-5 segundos hasta obtener status: "done" o "error". El resultado expira a las 24 horas.

Parámetros de query

Parámetro	Requerido	Descripción
`id`	Sí	`jobId` retornado por `/boletas/iniciar`

Ejemplo de request

curl "https://sii.vimaj.cl/boletas/job?id=bol_093ff07e35bf4e3abf8f06d6d67d7725" \
  -H "Authorization: Bearer sii_abc123..."

Respuesta en proceso (200)

{
  "status": "pending",
  "rut": "77222182-7",
  "periodo": "2026-08"
}

Respuesta finalizada (200)

{
  "status": "done",
  "total": 319,
  "duracion_ms": 1000,
  "iniciado_en": "2026-09-26T14:30:00.000Z",
  "documentos": [
    {
      "tipo_dte": 39,
      "folio": 144527,
      "fecha_emision": "2026-08-01",
      "rut_receptor": "66666666-6",
      "monto_neto": 11832,
      "monto_iva": 2248,
      "monto_exento": 0,
      "monto_total": 14080
    }
  ]
}

Valores de status:

Valor	Significado
`pending`	El SII aún está generando el archivo — continuar polling
`done`	Completado. `documentos` contiene el listado completo
`error`	Falló. Ver campo `mensaje` para el detalle

GET /verificar-dte Plan Resumen

Verifica si un DTE (Documento Tributario Electrónico) existe en el registro del SII y cuál es su estado. No requiere clave tributaria — el SII expone esta consulta públicamente. Útil para confirmar que una factura o boleta fue aceptada.

Parámetros

Parámetro	Requerido	Descripción
`rut_emisor`	Sí	RUT del emisor del DTE (formato `12345678-9`)
`tipo_dte`	Sí	Tipo de documento (33=Factura, 34=Factura Exenta, 39=Boleta, 61=NC, etc.)
`folio`	Sí	Número de folio del documento
`fecha_emision`	Sí	Fecha de emisión en formato `YYYY-MM-DD`
`monto_total`	Sí	Monto total del documento (entero, sin decimales)
`rut_receptor`	No	RUT del receptor (recomendado para facturas)

curl "https://sii.vimaj.cl/verificar-dte?rut_emisor=78399125-K&tipo_dte=33&folio=1234&fecha_emision=2026-08-01&monto_total=1190000&rut_receptor=77222182-7" \
  -H "Authorization: Bearer sii_tu_token"

Respuesta

{
  "existe": true,
  "estado": "DOC OK",
  "glosa": "BUSQUEDA REALIZADA CON EXITO",
  "tipo_dte": 33,
  "folio": 1234,
  "rut_emisor": "78399125-K",
  "fecha_emision": "2026-08-01",
  "monto_total": 1190000,
  "fecha_resolucion": "2014-08-22",
  "num_resolucion": "80"
}

GET /f22 Plan Full

Declaración de Renta anual (Formulario 22). Retorna el estado (declarado, propuesto o sin datos), folio, monto a pagar o devolver, y todos los códigos del formulario. El parámetro es el año tributario (año de la declaración, no el año comercial).

Parámetros

Parámetro	Requerido	Descripción
`rut`	Sí	RUT del contribuyente (formato `12345678-9`)
`anio`	Sí	Año tributario (`YYYY`, ej: `2025` para la renta AT2025)

curl "https://sii.vimaj.cl/f22?rut=78399125-K&anio=2025" \
  -H "Authorization: Bearer sii_tu_token" \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta

{
  "rut": "78399125-K",
  "estado": "declarado",
  "anio": "2025",
  "folio": "234567",
  "monto_a_pagar": 850000,
  "codigos": {
    "1": 18000000,
    "2": 4500000,
    "89": 850000
  }
}

El campo monto_a_pagar es negativo cuando el SII debe devolver dinero al contribuyente.

GET /contribuyente Plan Resumen

Datos públicos del contribuyente registrado ante el SII. No requiere clave tributaria — la información es pública. Retorna nombre o razón social, giro declarado, actividades económicas, domicilio y estado tributario.

Parámetros

Parámetro	Requerido	Descripción
`rut`	Sí	RUT a consultar (formato `12345678-9`)

curl "https://sii.vimaj.cl/contribuyente?rut=78399125-K" \
  -H "Authorization: Bearer sii_tu_token"

Respuesta

{
  "rut": "78399125-K",
  "nombre": "EMPRESA EJEMPLO LTDA",
  "giro": "SERVICIOS DE CONSULTORIA",
  "tipo_entidad": "SOCIEDAD DE RESPONSABILIDAD LIMITADA",
  "estado": "ACTIVO",
  "inicio_actividades": "2010-03-01",
  "actividades": [
    {
      "codigo": "7420",
      "descripcion": "SERVICIOS DE CONSULTORIA DE INFORMATICA",
      "categoria": "1era CATEGORIA",
      "inicio": "2010-03-01"
    }
  ],
  "domicilio": {
    "calle": "CALLE PROVIDENCIA",
    "numero": "1234",
    "departamento": "PISO 3",
    "comuna": "PROVIDENCIA",
    "ciudad": "SANTIAGO",
    "region": "REGION METROPOLITANA"
  }
}

GET /remuneraciones Plan Detalle

Libro de Remuneraciones Electrónico (LRE) del periodo indicado. Retorna el detalle de remuneraciones por trabajador: sueldo bruto, imponible, líquido, días trabajados y códigos de previsión y salud.

Parámetros

Parámetro	Requerido	Descripción
`rut`	Sí	RUT del empleador (formato `12345678-9`)
`periodo`	Sí	Mes a consultar (`YYYY-MM`)

curl "https://sii.vimaj.cl/remuneraciones?rut=78399125-K&periodo=2026-08" \
  -H "Authorization: Bearer sii_tu_token" \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta

{
  "rut": "78399125-K",
  "periodo": "2026-08",
  "total": 5,
  "filas": [
    {
      "rut_trabajador": "12345678-9",
      "nombre_trabajador": "JUAN PEREZ GONZALEZ",
      "periodo": "202608",
      "sueldo_bruto": 1200000,
      "sueldo_imponible": 1100000,
      "sueldo_liquido": 950000,
      "dias_trabajados": 30,
      "codigo_prevision": "AFP_CAPITAL",
      "codigo_salud": "FONASA",
      "estado": "VIGENTE"
    }
  ]
}

GET /honorarios/emitidas Plan Detalle

Boletas de Honorarios Electrónicas emitidas por el RUT en el periodo indicado. Requiere autenticación SII (clave tributaria). El resultado incluye folio, fecha, RUT y nombre del pagador, montos bruto/retención/líquido y estado.

Parámetros

Parámetro	Requerido	Descripción
`rut`	Sí	RUT del emisor (formato `12345678-9`)
`periodo`	Sí	Mes a consultar (`YYYY-MM`)

curl "https://sii.vimaj.cl/honorarios/emitidas?rut=17372302-4&periodo=2026-08" \
  -H "Authorization: Bearer sii_tu_token" \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta

{
  "rut": "17372302-4",
  "periodo": "2026-08",
  "total": 3,
  "documentos": [
    {
      "folio": 1234,
      "fecha_emision": "2026-08-05",
      "rut_pagador": "76543210-2",
      "nombre_pagador": "EMPRESA PAGADORA LTDA",
      "monto_bruto": 500000,
      "monto_retencion": 53750,
      "monto_liquido": 446250,
      "estado": "VIGENTE"
    }
  ]
}

GET /honorarios/recibidas Plan Detalle

Boletas de Honorarios Electrónicas recibidas por el RUT en el periodo indicado. Retorna las BHE que terceros (trabajadores independientes) emitieron a nombre de la empresa. Requiere autenticación SII (clave tributaria). El resultado incluye folio, fecha, RUT y nombre del emisor, montos bruto/retención/líquido y estado.

Parámetros

Parámetro	Requerido	Descripción
`rut`	Sí	RUT de la empresa receptora (formato `12345678-9`)
`periodo`	Sí	Mes a consultar (`YYYY-MM`)

curl "https://sii.vimaj.cl/honorarios/recibidas?rut=78362091-K&periodo=2026-08" \
  -H "Authorization: Bearer sii_tu_token" \
  -H "X-Clave-Tributaria: tu_clave_sii"

Respuesta

{
  "rut": "78362091-K",
  "periodo": "2026-08",
  "total": 10,
  "documentos": [
    {
      "folio": 987,
      "fecha_emision": "2026-08-03",
      "rut_emisor": "12345678-9",
      "nombre_emisor": "JUAN TRABAJADOR INDEPENDIENTE",
      "monto_bruto": 250000,
      "monto_retencion": 26875,
      "monto_liquido": 223125,
      "estado": "VIGENTE"
    }
  ]
}

Códigos de error

HTTP	Código interno	Descripción
401	1001	Token inválido o inactivo
401	1002	Falta header `Authorization`
403	1003	RUT no autorizado para este token
400	1004	Parámetros inválidos (RUT o período)
429	1005	Demasiadas solicitudes — reintenta en 1 segundo
504	1006	El SII no respondió a tiempo
502	1007	Error del SII (credencial incorrecta o SII no disponible)
403	1009	Cuota mensual alcanzada (modo multi-empresa)

Formato de error

{
  "error": "El token no está autorizado para el RUT 77222182-7",
  "code": 1003
}

API Reference

Endpoints disponibles

Autenticación

GET /pre-iva

Parámetros de query

Ejemplo de request

Respuesta exitosa (200)

GET /rcv/resumen

Parámetros de query

Ejemplo de request

Respuesta exitosa (200)

GET /libro-compras Plan Detalle

Parámetros

Ejemplo de respuesta (200)

GET /libro-ventas Plan Detalle

GET /carpeta-tributaria Plan Full

Parámetros de query

Ejemplo de request

Respuesta exitosa (200)

GET /f29-datos Plan Full

Parámetros de query

Ejemplo de request

Respuesta exitosa (200)

Valores de estado

GET /f29 Plan Full

Parámetros de query

Respuesta sin email (200)

Respuesta con email (200)

GET /carpeta-tributaria-pdf Plan Full

Parámetros de query

Ejemplo de request

Respuesta exitosa (200)

POST /boletas/iniciar Plan Detalle

Parámetros de query

Ejemplo de request

Respuesta exitosa (202)

GET /boletas/job Plan Detalle

Parámetros de query

Ejemplo de request

Respuesta en proceso (200)

Respuesta finalizada (200)

GET /verificar-dte Plan Resumen

Parámetros

Respuesta

GET /f22 Plan Full

Parámetros

Respuesta

GET /contribuyente Plan Resumen

Parámetros

Respuesta

GET /remuneraciones Plan Detalle

Parámetros

Respuesta

GET /honorarios/emitidas Plan Detalle

Parámetros

Respuesta

GET /honorarios/recibidas Plan Detalle

Parámetros

Respuesta

Códigos de error

Formato de error

Valores de `estado`