sii.declaraciones_juradas.consultar
Declaraciones juradas presentadas por el contribuyente.
Lectura Credencial SII Ver ficha en JSON
Antes de usarla
- Dos claves inválidas seguidas bloquean la credencial en Floid por 1 hora. Ante INVALID_CREDENTIALS o CLAVE_INVALIDA no reintentes con la misma clave.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
| rut | texto | RUT del contribuyente que inicia sesión, con guion. |
| clave solo REST | texto | Clave tributaria o Clave Única, según tipo_login. |
| tipo_login | texto |
Cómo se entra al SII. Por defecto: sii (clave tributaria).
Valores: sii clave_unica certificado |
| certificado solo REST | texto | Certificado digital en base64 (.pfx), si tipo_login es certificado. |
| clave_certificado solo REST | texto | Clave del certificado digital. |
| credencial_token | texto | Token de credencial guardada en Floid (por ejemplo, el que entrega el widget). Reemplaza rut y clave. |
| anio requerido | entero | Año tributario. |
| codigo_dj requerido | texto | Código de la declaración jurada (1835, 1837, 1847, 1879, 1887, 1926, 1929, 1946...). |
| caseid | texto | Identificador del caso. Para pedir otra página de un resultado ya obtenido, repite el caseid de la primera respuesta. |
Credenciales del titular: credencial_token (la única opción por MCP) o sus datos de acceso solo por REST desde tu backend.
Cómo funcionan las credenciales.
Ejemplo
Con los datos de prueba del sandbox. En producción, quita /sandbox de la URL.
Argumentos de la herramienta MCP ejecutar
{
"herramienta": "sii.declaraciones_juradas.consultar",
"parametros": {
"credencial_token": "<credencial_token>",
"anio": 2024,
"codigo_dj": "1879"
}
}
Terminal
curl https://mcp.floid.app/sandbox/v1/ejecutar \
-H "Authorization: Bearer $FLOID_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"herramienta": "sii.declaraciones_juradas.consultar",
"parametros": {
"rut": "11111111-1",
"clave": "1234",
"anio": 2024,
"codigo_dj": "1879"
}
}'
Python
import os
import httpx
respuesta = httpx.post(
"https://mcp.floid.app/sandbox/v1/ejecutar",
headers={"Authorization": f"Bearer {os.environ['FLOID_TOKEN']}"},
json={'herramienta': 'sii.declaraciones_juradas.consultar',
'parametros': {'rut': '11111111-1',
'clave': '1234',
'anio': 2024,
'codigo_dj': '1879'}},
timeout=300,
)
print(respuesta.json())
Respuesta
Respuesta del sandbox de Floid normalizada por la capa, recortada a dos elementos por lista.
{
"data": {
"idDJ": "1879",
"nombre": "Registro Anual de Boletas de Honorarios Electrónicas o Retenciones de honorarios",
"periodoTributario": "2025",
"DJ_data": [
{
"rut_receptor_renta": "11111111-1",
"monto_total_renta": 579709,
"numero_certificado": 1,
"monto_anual_honorarios": [
{
"tipo": "art42",
"tasa": "13.75%",
"monto": 79710
},
{
"tipo": "art48",
"tasa": "10%",
"monto": 0
}
],
"periodos_renta": {
"enero": false,
"febrero": false,
"marzo": false,
"abril": false,
"mayo": false,
"junio": false,
"julio": false,
"agosto": false,
"septiembre": false,
"octubre": false,
"noviembre": false,
"diciembre": true
},
"estado": "No Observada"
},
{
"rut_receptor_renta": "22222222-2",
"monto_total_renta": 8749396,
"numero_certificado": 2,
"monto_anual_honorarios": [
{
"tipo": "art42",
"tasa": "13.75%",
"monto": 1203042
},
{
"tipo": "art48",
"tasa": "10%",
"monto": 0
}
],
"periodos_renta": {
"enero": false,
"febrero": false,
"marzo": false,
"abril": false,
"mayo": false,
"junio": false,
"julio": false,
"agosto": false,
"septiembre": false,
"octubre": true,
"noviembre": true,
"diciembre": false
},
"estado": "No Observada"
}
]
},
"meta": {
"herramienta": "sii.declaraciones_juradas.consultar",
"caseid": "87c68b70-b104-4790-a4d7-03396182c28a"
}
}