Paso 1: Solicitar descarga asincrona de compras

POST/api/v1/sii/rcv/compras/async/solicitar/{receptor}/{periodo}/{dte}/{estado}v1 · ESTABLE

POST /api/v1/sii/rcv/compras/async/solicitar/{receptor}/{periodo}/{dte}/{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/async/solicitar/76192083-9/202601/33/REGISTRO",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Iniciar una descarga asincrona de compras del RCV.

Para periodos con gran volumen de documentos, el SII ofrece un flujo asincrono en 3 pasos: solicitar -> estado -> detalle. Este endpoint inicia el control y devuelve el id y uuid necesarios para los siguientes pasos.

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

credenciales SII PassAuth del receptor.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`receptor`	string	Si	RUT del receptor (validado modulo 11)
`periodo`	string	Si	`AAAAMM`
`dte`	string	Si	Codigo tipo DTE
`estado`	string	Si	`REGISTRO` / `PENDIENTE` / `NO_INCLUIR` / `RECLAMADO`

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion

Respuesta exitosa (200)

{
    "data": {
        "id": 371028377,
        "uuid": "SIN-BLOB",
        "dte": 33,
        "estado": "REGISTRO",
        "creada": "2026-04-01 10:15:30",
        "terminada": null,
        "seccion": "COMPRA",
        "registros": 0
    }
}

El campo terminada arranca en null y se llena cuando el SII genera el archivo. Hacer polling con /compras/async/estado/... hasta que terminada != null, recien entonces invocar /compras/async/detalle/....

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 o sin items	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Notas

Solicitar dos veces consecutivas con los mismos parametros retorna el mismo control (upsert idempotente del SII).
El id devuelto se pasa como {solicitud_id} en estado y detalle.

Parámetros

Header / Body

Tipo

Descripción

Requerido

dte

string · path

Codigo tipo DTE

Sí

estado

string · path

Estado del documento

Sí

periodo

string · path

Periodo `AAAAMM`

Sí

receptor

string · path

RUT del receptor

Sí

ambiente

string · query

`0` produccion, `1` certificacion

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.

{
  "data": {
    "creada": "string",
    "dte": 0,
    "estado": "string",
    "id": 0,
    "registros": 0,
    "seccion": "string",
    "terminada": "string",
    "uuid": "string"
  }
}

Paso 1: Solicitar descarga asincrona de compras

On this page