SIIBTE
Obtener HTML de BTE emitida
Obtener representacion HTML de una BTE emitida.
POST
/api/v1/sii/bte/emitidas/html/{codigo}v1 · ESTABLEPOST /api/v1/sii/bte/emitidas/html/{codigo}
Obtener representacion HTML de una BTE emitida.
Devuelve la representacion HTML impresa (misma vista que el SII entrega
en su portal) de la boleta identificada por codigo. El RUT emisor se
deriva de las credenciales auth, nunca del path.
Autenticacion requerida: API token en header X-API-Token con scope sii:read
- credenciales SII del emisor en el body.
Quota: Consume 1 consulta | Peso: 2x
Parametros de ruta
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
codigo | string | Si | Codigo unico del documento BTE (del listado emitidas) |
Body (JSON)
Respuesta exitosa (200)
Retorna HTML raw del SII con Content-Type: text/html. No es JSON.
Ejemplo en Python:
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 |
| 404 | HTTP_404 | Codigo BTE no existe en el SII | Verificar con /emitidas/documentos |
| 422 | VALIDATION_ERROR | Body con formato invalido | Revisar errors[] |
| 429 | SII_RATE_LIMIT / QUOTA_EXCEEDED | Rate limit | Respetar Retry-After |
| 502 | SII_GATEWAY_ERROR | SII no pudo generar el HTML | Reintentar |
| 503 | SII_UNAVAILABLE | SII en mantenimiento | Reintentar en 5 min |
Notas
- El HTML es generado on-demand por el SII; puede tardar 2-5 seg.
- Solo descarga BTE propias (emitidas bajo el RUT autenticado).
- Para version imprimible en PDF, renderizar el HTML con una libreria como
weasyprint.
Parámetros
Header / Body
Tipo
Descripción
Requerido
codigo
string · path
Codigo unico del documento BTE (obtenido de `/emitidas/documentos`)
Sí
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200HTML del documento BTE
400Codigo invalido o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `sii:read` o cuenta bloqueada
404BTE no encontrada
422Body con formato invalido
429Limite de tasa excedido
502Error en servicio SII upstream
503SII en mantenimiento
Ejemplo de respuesta
Código 200.