---
title: "Servicios Web (API) Nueva (versión 2)"
description: ""
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-08-27"
last_update: "2026-08-21"
time_minutes: 1
draft: false
unlisted: false
url: "https://www.stage.apigateway.cl/docs/api"
---
## API Gateway
Proveemos en [www.apigateway.cl](https://www.apigateway.cl) una API para
interactuar con diferentes funcionalidades del SII (Servicio de Impuestos Internos de Chile).
**¡Tenemos una API que ni el propio SII tiene disponible!**
**Importante**: esta API no está relacionada de ninguna forma con el SII, es
sólo una pasarela para interactuar con funcionalidades del sitio web del
SII. No somos parte del SII ni de otra institución pública.
Si requiere soporte con el uso de la API, por favor [abrir un ticket de
soporte](https://www.apigateway.cl/help).
**IMPORTANTE** Algunos ejemplos con código de esta documentación son generados
automáticamente y no representan ejemplos reales ni funcionales.
Cada usuario deberá construir los códigos necesarios según su lenguaje y
sistema con la documentación existente. Donde los códigos sugeridos por
Postman podrían servir de guía, pero nada más.
---
## Servicios y Recursos Disponibles
Nuestra API proporciona acceso a múltiples funcionalidades del SII organizadas en las siguientes categorías:
- Indicadores Económicos
- Contribuyentes
- DTE (Documentos Tributarios Electrónicos)
- MiSII
- RCV (Registro de Compras y Ventas)
- RTC (Registro de Transferencia de Cesiones)
- BHE (Boletas Honorarios Electrónicas)
- BTE (Boletas Terceros Electrónicas)
- MIPYME (Software MIPYME SII)
- Formulario 29
- Bienes Raíces
- API Eboleta (Boletas Electrónicas)
---
#### Academia de API Gateway
La Academia de API Gateway es un espacio diseñado para ayudar a los usuarios a entender y utilizar la API de API Gateway de manera eficiente.
Revise la lección [Primeros pasos](https://www.apigateway.cl/academy/primeros-pasos) para conocer los conceptos necesarios y realizar sus primeras consultas.
#### Clientes de la API
| Lenguaje | Autor | Repositorio |
| --- | --- | --- |
| PHP | API Gateway | [github.com/apigatewaycl/apigateway-api-client-php](https://github.com/apigatewaycl/apigateway-api-client-php) |
| Python | API Gateway | [github.com/apigatewaycl/apigateway-api-client-python](https://github.com/apigatewaycl/apigateway-api-client-python) |
---
## Cabeceras de respuesta
Cada respuesta de la API incluye cabeceras HTTP además del cuerpo
(JSON, PDF, XML u otro formato). Sirven para conocer el estado de la
consulta: créditos consumidos, límite de peticiones, sesión con el SII
y lo que ocurrió al consultar el origen.
No reemplazan el cuerpo de la respuesta. El resultado de la operación
sigue yendo en el body. Las cabeceras `X-Auth-*` y `X-Source-*` solo
aparecen en recursos que consultan al origen; si no hay sesión
(consultas públicas como UF) se omiten las de autenticación.
#### Límite de peticiones (`X-RateLimit-*`)
Controlan cuántas peticiones puede hacer la conexión por minuto.
| Cabecera | Función |
| --- | --- |
| `X-RateLimit-Limit` | Máximo de peticiones permitidas por minuto para la conexión. |
| `X-RateLimit-Remaining` | Peticiones que aún puede realizar en la ventana actual. |
| `X-RateLimit-Reset` | Marca de tiempo Unix en la que se reinicia el contador. |
| `Retry-After` | Segundos que debe esperar antes de reintentar. Solo aparece cuando la API responde `429 Too Many Requests`. |
Si `X-RateLimit-Remaining` llega a `0`, la siguiente petición será
rechazada con HTTP 429 hasta `X-RateLimit-Reset`.
#### Estadísticas de la consulta (`X-Stats-*`)
Presentes en todos los recursos autenticados con token de conexión.
Permiten medir costo, duración y créditos restantes sin consultar la
plataforma.
| Cabecera | Función |
| --- | --- |
| `X-Stats-Started-At` | Instantánea ISO 8601 en que comenzó a procesarse la petición. |
| `X-Stats-Ended-At` | Instantánea ISO 8601 en que terminó. |
| `X-Stats-Time` | Duración total de la petición en API Gateway, en segundos. |
| `X-Stats-Memory` | Memoria utilizada por la petición, en bytes. |
| `X-Stats-Credits-Used` | Créditos descontados por esta operación. |
| `X-Stats-Credits-Remaining` | Créditos que quedan en la conexión después de esta consulta. |
Use `X-Stats-Credits-Remaining` para saber si puede seguir consultando.
Si llega a `0`, las siguientes peticiones serán rechazadas hasta recargar
créditos.
#### Autenticación con el origen (`X-Auth-*`)
Indican el estado de la sesión con el origen. Se omiten cuando el
valor no existe.
| Cabecera | Función |
| --- | --- |
| `X-Auth-Expires-At` | Momento en que vence la sesión cacheada, cuando está disponible. |
| `X-Auth-Session-Problem` | `1` si el origen pidió reautenticar (sesión inválida o caducada). En ese caso conviene repetir la consulta con `auth_cache=0` para forzar un login nuevo. |
#### Consulta al origen (`X-Source-*`)
Describen lo que ocurrió al consultar el sitio del origen (SII,
Previred, eBoleta). Útiles para soporte y para entender por qué una
consulta tardó más de lo habitual.
| Cabecera | Función |
| --- | --- |
| `X-Source-Proxy` | `1` si la consulta al origen usó proxy; `0` si no. |
| `X-Source-Request-Count` | Cantidad de peticiones HTTP (o navegaciones) hechas al origen. |
| `X-Source-Request-Time` | Tiempo, en segundos, invertido en esas peticiones al origen. |
| `X-Source-Captcha-Attempts` | Intentos de resolver captcha. `0` si no hubo. |
`X-Stats-Time` mide el tiempo total en API Gateway (incluye
autenticación, créditos y armado de la respuesta).
`X-Source-Request-Time` mide solo el tiempo en el origen.
Servers: https://app.apigateway.cl
Index:
- API SII
- Unidad de Fomento anual
- Unidad de Fomento mensual
- Unidad de Fomento diario
- Corrección monetaria
- Impuesto de segunda categoría anual
- Impuesto de segunda categoría mensual
- API Contribuyentes - Consultas públicas
- Verificación de cédula RUT
- Situación tributaria de un contribuyente
- Actividades económicas
- API MiSII - Contribuyentes
- Datos del Contribuyente
- API MiSII - Representantes (otros al contribuyente)
- Listado de representantes
- API MiSII - Representados (contribuyente a otros)
- Listado de representados
- Representar un contribuyente
- API DTE - Contribuyentes
- Estado de autorización de un contribuyente
- Estado de autorización de un contribuyente (con certificado)
- Listado de contribuyentes autorizados (descarga masiva)
- Datos privados del contribuyente
- Actualizar datos privados del contribuyente
- Listado de usuarios autorizados de un contribuyente
- Asignar Usuarios Autorizados a un Contribuyente
- API BHE - Boletas de Honorarios Emitidas
- Listado de boletas de honorarios emitidas
- Emitir boleta de honorarios
- Obtener PDF de boleta de honorarios emitida
- Enviar email de boleta de honorarios emitida
- Anular boleta de honorarios emitida
- API BHE - Boletas de Honorarios Recibidas
- Listado de boletas de honorarios recibidas
- Obtener PDF de boleta de honorarios recibida
- Observar boleta de honorarios
- API BHE - Autenticidad de Boletas de Honorarios
- Verificar autenticidad de BHE
- API BTE - Boletas de Terceros Emitidas
- Resumen mensual y anual de boletas de terceros emitidas
- Listado de boletas de terceros emitidas
- Emitir boleta de terceros
- Descargar HTML boleta de terceros
- Anular boleta de tercera parte emitida
- Obtener detalle de documento de la boleta de terceros
- Obtener la tasa del receptor de una BTE
- API BTE - Boletas de Terceros Recibidas
- Listado de boletas de terceros recibidas
- Descargar HTML boleta de terceros recibida
- API DTE - Código de Asignación de Folios (CAF)
- Cantidad de Folios Disponibles
- Solicitar Folios
- Obtener XML de CAF
- Estado de Folio
- Anulación de Folios
- Listado de Solicitudes de CAF
- Estados de Folios
- API DTE - Documentos Emitidos
- Obtener Estado de Envío de un XML al SII
- Verificar un Documento Emitido
- API DTE - Información Electrónica de Compras y Ventas
- Obtener Código de Reemplazo de Libro IECV
- API RCV - Registro de Compras
- Resumen de Compras
- Detalle de Compras
- Asignación Tipo de Transacción de una Compra
- Paso 1: Solicitar descarga de compras
- Paso 2: Obtener estado de descarga de compras
- Paso 3: Obtener detalle de descarga de compras
- API RCV - Registro de Ventas
- Resumen de Ventas
- Detalle de Ventas
- Asignación de Resumen de Ventas por Documento
- Paso 1: Solicitar descarga de ventas
- Paso 2: Obtener estado de descarga de ventas
- Paso 3: Obtener detalle de descarga de ventas
- API RTC - Cesiones
- Obtener certificado de cesión electrónica
- Estado de envío de cesión electrónica
- Estado de cesión de DTE
- Listado de documentos de cesión electrónica
- API Vehículos
- Buscar tasación vehicular
- Tipos de vehículos según categoría
- Marcas de vehículos según categoría
- Características de vehículos según categoría
- API Bienes Raíces
- Comunas de los bienes raices
- Comuna del bienes raices
- Propiedades por Rol del bien raíz
- Propiedades del Contribuyente
- Obtener datos del certificado de avalúo fiscal simple
- Obtener datos del certificado de avaluo fiscal previo
- Obtener datos del certificado de antecedentes
- Obtener PDF de certificado de avalúo fiscal simple
- Obtener PDF de certificado de avalúo fiscal previo
- Obtener PDF de certificado de antecedentes
- API Software MIPYME SII - Contribuyentes
- Información Pública de un Contribuyente
- API Software MIPYME SII - Documentos Borradores
- Listado de Documentos Borradores
- Emitir Documento Borrador
- Descargar PDF de un Documento Borrador
- Eliminar Documento Borrador
- API Software MIPYME SII - Documentos Emitidos
- Listado de DTEs Emitidos
- Descargar PDF de un DTE Emitido
- Descargar XML de un DTE Emitido
- API Software MIPYME SII - Documentos Recibidos
- Listado de Documentos Recibidos
- Descargar PDF de un Documento Recibido
- Descargar XML de un Documento Recibido
- API Software SII - Formulario 29
- Obtener Estados del Formulario 29
- Consultar Detalles de Declaración del Formulario 29
- Consultar Listado de Declaraciones por Período del Formulario 29
- Descargar PDF Certificado Solemne del Formulario 29
- Descargar PDF Formulario Compacto del Formulario 29
- API eBoleta - Sistema de emisión de Boletas Electrónicas SII
- Obtener información del emisor
- Obtener lista de emisores autorizados
- Listado de documentos emitidos
- Emitir documento
- Obtener detalle de documento de la boleta electrónica
- Obtener PDF
- Enviar documento por email
- API Previred - Indicadores Previsionales
- Obtener listado de URLs del PDF de los indicadores
- Obtener PDF de un indicador
- Obtener datos de un indicador
- API Backoffice - Billing
- Calcular el precio de los créditos
### API SII
Recursos para obtener indicadores económicos y tributarios del SII:
- **UF (Unidad de Fomento)**: valores históricos y actuales (anual, mensual, diario)
- **Corrección Monetaria**: factores de corrección anuales
- **Impuesto Segunda Categoría**: tablas de impuestos a las rentas del trabajo
#### GET /api/v2/sii/indicadores/uf/anual/{anio}
Unidad de Fomento anual
Obtiene el valor de la Unidad de Fomento (UF) para un año específico.
**Nota:** Los datos están disponibles desde el año 2013 en adelante.
**La respuesta incluye** el año consultado, con los valores de la UF agrupados por mes y, dentro de cada mes, por día.
Parameters:
- `anio` (path, string, required) — Año que se desea consultar
Responses:
- `200` — Valor de la UF
#### GET /api/v2/sii/indicadores/uf/mensual/{mensual}
Unidad de Fomento mensual
Obtiene el valor de la Unidad de Fomento (UF) para un mes específico.
**Nota:** Los datos están disponibles desde el año 2013 en adelante.
**La respuesta incluye** el período consultado, con los valores de la UF de cada día del mes.
Parameters:
- `mensual` (path, string, required) — Año y mes que se desea consultar (YYYYMM)
Responses:
- `200` — Valores de la UF
#### GET /api/v2/sii/indicadores/uf/diario/{diario}
Unidad de Fomento diario
Obtiene el valor de la Unidad de Fomento (UF) para un día específico.
**Nota:** Los datos están disponibles desde el año 2013 en adelante.
**La respuesta incluye** la fecha consultada con el valor de la UF de ese día.
Parameters:
- `diario` (path, string, required) —
Año, mes y día que se desea consultar (YYYYMMDD)
o (YYYY-MM-DD)
Responses:
- `200` — Valores de la UF
#### GET /api/v2/sii/indicadores/correccion_monetaria/anual/{anio}
Corrección monetaria
Este recurso entrega los datos de manera anual. Se debe considerar que
en el resultado se obtendrá para cada año consultado una lista con los
valores de la corrección monetaria. Dicha lista tendrá 12 elementos,
donde:
- Elemento de índice `0`: es la corrección mensual del "capital
inicial".
- Elementos de índices `1` al `11`: es la corrección mensual de los
meses de enero a noviembre, siendo enero el índice `1` y noviembre el
índice `11`.
En diciembre no existe corrección monetaria mensual (pues estamos en el
mes final).
Cada elemento de la lista será un diccionario con índices del `1` al
`12`, enero a diciembre respectivamente.
**Nota:** Los datos están disponibles desde el año 2013 en adelante.
**La respuesta incluye:**
- El año consultado, con su listado de 12 elementos de corrección monetaria.
- Cada elemento del listado con los factores de corrección de enero a diciembre, indexados del `1` al `12`.
Parameters:
- `anio` (path, string, required) — Año que se desea consultar el valor de la corrección monetaria
Responses:
- `200` — Corrección monetaria anual
#### GET /api/v2/sii/indicadores/impuesto_segunda_categoria/anual/{anio}
Impuesto de segunda categoría anual
Obtiene los tramos anuales del impuesto de segunda categoría.
**Nota:** Los datos están disponibles desde el año 2013 en adelante.
**La respuesta incluye** el año consultado con su listado de tramos, donde cada tramo tiene:
- Renta desde y renta hasta del tramo.
- Tasa del tramo.
- Rebaja del tramo.
- Monto máximo del tramo, o `null` si no aplica.
Parameters:
- `anio` (path, string, required) — Año que se desea consultar
Responses:
- `200` — Impuesto de segunda categoría anual
#### GET /api/v2/sii/indicadores/impuesto_segunda_categoria/mensual/{mensual}
Impuesto de segunda categoría mensual
Obtiene los tramos mensuales del impuesto de segunda categoría.
**Nota:** Los datos están disponibles desde el año 2013 en adelante.
**La respuesta incluye** el período consultado con su listado de tramos, donde cada tramo tiene:
- Renta desde y renta hasta del tramo.
- Tasa del tramo.
- Rebaja del tramo.
- Monto máximo del tramo, o `null` si no aplica.
Parameters:
- `mensual` (path, string, required) — Año y mes que se desea consultar (YYYYMM)
Responses:
- `200` — Impuesto de segunda categoría mensual
### API Contribuyentes - Consultas públicas
Recursos de consulta pública del SII que no requieren autenticación:
- **Verificación de RUT**: validación de cédula de identidad con número de serie
- **Situación Tributaria**: información pública de contribuyentes
- **Actividades Económicas**: listado completo de códigos de actividades económicas
#### GET /api/v2/sii/contribuyentes/rut/verificar/{rut}/{serie}
Verificación de cédula RUT
Recurso para verificar la validez de la cédula RUT de empresas chilenas.
Este es un recurso público que no requiere autenticación.
**La respuesta incluye:**
- RUT del contribuyente.
- Nombre o razón social.
- Dirección principal de la casa matriz.
- Número de serie de la cédula RUT.
- Fecha de emisión de la cédula RUT.
- RUT del usuario de la cédula.
- Nombre del usuario de la cédula.
- Tipo de documento.
Parameters:
- `rut` (path, string, required) — RUT del contribuyente
- `serie` (path, string, required) — Serie de la cédula de RUT que se desea validar
Responses:
- `200` — Verificación de cédula RUT
#### GET /api/v2/sii/contribuyentes/situacion_tributaria/tercero/{rut}
Situación tributaria de un contribuyente
Permite obtener la situación tributaria de un contribuyente.
Este método no necesita autenticación en el SII, esto permite que sea un método `GET`.
**Tiempo de respuesta del servicio web**: 20 segundos.
**La respuesta incluye:**
- RUT.
- Razón social.
- Si tiene o no inicio de actividades.
- Fecha inicio de actividades.
- Si tiene autorización para declarar impuestos en moneda extranjera.
- Si es contribuyente PRO-PYME.
- El listado de actividades económicas vigentes.
- Los documentos que ha timbrado y el año del último timbraje.
- La fecha desde cuando está obligado a emitir sus documentos de manera electrónica.
- Si tiene períodos donde haya estado exento de emitir DTE y el motivo.
- Observaciones (como inconcurrencia a llamados del SII o posible suplantación de identidad).
Las observaciones específicas que se están considerando son:
- `inconcurrente` Contribuyente Inconcurrente
- `suplantado` Contribuyente en riesgo de ser suplantado
- `no_ubicado` Contribuyente no ubicado
- `termino_giro` Presentación en trámite término de giro
- `domicilio_inexistente` Domicilio Inexistente
- `actividad_esporadica` Contribuyente tasado para realizar actividad esporádica
- `no_habido_domicilio` Contribuyente no es habido en el domicilio declarado al SII
- `termino_giro_obligatorio` Contribuyente obligado a dar aviso de Término de Giro
Parameters:
- `rut` (path, string, required) — RUT del contribuyente
Responses:
- `200` — Situación tributaria del contribuyente
#### GET /api/v2/sii/contribuyentes/actividades_economicas
Actividades económicas
Recurso para obtener el listado de actividades económicas de los contribuyentes.
Este es un recurso público que no requiere autenticación.
**La respuesta incluye** un objeto agrupado por sector económico y, dentro de cada sector, por rubro. Cada actividad económica del rubro incluye:
- Código de la actividad económica.
- Glosa de la actividad económica.
- Si la actividad está afecta a IVA.
- Categoría tributaria de la actividad.
- Si la actividad permite el inicio de actividades por internet.
Parameters:
- `categoria` (query, integer) — Categoría de actividad económica (opcional)
Responses:
- `200` — Listado de actividades económicas
### API MiSII - Contribuyentes
Recursos para obtener información del contribuyente autenticado en MiSII:
- Datos personales y tributarios del contribuyente
#### POST /api/v2/sii/misii/contribuyente/datos
Datos del Contribuyente
Recurso para obtener los datos del contribuyente autenticado en la página MiSii.
**La respuesta incluye:**
- **Datos del contribuyente**
- RUT, nombres y apellidos o razón social.
- Tipo y subtipo de contribuyente, segmento y país.
- Sexo, número de pasaporte, correo electrónico y teléfono móvil.
- Fechas de nacimiento, defunción y constitución.
- Fechas de inicio de actividades y de término de giro.
- Si está autorizado a declarar el día 20.
- Unidad operativa: código, descripción y dirección.
- Capital enterado y capital por enterar.
- Glosa de la actividad económica.
- Fechas de creación y modificación del registro.
- **Direcciones del contribuyente**
- Tipo de domicilio, calle, número, bloque y departamento.
- Villa o población, ciudad, comuna y región.
- Código postal y casilla.
- Teléfono, fax y correo.
- Tipo de propiedad, RUT del propietario y canon.
- Fecha de modificación del registro.
- **Atributos del contribuyente**
- Código, descripción y valor del atributo.
- Fechas de inicio, término y creación.
- Usuarios de activación y desactivación, y si está eliminado.
- **Actividades económicas del contribuyente**
- Código y descripción de la actividad.
- Categoría tributaria y si está afecta a IVA.
- Fecha de inicio.
- **Alertas del contribuyente**
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Datos del Contribuyente
### API MiSII - Representantes (otros al contribuyente)
Recursos para gestionar representantes del contribuyente autenticado:
- Listado de personas que pueden representar al contribuyente
- Permisos y autorizaciones de representación
#### POST /api/v2/sii/misii/representantes/listado
Listado de representantes
Recurso para obtener el listado de representantes del contribuyente.
Además se obtiene el listado de posibles permisos que se pueden asignar.
**La respuesta incluye:**
- Datos del representado: RUT, dígito verificador y nombre.
- Listado de representantes, cada uno con su RUT, dígito verificador y nombre.
- Listado de permisos que se pueden asignar, cada uno con su código, descripción y nivel.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de representantes
### API MiSII - Representados (contribuyente a otros)
Recursos para gestionar contribuyentes que el usuario autenticado puede representar:
- Listado de contribuyentes representados
- Asignación de nuevas representaciones
- Gestión de permisos de representación
#### POST /api/v2/sii/misii/representados/listado
Listado de representados
Recurso para obtener el listado de representados del contribuyente autenticado en la página MiSii.
**La respuesta incluye:**
- Datos del representante: RUT, dígito verificador y nombre.
- Listado de representados, cada uno con su RUT, dígito verificador y nombre.
- Listado de permisos, cada uno con su código, descripción y nivel.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de representados
#### POST /api/v2/sii/misii/representados/representar/{rut}/{permisos}
Representar un contribuyente
Recurso para asignar un contribuyente que se desea representar en la siguientes llamadas a la API.
El parámetro de ruta `permisos` recibe los códigos de aplicación (campo **APPL** en MiSII) separados por coma. Referencia de códigos:
| Código | Aplicación |
|--------|------------|
| `MISII` | Acceso a MiSII |
| `FIS10` | Acceso a opciones de Usuarios Relacionados de BBRR |
| `AGRES` | Agentes Responsables |
| `BR001` | Bienes Raices |
| `CTYE` | Certificado de Timbres y Estampillas |
| `MUN01` | Consulta Instituciones |
| `SEREL` | Consulta Proveedores Camp. Politicas |
| `RPETC` | Consulta Registro Transferencia Credito |
| `BRCPI` | Consulta de Bienes Raices Registrados en el SII |
| `CIT` | Consulta de Interpretacion Tributaria |
| `SCG01` | Consulta de Pagos a Proveedores |
| `FIS02` | Decl. Municipal Recepciones Definitivas y/o Regularizaciones |
| `BR002` | Declaracion Jurada (F2803) |
| `DJPF1` | Declaracion Jurada de Predios Forestales |
| `DMSNE` | Declaracion Municipal SNE |
| `FIS01` | Declaracion Permisos de Obra Menor y/o Edificacion Municipal |
| `Decl.Juradas` | Declaraciones Juradas |
| `DJRen` | Declaraciones Juradas de Renta |
| `SIFM1` | Declarar usando el Sistema Integral de Formularios |
| `BRDGS` | Detalle Giro Sobretasa art 7 bis |
| `SIAG1` | Presentación RAV/RAF y Recurso Jerárquico (RJ) |
| `BRVEH` | Registro de informacion de vehiculos para Tasacion Fiscal |
| `REN01` | Renta Nivel 1 |
| `INTRP` | Servicios de Interoperabilidad de Cartografia |
| `SAR01` | Sistema Ampliado de Recepcion |
| `AVASE` | Sistema de Aseo Comunal |
| `SCTI` | Sistema de Consulta Tributaria Integrada |
| `SDV01` | Sistema de Descuentos Voluntarios |
| `SEE` | Sistema de Expediente Electronico |
| `MSR01` | Socios Representantes |
| `BROTI` | Solicitudes de Bienes Raices (OT) |
| `TDI01` | Timbraje de Documento Internet |
| `GAE01` | Upload de Archivos por Organismos Externos |
Ejemplos de `permisos`: `RPETC`, `SIFM1` o `MISII` (varios separados por coma, p. ej. `RPETC,MISII`).
**La respuesta incluye** los datos del contribuyente representado: RUT, dígito verificador y nombre.
Parameters:
- `permisos` (path, string, required) — Códigos APPL (aplicaciones MiSII) separados por coma. Ver tabla de referencia en la descripción de la operación.
- `rut` (path, string, required) — RUT del contribuyente que se desea representar en las siguientes llamadas a la API.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Representación de contribuyente
### API DTE - Contribuyentes
Recursos para gestionar contribuyentes autorizados para emitir documentos electrónicos:
- Verificación de autorización DTE
- Listado de contribuyentes autorizados
#### GET /api/v2/sii/dte/contribuyentes/autorizado/{rut}
Estado de autorización de un contribuyente
Este servicio entrega el estado de autorización de un contribuyente
para usar Documentos Tributarios Electrónicos (DTE).
**Se indicará**
- Si está o no autorizado.
- La fecha y número de resolución que lo autoriza.
- La dirección regional a la que pertenece el contribuyente.
- Si usa el Software del SII Portal MIPYME o Software de Mercado para facturar.
**La respuesta incluye:**
- RUT y razón social del contribuyente.
- Si está o no autorizado a emitir DTE.
- **Resolución** que lo autoriza, con su número y fecha.
- Dirección regional a la que pertenece el contribuyente.
- Software que usa para facturar: Portal MIPYME del SII o software de mercado.
- **Documentos autorizados**, cada uno con su código, descripción, fecha de autorización y fecha de desautorización.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `formato` (query, string) — `json` `html`
- `rut` (path, string, required) — RUT del contribuyente que se desea consultar
Responses:
- `200` — Estado de autorización de un contribuyente
#### POST /api/v2/sii/dte/contribuyentes/autorizado/{rut}
Estado de autorización de un contribuyente (con certificado)
Este servicio entrega el estado de autorización de un contribuyente
para usar Documentos Tributarios Electrónicos (DTE).
**Se indicará**
- Si está o no autorizado.
- La fecha y número de resolución que lo autoriza.
- La dirección regional a la que pertenece el contribuyente.
- Si usa el Software del SII Portal MIPYME o Software de Mercado para facturar.
**Además, se entregará un listado de los documentos que el contribuyente tiene autorizados a llevar de manera electrónica y desde qué fecha cuenta con la autorización del SII para hacerlo.**
Esta consulta, a diferencia de la que es por `GET`, requiere un
certificado digital para poder obtener el correo electrónico de
intercambio del contribuyente. Este dato extra es la única
diferencia entre esta llamada y la que se hace vía `GET`.
La respuesta se entrega sólo en formato `json`.
**La respuesta incluye:**
- RUT y razón social del contribuyente.
- Si está o no autorizado a emitir DTE.
- **Resolución** que lo autoriza, con su número y fecha.
- Dirección regional a la que pertenece el contribuyente.
- Software que usa para facturar: Portal MIPYME del SII o software de mercado.
- Correo electrónico de intercambio del contribuyente.
- **Documentos autorizados**, cada uno con su código, descripción, fecha de autorización y fecha de desautorización.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `rut` (path, string, required) — RUT del contribuyente que se desea consultar
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de autorización de un contribuyente
#### POST /api/v2/sii/dte/contribuyentes/autorizados
Listado de contribuyentes autorizados (descarga masiva)
**⚠️ Descarga masiva:** este recurso descarga la base de datos completa
del SII, cercana a un millón de registros. La respuesta pesa cientos de
megabytes y puede tardar hasta 15 minutos. No es un recurso para
consultas puntuales: para revisar un contribuyente específico use el
recurso de estado de autorización por RUT.
Antes de llamarlo, considere:
- Usar un timeout de al menos 15 minutos en el cliente.
- Usar el formato `csv_sii`, que es más rápido y liviano que `json`.
- Guardar el resultado localmente en vez de repetir la descarga.
Permite descargar la base de datos de contribuyentes autorizados por el
SII a operar con documentos tributarios electrónicos.
Se incluyen los siguientes datos:
- RUT.
- Razón social.
- Número de resolución que autoriza la emisión de DTE.
- Fecha de resolución que autoriza la emisión de DTE.
- Página web declarada en SII del sofware que se usa.
**Tiempo de respuesta del servicio web**
Este servicio requiere bastante tiempo (Puede tardar hasta 15 minutos)
para entregar la respuesta,
puesto que los registros entregados son cercanos al millón. Descargar
los datos en formato `csv_sii`, en la mayoría de los casos, debiese ser
más rápido que usar `json`.
**Datos con problemas en formato** **`json`**
Adicionalmente usar el formato `csv_sii` entregará los datos oficiales
del SII sin ser manipulados para darles formato `json`. API
Gateway evita manipular los datos del SII, por eso de ser necesario, te
recomendamos bajar el formato oficial del SII y procesar dicho archivo
en tu sistema
**La respuesta incluye** un listado donde cada contribuyente tiene:
- RUT y razón social.
- Dirección regional a la que pertenece.
- Software que usa para facturar.
Si se usa el formato `csv_sii`, la respuesta es el archivo CSV oficial del SII en vez de un objeto JSON.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dia` (query, string) — Fecha en formato YYYYMMDD o YYYY-MM-DD
- `formato` (query, string) —
`json` versión JSON de los datos que vienen en el archivo CSV descargado del SII
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Listado de contribuyentes autorizados
#### POST /api/v2/sii/dte/contribuyentes/datos/{contribuyente}
Datos privados del contribuyente
Permite obtener los datos privados del contribuyente autenticado.
**Se indicará**
- El RUT del contribuyente.
- La razón social del contribuyente.
- La fecha de autorización del contribuyente.
- La dirección regional a la que pertenece el contribuyente.
- El correo electrónico de intercambio del contribuyente.
- Si usa el Software del SII Portal MIPYME o Software de Mercado para facturar.
**La respuesta incluye:**
- RUT y razón social del contribuyente.
- Fecha de autorización.
- **Resolución** que autoriza la emisión de DTE, con su número y fecha.
- **Correos electrónicos** del administrador, del SII y de intercambio.
- **Software** utilizado para facturar, con su nombre y su URL.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `contribuyente` (path, string, required) — RUT del contribuyente
- `formato` (query, string) — `json`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Datos del contribuyente
#### POST /api/v2/sii/dte/contribuyentes/set_datos/{contribuyente}
Actualizar datos privados del contribuyente
Permite actualizar los datos privados del contribuyente.
**La respuesta incluye:**
- RUT y razón social del contribuyente.
- Fecha de autorización.
- **Resolución** que autoriza la emisión de DTE, con su número y fecha.
- **Correos electrónicos** del administrador, del SII y de intercambio.
- **Software** utilizado para facturar, con su nombre y su URL.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `contribuyente` (path, string, required) — RUT del contribuyente que se desea actualizar
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"datos": {
"emails": {
"administrador": "actualizado@example.com",
"intercambio": "actualizado@example.com",
"sii": "actualizado@example.com"
},
"software": {
"nombre": "LibreDTE",
"url": "libredte.cl"
}
}
}
```
Responses:
- `200` — Datos del contribuyente actualizados
#### POST /api/v2/sii/dte/contribuyentes/usuarios/{rut}
Listado de usuarios autorizados de un contribuyente
Permite consultar los usuarios autorizados de un contribuyente.
**La respuesta incluye** un listado donde cada usuario tiene:
- RUN y nombre del usuario.
- **Permisos** del usuario: administrador, solicitar folios, anular folios, firmar, enviar y consultar.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `rut` (path, string, required) — RUT del contribuyente que se desea consultar sus usuarios autorizados
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Listado de usuarios autorizados a un contribuyente
#### POST /api/v2/sii/dte/contribuyentes/set_usuario/{contribuyente}
Asignar Usuarios Autorizados a un Contribuyente
Permite asignar usuarios autorizados a un contribuyente.
**La respuesta incluye** el usuario asignado:
- RUT y nombre del usuario.
- **Permisos** del usuario: administrador, solicitar folios, anular folios, firmar, enviar y consultar.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `contribuyente` (path, string, required) — RUT del contribuyente que se desea actualizar
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"usuario": {
"permisos": {
"administrador": false,
"anular_folios": true,
"consultar": true,
"enviar": true,
"firmar": true,
"solicitar_folios": true
},
"run": "66666666-6"
}
}
```
Responses:
- `200` — Usuario del contribuyente actualizado
### API BHE - Boletas de Honorarios Emitidas
Recursos para gestionar Boletas de Honorarios Electrónicas emitidas (servicios de 2da categoría):
- Listado de boletas emitidas por período
- Emisión de nuevas boletas
- Descarga de PDF
- Envío por email
- Anulación de boletas
#### POST /api/v2/sii/bhe/emitidas/documentos/{emisor}/{periodo}
Listado de boletas de honorarios emitidas
La consulta de BHE debe ser realizada con el RUT y clave tributaria del
emisor de las boletas.
**Paginación**
La paginación se realiza mediante el parámetro `pagina`.
El valor debe ser el número de la página a obtener.
Si es la primera consulta, debe ser 1. Para las siguientes páginas, debe ser el número de la página.
**¿Se pueden consultar por día?**
Si, es posible consultar las boletas de manera diaria. Por ejemplo
20220316 consultará por el día 16 de marzo del año 2022.
**¿Qué significa el valor del campo "estado"?**
- **N:** Vigente.
- **S**: Anulada.
- **V**: Vigente con solicitud de anulacion pendiente.
- **R**: Observada por el Receptor.
- **U**: Observada en la Unidad del SII.
Otros valores de estado no están definidos por SII.
**La respuesta incluye:**
- Cantidad de páginas y cantidad total de boletas.
- **Listado de boletas**, cada una con:
- Número de la boleta y su código.
- RUT, dígito verificador y nombre del receptor.
- Fecha de la boleta y fecha de emisión.
- Total de honorarios, retención del emisor, retención del receptor y total líquido.
- Si corresponde a una sociedad profesional.
- Estado de la boleta y fecha de anulación, si está anulada.
- Usuario emisor y correo al que se envió.
Parameters:
- `emisor` (path, string, required)
- `pagina` (query, integer, required) — Si es la primera consulta, debe ser 1. Para las siguientes páginas, debe ser el número de la página.
- `periodo` (path, string, required) — Periodo (YYYYMM)
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de boletas de honorarios emitidas
#### POST /api/v2/sii/bhe/emitidas/emitir
Emitir boleta de honorarios
[https://loa.sii.cl/cgi_IMT/TMBEUS_ValidaAutoriz.cgi?modo=1](https://loa.sii.cl/cgi_IMT/TMBEUS_ValidaAutoriz.cgi?modo=1) (emisor autorizado).
El campo `TipoRetencion` puede tener los siguientes valores:
- `0` sin retención. Para sociedades de profesionales que tributan en 1era categoría.
- `1` la retención la hace el receptor de la boleta.
- `2` la retención la hace el contribuyente emisor de la boleta.
Adicionalmente, este recurso permite emitir BHE directamente con las credenciales del emisor o bien con las de un usuario autorizado. En este último caso el RUT del emisor será diferente al RUT usado para autenticar en el SII al
usuario.
La API permite emitir una boleta sin datos del receptor. Para esto se debe omitir el campo `Receptor` en el JSON o bien enviar `RUTRecep` con valor `0-0`.
Si se indica `RUTRecep`, y el RUT indicado existe en el SII, la boleta será siempre generada con los datos que el SII tenga (datos oficiales). Y, en dicho caso, los datos enviados en el JSON serán omitidos.
**Datos del emisor**
Actualmente se obtiene la dirección automáticamente del SII, pero siempre la primera dirección (casa matriz).
Para asignar la dirección, y otros datos, en el TAG Emisor hay que enviar estos campos:
- `GiroEmis`
- `Telefono`
- `CodigoDirOrigen`
- `DirOrigen`
- `CmnaOrigen`
Los campos deben tener los valores que usa SII en la web.
**La respuesta incluye** la boleta emitida:
- **Encabezado**
- Emisor: RUT, razón social, giro, dirección, código de dirección y comuna de origen.
- Identificación del documento: folio, tipo de DTE, fecha de emisión, tipo de retención, código de barras y código inferior.
- Receptor: RUT, razón social, dirección, comuna y sus códigos de comuna y región.
- **Detalle**, con el nombre y el monto de cada ítem.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"boleta": {
"Encabezado": {
"IdDoc": {
"FchEmis": "2024-10-16",
"TipoRetencion": 2
},
"Emisor": {
"RUTEmisor": "12345678-9"
},
"Receptor": {
"RUTRecep": "0-0",
"RznSocRecep": "Nombre Cliente",
"DirRecep": "Dirección",
"CmnaRecep": "Región"
}
},
"Detalle": [
{
"NmbItem": "Prueba integracion API Gateway 1",
"MontoItem": 50
},
{
"NmbItem": "Prueba integracion API Gateway 2",
"MontoItem": 100
}
]
}
}
```
Responses:
- `200` — Boleta de honorarios emitida correctamente
#### POST /api/v2/sii/bhe/emitidas/pdf/{codigo}
Obtener PDF de boleta de honorarios emitida
Este recurso permite obtener el PDF de una boleta de honorarios.
Se utiliza el código de la boleta asignado por SII para obtener el PDF.
Un listado de código se encuentra en el servicio que permite obtener el
listado de boletas.
**La respuesta no es un objeto JSON**, es el archivo PDF de la boleta de honorarios.
Parameters:
- `codigo` (path, string, required) — Código de la boleta de honorarios
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — PDF de boleta de honorarios emitida
#### POST /api/v2/sii/bhe/emitidas/email/{codigo}
Enviar email de boleta de honorarios emitida
Este recurso permite enviar por email la boleta de honorarios
electrónica.
La principal ventaja que tiene enviar por esta vía en vez del software
propio, es que se envía directo desde los sistemas del SII. Y ellos
adjuntan el mensaje estándar, el PDF y el XML de la boleta.
Se utiliza el código de la boleta asignado por SII para obtener enviar
el correo.
El correo del destinatario es opcional. Si se omite se usará el correo
que el SIi tenga registrado por defecto para el contribuyente receptor
de la boleta.
**La respuesta incluye:**
- Mensaje de confirmación del envío.
- Correo electrónico al que se envió la boleta.
Parameters:
- `codigo` (path, string, required) — Código de la boleta de honorarios
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"destinatario": {
"email": "email@destino.com"
}
}
```
Responses:
- `200` — Enviar boleta de honorarios por email
#### POST /api/v2/sii/bhe/emitidas/anular/{emisor}/{folio}
Anular boleta de honorarios emitida
Permite anular una boleta de honorarios electrónica previamente emitida.
**La respuesta incluye:**
- Resultado de la anulación en el campo `boleta_anulada`, que puede tener 2 valores: `S` indica que la boleta estaba vigente y fue anulada; `A` indica que la boleta ya se encontraba anulada previamente.
- Número de la boleta anulada.
- RUT y dígito verificador del contribuyente autenticado, y su nombre.
- RUT y dígito verificador del receptor, y su nombre.
- Fecha de la transacción en el SII.
- Monto máximo de anulación.
**Importante: No es posible anular una Boleta de Honorarios que fueemitida de forma autorizada.**
Parameters:
- `causa` (query, string, required) —
`1` No se efectuó el pago de los servicios por parte del
receptor
`2` No se efectuó la prestación de servicios
`3`
Error en la digitación
- `emisor` (path, string, required) — RUT del emisor
- `folio` (path, integer, required) — Folio de la boleta
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Anular Boleta de Honorarios Emitida
### API BHE - Boletas de Honorarios Recibidas
Recursos para gestionar Boletas de Honorarios Electrónicas recibidas (servicios de 2da categoría):
- Listado de boletas recibidas por período
- Descarga de PDF
- Observación de boletas recibidas
#### POST /api/v2/sii/bhe/recibidas/documentos/{receptor}/{periodo}
Listado de boletas de honorarios recibidas
La consulta de BHE debe ser realizada con el RUT y clave tributaria del
receptor de las boletas.
**Paginación**
La paginación se realiza mediante el parámetro `pagina`.
El valor debe ser el número de la página a obtener.
Si es la primera consulta, debe ser 1. Para las siguientes páginas, debe ser el número de la página.
**¿Se pueden consultar por día?**
Si, es posible consultar las boletas de manera diaria. Por ejemplo
20220316 consultará por el día 16 de marzo del año 2022.
**¿Por qué no veo la retención del emisor cuando consulto por mes?**
El SII no entrega la retención por día cuando es del emisor. Se podría
asumir con el total de honorarios y el líquido.
**¿Por qué no veo el RUT del emisor cuando consulto por día?**
El SII no entrega el RUT del emisor de la BHE al consultar por día.
**¿Qué significa el valor del campo "estado"?**
- **N:** Vigente.
- **S**: Anulada.
- **V**: Vigente con solicitud de anulacion pendiente.
- **R**: Observada por el Receptor.
- **U**: Observada en la Unidad del SII.
Otros valores de estado no están definidos por SII.
**La respuesta incluye:**
- Cantidad de páginas y cantidad total de boletas.
- **Listado de boletas**, cada una con:
- Número de la boleta y su código.
- RUT, dígito verificador y nombre del emisor.
- Comuna del emisor.
- Fecha de la boleta.
- Total de honorarios, total de retención y total líquido.
- Si corresponde a una sociedad profesional.
- Estado de la boleta y fecha de anulación, si está anulada.
Parameters:
- `pagina` (query, integer, required) — Si es la primera consulta, debe ser 1. Para las siguientes páginas, debe ser el número de la página.
- `periodo` (path, string, required) — Periodo mensual (YYYYMM) o diario (YYYYMMDD)
- `receptor` (path, string, required) — RUT del receptor de las boletas
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de boletas de honorarios recibidas
#### POST /api/v2/sii/bhe/recibidas/pdf/{codigo}
Obtener PDF de boleta de honorarios recibida
Este recurso permite obtener el PDF de una boleta de honorarios.
Se utiliza el código de la boleta asignado por SII para obtener el PDF.
Un listado de código se encuentra en el servicio que permite obtener el listado de boletas.
**La respuesta no es un objeto JSON**, es el archivo PDF de la boleta de honorarios.
Parameters:
- `codigo` (path, string, required) — Código de la boleta
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — PDF de boleta de honorarios recibida
#### POST /api/v2/sii/bhe/recibidas/observar/{emisor}/{folio}
Observar boleta de honorarios
Permite observar una boleta de honorarios electrónica previamente recibida.
**La respuesta incluye:**
- Número de la transacción registrada en el SII.
- RUT, dígito verificador y nombre del contribuyente.
- Fecha de la transacción en el SII.
Parameters:
- `causa` (query, integer, required) —
`1` No se reconoce la relación contractual o comercial con el emisor
`2` No se reconoce al emisor de la BHE
- `emisor` (path, string, required) — RUT del emisor de la boleta
- `folio` (path, integer, required) — Folio de la boleta
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Boleta de honorarios observada correctamente
### API BHE - Autenticidad de Boletas de Honorarios
Recursos alineados a la consulta de boletas por terceros del SII: terceras personas
pueden verificar la autenticidad de boletas de honorarios electrónicas.
- Verificación por código de barras
- Verificación por emisor, receptor, período y folio
#### POST /api/v2/sii/bhe/consultas_por_terceros
Verificar autenticidad de BHE
**Autenticidad de Boletas de Honorarios**
Corresponde a la funcionalidad con la que **terceras personas** pueden
**verificar la autenticidad** de boletas de honorarios electrónicas emitidas
mediante la aplicación que dispone el SII. La respuesta es el **PDF oficial**
de la boleta, útil para comprobar que el documento existe y coincide con los
datos consultados.
Requiere autenticación en el SII.
Parámetros de consulta (modos **excluyentes**):
- **`codigo_barras`**: enviar solo este campo.
- **`emisor`**, **`receptor`**, **`periodo`** (YYYY-MM-DD), **`folio`**: todos
obligatorios si no se usa código de barras.
**La respuesta no es un objeto JSON**, es el archivo PDF oficial de la boleta de honorarios emitido por el SII.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"codigo_barras": "12345678901234567890123456789012"
}
```
Responses:
- `200` — PDF de la boleta de honorarios
### API BTE - Boletas de Terceros Emitidas
Recursos para gestionar Boletas de Terceros Electrónicas emitidas (servicios de 2da categoría):
- Resumen anual de emisión
- Listado de boletas emitidas por período
- Emisión de nuevas boletas
- Consulta de documento específico
- Visualización en HTML
- Consulta de tasa por receptor
- Anulación de boletas
#### POST /api/v2/sii/bte/emitidas/resumen/{emisor}/{anio}
Resumen mensual y anual de boletas de terceros emitidas
Obtiene el resumen anual de las boletas emitidas.
**La respuesta incluye:**
- **Resumen anual**
- Cantidad de boletas vigentes y anuladas.
- Folio inicial y folio final utilizados.
- Monto bruto, retención y total.
- **Resumen mensual**, un elemento por mes, cada uno con:
- Código y glosa del mes.
- Cantidad de boletas vigentes y anuladas.
- Folio inicial y folio final utilizados.
- Monto bruto, retención y total.
Parameters:
- `anio` (path, string, required) — Año que se desea obtener el resumen
- `emisor` (path, string, required) — Emisor de la BTE
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Resumen mensual y anual de boletas de terceros emitidas
#### POST /api/v2/sii/bte/emitidas/documentos/{emisor}/{periodo}
Listado de boletas de terceros emitidas
La consulta de BTE debe ser realizada con el RUT y clave tributaria del
emisor de las boletas.
**¿Tienes muchas boletas emitidas?**
Si tienes más de 100 BTE emitidas en un período, deberás bajar los
listados de boletas de manera paginada.
Para esto indica en tu primera llamada el parámetro `pagina=1` en la
URL. Esta llamada te entregará:
- La cantidad de boletas disponibles en el período en `n_boletas`.
- La cantidad de páginas disponibles en `n_paginas`.
- El listado de boletas en `boletas`.
Para obtener las siguientes páginas (desde la 2) deberás indicar el
parámetro `pagina`. Esto permitirá ir obteniendo de manera paginada las boletas.
**¿Se pueden consultar por día?**
Si, es posible consultar las boletas de manera diaria. Por ejemplo
20220316 consultará por el día 16 de marzo del año 2022.
**¿Qué significa el valor del campo "estado"?**
- **ANUL:** Anulada.
- **VIG:** Vigente.
Otros valores de estado no están definidos por SII.
**La respuesta incluye:**
- **Listado de boletas**, cada una con:
- Número de la boleta y su código.
- Fecha de la boleta y fecha de emisión.
- RUT y nombre del emisor.
- RUT y nombre del receptor.
- Total de honorarios, total de retención y total líquido.
- Estado de la boleta.
- **Metadata** de la consulta, con la cantidad de boletas y la cantidad de páginas del período.
Parameters:
- `emisor` (path, string, required) — RUT del emisor de las BTE
- `pagina` (query, integer, required) — Si es la primera consulta, debe ser 1. Para las siguientes páginas, debe ser el número de la página.
- `periodo` (path, string, required) — Período de las BTE buscadas (YYYYMM o YYYYMMDD)
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de boletas de terceros emitidas
#### POST /api/v2/sii/bte/emitidas/emitir
Emitir boleta de terceros
Este recurso permite emitir una BTE en el SII.
Se aplica una tasa de retención que varía según el período de emisión de la BTE:
| Período | Retención |
| --- | --- |
| 2020 | 10,75% |
| 2021 | 11,50% |
| 2022 | 12,25% |
| 2023 | 13,00% |
| 2024 | 13,75% |
| 2025 | 14,50% |
| 2026 | 15,25% |
| 2027 | 16,00% |
| 2028 | 17,00% |
Sin embargo, por el [préstamo solidario](https://www.sii.cl/destacados/prestamo_solidario/),
algunos contribuyentes pueden tener una tasa de retención adicional del 3%.
Es importante al emitir una BTE corroborar la tasa de retención.
Si el receptor de la BTE tiene retención adicional del 3%, envía la tasa real
en los datos de la boleta. Esto será meramente informativo y no afectará la
creación de la boleta en el SII (ya que el SII hace los cálculos sin considerar
lo que envíes). Sin embargo, servirá para que en nuestra respuesta se entregue
la retención correcta.
Debes enviar la retención en el encabezado:
{{
'Encabezado': {{
'Totales': {{
'TasaRetencion': 15.25
}}
}}
}}
**La respuesta incluye** la boleta emitida:
- **Encabezado**
- Emisor: RUT, razón social, giro, actividad económica, dirección, comuna y código de sucursal del SII.
- Identificación del documento: folio, fecha de emisión y código de barras.
- Receptor: RUT, razón social, dirección y comuna.
- Totales: monto bruto, tasa de retención, monto de retención y monto neto.
- **Detalle**, con el nombre y el monto de cada ítem.
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
},
"boleta": {
"Encabezado": {
"Emisor": {
"RUTEmisor": "76192083-9"
},
"IdDoc": {
"FchEmis": "2025-01-15"
},
"Receptor": {
"RUTRecep": "12345678-9",
"RznSocRecep": "Contribuyente Receptor",
"DirRecep": "Av. Principal 123",
"CmnaRecep": "Santiago"
}
},
"Detalle": [
{
"MontoItem": 50000,
"NmbItem": "Servicio de consultoría"
},
{
"MontoItem": 100000,
"NmbItem": "Desarrollo de software"
}
]
}
}
```
Responses:
- `200` — Boleta de terceros emitida exitosamente
#### POST /api/v2/sii/bte/emitidas/html/{codigo}
Descargar HTML boleta de terceros
Este recurso permite obtener el HTML de una boleta de terceros.
Se utiliza el código de la boleta asignado por SII para obtener el HTML.
**La respuesta no es un objeto JSON**, es el HTML de la boleta emitido por el SII.
Parameters:
- `codigo` (path, string, required) — Código de la BTE
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — HTML de la boleta de terceros
#### POST /api/v2/sii/bte/emitidas/anular/{emisor}/{folio}
Anular boleta de tercera parte emitida
Permite anular una Boleta de Terceros Electrónica previamente emitida.
**La respuesta incluye** los datos de la boleta anulada:
- Número de la boleta y su código.
- Fecha de la boleta y fecha de emisión.
- RUT y nombre del emisor.
- RUT y nombre del receptor.
- Total de honorarios, total de retención y total líquido.
- Estado de la boleta y fecha de anulación.
Parameters:
- `causa` (query, integer, required) —
Causa de la anulación
`2` No se efectuó la prestación de servicios
`3`
Error en la digitación
- `emisor` (path, string, required) — RUT del emisor
- `folio` (path, integer, required) — Folio de la boleta
- `periodo` (query, string) —
Periodo de la boleta (YYYYMM), usado para acelerar la consulta.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Anular Boleta de Tercera Parte Emitida
#### POST /api/v2/sii/bte/emitidas/documento/{emisor}/{folio}
Obtener detalle de documento de la boleta de terceros
Permite obtener los datos de una Boleta de Tercera Parte Electrónica.
**La respuesta incluye:**
- Número de la boleta y su código.
- Fecha de la boleta y fecha de emisión.
- RUT y nombre del emisor.
- RUT y nombre del receptor.
- Total de honorarios, total de retención y total líquido.
- Estado de la boleta.
Parameters:
- `emisor` (path, string, required) — RUT del emisor
- `folio` (path, integer, required) — Folio de la boleta
- `periodo` (query, string) — Periodo de la boleta (YYYYMM)
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Obtener detalle de documento
#### POST /api/v2/sii/bte/emitidas/receptor_tasa/{emisor}/{receptor}
Obtener la tasa del receptor de una BTE
Permite obtener la tasa real que se debe usar con el receptor de la
Boleta de Terceros Electrónica.
Esto es necesario por la tasa adicional que puede existir en la retención.
Ejemplo: 3% adicional por préstamo del SII.
**La respuesta incluye:**
- Período consultado.
- Tasa base de retención del período.
- Tasa que corresponde aplicar al receptor.
Parameters:
- `emisor` (path, string, required) — Emisor de la BTE
- `periodo` (query, string) — Período de la tasa de retención buscada (AAAAMM)
- `receptor` (path, string, required) — Receptor de la BTE
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Tasa del receptor de la BTE
### API BTE - Boletas de Terceros Recibidas
Recursos para gestionar Boletas de Terceros Electrónicas recibidas (servicios de 2da categoría):
- Listado de boletas recibidas por período
- Visualización en HTML
#### POST /api/v2/sii/bte/recibidas/documentos/{receptor}/{periodo}
Listado de boletas de terceros recibidas
La consulta de BTE debe ser realizada con el RUT y clave tributaria del
receptor de las boletas.
**Paginación**
La paginación se realiza mediante el parámetro `pagina`.
El valor debe ser el número de la página a obtener.
Si es la primera consulta, debe ser 1. Para las siguientes páginas, debe ser el número de la página.
**¿Se pueden consultar por día?**
Si, es posible consultar las boletas de manera diaria. Por ejemplo
20220316 consultará por el día 16 de marzo del año 2022.
**La respuesta incluye:**
- **Listado de boletas**, cada una con:
- Número de la boleta y su código.
- Fecha de la boleta y fecha de emisión.
- RUT y nombre del emisor.
- RUT y nombre del receptor.
- Total de honorarios, total de retención y total líquido.
- Estado de la boleta.
- **Metadata** de la consulta, con la cantidad de boletas del período.
Parameters:
- `pagina` (query, integer, required) — Si es la primera consulta, debe ser 1. Para las siguientes páginas, debe ser el número de la página.
- `periodo` (path, string, required) — Período de las BTE buscadas (YYYYMM o YYYYMMDD)
- `receptor` (path, string, required) — RUT del receptor de las BTE
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de boletas de terceros recibidas
#### POST /api/v2/sii/bte/recibidas/html/{codigo}
Descargar HTML boleta de terceros recibida
Este recurso permite obtener el HTML de una boleta de terceros recibida.
Se utiliza el código de la boleta asignado por SII para obtener el HTML.
**La respuesta no es un objeto JSON**, es el HTML de la boleta emitido por el SII.
Parameters:
- `codigo` (path, string, required) — Código de la BTE recibida
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — HTML de la boleta de terceros recibida
### API DTE - Código de Asignación de Folios (CAF)
Recursos para gestionar el CAF (Código de Autorización de Folios) del SII:
- Consulta de cantidad disponible de folios
- Solicitud de nuevos folios
- Consulta de estado de folios individuales
- Consulta de estados múltiples de folios (anulados, no anulados, pendientes, reclamados, no incluidos)
- Anulación de folios
- Descarga de XML de autorización de folios
- Listado de solicitudes de folios
#### POST /api/v2/sii/dte/caf/cantidad/{rut}/{dte}
Cantidad de Folios Disponibles
Permite obtener la cantidad de folios disponibles para un tipo de DTE.
**La respuesta incluye:**
- Tipo de DTE consultado.
- Cantidad de folios disponibles.
Parameters:
- `dte` (path, integer, required) — Código del tipo de documento
- `rut` (path, string, required) — RUT del emisor
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Cantidad de Folios Disponibles
#### POST /api/v2/sii/dte/caf/solicitar/{emisor}/{dte}/{cantidad}
Solicitar Folios
Recurso que permite solicitar un nuevo XML de un CAF al SII.
**La respuesta no es un objeto JSON**, es el XML del CAF entregado por el SII.
Parameters:
- `cantidad` (path, integer, required) — Cantidad de folios a solicitar
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, integer, required) — Código del tipo de documento
- `emisor` (path, string, required) — RUT del emisor del CAF
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Solicitud de CAF exitosa
#### POST /api/v2/sii/dte/caf/xml/{emisor}/{dte}/{folioInicial}/{folioFinal}/{fechaAutorizacion}
Obtener XML de CAF
Recurso que permite obtener el XML de un CAF.
**La respuesta no es un objeto JSON**, es el XML del CAF entregado por el SII.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, integer, required) — Código del tipo de documento
- `emisor` (path, string, required) — RUT del emisor del CAF
- `fechaAutorizacion` (path, string, required) — Fecha de autorización del CAF
- `folioFinal` (path, integer, required) — Folio final del CAF
- `folioInicial` (path, integer, required) — Folio inicial del CAF
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — XML de CAF
#### POST /api/v2/sii/dte/caf/estado/{emisor}/{dte}/{folio}
Estado de Folio
Permite obtener el estado de un folio en el SII.
**La respuesta incluye:**
- Estado del folio y su glosa.
- Track ID del envío asociado al folio.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, integer, required) — Código del tipo de documento
- `emisor` (path, string, required) — RUT del emisor del folio
- `folio` (path, integer, required) — Folio que se desea consultar
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de Folio
#### POST /api/v2/sii/dte/caf/anular/{emisor}/{dte}/{folioInicial}/{folioFinal}
Anulación de Folios
Permite anular un rango de folios previamente solicitados al SII.
**La respuesta incluye:**
- RUT del emisor.
- Tipo de DTE.
- Folio inicial y folio final anulados.
- Fecha de la anulación.
- Usuario que realizó la anulación.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, integer, required) — Código del tipo de documento
- `emisor` (path, string, required) — RUT del emisor
- `folioFinal` (path, integer, required) — Último folio que se desea anular
- `folioInicial` (path, integer, required) — Primer folio que se desea anular
- `formato` (query, string) — `json` `html`
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Resultado de la anulación de folios
#### POST /api/v2/sii/dte/caf/solicitudes/{emisor}/{dte}
Listado de Solicitudes de CAF
Recurso que permite obtener el listado de solicitudes de CAF realizadas por un emisor.
El listado se entrega paginado. Indica la página en el parámetro `pagina`,
partiendo desde la `1`, y usa `metadata.siguiente_pagina` de la respuesta
para saber si existen más páginas.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, integer, required) — Código del tipo de documento
- `emisor` (path, string, required) — RUT del emisor del CAF
- `formato` (query, string) — `json` `html`
- `pagina` (query, integer, required) —
Página de las solicitudes de CAF. La primera página es la `1`.
La respuesta incluye `metadata.siguiente_pagina` con el número
de la página siguiente, o `null` si es la última.
Responses:
- `200` — Listado de solicitudes de CAF
#### POST /api/v2/sii/dte/caf/estados/{emisor}/{dte}/{folioInicial}/{folioFinal}/{estado}
Estados de Folios
Permite obtener los estados de un rango de folios en el SII.
**La respuesta incluye** un listado donde cada rango de folios tiene:
- Folio inicial y folio final del rango.
- Cantidad de folios del rango.
Parameters:
- `dte` (path, integer, required) — Código del tipo de documento
- `emisor` (path, string, required) — RUT del emisor
- `estado` (path, string, required) — Estado de los folios
- `folioFinal` (path, integer, required) — Último folio
- `folioInicial` (path, integer, required) — Primer folio
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estados de Folios
### API DTE - Documentos Emitidos
Recursos que permiten consultar y verificar documentos emitidos por contribuyentes. Ya sean, emitidos por el propio usuario o por terceros.
Permiten, principalmente, validar documentos emitidos por empresas. Es decir, verificar si un documento ha sido emitido correctamente por un contribuyente.
Recursos para gestionar documentos emitidos al SII:
- **Verificación de DTE**: validación de documentos emitidos por empresas
- **Estado de envío**: consulta del estado de envío de un XML al SII
#### POST /api/v2/sii/dte/emitidos/estado_envio/{emisor}/{trackId}
Obtener Estado de Envío de un XML al SII
Entrega el estado del envío de un XML de DTE al SII.
**Nota:** solo se pueden consultar por envíos al SII de empresas que el
usuario autenticado con certificado digital tenga acceso.
**La respuesta incluye:**
- RUT del emisor.
- Track ID del envío.
- Estado del envío.
- **Documentos del envío**, agrupados por tipo de DTE, cada grupo con:
- Tipo de DTE.
- Cantidad de documentos informados, aceptados, rechazados y con reparos.
- Total de documentos del tipo.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `emisor` (path, string, required) — RUT del emisor de los documentos
- `formato` (query, string) — `json` `html`
- `trackId` (path, integer, required) — Identificador del envío del libro que se desea reemplazar
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de Envío de DTE
#### POST /api/v2/sii/dte/emitidos/verificar
Verificar un Documento Emitido
Verifica un DTE emitido contra el SII.
**Tipos de documento**
- `33` Factura electrónica
- `34` Factura no afecta o exenta electrónica
- `39` Boleta electrónica
- `41` Boleta exenta electrónica
- `43` Liquidación factura electrónica
- `46` Factura de compra electrónica
- `52` Guía de despacho electrónica
- `56` Nota de débito electrónica
- `61` Nota de crédito electrónica
**Response (`data`)**
- `status`: código SII
- `detalle`: mensaje estándar del código
- `track_id`: identificador de envío (`0` si el SII no lo informa)
- `razon_social`: razón social informada por el SII (`null` si no viene)
**Códigos `status`**
- `DOK` Documento recibido por el SII. Datos coinciden con los registrados.
- `DNK` Documento recibido por el SII pero datos no coinciden con los registrados.
- `FAU` Folio del documento no recibido por el SII.
- `FNA` Folio no autorizado por el SII.
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
},
"dte": {
"dte": 33,
"emisor": "76192083-9",
"fecha": "2017-10-01",
"folio": 1000,
"receptor": "1234567-K",
"total": 31724
}
}
```
Responses:
- `200` — Documento verificado (`data` con status, detalle, track_id y razon_social).
### API DTE - Información Electrónica de Compras y Ventas
Recursos para gestionar la Información Electrónica de Compras y Ventas del SII:
- Código de Reemplazo de Libro IECV
#### POST /api/v2/sii/dte/iecv/codigo_reemplazo/{emisor}/{periodo}/{operacion}/{tipo}/{trackId}
Obtener Código de Reemplazo de Libro IECV
Recurso que entrega el código de reemplazo de libro de compras o
ventas para poder rectificar un libro.
Nota: sólo para períodos de 201707 hacia atrás.
**La respuesta incluye** el código de reemplazo del libro.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `emisor` (path, string, required) — RUT del emisor de los documentos
- `operacion` (path, string, required) —
`VENTA`
`COMPRA`
- `periodo` (path, string, required) — Período del registro (YYYYMM)
- `tipo` (path, integer, required) —
`MENSUAL`
`RECTIFICA`
- `trackId` (path, integer, required) — Identificador del envío del libro que se desea reemplazar
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Código de Reemplazo
### API RCV - Registro de Compras
Recursos para gestionar el Registro de Compras del SII:
- Resumen mensual de compras
- Detalle de documentos de compra por tipo de DTE y estado
- Modificación de tipo de transacción
- Procesamiento asíncrono para grandes volúmenes (>1000 registros)
Los documentos pueden estar en 4 estados:
- `REGISTRO`: con acuse de recibo, pago al contado o registrados automáticamente después de 8 días
- `PENDIENTE`: sin acuse de recibo dentro de los 8 días
- `NO_INCLUIR`: documentos excluidos de la contabilidad
- `RECLAMADO`: documentos reclamados antes de los 8 días
**Nota**: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.
#### POST /api/v2/sii/rcv/compras/resumen/{receptor}/{periodo}/{estado}
Resumen de Compras
**Permiso requerido**: `query rcv`
Recurso para obtener el resumen de las compras a partir de los datos del
Registro de Compras.
**La respuesta incluye:**
- **Resumen por tipo de documento**, un elemento por tipo, cada uno con:
- Código y nombre del tipo de documento.
- Tipo de ingreso del documento y operación.
- Cantidad total de documentos.
- Monto exento, neto, IVA y total.
- IVA no recuperable e IVA de uso común.
- Estado contable.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `estado` (path, string, required) — `REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`
- `formato` (query, string) — `json`
- `periodo` (path, string, required) — Período del registro
- `receptor` (path, string, required) — RUT del receptor de los documentos
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Resumen de Compras
#### POST /api/v2/sii/rcv/compras/detalle/{receptor}/{periodo}/{dte}/{estado}
Detalle de Compras
Recurso para obtener el detalle de las compras a partir de los datos del
Registro de Compras.
El detalle es el listado de documentos de cierto tipo disponibles en el
registro de compras. En ningún caso este recurso entregará el listado de
items (productos o servicios) de cada documento. Esto no es posible
porque ese dato no se encuentra en el listado de documentos del registro
de compras.
**Archivo en CSV del RCV del SII**
Se pueden obtener los datos en distintos tipos. Sin embargo, el tipo
`rcv_csv` tiene ciertas ventajas:
- No es necesario indicar el código de DTE, se recomienda usar 0 para el
campo `dte` en la URL ya que no se usa. Siempre se obtienen todos los
tipos de documentos del período.
- Permite obtener los datos de impuestos específicos.
- En general, debería ser el tipo con mejor tiempo de respuesta.
**Importante**: el tipo `rcv_csv` y formato `json` sólo funciona con el
estado `REGISTRO`. No es posible bajar otros estados con este tipo y
formato de datos. Si desea utilizar el tipo `rcv_csv` con otro estado deberá usar el formato `csv`.
**Respuesta**
**La respuesta incluirá** por defecto los datos obtenidos directamente desde el SII, donde los campos vienen desde el SII. Se recomienda revisar el registro de compras para ir comparando aquellos campos que no se entienda a partir de su nombre lo que significan. Adjuntamos una descripción general de los campos:
- `detTipoDoc`: código del tipo de DTE recibido.
- `detRutDoc`: RUT del proveedor, sin dígito verificador.
- `detDvDoc`: dígito verificador del RUT del proveedor.
- `detRznSoc`: razón social del proveedor.
- `detNroDoc`: folio del DTE recibido.
- `detFchDoc`: fecha de emisión del DTE recibido.
- `detFecAcuse`: fecha en que el receptor generó el acuse de recibido (si es que se generó).
- `detFecReclamado`: fecha en que el receptor generó el reclamo (si es que se generó).
- `detFecRecepcion`: fecha de recepción del XML del DTE por parte del SII.
- `detMntExe`: total monto exento.
- `detMntNeto`: total monto neto.
- `detMntIVA`: total monto IVA.
- `detMntTotal`: total del documento.
- `detTipoDocRef`: código del tipo de DTE de la referencia en el DTE recibido.
- `detFolioDocRef`: folio del DTE referenciado en el documento de compra.
- `detEventoReceptor`: código del evento que a realizado el receptor (si se ha realizado).
- `detEventoReceptorLeyenda`: glosa del evento que a realizado el receptor (si se ha realizado).
- `detPcarga`: período contable en el que corresponde registrar este documento de compra.
- `detMntActFijo`: Corresponde al monto del activo fijo del DTE (si fue clasificado como activo fijo).
- `detMntIVAActFijo`: Monto del IVA del activo fijo del DTE (si fue clasificado como activo fijo).
- `detMntIVANoRec`: Monto IVA no recuperable del DTE.
- `detMntCodNoRec`: corresponde el código del IVA no recuperable (si es que hay IVA no recuperable).
- `detAnulado`: cantidad de documentos anulados.
- `detMntSinCredito`: es el monto del IVA sin derecho a crédito fiscal.
- `detCdgSIISucur`: corresponde al código de la sucursal registrada en el SII.
- `detIndServicio`: código del indicador de servicio.
- `detTipoTransaccion`: tipo de transacción del documento.
- `detIndSinCosto`: indica si la compra es sin costo (solo en facturas).
- `detIVAFueraPlazo`: valor del total del IVA que está fuera de plazo, sólo aplica para notas de crédito.
- `detMntNoFact`: monto no facturable del DTE.
- `detIVATerceros`: monto del IVA terceros, sólo cuando hay venta o servicio por cuenta de terceros.
- `detMntPeriodo`: se refiere a la cantidad o monto de dinero declarado durante un período determinado. Este valor puede ser negativo.
- `detCredEc`: es el crédito especial del 65% para Empresas Constructoras.
- `detIVAPropio`: se refiere al monto del Impuesto al Valor Agregado (IVA) propio que ha sido declarado durante un período determinado. Aplica sólo cuando hay venta o servicio por cuenta de terceros.
- `detDepEnvase`: se refiera a la garantía de depósito por envase.
- `detLiqValComIVA`: se refiere al valor líquido de una compra o transacción que incluye el Impuesto al Valor Agregado (IVA).
- `detTasaImp`: se refiere a la tasa o porcentaje de impuesto aplicado a una transacción específica.
- `detLiqValComExe`: se refiere al valor líquido de una compra o transacción exenta de impuestos.
- `detMntSinCredito`: corresponde al monto sin derecho a crédito.
- `detLiqValComNeto`: se refiere al valor líquido o neto de una compra o transacción.
- `detExpNumId`: se refiere al número de identificación del exportador.
- `detExpNacionalidad`: se refiere a la nacionalidad del exportador.
- `detLiqDvEmisor`: se refiere al dígito verificador del emisor en una transacción o documento tributario.
- `detCodigo`: puede referirse a diferentes códigos asociados a transacciones, productos o servicios en el contexto de los registros - tributarios`.
- `detTabPuros`: corresponde al impuesto por tabacos manufacturados (cigarros puros)
- `detTabCigarrillos`: corresponde al impuesto por tabacos manufacturados (cigarrillos)
- `detTabElaborado`: corresponde al impuesto por tabacos manufacturados (tabaco elaborado)
- `detIVARetTotal`: se refiere al monto total de Impuesto al Valor Agregado (IVA) retenido en una transacción o período determinado.
- `detIVARetParcial`: Corresponde al monto parcial de Impuesto al Valor Agregado (IVA) retenido en una transacción o período determinado.
- `detIVANoRetenido`: es el monto de Impuesto al Valor Agregado (IVA) que no ha sido retenido en una transacción o período determinado.
- `detImpVehiculo`: corresponde al impuesto a los vehículos automóviles
- `detIVAUsoComun`: se refiere al Impuesto al Valor Agregado (IVA) aplicado a los bienes o servicios de uso común.
- `detTpoImp`: corresponde al código del tipo impuesto del DTE.
- `detLiqRutEmisor`: se refiere al RUT (Rol Único Tributario) del emisor en una transacción o documento tributario.
- `descTipoTransaccion`: descripción de cómo se clasifica el tipo de compra del DTE.
- `detEmisorNota`: se refiere al emisor de una nota de crédito o débito.
- `totalDinrMontoIVANoR`: se refiere al monto total en dinero del Impuesto al Valor Agregado (IVA) no retenido en una transacción o período determinado.
- `detPsjNac`: se refiere al número de pasajeros nacionales en una transacción o documento tributario.
- `detPsjInt`: se refiere al número de pasajeros internacionales en una transacción o documento tributario.
- `detNumInt`: corresponde al número o cantidad relacionada con operaciones o transacciones internacionales.
- `totalDtoiMontoImp`: se refiere al monto total del descuento sobre impuestos en una transacción o período determinado.
- `dcvCodigo`: corresponde al código que permite al SII tener información precisa sobre la actividad económica del contribuyente.
- `dcvEstadoContab`: se refiere al estado contable de una entidad o contribuyente.
- `detLey18211`: corresponde al impuesto del 4.4% por la importación de mercancías extranjeras, efectuada desde Zona Franca Primaria a Zona Franca de Extensión, el cual se calculará sobre el valor CIF de dichas mercancías.
Parameters:
- `certificacion` (query, string) — `0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, string, required) — Código del tipo de documento (33, 34, 46, etc.)
- `estado` (path, string, required) — `REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`
- `formato` (query, string) — `json` `csv`
- `periodo` (path, string, required) — Período del registro (YYYYMM)
- `receptor` (path, string, required) — RUT del receptor de los documentos
- `tipo` (query, string) — `rcv` `iecv` `rcv_csv`
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Detalle de Compras
#### POST /api/v2/sii/rcv/compras/set_tipo_transaccion/{receptor}/{periodo}
Asignación Tipo de Transacción de una Compra
Tipos de transacciones que se pueden asignar usando `tipo_transaccion`:
- `1` Compras del giro
- `2` Compras en supermercados o comercios similares
- `3` Adquisición de bienes raíces
- `4` Compra de activo fijo
- `5` Compras con IVA uso común
- `6` Compras sin derecho a crédito
Para el campo `codigo_iva` los posible valores son:
- Caso normal se usa `1` donde la empresa es sólo afecta, no hay IVA de
uso común y el IVA es recuperable.
- Caso IVA de uso común se asigna `2`.
- Caso IVA no recuperable, se usará uno de los códigos de IVA no
recuperable, ya sean:
- `1` Compras destinadas a IVA a generar operaciones no gravadas o exentas
- `2` Facturas de proveedores registradas fuera de plazo.
- `3` Gastos rechazados.
- `4` Entregas gratuitas (premios, bonificaciones, etc) recibidas.
- `9` Otros.
**La respuesta es vacía** cuando el tipo de transacción se asignó correctamente.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `periodo` (path, string, required) — Período del registro
- `receptor` (path, string, required) — RUT del receptor de los documentos
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
},
"documentos": [
{
"emisor": "77666555-4",
"dte": 33,
"folio": 1,
"tipo_transaccion": 1,
"codigo_iva": 1
}
]
}
```
Responses:
- `200` — Respuesta exitosa
#### POST /api/v2/sii/rcv/compras/async/solicitar/{receptor}/{periodo}/{dte}/{estado}
Paso 1: Solicitar descarga de compras
Este recurso solicita la descarga asíncrona de compras para un contribuyente y período específicos.
**Nota: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.**
Recurso disponible en ambiente de producción. No está disponible en ambiente de certificación.
**Primer recurso a consumir para obtener el ID de la descarga asíncrona.**
**La respuesta incluye:**
- ID y UUID de la descarga.
- Tipo de DTE solicitado.
- Estado y sección (`COMPRA`) de la descarga.
- Fecha de creación y fecha de término.
- Cantidad de registros de la descarga.
Parameters:
- `dte` (path, string, required)
- `estado` (path, string, required) — `REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`
- `periodo` (path, string, required)
- `receptor` (path, string, required)
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Solicitud de descarga asíncrona de compras
#### POST /api/v2/sii/rcv/compras/async/estado/{receptor}/{periodo}/{requestId}/{dte}/{estado}
Paso 2: Obtener estado de descarga de compras
Este recurso obtiene el estado de una descarga asíncrona de compras para un contribuyente y período específicos.
**Nota: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.**
Recurso disponible en ambiente de producción. No está disponible en ambiente de certificación.
**Segundo recurso a consumir para obtener el estado de la descarga asíncrona.**
Este recurso debe ser consumido después de obtener el ID de la descarga asíncrona.
**La respuesta incluye:**
- ID y UUID de la descarga.
- Tipo de DTE solicitado.
- Estado y sección (`COMPRA`) de la descarga.
- Fecha de creación y fecha de término.
- Cantidad de registros de la descarga.
Parameters:
- `dte` (path, string, required)
- `estado` (path, string, required)
- `periodo` (path, string, required)
- `receptor` (path, string, required)
- `requestId` (path, string, required) — ID de la descarga asíncrona obtenido en el paso 1
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Estado de descarga asíncrona de compras
#### POST /api/v2/sii/rcv/compras/async/detalle/{receptor}/{periodo}/{requestId}/{dte}/{estado}
Paso 3: Obtener detalle de descarga de compras
Este recurso obtiene el detalle de una descarga asíncrona de compras para un contribuyente y período específicos.
**Nota: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.**
Recurso disponible en ambiente de producción. No está disponible en ambiente de certificación.
**Tercer recurso a consumir para obtener el detalle de la descarga asíncrona.**
Este recurso debe ser consumido después de obtener el estado de la descarga asíncrona.
**La respuesta incluye** un listado donde cada documento tiene:
- **Identificación del documento**
- Tipo de DTE y folio.
- RUT y razón social del proveedor.
- Tipo de transacción.
- Fecha de emisión, fecha de recepción en el SII y fecha del acuse de recibo.
- **Montos**
- Monto exento, neto, IVA y total.
- IVA no recuperable, con su monto y su código.
- IVA de uso común, IVA no retenido e impuesto sin derecho a crédito.
- Monto del activo fijo y su IVA.
- **Impuestos específicos**
- Impuesto a los puros, a los cigarrillos y al tabaco elaborado.
- Listado de impuestos adicionales.
- Emisor de la nota de crédito o débito.
Parameters:
- `dte` (path, string, required) — Código del tipo de documento
- `estado` (path, string, required) — `REGISTRO` `PENDIENTE` `NO_INCLUIR` `RECLAMADO`
- `formato` (query, string) — `json`
- `periodo` (path, string, required)
- `receptor` (path, string, required)
- `requestId` (path, string, required) — ID de la descarga asíncrona obtenido en el paso 1
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Detalle de descarga asíncrona de compras
### API RCV - Registro de Ventas
Recursos para gestionar el Registro de Ventas del SII:
- Resumen mensual de ventas
- Detalle de documentos de venta por tipo de DTE
- Actualización de resumen de ventas
- Procesamiento asíncrono para grandes volúmenes (>1000 registros)
**Nota**: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.
#### POST /api/v2/sii/rcv/ventas/resumen/{emisor}/{periodo}
Resumen de Ventas
Recurso para obtener el resumen de las ventas a partir de los datos del
Registro de Ventas.
**La respuesta incluye** un resumen por tipo de documento, donde cada elemento tiene:
- Código y nombre del tipo de documento.
- Tipo de ingreso del documento y operación.
- Cantidad total de documentos.
- Monto exento, neto, IVA y total.
- IVA no recuperable e IVA de uso común.
- Estado contable.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `emisor` (path, string, required) — RUT del emisor de los documentos
- `formato` (query, string) — `json`
- `periodo` (path, string, required) — Período del registro (YYYYMM)
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Resumen de Ventas
#### POST /api/v2/sii/rcv/ventas/detalle/{emisor}/{periodo}/{dte}
Detalle de Ventas
Recurso para obtener el detalle de las ventas a partir de los datos del
Registro de Ventas.
El detalle es el listado de documentos de cierto tipo disponibles en el
registro de ventas. En ningún caso este recurso entregará el listado de
items (productos o servicios) de cada documento. Esto no es posible
porque ese dato no se encuentra en el listado de documentos del registro
de ventas.
**Archivo en CSV del RCV del SII**
Se pueden obtener los datos en distintos tipos. Sin embargo, el tipo
`rcv_csv` tiene ciertas ventajas:
- No es necesario indicar el código de DTE, se recomienda usar 0 para el
campo `dte` en la URL ya que no se usa. Siempre se obtienen todos los
tipos de documentos del período.
- Permite obtener los datos de impuestos específicos.
- En general, debería ser el tipo con mejor tiempo de respuesta.
Considerar adicionalmente, que es más rápido usar el tipo `rcv_csv` con el formato `csv`.
**Respuesta**
**La respuesta incluirá** por defecto los datos obtenidos directamente desde
el SII, donde los campos vienen desde el SII. Los más importantes son:
- `detTipoDoc`: código del tipo de DTE emitido.
- `detRutDoc`: RUT del cliente, sin dígito verificador.
- `detDvDoc`: dígito verificador del RUT del cliente.
- `detRznSoc`: razón social del cliente.
- `detNroDoc`: folio del DTE emitido.
- `detFchDoc`: fecha de emisión del DTE emitido.
- `detFecAcuse`: fecha en que el receptor generó el acuse de recibido (si es que se generó).
- `detFecReclamado`: fecha en que el receptor generó el reclamo (si es que se generó).
- `detFecRecepcion`: fecha de recepción del XML del DTE por parte del SII.
- `detMntExe`: total monto exento.
- `detMntNeto`: total monto neto.
- `detMntIVA`: total monto IVA.
- `detMntTotal`: total del documento.
- `detTipoDocRef`: código del tipo de DTE de la referencia en el DTE emitido.
- `detFolioDocRef`: folio del DTE referenciado en el documento de venta.
- `detEventoReceptor`: código del evento que ha realizado el receptor (si se ha realizado).
- `detEventoReceptorLeyenda`: glosa del evento que ha realizado el receptor (si se ha realizado).
- `detPcarga`: período contable en el que corresponde registrar este documento de venta.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, string, required) — Código del tipo de documento (33, 34, 46, etc.)
- `emisor` (path, string, required) — RUT del emisor de los documentos
- `formato` (query, string) — `json` `csv`
- `periodo` (path, string, required) — Período del registro (YYYYMM)
- `tipo` (query, string) — `rcv` `iecv` `rcv_csv`
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Detalle de Ventas
#### POST /api/v2/sii/rcv/ventas/set_resumen/{emisor}/{periodo}
Asignación de Resumen de Ventas por Documento
Permite asignar un resumen de documentos emitidos al registro de ventas.
Por ejemplo, agregar mensualmente el resumen de boletas emitidas.
**Campos del documento:**
- `det_tipo_doc`: Código del tipo de documento (39 para boleta afecta, 41 para boleta exenta, etc.)
- `det_nro_doc`: Cantidad de documentos del tipo indicado
- `det_mnt_neto`: Monto neto total
- `det_mnt_iva`: Monto IVA total
- `det_mnt_exe`: Monto exento total
- `det_mnt_total`: Monto total
**La respuesta incluye** el resultado de la operación: `true` si el resumen fue asignado al registro de ventas.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `emisor` (path, string, required) — RUT del emisor de los documentos del resumen
- `periodo` (path, string, required) — Período de emisión de los documentos del resumen (YYYYMM)
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
},
"documentos": [
{
"det_tipo_doc": 39,
"det_nro_doc": 10,
"det_mnt_neto": 10000,
"det_mnt_iva": 1900,
"det_mnt_exe": 5000,
"det_mnt_total": 16900
}
]
}
```
Responses:
- `200` — Respuesta exitosa
#### POST /api/v2/sii/rcv/ventas/async/solicitar/{receptor}/{periodo}/{dte}
Paso 1: Solicitar descarga de ventas
Este recurso solicita una descarga asíncrona de ventas para un contribuyente y período específicos.
**Nota: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.**
**Primer recurso a consumir para obtener el ID de la descarga asíncrona.**
**La respuesta incluye:**
- ID y UUID de la descarga.
- Tipo de DTE solicitado.
- Estado y sección (`VENTA`) de la descarga.
- Fecha de creación y fecha de término.
- Cantidad de registros de la descarga.
Parameters:
- `dte` (path, string, required)
- `periodo` (path, string, required)
- `receptor` (path, string, required)
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Solicitud de descarga asíncrona de ventas
#### POST /api/v2/sii/rcv/ventas/async/estado/{receptor}/{periodo}/{requestId}/{dte}
Paso 2: Obtener estado de descarga de ventas
Este recurso obtiene el estado de una descarga asíncrona de ventas para un contribuyente y período específicos.
**Nota: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.**
**Segundo recurso a consumir para obtener el estado de la descarga asíncrona.**
Este recurso debe ser consumido después de obtener el ID de la descarga asíncrona.
**La respuesta incluye:**
- ID y UUID de la descarga.
- Tipo de DTE solicitado.
- Estado y sección (`VENTA`) de la descarga.
- Fecha de creación y fecha de término.
- Cantidad de registros de la descarga.
Parameters:
- `dte` (path, string, required) —
El tipo de documento a obtener. Si se desean obtener boletas (afectas y/o exentas) se debe pasar el valor `3941`.
- `periodo` (path, string, required)
- `receptor` (path, string, required)
- `requestId` (path, string, required) — ID de la descarga asíncrona obtenido en el paso 1
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Estado de descarga asíncrona de ventas
#### POST /api/v2/sii/rcv/ventas/async/detalle/{emisor}/{periodo}/{requestId}/{dte}
Paso 3: Obtener detalle de descarga de ventas
Este recurso obtiene el detalle de una descarga asíncrona de ventas para un contribuyente y período específicos.
**Nota: Si el contribuyente posee más de 1000 registros en el mes, se debe utilizar la API asíncrona.**
**Tercer recurso a consumir para obtener el detalle de la descarga asíncrona.**
Este recurso debe ser consumido después de obtener el estado de la descarga asíncrona.
**La respuesta incluye** un listado donde cada documento tiene:
- **Identificación del documento**
- Tipo de DTE y folio.
- RUT y razón social del cliente.
- Tipo de transacción e indicador de servicio.
- Fechas de emisión, vencimiento, recepción en el SII, acuse de recibo y reclamo.
- Tipo y folio del documento de referencia.
- Código de la sucursal registrada en el SII y número interno.
- **Montos**
- Monto exento, neto, IVA y total.
- IVA retenido total y parcial, IVA no retenido, IVA propio e IVA de terceros.
- IVA fuera de plazo, monto no facturable y monto del período.
- Depósito por envases y crédito especial de empresas constructoras.
- Indicador de venta sin costo.
- **Liquidación de comisiones**
- RUT de la liquidación.
- Comisión neta, exenta y su IVA.
- **Datos complementarios**
- Identificación y nacionalidad del extranjero.
- Impuesto de la Ley 18.211.
- Pasajes nacionales e internacionales.
- Emisor de la nota de crédito o débito.
Parameters:
- `dte` (path, string, required) —
El tipo de documento a obtener. Si se desean obtener boletas (afectas y/o exentas) se debe pasar el valor `3941`.
- `emisor` (path, string, required)
- `periodo` (path, string, required)
- `requestId` (path, string, required) — ID de la descarga asíncrona obtenido en el paso 1
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Detalle de descarga asíncrona de ventas
### API RTC - Cesiones
Recursos para interactuar con el [Registro de Transferencia de Créditos](https://palena.sii.cl/rtc/RTC/RTCMenu.html) del SII.
En otras palabras, lo asociado a la cesión de documentos tributarios:
- Certificado de cesión de documentos
- Estado de envío de cesiones (track_id)
- Estado de cesión de un documento específico
- Listado de documentos cedidos por rango de fechas
**Importante**: En estos recursos, la autenticación del SII fue probada
originalmente con certificado digital. Sin embargo, al menos un usuario ha
reportado que sólo le funcionó con RUT y clave tributaria del
contribuyente. Considerar esto en caso de algún problema al obtener los
datos.
#### POST /api/v2/sii/rtc/cesiones/certificado/{emisor}/{dte}/{folio}/{fecha}
Obtener certificado de cesión electrónica
Obtiene el certificado de cesión de un documento tributario electrónico (DTE).
El certificado contiene la información de las cesiones realizadas sobre
el documento, incluyendo cedente, cesionario y fecha de cesión.
**La respuesta no es un objeto JSON**, es el certificado de cesión emitido por el SII en formato HTML.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, string, required) — Código del tipo de documento (33=Factura, 34=Factura Exenta, etc.)
- `emisor` (path, string, required) — RUT del emisor del documento (sin puntos, con guión)
- `fecha` (path, string, required) — Fecha de emisión del documento (formato YYYY-MM-DD)
- `folio` (path, string, required) — Número de folio del documento
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Certificado de cesión
#### POST /api/v2/sii/rtc/cesiones/estado_envio/{trackId}
Estado de envío de cesión electrónica
Obtiene el estado de envío de una cesión.
**La respuesta incluye:**
- Estado del envío de la cesión.
- Track ID consultado.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `trackId` (path, string, required) — ID de la cesión
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de envío de cesión
#### POST /api/v2/sii/rtc/cesiones/estado/{emisor}/{dte}/{folio}
Estado de cesión de DTE
Para el caso con respuesta del SII "Tenedor Vigente" se entrega el estado de un DTE para conocer si está o no cedido junto con datos del estado actual de la cesión.
En el caso de que el SII sólo indique "Documento Cedido" se entrega sólo si está o no cedido.
**La respuesta incluye:**
- Si el documento está o no cedido.
Cuando el SII entrega el detalle de la cesión ("Tenedor Vigente"), además se incluye:
- Tenedor vigente del documento.
- Fecha de la última anotación.
- Clave de acceso.
- Declaración jurada.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `dte` (path, string, required) — Código del tipo de documento (33=Factura, 34=Factura Exenta, etc.)
- `emisor` (path, string, required) — RUT del emisor del documento (sin puntos, con guión)
- `folio` (path, string, required) — Número de folio del documento
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Estado de cesión
#### POST /api/v2/sii/rtc/cesiones/documentos/{desde}/{hasta}/{consulta}
Listado de documentos de cesión electrónica
Obtener las cesiones de un periodo.
Para acceder a la información entregada en esta opción, debe autenticarse:
- **Con RUT/Clave o Certificado Digital:** un contribuyente relacionado con la cesión (como deudor, cedente o cesionario).
- **Con RUT/Clave o Certificado Digital:** una persona que haya sido autorizada para representar electrónicamente a algunos de los contribuyentes antes indicados.
El rango de tiempo de la búsqueda no puede ser superior a 1 mes.
**Importante:** si no obtiene datos al usar el certificado digital. Se recomienda probar con RUT y clave. Ya que en la mayoría de los casos es por permisos y es mejor usar directamente el RUT y clave del contribuyente.
**La respuesta incluye** un listado donde cada cesión tiene:
- RUT del cedente y su razón social.
- RUT del cesionario y su razón social.
- RUT del deudor.
- RUT del vendedor.
- Estado de la cesión.
- Fecha de la cesión.
- Tipo de documento, su nombre y el folio.
- Fecha de emisión y fecha de vencimiento del documento.
- Monto total del documento y monto cedido.
- Correo electrónico del cedente y del cesionario.
Si se usa el parámetro `formato`, la respuesta se entrega como archivo en el formato solicitado (`xml`, `csv` o `txt`) en vez de un objeto JSON.
Parameters:
- `certificacion` (query, string) —
`0` ambiente de producción
`1` ambiente de certificación
- `consulta` (path, string, required) —
`0` consulta para el deudor (está obligado a pagar)
`1` consulta para el cedente (ha cedido)
`2` consulta para el cesionario (ha adquirido)
- `desde` (path, string, required) — Fecha de inicio (YYYY-MM-DD)
- `formato` (query, string) —
Formato de la respuesta
`xml` formato XML
`csv` formato CSV
`txt` formato TXT
- `hasta` (path, string, required) —
Hasta cuando buscar (máximo 30 días desde desde), formato: AAAA-MM-DD
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Listado de documentos de cesión
### API Vehículos
Recursos para consultar información vehicular del SII:
- **Tasación vehicular**: búsqueda y valorización de vehículos
- **Tipos de vehículos**: listado por categoría (automóviles, motos, camiones, etc.)
- **Marcas**: marcas disponibles por categoría
- **Características**: características técnicas por categoría
#### POST /api/v2/sii/vehiculos/tasacion/buscar
Buscar tasación vehicular
Recurso de la API que permite buscar la tasación fiscal de un vehículo y
el valor del permiso de circulación para cierto periodo.
**Campos obligatorios:**
- `anioTasa`: año fiscal de la búsqueda (por defecto el año actual).
- `categoria`: 1 es vehículo liviano.
- `tipo`: 6 es SUV.
Estos valores son opcionales, pero se recomienda al menos filtrar por
`marca` y `anio` para que la búsqueda sea eficiente.
- `marca`: 229 es SUZUKI.
- `modelo`
- `version`
- `anio`
Buscar sin estos filtros, descargará todos los registros, que puede ser
útil si se desea obtener todos los datos para almacenar localmente y
consultar con posterioridad.
**La respuesta incluye** un listado donde cada vehículo tiene:
- **Identificación del vehículo**
- ID y código del registro.
- Marca, con su ID.
- Modelo y versión.
- Año del vehículo.
- Tipo de vehículo y categoría, con sus IDs.
- **Valores fiscales**
- Año fiscal de la tasación.
- Monto de la tasación fiscal.
- Monto del permiso de circulación.
- Precio.
- **Datos complementarios**
- Número de caras y equipamiento.
- Si el vehículo tiene características asociadas.
Request body example:
```
{
"anio": 2017,
"anioTasa": 2020,
"categoria": 1,
"marca": 229,
"modelo": "VITARA",
"tipo": 6,
"version": "GLX SPORT"
}
```
Responses:
- `200` — Buscar tasación vehicular
#### GET /api/v2/sii/vehiculos/categorias/tipos/{categoria}
Tipos de vehículos según categoría
Obtiene los tipos de vehículos disponibles para una categoría.
Estos tipos son utilizados para filtrar la búsqueda de tasación
de vehículos.
**La respuesta incluye** un listado donde cada tipo tiene:
- ID del tipo.
- Nombre del tipo.
Parameters:
- `categoria` (path, string, required) —
ID de categorías:
| ID | Categoría |
|----|-----------|
| 1 | Livianos |
| 2 | Pesados |
| 3 | Motos |
Responses:
- `200` — Tipos de vehículos según categoría
#### GET /api/v2/sii/vehiculos/categorias/marcas/{categoria}
Marcas de vehículos según categoría
Obtiene las marcas de vehículos disponibles para una categoría.
Estas marcas son utilizadas para filtrar la búsqueda de tasación
de vehículos.
**La respuesta incluye** un listado donde cada marca tiene:
- ID de la marca.
- Nombre de la marca.
Parameters:
- `categoria` (path, string, required) —
ID de categorías:
| ID | Categoría |
|----|-----------|
| 1 | Livianos |
| 2 | Pesados |
| 3 | Motos |
Responses:
- `200` — Marcas de vehículos según categoría
#### GET /api/v2/sii/vehiculos/categorias/caracteristicas/{categoria}
Características de vehículos según categoría
Obtiene las características disponibles para una categoría de vehículo.
Estas características son utilizadas para filtrar la búsqueda de tasación
de vehículos.
**La respuesta incluye** un listado donde cada característica tiene:
- ID de la característica.
- Nombre de la característica.
- Listado de valores posibles, cada uno con su ID y su nombre. Es `null` cuando la característica no tiene valores predefinidos (por ejemplo, la cilindrada).
Parameters:
- `categoria` (path, string, required) —
ID de categorías:
| ID | Categoría |
|----|-----------|
| 1 | Livianos |
| 2 | Pesados |
| 3 | Motos |
Responses:
- `200` — Características de vehículos según categoría
### API Bienes Raíces
Recursos para consultar información de bienes raíces del SII:
- **Comunas**: listado completo de comunas y consulta por nombre
- **Propiedades**: búsqueda de propiedades por dirección, por ROL, o del contribuyente autenticado
- **Certificados**: obtención de datos y PDF de certificados
- Certificado de Avalúo Fiscal Simple
- Certificado de Avalúo Fiscal Previo
- Certificado de Antecedentes
#### GET /api/v2/sii/bienes_raices/comunas
Comunas de los bienes raices
**La respuesta incluye** un listado donde cada comuna tiene:
- Código de la comuna en CONARA/SII (`codigoConaraSii`).
- Nombre de la comuna.
- Código de la región de la comuna.
- Código de la comuna.
- Descripción y descripción corta de la comuna.
Responses:
- `200` — Comunas
#### POST /api/v2/sii/bienes_raices/comuna
Comuna del bienes raices
Filtros permitidos:
- Nombre de la comuna
**La respuesta incluye** los datos de la comuna:
- Código de la comuna en CONARA/SII (`codigoConaraSii`).
- Nombre de la comuna.
- Código de la región de la comuna.
- Código de la comuna.
- Descripción y descripción corta de la comuna.
Request body example:
```
{
"filtros": {
"comuna": "SANTA CRUZ"
}
}
```
Responses:
- `200` — Comuna
#### GET /api/v2/sii/bienes_raices/propiedades/rol/{comuna}/{manzana}/{predio}
Propiedades por Rol del bien raíz
Filtros permitidos:
- comuna: Código de la comuna.
- manzana: Número de manzana.
- predio: Número de predio.
**La respuesta incluye** un listado donde cada propiedad tiene:
- **Identificación del rol**
- Comuna, manzana y predio del rol.
- Comuna, manzana y predio actuales.
- Rol y último EAC aplicado.
- Si el predio existe, tabla de origen e indicadores de padre/hijo y copropiedad.
- **Ubicación**
- Nombre de la comuna y dirección.
- Calle, número, detalle y lugar.
- Ubicación (urbana o rural), destino y área homogénea.
- **Inscripción**
- Fojas, número y año de la inscripción.
- Porcentaje de derecho.
- RUT del propietario y su dígito verificador.
- **Avalúos y contribuciones**
- Avalúo fiscal, avalúo deflactado y avalúo del suelo.
- Avalúo total final, avalúo exento final y avalúo afecto.
- Año y semestre del avalúo.
- Estado de las contribuciones.
Parameters:
- `comuna` (path, integer, required) — Código de la comuna.
- `manzana` (path, integer, required) — Código de la manzana.
- `predio` (path, integer, required) — Código del predio.
Responses:
- `200` — Propiedades por Rol del bien raíz
#### POST /api/v2/sii/bienes_raices/propiedades/contribuyente
Propiedades del Contribuyente
Obtiene las propiedades del contribuyente autenticado.
**Este recurso requiere autenticación con certificado digital.** No se puede autenticar con RUT y clave.
El certificado se puede enviar de dos formas en `auth.cert`:
- `cert-data` y `pkey-data`: certificado y llave privada en formato PEM.
**La respuesta incluye** un listado donde cada propiedad tiene:
- **Identificación del rol**
- Comuna, manzana y predio del rol.
- Comuna, manzana y predio actuales.
- Rol y último EAC aplicado.
- Si el predio existe, tabla de origen e indicadores de padre/hijo y copropiedad.
- **Ubicación**
- Nombre de la comuna y dirección.
- Calle, número, detalle y lugar.
- Ubicación (urbana o rural), destino y área homogénea.
- **Inscripción**
- Fojas, número y año de la inscripción.
- Porcentaje de derecho.
- RUT del propietario y su dígito verificador.
- **Avalúos y contribuciones**
- Avalúo fiscal, avalúo deflactado y avalúo del suelo.
- Avalúo total final, avalúo exento final y avalúo afecto.
- Año y semestre del avalúo.
- Estado de las contribuciones.
Request body example:
```
{
"auth": {
"cert": {
"cert-data": "",
"pkey-data": ""
}
}
}
```
Responses:
- `200` — Propiedades del Contribuyente
#### GET /api/v2/sii/bienes_raices/certificados/avaluo_fiscal_simple/data/{comuna}/{manzana}/{predio}/{eac}
Obtener datos del certificado de avalúo fiscal simple
Obtiene los datos del certificado de avalúo fiscal simple de un bien raíz.
Filtros permitidos:
- comuna: Código de la comuna.
- manzana: Código de la manzana.
- predio: Código del predio.
- eac: Último EAC aplicado.
**La respuesta incluye:**
- **Datos generales**
- Comuna y rol del bien raíz.
- Dirección y destino.
- Folio y código de verificación del certificado.
- **Avalúo**
- Año y semestre del avalúo.
- Avalúo total.
- Fecha de emisión del certificado.
- Resultado de la consulta y su mensaje de error, si lo hubo.
Parameters:
- `comuna` (path, integer, required) — Código de la comuna.
- `eac` (path, integer, required) — Último EAC aplicado.
- `manzana` (path, integer, required) — Código de la manzana.
- `predio` (path, integer, required) — Código del predio.
Responses:
- `200` — Certificado de avalúo fiscal simple
#### GET /api/v2/sii/bienes_raices/certificados/avaluo_fiscal_previo/data/{comuna}/{manzana}/{predio}/{eac}
Obtener datos del certificado de avaluo fiscal previo
Obtiene los datos del certificado de avaluo fiscal previo de un bien raíz.
Filtros permitidos:
- comuna: Código de la comuna.
- manzana: Código de la manzana.
- predio: Código del predio.
- eac: Último EAC aplicado.
**La respuesta incluye:**
- **Datos generales**
- Comuna y rol del bien raíz.
- Dirección y destino.
- Folio y código de verificación del certificado.
- **Avalúo**
- Año y semestre del avalúo.
- Avalúo total.
- Fecha de emisión del certificado.
- Resultado de la consulta y su mensaje de error, si lo hubo.
Parameters:
- `comuna` (path, integer, required) — Código de la comuna.
- `eac` (path, integer, required) — Último EAC aplicado.
- `manzana` (path, integer, required) — Código de la manzana.
- `predio` (path, integer, required) — Código del predio.
Responses:
- `200` — Certificado de avaluo fiscal previo
#### GET /api/v2/sii/bienes_raices/certificados/antecedentes/data/{comuna}/{manzana}/{predio}/{eac}
Obtener datos del certificado de antecedentes
Obtiene los datos del certificado de antecedentes de un bien raíz.
Filtros permitidos (Requeridos):
- comuna: Código de la comuna.
- manzana: Código de la manzana.
- predio: Código del predio.
- eac: Último EAC aplicado.
**La respuesta incluye:**
- **Datos generales**
- Comuna y rol del bien raíz.
- Dirección, ubicación, destino y serie.
- Semestre, folio y código de verificación del certificado.
- **Avalúos**
- Avalúo total, exento y afecto.
- Año de término de la exención.
- **Contribuciones**
- Contribución neta y total.
- Sobretasa, sobretasa de sitios e impuesto adicional.
- Cuota de aseo.
- Avalúo actualizado.
- Fecha de emisión del certificado.
Parameters:
- `comuna` (path, integer, required) — Código de la comuna.
- `eac` (path, integer, required) — Último EAC aplicado.
- `manzana` (path, integer, required) — Código de la manzana.
- `predio` (path, integer, required) — Código del predio.
Responses:
- `200` — Certificado de antecedentes
#### GET /api/v2/sii/bienes_raices/certificados/avaluo_fiscal_simple/pdf/{comuna}/{manzana}/{predio}/{eac}
Obtener PDF de certificado de avalúo fiscal simple
Obtiene el PDF de certificado de avalúo fiscal simple de un bien raíz.
Filtros permitidos:
- comuna_cnp: Código de la comuna.
- manzana_cnp: Código de la manzana.
- predio_cnp: Código del predio.
- ultimo_eac_aplicado: Último EAC aplicado.
**La respuesta no es un objeto JSON**, es el archivo PDF del certificado de avalúo fiscal simple.
Parameters:
- `comuna` (path, integer, required) — Código de la comuna.
- `eac` (path, integer, required) — Último EAC aplicado.
- `manzana` (path, integer, required) — Código de la manzana.
- `predio` (path, integer, required) — Código del predio.
Responses:
- `200` — PDF de certificado de avalúo fiscal simple
#### GET /api/v2/sii/bienes_raices/certificados/avaluo_fiscal_previo/pdf/{comuna}/{manzana}/{predio}/{eac}
Obtener PDF de certificado de avalúo fiscal previo
Obtiene el PDF de certificado de avalúo fiscal previo de un bien raíz.
Filtros permitidos:
- comuna: Código de la comuna.
- manzana: Código de la manzana.
- predio: Código del predio.
- eac: Último EAC aplicado.
**La respuesta no es un objeto JSON**, es el archivo PDF del certificado de avalúo fiscal previo.
Parameters:
- `comuna` (path, integer, required) — Código de la comuna.
- `eac` (path, integer, required) — Último EAC aplicado.
- `manzana` (path, integer, required) — Código de la manzana.
- `predio` (path, integer, required) — Código del predio.
Responses:
- `200` — PDF de certificado de avalúo fiscal previo
#### GET /api/v2/sii/bienes_raices/certificados/antecedentes/pdf/{comuna}/{manzana}/{predio}/{eac}
Obtener PDF de certificado de antecedentes
Obtiene el PDF de certificado de antecedentes de un bien raíz.
Filtros permitidos:
- comuna: Código de la comuna.
- manzana: Código de la manzana.
- predio: Código del predio.
- eac: Último EAC aplicado.
**La respuesta no es un objeto JSON**, es el archivo PDF del certificado de antecedentes.
Parameters:
- `comuna` (path, integer, required) — Código de la comuna.
- `eac` (path, integer, required) — Último EAC aplicado.
- `manzana` (path, integer, required) — Código de la manzana.
- `predio` (path, integer, required) — Código del predio.
Responses:
- `200` — PDF de certificado de antecedentes
### API Software MIPYME SII - Contribuyentes
Recursos para consultar información de contribuyentes en el Portal MIPYME del SII (sistema gratuito de facturación):
- Información pública de un contribuyente (razón social, direcciones, actividades económicas)
- Validación de datos del receptor para emisión de documentos
**Requisitos de autenticación**:
- RUT de una empresa registrada en el Portal MIPYME (emisor)
- RUT y clave tributaria de un usuario (persona) con acceso a esa empresa
La autenticación en el SII se hace con el RUT y clave tributaria de la persona; las consultas quedan asociadas al RUT de la empresa emisora.
**Importante**: no es posible obtener datos de una empresa (por ejemplo, su dirección) desde el Portal MIPYME si no se tiene acceso a una empresa que use ese portal. Además, estos servicios web son sólo para extraer datos; actualmente no permiten emitir documentos.
#### POST /api/v2/sii/mipyme/contribuyentes/info/{contribuyente}/{emisor}/{dte}
Información Pública de un Contribuyente
Obtiene información pública de un contribuyente desde el Portal MIPYME del SII.
El RUT y clave tributaria del cuerpo de la solicitud deben ser de un
usuario (persona) que tenga acceso a la empresa "emisora" que está
registrada en el Portal MIPYME del SII.
**La respuesta incluye:**
- RUT y dígito verificador del contribuyente.
- Razón social.
- **Direcciones registradas**, cada una con su dirección, comuna, ciudad y teléfono.
- **Actividades económicas**, cada una con su código y glosa.
Parameters:
- `contribuyente` (path, string, required) — RUT del contribuyente a consultar
- `dte` (path, integer, required) — Tipo de documento a consultar
- `emisor` (path, string, required) — RUT del emisor a consultar
Request body example:
```
{
"auth": {
"pass": {
"rut": "11111111-1",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Información del contribuyente
### API Software MIPYME SII - Documentos Borradores
Recursos para gestionar documentos borradores en el Software MIPYME del SII:
- Listado de documentos en borrador
- Emisión de borradores (conversión a documento oficial)
- Descarga de PDF de borradores
- Eliminación de borradores
#### POST /api/v2/sii/mipyme/borradores/documentos/{emisor}
Listado de Documentos Borradores
[https://www4.sii.cl/mipymeinternetui/#!/borradores](https://www4.sii.cl/mipymeinternetui/#!/borradores)
Por defecto se buscan todos los borradores, se puede usar el atributo
`filtros` para definir filtrar por cualquier campo del borrador.
Algunos filtros útiles son los siguientes:
- `ptdc_CODIGO`: Código del tipo de DTE
- `efxp_RUT_RECEP`: RUT sin DV del receptor
- `efxp_MNT_TOTAL`: Monto total del DTE
**La respuesta incluye** el listado de borradores tal como los entrega el Portal MIPYME, ordenado por fecha de emisión de forma descendente. Cada borrador trae, entre otros campos:
- Código del tipo de DTE (`ptdc_CODIGO`).
- RUT del receptor (`efxp_RUT_RECEP`).
- Monto total del DTE (`efxp_MNT_TOTAL`).
- Fecha de emisión (`efxp_FCH_EMIS`).
Cualquiera de los campos del borrador se puede usar como filtro en el atributo `filtros`.
Parameters:
- `emisor` (path, string, required) — RUT del emisor de los documentos
- `formato` (query, string) — `json`
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de documentos borradores
#### POST /api/v2/sii/mipyme/borradores/emitir
Emitir Documento Borrador
Considerar los siguientes puntos al emitir un DTE:
- Los datos del emisor si se envían no se usan, se usa lo por defecto del emisor en el SII. Se puede emitir sólo enviando el RUT del emisor.
- Los datos del receptor deben ir por requerimiento de nuestra API, pero no se utilizan para generar el borrador. Se ocuparán los datos por defecto que tenga el receptor en el SII.
- El descuento de un item sólo puede ser en porcentaje.
- El descuento global puede ser en porcentaje o en monto, pero debe ser sólo 1 descuento (no se permiten recargos).
- Los items son máximo 10.
- Las referencias son máximo 3.
- La factura afecta debe llevar sólo items afectos. Si se desea facturar items exentos deberán ir en una factura exenta aparte.
- Para emitir una factura exenta se debe indicar en los items el campo `"IndExe": 1`. En el descuento global, en caso de existir, se debe indicar el campo `"IndExeDR": 1`
- La guía de despacho no puede ir con descuentos, ni por item, ni global.
- No se guarda la forma de pago en el borrador. Por lo que no se puede asignar algo diferente a crédito que es el valor por defecto.
- No se guardan los datos de transporte en el borrador.
**La respuesta incluye** el borrador creado, con los mismos campos que entrega el listado de documentos borradores del Portal MIPYME: código del tipo de DTE, RUT del receptor, monto total y fecha de emisión, entre otros.
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
},
"dte": {
"Encabezado": {
"IdDoc": {
"TipoDTE": 33
},
"Emisor": {
"RUTEmisor": "76192083-9"
},
"Receptor": {
"RUTRecep": "66666666-6",
"RznSocRecep": "CLIENTE EJEMPLO",
"GiroRecep": "ACTIVIDADES VARIAS",
"DirRecep": "DIRECCION 123",
"CmnaRecep": "SANTIAGO"
}
},
"Detalle": [
{
"NmbItem": "Producto ejemplo",
"QtyItem": 1,
"PrcItem": 10000
}
]
}
}
```
Responses:
- `200` — Borrador emitido exitosamente
#### POST /api/v2/sii/mipyme/borradores/pdf/{emisor}/{codigo}
Descargar PDF de un Documento Borrador
**NOTA: Servicio no implementado.**
Permite descargar el PDF de un documento borrador del sistema MIPYME del SII.
El código del borrador se obtiene del listado de documentos borradores.
**La respuesta incluye** el PDF del borrador codificado en base64.
Parameters:
- `codigo` (path, string, required) — Código del Borrador que se desea descargar su PDF
- `emisor` (path, string, required) — RUT del emisor de los documentos
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — PDF del documento borrador en base64
#### POST /api/v2/sii/mipyme/borradores/eliminar/{emisor}/{codigo}
Eliminar Documento Borrador
Permite eliminar un documento borrador del sistema MIPYME del SII.
El código del borrador se obtiene del listado de documentos borradores.
**La respuesta incluye** el resultado de la eliminación: `true` si el borrador fue eliminado.
Parameters:
- `codigo` (path, string, required) — Código del Borrador que se desea eliminar
- `emisor` (path, string, required) — RUT del emisor de los documentos
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Borrador eliminado exitosamente
### API Software MIPYME SII - Documentos Emitidos
Recursos para gestionar documentos emitidos en el Software MIPYME del SII:
- Listado de documentos emitidos
- Descarga de PDF de documentos emitidos
- Descarga de XML de documentos emitidos (DTE firmado)
#### POST /api/v2/sii/mipyme/emitidos/documentos/{emisor}
Listado de DTEs Emitidos
**El rango de fechas es obligatorio y no puede ser superior a 1 mes.** Se debe enviar
siempre `FEC_DESDE` y `FEC_HASTA` en los filtros del body. Para consultar un período
más largo, se deben hacer varias llamadas, una por cada mes.
Al realizar la búsqueda se pueden utilizar los siguientes filtros en el body:
- `FEC_DESDE`: Desde qué fecha buscar, formato AAAA-MM-DD. **Obligatorio.**
- `FEC_HASTA`: Hasta qué fecha buscar, formato AAAA-MM-DD. **Obligatorio**, máximo 1 mes desde `FEC_DESDE`.
- `RUT_RECP`: RUT del receptor del documento, sin puntos ni dígito verificador
- `RZN_SOC`: Razón social del receptor del documento
- `TPO_DOC`: Código de DTE que se está buscando
- `FOLIO`: Folio del documento
- `ESTADO`: Estado del DTE que se está buscando
Los valores para `ESTADO` pueden ser:
- `EMI` Documento emitido
- `PRV` Borrador (pre-view) de documento
- `DCD` Certificado rechazado
- `DEI` RUT emisor inválido
- `DFI` Folio DTE inválido
- `DIN` Incompleto
- `DPF` Sin permiso de firma
- `DRF` DTE rechazado por firma
- `DRI` RUT receptor inválido
- `DRR` Rechazado por repetido
- `INI` DTE inicializado
- `RAC` DTE aceptado por receptor
- `RAD` DTE aceptado con discrepancias
- `RNR` DTE no recibido por receptor
- `RRC` DTE recibido por receptor
- `RRH` DTE rechazado por receptor
- `RSR` Recibido sin reparos
**La respuesta incluye** un listado donde cada documento tiene:
- Código del documento en el Portal MIPYME.
- Tipo de DTE y su glosa.
- Folio del documento.
- Fecha de emisión.
- Monto total.
- Estado del documento.
- RUT, dígito verificador y razón social del receptor.
Parameters:
- `emisor` (path, string, required) — RUT del emisor de los documentos
- `formato` (query, string) — `json`
Request body example:
```
{
"auth": {
"pass": {
"rut": "11111111-1",
"clave": "clave123"
}
},
"filtros": {
"FEC_DESDE": "2025-01-01",
"FEC_HASTA": "2025-01-31",
"TPO_DOC": 33,
"ESTADO": "EMI"
}
}
```
Responses:
- `200` — Listado de documentos emitidos
#### POST /api/v2/sii/mipyme/emitidos/pdf/{emisor}/{dte}/{folio}
Descargar PDF de un DTE Emitido
Permite descargar el PDF de un documento emitido del sistema MIPYME del SII.
El código del documento se obtiene del listado de documentos emitidos.
**Nota:** Es más rápido pasar el código del documento directamente que buscar por tipo de DTE y folio.
**La respuesta no es un objeto JSON**, es el archivo PDF del documento emitido.
Parameters:
- `dte` (path, integer, required) — Código interno del documento emitido (obtenido del listado de documentos)
- `emisor` (path, string, required) — RUT del emisor del DTE
- `folio` (path, integer, required)
- `folio` (query, integer) — Folio del documento emitido
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — PDF del documento emitido en base64
#### POST /api/v2/sii/mipyme/emitidos/xml/{emisor}/{dte}/{folio}
Descargar XML de un DTE Emitido
Permite descargar el XML de un documento emitido del sistema MIPYME del SII.
Se requiere el tipo de DTE, folio y fecha de emisión para obtener el XML.
**La respuesta no es un objeto JSON**, es el XML del documento tributario electrónico.
Parameters:
- `dte` (path, integer, required) — Código del tipo de DTE
- `emisor` (path, string, required) — RUT del emisor del DTE
- `fecha_emision` (query, string) — Fecha de emisión del documento (formato YYYY-MM-DD)
- `folio` (path, integer, required) — Folio del documento emitido
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — XML del documento emitido
### API Software MIPYME SII - Documentos Recibidos
Recursos para gestionar documentos recibidos en el Software MIPYME del SII:
- Listado de documentos recibidos
- Descarga de PDF de documentos recibidos
- Descarga de XML de documentos recibidos
#### POST /api/v2/sii/mipyme/recibidos/documentos/{receptor}
Listado de Documentos Recibidos
**El rango de fechas es obligatorio y no puede ser superior a 1 mes.** Se debe enviar
siempre `FEC_DESDE` y `FEC_HASTA` en los filtros del body. Para consultar un período
más largo, se deben hacer varias llamadas, una por cada mes.
Al realizar la búsqueda se pueden utilizar los siguientes filtros en el body:
- `FEC_DESDE`: Desde qué fecha buscar, formato AAAA-MM-DD. **Obligatorio.**
- `FEC_HASTA`: Hasta qué fecha buscar, formato AAAA-MM-DD. **Obligatorio**, máximo 1 mes desde `FEC_DESDE`.
- `RUT_EMI`: RUT del emisor del documento, sin puntos ni dígito verificador
- `RZN_SOC`: Razón social del emisor del documento
- `TPO_DOC`: Código de DTE que se está buscando
- `FOLIO`: Folio del documento
- `ESTADO`: Estado del DTE que se está buscando
Los valores para `ESTADO` pueden ser:
- `EMI` Documento emitido
- `PRV` Borrador (pre-view) de documento
- `DCD` Certificado rechazado
- `DEI` RUT emisor inválido
- `DFI` Folio DTE inválido
- `DIN` Incompleto
- `DPF` Sin permiso de firma
- `DRF` DTE rechazado por firma
- `DRI` RUT receptor inválido
- `DRR` Rechazado por repetido
- `INI` DTE inicializado
- `RAC` DTE aceptado por receptor
- `RAD` DTE aceptado con discrepancias
- `RNR` DTE no recibido por receptor
- `RRC` DTE recibido por receptor
- `RAL` DTE aceptado Ley 19.983
- `RRH` DTE rechazado por receptor
- `RSR` Recibido sin reparos
**La respuesta incluye** un listado donde cada documento tiene:
- Código del documento en el Portal MIPYME.
- Tipo de DTE y su glosa.
- Folio del documento.
- Fecha de emisión.
- Monto total.
- Estado del documento.
- RUT, dígito verificador y razón social del emisor.
Parameters:
- `formato` (query, string) — `json`
- `receptor` (path, string, required) — RUT del receptor de los documentos
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
},
"filtros": {
"FEC_DESDE": "2025-01-01",
"FEC_HASTA": "2025-01-31",
"TPO_DOC": 33,
"RUT_EMI": 12345678,
"ESTADO": "RRC"
}
}
```
Responses:
- `200` — Listado de documentos recibidos
#### POST /api/v2/sii/mipyme/recibidos/pdf/{receptor}/{emisor}/{dte}/{folio}
Descargar PDF de un Documento Recibido
Permite descargar el PDF de un documento recibido del sistema MIPYME del SII.
**La respuesta no es un objeto JSON**, es el archivo PDF del documento recibido.
Parameters:
- `dte` (path, integer, required) — Código del tipo de documento
- `emisor` (path, string, required)
- `folio` (path, integer, required) — Folio del documento
- `receptor` (path, string, required) — RUT del receptor del documento
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — PDF del documento recibido
#### POST /api/v2/sii/mipyme/recibidos/xml/{receptor}/{emisor}/{dte}/{folio}
Descargar XML de un Documento Recibido
Permite descargar el XML de un documento recibido del sistema MIPYME del SII.
**La respuesta no es un objeto JSON**, es el XML del documento tributario electrónico.
Parameters:
- `dte` (path, integer, required) — Código del documento
- `emisor` (path, string, required) — RUT del emisor del documento
- `fecha_emision` (query, string) — Fecha de emisión del documento (formato YYYY-MM-DD)
- `folio` (path, integer, required) — Folio del documento
- `receptor` (path, string, required) — RUT del receptor del documento
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — XML del documento recibido
### API Software SII - Formulario 29
Recursos para gestionar el Formulario 29 (Declaración Mensual y Pago Simultáneo de Impuestos) del SII:
- **Consultar Estados**: consulta general del estado de declaraciones F29 para todos los períodos
- **Listado de Declaraciones**: listado de declaraciones específicas de un período tributario
- **Detalles de Declaración**: información completa de una declaración específica (códigos, montos, impuestos)
- **PDF Certificado Solemne**: descarga del certificado solemne de presentación
- **PDF Formulario Compacto**: descarga del formulario en formato compacto
#### POST /api/v2/sii/f29/obtener_estados
Obtener Estados del Formulario 29
**Consulta Integral de Fiscalización**
**Tiempo de respuesta del servicio web**: 20 segundos.
Este endpoint realiza una consulta integral de fiscalización del Formulario 29.
Cada período puede tener diferentes estados según la información en las bases del SII y
la información proporcionada por el contribuyente y/o terceros.
**La respuesta incluye** un listado donde cada período tiene:
- Período consultado.
- Si el período fue declarado o no.
- Estado del período: para las declaraciones ingresadas indica si está sin observaciones, con observaciones o con observaciones justificadas; para los períodos sin declaración indica que no se ha presentado declaración.
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Estados del Formulario 29
#### POST /api/v2/sii/f29/detalles_declaracion/{folio}
Consultar Detalles de Declaración del Formulario 29
**Tiempo de respuesta promedio del servicio web**: 20 segundos.
Este endpoint realiza una consulta de detalles de declaración del Formulario 29.
**La respuesta incluye:**
- Folio de la declaración.
- Período de la declaración.
- Fecha y hora de la declaración.
- Estado de la declaración.
- **Historial de la declaración**
- Fecha del evento.
- Descripción del evento.
Este recurso puede tardar hasta 20 segundos en procesarse. Por lo tanto, se recomienda
usar un timeout de 20 segundos o superior en su uso.
Parameters:
- `folio` (path, string, required) — Folio del formulario 29
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Detalles de Declaración del Formulario 29
#### POST /api/v2/sii/f29/declaraciones/listado/{periodo}
Consultar Listado de Declaraciones por Período del Formulario 29
**Tiempo de respuesta promedio del servicio web**: 15 segundos.
Este endpoint realiza una consulta de listado de declaraciones por período del Formulario 29.
**La respuesta incluye** un listado donde cada declaración tiene:
- Período de la declaración.
- Folio de la declaración.
- RUT del contribuyente.
- Fecha de la declaración.
- Estado de la declaración.
Este recurso puede tardar hasta 20 segundos en procesarse. Por lo tanto, se recomienda
usar un timeout de 20 segundos o superior en su uso.
Parameters:
- `periodo` (path, string, required) — Período (YYYY or YYYY-MM)
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Listado de Declaraciones por Período del Formulario 29
#### POST /api/v2/sii/f29/certificado_solemne/pdf/{folio}
Descargar PDF Certificado Solemne del Formulario 29
Este endpoint realiza la descarga del PDF del Certificado Solemne del Formulario 29.
**La respuesta no es un objeto JSON**, es el archivo PDF del certificado solemne del folio solicitado.
Este recurso puede tardar hasta 20 segundos en procesarse. Por lo tanto, se recomienda
usar un timeout de 20 segundos o superior en su uso.
Parameters:
- `folio` (path, string, required) — Folio del certificado solemne
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Certificado Solemne
#### POST /api/v2/sii/f29/formulario_compacto/pdf/{folio}
Descargar PDF Formulario Compacto del Formulario 29
Este endpoint realiza la descarga del PDF del formulario compacto del Formulario 29.
**La respuesta no es un objeto JSON**, es el archivo PDF del formulario compacto del folio solicitado.
Este recurso puede tardar hasta 20 segundos en procesarse. Por lo tanto, se recomienda
usar un timeout de 20 segundos o superior en su uso.
Parameters:
- `folio` (path, string, required) — Folio del formulario compacto
Request body example:
```
{
"auth": {
"pass": {
"rut": "76192083-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — PDF formulario compacto
### API eBoleta - Sistema de emisión de Boletas Electrónicas SII
Recursos para interactuar con el sistema oficial de Boletas Electrónicas (eBoleta) del SII:
- **Información del emisor**: datos del contribuyente como emisor de boletas
- **Emisores autorizados**: listado de emisores autorizados asociados
- **Gestión de documentos emitidos**: listado y consulta de boletas emitidas
- **Emisión de boletas**: creación de nuevas boletas electrónicas
- **Consulta de documentos**: obtener información específica de una boleta
- **Descarga de PDF**: generación y descarga de boletas en formato PDF
- **Envío por email**: envío de boletas electrónicas por correo
#### POST /api/v2/sii/eboleta/contribuyente/emisor/{emisor}
Obtener información del emisor
Este recurso permite obtener información del emisor
de la boleta electrónica.
**La respuesta incluye:**
- **Contribuyente**
- RUT, dígito verificador y razón social.
- Nombres y apellidos paterno y materno.
- Giro y actividad económica.
- Dirección y comuna.
- Teléfono y correo electrónico.
- Número y fecha de la resolución.
- Estado de autorización, con su fecha de autorización y de desautorización.
- **Sucursales**, cada una con su RUT, código, nombre, dirección, comuna y ciudad.
- **Usuarios**, cada uno con su RUT, nombre, si es representante y sus permisos.
Parameters:
- `emisor` (path, integer, required) — RUT del emisor en formato 11222333-K
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Información del emisor obtenida exitosamente
#### POST /api/v2/sii/eboleta/contribuyente/emisores_autorizados
Obtener lista de emisores autorizados
Este recurso permite obtener lista de emisores autorizados
de la boleta electrónica.
**La respuesta incluye** un listado donde cada contribuyente tiene:
- RUT y dígito verificador.
- Razón social.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
}
}
```
Responses:
- `200` — Lista de emisores autorizados obtenida exitosamente
#### POST /api/v2/sii/eboleta/emitidas/documentos
Listado de documentos emitidos
Este recurso permite obtener listado de documentos emitidos de la boleta electrónica.
Los parámetros requeridos son:
- **contribuyente**: RUT del contribuyente
- **date_from**: Fecha de inicio (YYYY-MM-DD)
- **date_to**: Fecha de fin (YYYY-MM-DD)
Los siguientes parámetros son opcionales y se pueden omitir:
- **page**: Página a obtener (1 por defecto)
- **items_per_page**: Items por página (10 por defecto)
- **estado**: Estado del documento (emitido por defecto)
**La respuesta incluye:**
- **Listado de documentos**, cada uno con:
- Folio y tipo de documento (DTE).
- Fecha de emisión.
- Montos neto, exento, IVA y total.
- Cantidad total de ítems.
- RUT del vendedor.
- Sucursal y su código en el SII.
- Estado de la boleta y si está anulada.
- Estado de la revisión, su código, si tiene error y la fecha de la última revisión.
- URL del PDF del documento.
- **Metadata** de la consulta, con el total de documentos y la cantidad emitida.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"contribuyente": "12345678",
"date_from": "2025-01-01",
"date_to": "2025-12-31",
"page": 1,
"items_per_page": 10,
"estado": "rechazada,en_proceso,aceptada"
}
```
Responses:
- `200` — Listado de documentos emitidos obtenido exitosamente
#### POST /api/v2/sii/eboleta/emitidas/emitir
Emitir documento
**NOTA:**
Este recurso solo permite emitir Boletas Electrónicas Afectas y Exentas con un solo item.
Se recomienda consolidar el total en un solo item. Esta es un restricción de la plataforma de eBoleta.
Este recurso permite emitir:
- **Boleta Electrónica Afecta (39)**
- **Boleta Electrónica Exenta (41)**
**El campo `vendedor` es obligatorio y debe ser el mismo RUT que se usa para
autenticar en el SII**, es decir, el RUT de `auth.pass.rut` y el de `dte.vendedor`
tienen que ser idénticos. Si no coinciden, el SII rechaza la emisión.
**La respuesta incluye:**
- Folio y tipo de documento (DTE) de la boleta emitida.
- URL del PDF de la boleta.
- PDF de la boleta codificado en base64.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"dte": {
"vendedor": "12345678-9",
"Encabezado": {
"IdDoc": {
"TipoDTE": 39,
"MedioPago": 1
},
"Emisor": {
"RUTEmisor": "78987254-3",
"CdgSIISucur": 13214214
},
"Receptor": {
"RUTRecep": "19587454-4",
"RznSocRecep": "Nombre Cliente",
"DirRecep": "Dirección",
"TelefonoRecep": "123456789",
"CorreoRecep": "cliente@example.com"
}
},
"Detalle": [
{
"NmbItem": "Producto",
"QtyItem": 1,
"PrcItem": 1000
}
]
}
}
```
Responses:
- `200` — Documento emitido exitosamente
#### POST /api/v2/sii/eboleta/emitidas/documento
Obtener detalle de documento de la boleta electrónica
Este recurso permite obtener detalle de documento de la boleta electrónica.
Los parámetros requeridos son:
- **contribuyente**: RUT del contribuyente
- **folio**: Folio del documento
- **dte**: Tipo de documento
- **fecha**: Fecha de emisión del documento
**La respuesta incluye:**
- Folio y tipo de documento (DTE).
- Fecha de emisión.
- Montos neto, exento, IVA y total.
- Cantidad total de ítems.
- RUT del vendedor.
- Sucursal y su código en el SII.
- Estado de la boleta y si está anulada.
- Estado de la revisión, su código, si tiene error y la fecha de la última revisión.
- URL del PDF del documento.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"contribuyente": "12345678",
"folio": 53,
"dte": 39,
"fecha": "2025-11-10"
}
```
Responses:
- `200` — Detalle de documento obtenido exitosamente
#### POST /api/v2/sii/eboleta/emitidas/pdf
Obtener PDF
Este recurso permite obtener PDF de un documento de la boleta electrónica.
Los parámetros requeridos son:
- **contribuyente**: RUT del contribuyente
- **folio**: Folio del documento
- **dte**: Tipo de documento
- **fecha**: Fecha de emisión del documento
**La respuesta no es un objeto JSON**, es el PDF del documento codificado en base64.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"contribuyente": "12345678",
"folio": 53,
"dte": 39,
"fecha": "2025-11-03"
}
```
Responses:
- `200` — PDF obtenido exitosamente
#### POST /api/v2/sii/eboleta/emitidas/email
Enviar documento por email
Este recurso permite enviar por email una boleta electrónica.
**La respuesta incluye** el mensaje de confirmación del envío.
Request body example:
```
{
"auth": {
"pass": {
"rut": "12345678-9",
"clave": "clave123"
}
},
"contribuyente": "12345678",
"folio": 53,
"dte": 39,
"fecha": "2025-11-10",
"to": "email@destino.com"
}
```
Responses:
- `200` — Información del emisor obtenida exitosamente
### API Previred - Indicadores Previsionales
Recursos para obtener datos de indicadores previsionales del Previred:
- **Listado de indicadores**: listado de indicadores previsionales
- **Datos de un indicador**: datos de un indicador previsional
- **PDF de un indicador**: PDF de un indicador previsional
#### GET /api/v2/previred/indicadores/periodos
Obtener listado de URLs del PDF de los indicadores
Este recurso permite obtener un listado de URLs del PDF de los indicadores previsionales.
**La respuesta incluye** un listado donde cada elemento tiene:
- URL del PDF del indicador.
- Período del indicador.
Responses:
- `200` — Listado de URLs del PDF de los indicadores
#### GET /api/v2/previred/indicadores/pdf/{periodo}
Obtener PDF de un indicador
Este recurso permite obtener el PDF de un indicador previsional.
**La respuesta no es un objeto JSON**, es el archivo PDF del indicador del período solicitado, entregado con el tipo de contenido `application/pdf`.
Parameters:
- `periodo` (path, string, required) — Periodo del indicador
Responses:
- `200` — PDF del indicador
#### GET /api/v2/previred/indicadores/data/{periodo}
Obtener datos de un indicador
Este recurso permite obtener datos de un indicador previsional.
El tiempo de respuesta puede ser de hasta 15 o mas segundos debido a que se debe descargar el PDF del indicador.
**Durante la semana del 6 de abril del 2026, este recurso tendrá un cambio en la estructura de la respuesta.**
**La respuesta incluye:**
- **Identificación del indicador**
- Período del indicador y período de pago de las cotizaciones.
- Descripción del indicador.
- **Valores de referencia**
- Valor de la UF del período actual y del período anterior.
- Valores de la UTM y la UTA del mes.
- **Rentas imponibles**
- Topes imponibles para AFP, IPS y seguro de cesantía.
- Rentas mínimas para dependientes e independientes, menores de 18 y mayores de 65 años, casa particular y fines no remuneracionales.
- **AFP**
- Tasa de cada AFP con cargo del trabajador, cargo del empleador y total a pagar.
- Tasa del independiente que incluye el SIS.
- **Seguro de cesantía (AFC)**
- Tasas para plazo indefinido, plazo fijo, plazo indefinido sobre 11 años y casa particular.
- Aporte del empleador y del trabajador en cada caso.
- **Otras cotizaciones**
- Tasa del SIS.
- Trabajos pesados y menos pesados: calificación y aporte del empleador y del trabajador.
- Factor de expectativa de vida del seguro social.
- Distribución de la cotización de salud entre CCAF y FONASA.
- **Ahorro previsional**
- Topes del APV mensual y anual.
- Tope anual del depósito convenido.
- **Asignación familiar**
- Tramos con su monto.
- Requisitos de renta mínima y máxima de cada tramo.
Parameters:
- `periodo` (path, string, required) — Periodo del indicador
Responses:
- `200` — Datos del indicador
### API Backoffice - Billing
#### POST /api/v2/connections/pricing
Calcular el precio de los créditos
Este recurso permite calcular el precio de los créditos.
Acepta 'quantity' (cantidad de créditos) o 'amount' (monto en CLP),
y devuelve el cálculo de precio o cantidad de créditos.
Parameters:
- `amount` (query, number) — Monto en CLP
- `format` (query, string)
- `quantity` (query, number) — Cantidad de créditos
Request body example:
```
{
"quantity": 100
}
```
Responses:
- `200` — Calcular el precio de los créditos
---
Last updated on 21/08/2026