sii.carpeta_tributaria_personalizada.consultar
Carpeta tributaria con las secciones que se elijan.
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. |
| representante_legal | booleano | Incluye la sección representante legal. |
| conformacion_de_la_sociedad | booleano | Incluye la sección conformacion de la sociedad. |
| participacion_en_sociedades | booleano | Incluye la sección participacion en sociedades. |
| sucursales | booleano | Incluye la sección sucursales. |
| ultimos_documentos_tributarios_autorizados | booleano | Incluye la sección ultimos documentos tributarios autorizados. |
| observaciones_tributarias | booleano | Incluye la sección observaciones tributarias. |
| bienes_raices | booleano | Incluye la sección bienes raices. |
| boletas_de_honorarios_electronicas | booleano | Incluye la sección boletas de honorarios electronicas. |
| f29 | entero |
Meses de F29 a incluir.
Valores: 6 12 24 36 |
| f22 | entero |
Cantidad de F22 a incluir.
Valores: 1 2 3 4 |
| 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.carpeta_tributaria_personalizada.consultar",
"parametros": {
"credencial_token": "<credencial_token>"
}
}
Terminal
curl https://mcp.floid.app/sandbox/v1/ejecutar \
-H "Authorization: Bearer $FLOID_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"herramienta": "sii.carpeta_tributaria_personalizada.consultar",
"parametros": {
"rut": "11111111-1",
"clave": "1234"
}
}'
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.carpeta_tributaria_personalizada.consultar',
'parametros': {'rut': '11111111-1', 'clave': '1234'}},
timeout=300,
)
print(respuesta.json())
Respuesta
Siempre {"data": …, "meta": {"herramienta", "caseid"}}, o {"error": …, "meta": …} si algo falla.
Formato de respuestas.