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
| Nombre | Tipo | Descripció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"
}
}