Obtener token de autenticacion del SII

POST/api/v1/vendemas/auth/tokenv1 · ESTABLE

POST /api/v1/vendemas/auth/token

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/vendemas/auth/token",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Obtener token de autenticacion del SII usando certificado digital.

Ejecuta el flujo SOAP completo del SII (semilla -> firma -> token) con cache temporal y locks distribuidos. Util para operaciones que requieren token SII previo (descarga de archivos, envio de XML).

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

certificado digital en auth.cert (PFX o PEM).

Quota: Consume 1 consulta | Peso: 2x

Parametros de consulta

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

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.cert.pfx-data` + `auth.cert.passphrase`	string	Si*	PKCS#12 en base64 + clave
`auth.cert.cert-data` + `auth.cert.pkey-data`	string	Si*	Alternativa PEM base64

*Usar PFX o PEM, no ambos.

Respuesta exitosa (200)

{
    "token": "TOKEN_SII",
    "rut": "76.XXX.XXX-K",
    "fingerprint": "AB:CD:...",
    "environment": "certificacion",
    "expires_at": "2026-02-22T20:00:00"
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	Datos de certificado faltantes	Enviar `pfx-data` o `cert-data + pkey-data`
400	`AUTH_ERROR`	Certificado invalido o passphrase incorrecta	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`VENDEMAS_ERROR`	SII rechazo la autenticacion	Revisar certificado
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min