SIIRCV

Consultar estado de solicitud asincrona de ventas

Consultar el estado de una descarga asincrona de ventas.

POST /api/v1/sii/rcv/ventas/async/estado/{emisor}/{periodo}/{solicitud_id}/{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/async/estado/76192083-9/202601/371028377/33",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Consultar el estado de una descarga asincrona de ventas.

Util para hacer polling antes de invocar /ventas/async/detalle/.... Cuando data.terminada != null, el archivo esta listo.

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

ParametroTipoRequeridoDescripcion
emisorstringSiRUT del emisor (validado modulo 11)
periodostringSiAAAAMM
solicitud_idstringSiid retornado por async/solicitar
dtestringSiCodigo tipo DTE

Respuesta exitosa (200)

{
    "data": {
        "id": 371028377,
        "uuid": "abc123def",
        "dte": 33,
        "estado": "TERMINADO",
        "creada": "2026-04-01 10:15:30",
        "terminada": "2026-04-01 10:18:45",
        "seccion": "VENTA",
        "registros": 1543
    }
}

estado refleja el caEstado literal del SII; cuando es "TERMINADO" el campo terminada se llena.

Errores especificos

Codigoerror_codeCausaResolucion
400AUTH_ERRORCredenciales SII incorrectasRevisar RUT/clave
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 error o sin itemsReintentar
503SII_UNAVAILABLESII en mantenimientoReintentar 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í
solicitud_id
string · path
`id` retornado por `async/solicitar`
Sí
ambiente
string · query
`0` produccion, `1` certificacion
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
404Solicitud no encontrada
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"
  }
}

Previous

Paso 3: Obtener detalle de descarga asincrona de ventas

Next

Paso 1: Solicitar descarga asincrona de ventas

On this page