SIIBTE
Obtener tasa de retencion aplicada a un receptor
Obtener tasa de retencion aplicada a un receptor para BTE.
POST
/api/v1/sii/bte/emitidas/receptor-tasa/{receptor}v1 · ESTABLEPOST /api/v1/sii/bte/emitidas/receptor-tasa/{receptor}
Obtener tasa de retencion aplicada a un receptor para BTE.
Ejecuta los pasos 1 y 2 del flujo de emision BTE en el SII sin emitir el documento. El SII calcula la tasa del impuesto (TASA_IMP) en el paso 2 al recibir el RUT del receptor. Util para previsualizar montos antes de emitir.
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 |
|---|---|---|---|
receptor | string | Si | RUT del receptor con formato XXXXXXXX-K |
Parametros de consulta
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
periodo | string | mes actual | YYYYMM de consulta |
Body (JSON)
Respuesta exitosa (200)
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | AUTH_ERROR | Credenciales SII incorrectas | Revisar RUT/clave |
| 400 | VALIDATION_ERROR | Formato RUT receptor invalido | Usar XXXXXXXX-K |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 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 retorno error | Reintentar |
| 503 | SII_UNAVAILABLE | SII en mantenimiento | Reintentar en 5 min |
Notas
- La tasa base es la tasa general para BTE; la tasa del receptor puede diferir si el SII aplica excepciones.
- No emite la BTE — solo consulta la tasa. Para emitir usar
POST /emitidas/emitir.
Parámetros
Header / Body
Tipo
Descripción
Requerido
receptor
string · path
RUT del receptor con formato `XXXXXXXX-K`
Sí
periodo
string | null · query
Periodo `YYYYMM` (opcional, default: mes actual)
No
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200Successful Response
400RUT receptor invalido o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `sii:read` o cuenta bloqueada
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.