Skip to main content
GET
Estado del enrolamiento

Que hace

  • Devuelve el estado del enrolamiento iniciado con POST /credentials
  • Entrega la credencial cuando el SII ya validó la clave
  • Distingue una clave rechazada por el SII de una falla temporal reintentable

Por que existe

El login contra el SII se hace con un navegador real, fuera del request HTTP. Por eso POST /credentials no puede devolver la credencial: responde 202 con un enrollment_id y este endpoint entrega el resultado cuando está listo.

Estados

Cuanto tarda

El login demora del orden de 15 segundos. Consultar cada 2-3 segundos es suficiente; no es necesario consultar más seguido.

Ejemplo

Authorizations

Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Path Parameters

enrollment_id
string
required

Identificador devuelto por POST /credentials

Response

Estado del enrolamiento

enrollment_id
string

Identificador del enrolamiento

Example:

"cenr_3940730445066399260"

status
enum<string>

pending: el login sigue en curso. valid: la credencial quedó enrolada. invalid: el SII rechazó la clave. error: no se pudo preguntarle al SII (reintentable).

Available options:
pending,
valid,
invalid,
error
Example:

"pending"

user_rut
string

RUT de la credencial que se está enrolando

Example:

"12345678-9"

error
string | null

Mensaje del SII cuando status es invalid o error

Example:

null

credential
object | null

La credencial creada; sólo viene cuando status es valid

ws_channel
string

Canal WebSocket con el avance en vivo (lo usa el frontend)

Example:

"cred-validation-129816"

created_at
string<date-time>
finished_at
string<date-time> | null