SIIRCV
Obtener resumen de compras del RCV
Obtener resumen de compras del RCV para un periodo y estado.
POST
/api/v1/sii/rcv/compras/resumen/{receptor}/{periodo}/{estado}v1 · ESTABLEPOST /api/v1/sii/rcv/compras/resumen/{receptor}/{periodo}/{estado}
Obtener resumen de compras del RCV para un periodo y estado.
Consulta el resumen agregado del Registro de Compras del contribuyente
y transmite la respuesta integra del SII (data, respEstado y
demas campos auxiliares). El backend no interpreta codRespuesta —
el cliente decide que hacer con cada codigo devuelto.
Autenticacion requerida: API token en header X-API-Token con scope sii:read.
Quota: Consume 1 consulta | Peso: 2x
Parametros de ruta
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
receptor | string | Si | RUT del receptor (contribuyente a consultar) |
periodo | string | Si | AAAAMM (ej: 202601) |
estado | string | Si | REGISTRO / PENDIENTE / NO_INCLUIR / RECLAMADO |
Parametros de consulta
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
ambiente | string | 0 | 0 produccion, 1 certificacion |
formato | string | json | json (default) o csv |
csv_delimiter | string | ; | Delimitador cuando formato=csv |
Respuesta exitosa (200)
Objeto RCVGetResumenResponse:
data: lista deRCVResumenItem(1 item por tipo de documento;nullcuando el periodo no tiene registros). El SII agrupa los documentos por tipo y devuelve un resumen agregado por cada uno. Para ver los documentos individuales usarPOST /compras/detalle/{receptor}/{periodo}/{dte}/{estado}.totDocRes: total de documentos en todos los resumenes (suma dedata[].rsmnTotDoc).nullcuando no hay registros.respEstado:codRespuesta/msgeRespuesta/codErrordel SII.codRespuesta=0con datos,=3periodo sin datos.mensaje: aparece SOLO cuando el SII no envia texto enrespEstado.msgeRespuestanicodErrory se extrae del bundle Angular del SPA del SII (caso tipico: periodo sin datos concodRespuesta=3). SirespEstadoya trae texto, este campo se omite para evitar duplicacion.
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | AUTH_ERROR | Credenciales SII incorrectas | Revisar RUT/clave |
| 400 | VALIDATION_ERROR | Periodo/estado con formato invalido | Usar valores validos |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 429 | SII_RATE_LIMIT / QUOTA_EXCEEDED | Rate limit | Respetar Retry-After |
| 502 | SII_GATEWAY_ERROR | SII retorno error HTTP no 2xx | Reintentar |
| 503 | SII_UNAVAILABLE | SII en mantenimiento | Reintentar en 5 min |
Parámetros
Header / Body
Tipo
Descripción
Requerido
estado
string · path
Estado: `REGISTRO`, `PENDIENTE`, `NO_INCLUIR`, `RECLAMADO`
Sí
periodo
string · path
Periodo `AAAAMM`
Sí
receptor
string · path
RUT del receptor
Sí
ambiente
string · query
`0` produccion, `1` certificacion
No
csv_delimiter
string · query
Delimitador CSV cuando `formato=csv`
No
formato
string · query
`json` (default) o `csv`
No
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200Successful Response
400Parametros invalidos o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `sii:read` o cuenta bloqueada
422Body con formato invalido
429Limite de tasa excedido
502Error en servicio SII upstream
503SII en mantenimiento
Forma de la respuesta
Código 200. Estructura del JSON devuelto.