Buscar tasacion vehicular SII

POST/api/v1/sii/vehiculos/tasacion/buscarv1 · ESTABLE

POST /api/v1/sii/vehiculos/tasacion/buscar

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

Buscar tasacion vehicular del SII.

Consulta la tasacion fiscal y el valor del permiso de circulacion que el SII asigna a un vehiculo para un año fiscal dado. Los montos son los valores oficiales del SII (pass-through, sin recalculo local) — apropiados para auditoria financiera y calculo de impuestos.

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

Quota: Consume 1 consulta | Peso: 2x (operacion pesada por resolucion CAPTCHA)

Flujo recomendado

Descubrir IDs validos con GET /categorias/tipos/{categoria} y GET /categorias/marcas/{categoria}.
Enviar POST con esos IDs + filtros opcionales.
Si hay mas resultados, navegar con page y pageSize usando pagina_sig_codigo del response.

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`anioTasa`	integer	Si	Año fiscal de la tasacion (no de fabricacion)
`categoria`	integer	Si	`1`=Livianos, `2`=Pesados, `3`=Motos
`tipo`	integer	No	ID tipo obtenido de `/categorias/tipos/{categoria}`
`marca`	integer	No	ID marca obtenido de `/categorias/marcas/{categoria}`
`modelo`	string	No	Substring match (p.ej. `VITARA` retorna tambien `GRAND VITARA`)
`version`	string	No	Substring match
`anio`	integer	No	Año de fabricacion del vehiculo
`page`	integer	No	Pagina (default: 1)
`pageSize`	integer	No	Items por pagina (default: 25)

Respuesta exitosa (200)

Envelope SiiListResponse[VehiculoTasacionItem]:

{
    "success": true,
    "data": [
        {
            "codigoSii": "K9999",
            "marca": "SUZUKI",
            "modelo": "VITARA",
            "version": "1.6 GL 5MT 4X4",
            "anioFabricacion": 2020,
            "tasacion": 8450000,
            "permisoCirculacion": 126750
        }
    ],
    "total": 1,
    "paginacion": {
        "pagina_actual": 1,
        "por_pagina": 25,
        "total_paginas": 1,
        "tiene_siguiente": false,
        "tiene_anterior": false
    }
}

Clarificacion `anioTasa` vs `anio`

anioTasa: año fiscal que define los montos de tasacion y permiso. Los valores varian por año.
anio: año de fabricacion del vehiculo (filtro de busqueda).

Para replicar los valores visibles en la web del SII, enviar el año en curso como anioTasa.

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	`ValueError` del service (IDs inexistentes, etc.)	Revisar `message`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
422	`VALIDATION_ERROR`	Campos del body rechazados (campos faltantes, tipos)	Revisar `errors[]`
429	`QUOTA_EXCEEDED` / `SII_RATE_LIMIT`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII retorno error o CAPTCHA no resuelto	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min
504	`SII_TIMEOUT`	CAPTCHA server-side tardo demasiado	Reintentar

Notas

Resuelve CAPTCHA server-side de forma transparente al cliente.
Latencia tipica: 1-3 segundos; peor caso ~30s si hay reintentos de CAPTCHA.
Peso 2x en cuota por el costo computacional del CAPTCHA.

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "anio": 0,
  "anioTasa": 0,
  "categoria": 0,
  "marca": 0,
  "modelo": "string",
  "page": 0,
  "pageSize": 0,
  "tipo": 0,
  "version": "string"
}

Respuestas

200Successful Response

400Parametros invalidos (ValueError del service)

401API token ausente o invalido

403Sin permisos o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

504Timeout hacia SII (CAPTCHA lento)

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": [
    {
      "anio_fabricacion": 0,
      "anio_tasacion": 0,
      "categoria": {
        "id": 0,
        "name": "string"
      },
      "codigo_sii": "string",
      "id": 0,
      "marca": "<circular: #/components/schemas/VehiculoReferenciaNominal>",
      "modelo": "string",
      "monto_permiso_circulacion": 0,
      "monto_tasacion": 0,
      "tipo": "<circular: #/components/schemas/VehiculoReferenciaNominal>",
      "version": "string"
    }
  ],
  "message": "string",
  "n_boletas": 0,
  "pagina_sig_codigo": "string",
  "paginacion": {
    "pagina_actual": 0,
    "pagina_sig_codigo": "string",
    "pagina_siguiente": 0,
    "total_registros": 0
  },
  "success": true,
  "total": 0
}

On this page