Floid Developers Contáctanos

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

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.
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"
  }
}