SIIRCV
Obtener resumen de ventas del RCV
Obtener resumen de ventas del RCV para un periodo.
POST
/api/v1/sii/rcv/ventas/resumen/{emisor}/{periodo}v1 · ESTABLEPOST /api/v1/sii/rcv/ventas/resumen/{emisor}/{periodo}
Obtener resumen de ventas del RCV para un periodo.
Consulta el resumen agregado del Registro de Ventas del contribuyente
target. El RUT del emisor (path) se valida sintacticamente (modulo 11)
y se pasa al SII tal cual; la sesion (auth.pass) debe estar
autorizada para operar sobre ese RUT (rol de representante o el RUT
propio del login) — el SII rechaza si no lo esta. El campo mensaje
reproduce el texto oficial que el SII muestra cuando el periodo no
tiene registros.
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 |
|---|---|---|---|
emisor | string | Si | RUT del emisor (validado modulo 11) |
periodo | string | Si | AAAAMM |
Parametros de consulta
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
ambiente | string | 0 | 0 produccion, 1 certificacion |
formato | string | json | Reservado (siempre JSON del SII) |
csv_delimiter | string | ; | Reservado |
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 /ventas/detalle/{emisor}/{periodo}/{dte}.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 con formato invalido | Usar AAAAMM |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 400 | VALIDATION_ERROR | RUT del path con DV invalido (modulo 11) | Usar un RUT chileno valido |
| 429 | SII_RATE_LIMIT / QUOTA_EXCEEDED | Rate limit | Respetar Retry-After |
| 502 | SII_GATEWAY_ERROR | SII retorno error | Reintentar |
| 503 | SII_UNAVAILABLE | SII en mantenimiento | Reintentar en 5 min |
Parámetros
Header / Body
Tipo
Descripción
Requerido
emisor
string · path
RUT del emisor de las ventas
Sí
periodo
string · path
Periodo `AAAAMM`
Sí
ambiente
string · query
`0` produccion, `1` certificacion
No
csv_delimiter
string · query
Reservado: no aplica al response JSON-RPC
No
formato
string · query
Reservado: el SII responde JSON unicamente
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.