Cómo Descargar el RCV del SII Automáticamente con API
Guía paso a paso para descargar el Registro de Compras y Ventas (RCV) del SII de forma automática vía API REST. Código en JavaScript y Python, ejemplos reales.
Si tienes que descargar el Registro de Compras y Ventas del SII todos los meses —para uno o varios contribuyentes— sabes exactamente cuánto tiempo se pierde en el proceso manual. Iniciar sesión, navegar entre menús, seleccionar el período, esperar que cargue, descargar el CSV, abrirlo en Excel, corregir los caracteres mal codificados, y repetir todo eso empresa por empresa. Este artículo te muestra cómo automatizar completamente ese flujo usando la API RCV del SII a través de BaseAPI, con ejemplos reales en JavaScript y Python.
Qué es el RCV y por qué importa descargarlo correctamente
El Registro de Compras y Ventas (RCV) es el libro tributario electrónico que el SII administra de forma centralizada. Reemplazó al antiguo Libro de Compras y Ventas en papel desde 2017. Cada DTE emitido o recibido queda registrado automáticamente, y el contribuyente puede aceptar, reclamar o confirmar los documentos de compras dentro del plazo legal.
Según la página oficial del SII sobre el RCV, este registro es la base para la confección del Formulario 29 y la declaración mensual de IVA. Un dato erróneo o una descarga incompleta puede significar diferencias en el crédito fiscal o inconsistencias que el Servicio detecta en la cruzada de información.
Para un contador que maneja 30 o 40 clientes, descargar el RCV de cada empresa para el cierre del mes puede consumir entre 2 y 4 horas de trabajo mecánico y repetitivo. Para un equipo de desarrollo que quiere integrar información tributaria en un ERP o sistema contable, el proceso manual simplemente no escala.
El proceso manual paso a paso (y sus problemas)
Para entender el valor de la automatización, conviene revisar exactamente qué implica descargar el RCV desde el portal del SII de forma manual.
Paso 1 — Ingresar al portal del SII
Accede a www.sii.cl, selecciona "Servicios Online" e inicia sesión con RUT y clave tributaria. Si manejas varios contribuyentes, deberás repetir este paso con las credenciales de cada uno, o usar el sistema de representante si tienes poder notarial.
Paso 2 — Navegar hasta el RCV
Desde el menú de servicios, ve a "Registro de Compras y Ventas". La ruta exacta varía según actualizaciones del portal, pero normalmente está bajo "IVA" o "Facturación Electrónica". El portal no siempre carga con fluidez en horas peak.
Paso 3 — Seleccionar período y tipo
Debes elegir el período (año y mes), si quieres ver Compras o Ventas, y el estado de los documentos (todos, aceptados, reclamados). Cada combinación genera una vista distinta.
Paso 4 — Descargar el archivo
El SII permite exportar a CSV. El archivo viene con codificación ISO-8859-1, lo que significa que los caracteres especiales (tildes, la ene) aparecen mal en Excel a menos que configures la importación correctamente.
Paso 5 — Repetir por cada cliente y cada mes
Si necesitas los últimos tres meses para cinco empresas, acabas de multiplicar ese proceso por quince. Sin contar errores de sesión, timeouts del portal o períodos donde el SII realiza mantenimiento.
La guía de preguntas frecuentes del SII sobre el RCV documenta muchas de estas complejidades, incluyendo los plazos de acuse de recibo y las diferencias entre los estados de los documentos.
La alternativa: descargar el RCV del SII con API
En lugar de que una persona navegue el portal manualmente, puedes delegar ese trabajo a código. La API RCV de BaseAPI se autentica contra el SII con las credenciales del contribuyente, navega el portal de forma programática, extrae los datos y los devuelve como JSON estructurado listo para usar.
No hay scraping frágil que rompa con cada actualización del portal. No hay dependencia de que el navegador funcione de cierta manera. Solo un endpoint REST que hace el trabajo y retorna datos.
Ejemplo en JavaScript
// JavaScript example
const response = await fetch('https://api.baseapi.cl/sii/rcv/compras', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
rut: '76123456-7',
clave_sii: 'password',
periodo: '2026-02',
tipo: 'compras'
})
});
const data = await response.json();
Con esto obtienes los documentos del período solicitado en milisegundos, sin abrir ningún navegador. El campo tipo acepta 'compras' o 'ventas', y periodo sigue el formato YYYY-MM.
Ejemplo en Python
# Python example
import requests
response = requests.post('https://api.baseapi.cl/sii/rcv/compras',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'rut': '76123456-7',
'clave_sii': 'password',
'periodo': '2026-02',
'tipo': 'compras'
}
)
data = response.json()
La misma lógica aplica si usas Python para procesar datos tributarios, construir reportes automáticos o alimentar un sistema de conciliación de IVA.
Para obtener tu API key y revisar los planes y precios disponibles, puedes registrarte directamente en BaseAPI.cl.
Estructura del JSON de respuesta
Uno de los principales beneficios de consumir el RCV via API es recibir los datos ya estructurados, sin necesidad de parsear CSVs con codificaciones problemáticas. A continuación un ejemplo representativo de cómo se ve un ítem del registro de compras en la respuesta de BaseAPI:
{
"periodo": "2026-02",
"tipo": "compras",
"documentos": [
{
"folio": "123456",
"tipo_dte": 33,
"fecha": "2026-02-14",
"rut_proveedor": "96874030-K",
"razon_social": "Proveedor Ejemplo SpA",
"monto_neto": 840000,
"iva": 159600,
"total": 999600,
"estado": "aceptado"
},
{
"folio": "789012",
"tipo_dte": 61,
"fecha": "2026-02-20",
"rut_proveedor": "77543210-8",
"razon_social": "Servicios Generales Ltda.",
"monto_neto": 200000,
"iva": 38000,
"total": 238000,
"estado": "aceptado"
}
],
"resumen": {
"total_documentos": 2,
"total_neto": 1040000,
"total_iva": 197600,
"total_monto": 1237600
}
}
Los campos clave que recibiras en cada documento son:
folio— Número de folio del documentotipo_dte— Código del tipo de DTE (33 es factura electrónica, 61 es nota de crédito, etc.). Puedes revisar la referencia completa en nuestra guía de tipos de DTE en Chilefecha— Fecha de emisión en formato ISO 8601rut_proveedor— RUT del emisor del documentorazon_social— Razón social del proveedor o clientemonto_neto— Base imponible en pesos chilenosiva— IVA del documento (19%)total— Monto total del documentoestado— Estado en el RCV (aceptado, reclamado, pendiente)
El objeto resumen al final del JSON agrega los totales del período, lo que simplifica la conciliación de IVA sin necesidad de iterar todos los documentos.
Manual vs. API: comparativa directa
| Criterio | Proceso Manual (Portal SII) | API RCV de BaseAPI |
|---|---|---|
| Tiempo por empresa por mes | 10 a 20 minutos | Segundos |
| Escalabilidad (multi-RUT) | No escala, lineal por empresa | Una llamada por RUT, paralelizable |
| Formato de salida | CSV con codificación ISO-8859-1 | JSON estructurado, UTF-8 |
| Disponibilidad | Depende del portal SII | 24/7, independiente del portal |
| Integración con sistemas | Requiere parseo manual | Directo a base de datos o sistema |
| Error handling | Visual (hay que detectarlo a ojo) | HTTP status codes estándar |
| Auditoría y logs | No disponible | Registro de cada llamada |
| Curva de aprendizaje | Baja (interfaz visual) | Media (requiere conocimiento de APIs) |
| Costo | Tiempo humano (alto para volumen) | Costo por llamada (bajo para volumen) |
Para un contador que maneja pocos clientes, el proceso manual puede ser suficiente. Para cualquier operación que supere los 5 contribuyentes o que necesite datos tributarios integrados en otro sistema, la API es el camino natural.
Casos de uso reales
Estudios contables y despachos tributarios
Un contador con 40 clientes que necesita cerrar el IVA de todos ellos cada mes enfrenta un problema de tiempo, no de conocimiento. Con la API, puede construir un script que recorra la lista de RUTs, solicite el RCV de compras y ventas por período, y consolide la información en una planilla o en su software contable. Lo que antes tomaba medio día, pasa a ejecutarse en minutos.
Nubox, una de las plataformas contables más usadas en Chile, documenta en su blog lo complejo que puede resultar el proceso de consulta manual del RCV para despachos que manejan múltiples contribuyentes. La automatización vía API resuelve exactamente ese punto de fricción.
ERP y sistemas de gestión empresarial
Las empresas que operan con sistemas ERP necesitan que la información tributaria fluya automáticamente hacia sus módulos de contabilidad, cuentas por pagar y conciliación bancaria. Integrar la API RCV permite que cada vez que se registra un proveedor o se contabiliza una factura, el sistema valide contra el RCV real del SII si el documento está aceptado o reclamado.
Fintech y plataformas de crédito
Las plataformas de crédito para empresas utilizan datos tributarios para evaluar la salud financiera de un solicitante. Acceder al historial de compras y ventas de los últimos 12 meses, de forma programática y con consentimiento del contribuyente, permite construir modelos de scoring crediticio mucho más precisos que los basados solo en información bancaria.
Conciliación automática de IVA
El proceso de conciliación de IVA compara el crédito fiscal de compras con el débito fiscal de ventas para determinar el IVA a pagar o devolver. Con los datos del RCV en formato JSON, puedes construir este cálculo en código con precisión, detectar diferencias, identificar documentos reclamados que afecten el crédito, y generar el borrador del Formulario 29. Puedes ver cómo conectar este flujo en nuestra guía sobre el Formulario 29 y declaración de IVA.
Automatización de documentos tributarios en general
El RCV es solo una pieza del ecosistema tributario del SII. Si ya estás integrando la descarga automática del RCV, el siguiente paso natural es automatizar otros documentos tributarios del SII como DTEs emitidos, BHEs y datos del contribuyente, todo desde una misma integración.
Consideraciones de seguridad y mejores prácticas
Dado que la API trabaja con credenciales SII del contribuyente, es fundamental manejar esos datos con cuidado. Algunas prácticas recomendadas:
No almacenes la clave SII en texto plano. Si necesitas persistirla para consultas recurrentes, usa un gestor de secretos (AWS Secrets Manager, HashiCorp Vault, o al menos variables de entorno cifradas).
Usa HTTPS en todas las llamadas. La API de BaseAPI solo acepta conexiones sobre TLS. Nunca transmitas credenciales sobre HTTP.
Implementa manejo de errores. Los códigos HTTP estándar indican qué salió mal: 401 si la clave SII es incorrecta, 404 si el período no tiene datos, 429 si superaste el límite de llamadas. Captura estos casos en tu código.
Genera una API key por entorno. Usa una key distinta para desarrollo, staging y producción. Así puedes revocar una sin afectar las otras.
Registra las llamadas. Mantén un log de qué RUT consultaste, qué período, cuándo y cuál fue el resultado. Esto es útil para auditorías internas y para detectar anomalías.
Cómo empezar con la API RCV de BaseAPI
El proceso para comenzar a usar la API es directo:
- Crea una cuenta en BaseAPI.cl
- Selecciona el plan que se ajuste a tu volumen de consultas en la página de planes y precios
- Genera una API key desde el panel de control
- Haz tu primera llamada de prueba con el sandbox (sin credenciales reales)
- Integra el endpoint en tu sistema usando los ejemplos de código de este artículo
La documentación técnica completa, incluyendo parámetros, códigos de respuesta y ejemplos adicionales, está disponible directamente en el panel de desarrollador.
Si necesitas más contexto sobre cómo funciona el RCV a nivel tributario antes de integrarlo, te recomendamos leer la guía completa del RCV en Chile, donde cubrimos los plazos de acuse de recibo, los tipos de documentos que aparecen en el registro y las diferencias entre el estado aceptado y el reclamado.
Preguntas frecuentes
¿La API funciona para cualquier tipo de contribuyente?
Sí, siempre que el contribuyente tenga RUT vigente y clave SII activa. Funciona para personas naturales, empresas individuales, SpA, SA, Ltda. y otros tipos societarios.
¿Puedo consultar períodos anteriores?
La API permite consultar períodos históricos disponibles en el SII. El RCV electrónico existe desde 2017, por lo que puedes consultar desde ese año en adelante según disponibilidad de datos en el portal oficial.
¿Qué pasa si el SII tiene mantenimiento?
La API retorna un error descriptivo cuando el portal del SII no está disponible. Se recomienda implementar reintentos con backoff exponencial para estos casos.
¿Puedo consultar compras y ventas en la misma llamada?
Actualmente el endpoint separa compras y ventas para mantener tiempos de respuesta razonables. Para obtener ambos, realiza dos llamadas cambiando el campo tipo. Ambas pueden ejecutarse en paralelo.
¿Los datos incluyen notas de crédito y débito?
Sí. El RCV incluye todos los tipos de DTE que el SII registra: facturas (33), facturas no afectas (34), liquidaciones (43), notas de débito (56), notas de crédito (61), entre otros.
¿Cómo manejo el caso de un contribuyente que aún no acepta ciertos documentos?
El campo estado en cada documento refleja el estado real en el SII: pendiente, aceptado o reclamado. Puedes filtrar en tu código según el estado que necesites para el proceso de conciliación.
Conclusión
Descargar el RCV del SII manualmente puede parecer un proceso sencillo cuando lo haces una vez. Cuando lo repites decenas de veces al mes, para múltiples contribuyentes, y necesitas integrar esos datos en otros sistemas, el proceso manual se convierte en un cuello de botella costoso en tiempo y propenso a errores humanos.
La API RCV de BaseAPI resuelve este problema entregando los datos del Registro de Compras y Ventas en formato JSON estructurado, con una sola llamada REST, sin depender de la disponibilidad del portal del SII ni del tiempo de un operador. El resultado: menos horas dedicadas a trabajo mecánico, mayor confiabilidad de los datos y la posibilidad real de construir procesos tributarios automatizados a escala.
Si manejas información tributaria de forma recurrente, ya sea como contador, desarrollador de sistemas, o empresa que necesita datos del SII en sus procesos internos, este es el momento de evaluar la automatización. Revisa los planes y precios disponibles y comienza con una prueba gratuita.
¿Listo para automatizar tu gestión tributaria?
Activa todos los endpoints gratis y descubre cómo integrar datos del SII en tu sistema.