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}
import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/bte/emitidas/receptor-tasa/12345678-9?periodo=202601",
    headers=headers,
)
response.raise_for_status()
print(response.json())

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

ParametroTipoRequeridoDescripcion
receptorstringSiRUT del receptor con formato XXXXXXXX-K

Parametros de consulta

ParametroTipoDefaultDescripcion
periodostringmes actualYYYYMM de consulta

Body (JSON)

{
    "auth": {
        "pass": {"rut": "76.XXX.XXX-K", "clave": "clave_tributaria"}
    }
}

Respuesta exitosa (200)

{
    "periodo": 202601,
    "tasa_base": 13.75,
    "tasa_receptor": 13.75
}

Errores especificos

Codigoerror_codeCausaResolucion
400AUTH_ERRORCredenciales SII incorrectasRevisar RUT/clave
400VALIDATION_ERRORFormato RUT receptor invalidoUsar XXXXXXXX-K
401HTTP_401API token ausente o invalidoEnviar X-API-Token valido
422VALIDATION_ERRORBody con formato invalidoRevisar errors[]
429SII_RATE_LIMIT / QUOTA_EXCEEDEDRate limitRespetar Retry-After
502SII_GATEWAY_ERRORSII retorno errorReintentar
503SII_UNAVAILABLESII en mantenimientoReintentar 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`
periodo
string | null · query
Periodo `YYYYMM` (opcional, default: mes actual)
No

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  }
}

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.

{
  "periodo": 0,
  "tasa_base": 0,
  "tasa_receptor": 0
}

On this page