Floid Developers Contáctanos

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

NombreTipoDescripció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.