SIIBTE
Obtener HTML de BTE recibida
Obtener representacion HTML de una BTE recibida.
POST
/api/v1/sii/bte/recibidas/html/{codigo}v1 · ESTABLEPOST /api/v1/sii/bte/recibidas/html/{codigo}
Obtener representacion HTML de una BTE recibida.
Devuelve la representacion HTML impresa de la boleta de terceros
recibida por el contribuyente autenticado. El RUT receptor 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 receptor 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 recibidas) |
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 /recibidas/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
- Solo descarga BTE recibidas por el RUT autenticado.
- El HTML es generado on-demand por el SII; puede tardar 2-5 seg.
- Para version imprimible en PDF, renderizar con
weasyprintu otra libreria.
Parámetros
Header / Body
Tipo
Descripción
Requerido
codigo
string · path
Codigo unico del documento BTE (obtenido de `/recibidas/documentos`)
Sí
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200HTML del documento BTE recibido
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.