Floid Developers Contáctanos

sii.contribuyente.consultar

Datos públicos de un contribuyente: razón social, actividades y situación tributaria.

Lectura Sin credenciales del titular Ver ficha en JSON

Parámetros

NombreTipoDescripción
rut requerido texto RUT del contribuyente, con guion.
caseid texto Identificador del caso. Para pedir otra página de un resultado ya obtenido, repite el caseid de la primera respuesta.

Ejemplo

Con los datos de prueba del sandbox. En producción, quita /sandbox de la URL.

Argumentos de la herramienta MCP ejecutar

{
  "herramienta": "sii.contribuyente.consultar",
  "parametros": {
    "rut": "11111111-1"
  }
}

Terminal

curl https://mcp.floid.app/sandbox/v1/ejecutar \
  -H "Authorization: Bearer $FLOID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "herramienta": "sii.contribuyente.consultar",
  "parametros": {
    "rut": "11111111-1"
  }
}'

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.contribuyente.consultar',
     'parametros': {'rut': '11111111-1'}},
    timeout=300,
)
print(respuesta.json())

Respuesta

Respuesta del sandbox de Floid normalizada por la capa, recortada a dos elementos por lista.

{
  "data": {
    "datos": {
      "razon_social": "STARTUP SPA",
      "rut": "xxxxxxxx-x",
      "inicio_actividades": "SI",
      "authExt": "NO",
      "fecha_inicio_actividades": "2019-05-26",
      "empresa_menor_tamano": "SI",
      "actividades": [
        {
          "actividad": "OTRAS ACTIVIDADES DE TECNOLOGIA DE LA INFORMACION Y DE SERVICIOS INFOR",
          "codigo": "620900",
          "categoria": "Primera",
          "afecta_iva": "Si",
          "fecha": "2020-12-01"
        }
      ],
      "documentos": [
        {
          "documento": "Boleta Electronica",
          "anio": "2021"
        },
        {
          "documento": "Boleta Exenta Electronica",
          "anio": "2021"
        }
      ]
    }
  },
  "meta": {
    "herramienta": "sii.contribuyente.consultar",
    "caseid": "xxxxx"
  }
}