sii.cesion.historico.consultar
Histórico de cesiones de facturas (rango máximo 1 mes).
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. |
| desde requerido | fecha YYYY-MM-DD | Fecha inicial (YYYY-MM-DD). |
| hasta requerido | fecha YYYY-MM-DD | Fecha final (YYYY-MM-DD). |
| tipo requerido | texto |
0, 1 o 2 según el tipo de cesión.
Valores: 0 1 2 |
| 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.cesion.historico.consultar",
"parametros": {
"credencial_token": "<credencial_token>",
"desde": "2025-01-01",
"hasta": "2025-01-31",
"tipo": "0"
}
}
Terminal
curl https://mcp.floid.app/sandbox/v1/ejecutar \
-H "Authorization: Bearer $FLOID_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"herramienta": "sii.cesion.historico.consultar",
"parametros": {
"rut": "11111111-1",
"clave": "1234",
"desde": "2025-01-01",
"hasta": "2025-01-31",
"tipo": "0"
}
}'
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.cesion.historico.consultar',
'parametros': {'rut': '11111111-1',
'clave': '1234',
'desde': '2025-01-01',
'hasta': '2025-01-31',
'tipo': '0'}},
timeout=300,
)
print(respuesta.json())
Respuesta
Respuesta del sandbox de Floid normalizada por la capa, recortada a dos elementos por lista.
{
"data": {
"DEUDOR": {
"datos_consulta": {
"rut": "12345678-9",
"tipo_consulta": "DEUDOR",
"desde_ddmmaaaa": "01032024",
"hasta_ddmmaaaa": "01042024"
},
"cesion": {
"vendedor": "98765432-1",
"estado_cesion": "Cesion Vigente",
"deudor": "12345678-9",
"mail_deudor": "[email protected]",
"tipo_doc": "33",
"nombre_doc": "Factura Electronica",
"folio_doc": "123456",
"fch_emis_dte": "2024-03-15",
"mnt_total": "50000",
"cedente": "98765432-1",
"rz_cedente": "Example Logistics SPA",
"mail_cedente": "[email protected]",
"cesionario": "87654321-2",
"rz_cesionario": "Investment Fund ABC",
"mail_cesionario": "[email protected]",
"fch_cesion": "2024-03-20 15:30",
"mnt_cesion": "50000",
"fch_vencimiento": "2024-03-30"
}
},
"CEDENTE": {
"datos_consulta": {
"rut": "98765432-1",
"tipo_consulta": "CEDENTE",
"desde_ddmmaaaa": "01032024",
"hasta_ddmmaaaa": "01042024"
}
},
"CESIONARIO": {
"datos_consulta": {
"rut": "87654321-2",
"tipo_consulta": "CESIONARIO",
"desde_ddmmaaaa": "01032024",
"hasta_ddmmaaaa": "01042024"
}
}
},
"meta": {
"herramienta": "sii.cesion.historico.consultar",
"caseid": "xxxxx"
}
}