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}
import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/rcv/ventas/resumen/76192083-9/202601",
    headers=headers,
)
response.raise_for_status()
print(response.json())

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

ParametroTipoRequeridoDescripcion
emisorstringSiRUT del emisor (validado modulo 11)
periodostringSiAAAAMM

Parametros de consulta

ParametroTipoDefaultDescripcion
ambientestring00 produccion, 1 certificacion
formatostringjsonReservado (siempre JSON del SII)
csv_delimiterstring;Reservado

Respuesta exitosa (200)

Objeto RCVGetResumenResponse:

  • data: lista de RCVResumenItem (1 item por tipo de documento; null cuando 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 usar POST /ventas/detalle/{emisor}/{periodo}/{dte}.
  • totDocRes: total de documentos en todos los resumenes (suma de data[].rsmnTotDoc). null cuando no hay registros.
  • respEstado: codRespuesta / msgeRespuesta / codError del SII. codRespuesta=0 con datos, =3 periodo sin datos.
  • mensaje: aparece SOLO cuando el SII no envia texto en respEstado.msgeRespuesta ni codError y se extrae del bundle Angular del SPA del SII (caso tipico: periodo sin datos con codRespuesta=3). Si respEstado ya trae texto, este campo se omite para evitar duplicacion.

Errores especificos

Codigoerror_codeCausaResolucion
400AUTH_ERRORCredenciales SII incorrectasRevisar RUT/clave
400VALIDATION_ERRORPeriodo con formato invalidoUsar AAAAMM
401HTTP_401API token ausente o invalidoEnviar X-API-Token valido
400VALIDATION_ERRORRUT del path con DV invalido (modulo 11)Usar un RUT chileno valido
429SII_RATE_LIMIT / QUOTA_EXCEEDEDRate limitRespetar Retry-After
502SII_GATEWAY_ERRORSII retorno errorReintentar
503SII_UNAVAILABLESII en mantenimientoReintentar en 5 min

Parámetros

Header / Body
Tipo
Descripción
Requerido
emisor
string · path
RUT del emisor de las ventas
periodo
string · path
Periodo `AAAAMM`
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.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  }
}

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.

{}

On this page