RCV (Compras y Ventas)

2 endpoints disponibles · Base URL: https://api.baseapi.cl

POST/api/v1/sii/rcv/anual/{year}/{tipo}

Consultar RCV de un año completo

Descarga el Registro de Compras y Ventas (RCV) de los 12 meses de un año.

Realiza 12 consultas secuenciales al SII (una por mes) con una sola autenticación. Si algún mes falla, los demás meses se siguen descargando y el resultado indica el estado de cada mes individualmente.

Tiempo estimado: ~1-3 minutos (depende de la cantidad de documentos por mes)

Estructura de respuesta:

resumen: Totales agregados del año
meses: Array de 12 objetos, cada uno con status (success/empty/error) y datos

Sobre boletas electrónicas (39/41) y comprobantes de pago (48): El campo datos de cada mes no incluye estos tipos. Sí aparecen en resumenPorTipo con totales agregados por mes (cantidad y montos), sin detalle individual.

Parámetros de ruta

Nombre	Tipo	Ejemplo	Descripción
`{year}`	`string`	2024	Año a consultar (4 dígitos)
`{tipo}`	`string`	compra	Tipo de registro: compra (documentos recibidos) o venta (documentos emitidos)

Request body · SiiCredentialsDto

Campo	Tipo	Requerido	Descripción
`rut`	`string`	Sí	RUT del contribuyente con dígito verificador
`password`	`string`	Sí	Clave del SII del contribuyente

Respuesta 200 · RCV anual descargado exitosamente

Campo	Tipo	Requerido	Descripción
`success`	`boolean`	No	—
`data`	`object`	No	—

Ejemplo

curl -X POST 'https://api.baseapi.cl/api/v1/sii/rcv/anual/2024/compra' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII"
  }'

POST/api/v1/sii/rcv/{periodo}/{tipo}

Consultar Registro de Compras y Ventas (RCV)

Descarga el Registro de Compras y Ventas (RCV) de un período específico.

¿Qué es el RCV? El Registro de Compras y Ventas es el libro electrónico obligatorio donde se registran todas las operaciones de compra y venta con documentos tributarios electrónicos (DTE).

Datos incluidos por documento:

Tipo de documento (factura, boleta, nota de crédito, etc.)
Folio y fecha de emisión
RUT y razón social del emisor/receptor
Montos (neto, IVA, total)
Estado del documento

Tipos de registro:

compra: Documentos recibidos (facturas de proveedores)
venta: Documentos emitidos (facturas a clientes)

Sobre boletas electrónicas (39/41) y comprobantes de pago (48): El campo datos contiene el detalle individual de facturas, notas de crédito/débito y guías de despacho, pero no incluye boletas electrónicas (tipo 39/41) ni comprobantes de pago electrónico (tipo 48). Estos tipos sí aparecen en el campo resumenPorTipo con totales agregados (cantidad y montos), pero sin detalle por documento individual.

Tiempo estimado: ~5-15 segundos (depende de la cantidad de documentos)

Límites: El SII puede limitar consultas muy frecuentes al mismo período.

Parámetros de ruta

Nombre	Tipo	Ejemplo	Descripción
`{periodo}`	`string`	2025-01	Período a consultar en formato YYYY-MM
`{tipo}`	`string`	compra	Tipo de registro: compra (documentos recibidos) o venta (documentos emitidos)

Request body · SiiCredentialsDto

Campo	Tipo	Requerido	Descripción
`rut`	`string`	Sí	RUT del contribuyente con dígito verificador
`password`	`string`	Sí	Clave del SII del contribuyente

Respuesta 200 · RCV descargado exitosamente. Si no hay datos, retorna `data: [], message, documentos: []`.

Campo	Tipo	Requerido	Descripción
`success`	`boolean`	No	—
`data`	`object`	No	Con datos: {totalRegistros, datos, resumenPorTipo}. Sin datos: {data: [], message, documentos: []}

Ejemplo

curl -X POST 'https://api.baseapi.cl/api/v1/sii/rcv/2025-01/compra' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "rut": "12345678-5",
    "password": "miClaveSII"
  }'

¿Listo para integrar?

Crea tu cuenta gratis y obtén tu API Key en menos de un minuto.

Empezar gratis →

Nombre

Tipo

{year}

string

{tipo}

string

Campo

Tipo

rut

string

password

string

Campo

Tipo

success

boolean

data

object

curl -X POST 'https://api.baseapi.cl/api/v1/sii/rcv/anual/2024/compra' \ -H 'x-api-key: TU_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "rut": "12345678-5", "password": "miClaveSII" }'

Nombre

Tipo

{periodo}

string

{tipo}

string

Campo

Tipo

rut

string

password

string

Campo

Tipo

success

boolean

data

object

curl -X POST 'https://api.baseapi.cl/api/v1/sii/rcv/2025-01/compra' \ -H 'x-api-key: TU_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "rut": "12345678-5", "password": "miClaveSII" }'