Obtener detalle de ventas del RCV

POST/api/v1/sii/rcv/ventas/detalle/{emisor}/{periodo}/{dte}v1 · ESTABLE

POST /api/v1/sii/rcv/ventas/detalle/{emisor}/{periodo}/{dte}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/rcv/ventas/detalle/76192083-9/202601/33",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Obtener detalle de ventas del RCV por tipo DTE.

Retorna el listado detallado (documento a documento) de ventas del contribuyente target, filtrado por tipo DTE. 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.

Autenticacion requerida: API token en header X-API-Token con scope sii:read

credenciales SII PassAuth del emisor.

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`
`dte`	string	Si	Codigo tipo DTE

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion
`formato`	string	`json`	`json` o `csv` (passthrough text/csv)
`tipo`	string	`rcv`	`rcv` (JSON detallado) o `rcv_csv` (CSV en JSON wrapper)

Respuesta exitosa (200, formato=json + tipo=rcv)

RCVGetDetalleResponse con data: list[RCVDetalleItem] (~67 campos 1:1 con el SII por cada documento).

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
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

dte

string · path

Codigo tipo DTE

Sí

emisor

string · path

RUT del emisor de las ventas

Sí

periodo

string · path

Periodo `AAAAMM`

Sí

ambiente

string · query

`0` produccion, `1` certificacion

csv_delimiter

string · query

Reservado

formato

string · query

`json` (default) o `csv`

tipo

string · query

`rcv` (default, JSON detallado) o `rcv_csv` (lineas del CSV)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Detalle de ventas del RCV. Por defecto retorna JSON (`RCVGetDetalleResponse`) con los items detallados. Con `formato=csv` retorna el CSV passthrough del SII (`text/csv; charset=ISO-8859-1`).

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

Obtener detalle de ventas del RCV

Parametros de ruta

Parametros de consulta

Respuesta exitosa (200, formato=json + tipo=rcv)

Errores especificos

Parámetros

Cuerpo de la solicitud

Respuestas

On this page