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

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

ParametroTipoRequeridoDescripcion
receptorstringSiRUT del receptor (contribuyente a consultar)
periodostringSiAAAAMM (ej: 202601)
estadostringSiREGISTRO / PENDIENTE / NO_INCLUIR / RECLAMADO

Parametros de consulta

ParametroTipoDefaultDescripcion
ambientestring00 produccion, 1 certificacion
formatostringjsonjson (default) o csv
csv_delimiterstring;Delimitador cuando formato=csv

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 /compras/detalle/{receptor}/{periodo}/{dte}/{estado}.
  • 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/estado con formato invalidoUsar valores validos
401HTTP_401API token ausente o invalidoEnviar X-API-Token valido
429SII_RATE_LIMIT / QUOTA_EXCEEDEDRate limitRespetar Retry-After
502SII_GATEWAY_ERRORSII retorno error HTTP no 2xxReintentar
503SII_UNAVAILABLESII en mantenimientoReintentar en 5 min

Parámetros

Header / Body
Tipo
Descripción
Requerido
estado
string · path
Estado: `REGISTRO`, `PENDIENTE`, `NO_INCLUIR`, `RECLAMADO`
periodo
string · path
Periodo `AAAAMM`
receptor
string · path
RUT del receptor
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.

{
  "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