Floid Developers Contáctanos

sii.reclamos.consultar

Historial de aceptación y reclamo de un documento recibido (solo lectura).

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.
rut_emisor requerido texto RUT del emisor del documento, con guion.
tipo_documento requerido texto Tipo de DTE (33 = factura electrónica, 34 = exenta...).
folio requerido texto Folio del documento.
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.reclamos.consultar",
  "parametros": {
    "credencial_token": "<credencial_token>",
    "rut_emisor": "76543210-3",
    "tipo_documento": "33",
    "folio": "12345"
  }
}

Terminal

curl https://mcp.floid.app/sandbox/v1/ejecutar \
  -H "Authorization: Bearer $FLOID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "herramienta": "sii.reclamos.consultar",
  "parametros": {
    "rut": "11111111-1",
    "clave": "1234",
    "rut_emisor": "76543210-3",
    "tipo_documento": "33",
    "folio": "12345"
  }
}'

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.reclamos.consultar',
     'parametros': {'rut': '11111111-1',
                    'clave': '1234',
                    'rut_emisor': '76543210-3',
                    'tipo_documento': '33',
                    'folio': '12345'}},
    timeout=300,
)
print(respuesta.json())

Respuesta

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

{
  "data": {
    "dhdrCodigo": 99999999,
    "dhdrRutEmisor": 11111111,
    "rzEmisor": "EMPRESA EMISORA",
    "dtdcCodigo": 33,
    "descDoc": "Factura Electronica",
    "dhdrFolio": 111,
    "dhdrRutRecep": 2222222222,
    "dhdrDvRecep": "2",
    "rzReceptor": "EMPRESA RECEPTORA",
    "dhdrFchEmis": "DD-MM-AAAA",
    "dhdrMntTotal": "YYY",
    "dhdrIva": "TT",
    "dtecTmstRecep": "DD-MM-AAAA HH:MM:SS",
    "diferenciaFecha": "XX",
    "tieneAccesoEmisor": true,
    "mayorOchoDias": true,
    "listEvenHistDoc": [
      {
        "descEvento": "DTE Cedido",
        "codEvento": "CED",
        "fechaEvento": "DD-MM-AAAA HH:MM:SS",
        "rutResponsable": "XXXXXXXXX",
        "dvResponsable": "X"
      },
      {
        "descEvento": "Recepción de NC de Anulación que Referencia Documento",
        "codEvento": "NCA",
        "fechaEvento": "DD-MM-AAAA HH:MM:SS",
        "rutResponsable": "XXXXXXXXX",
        "dvResponsable": "X"
      }
    ]
  },
  "meta": {
    "herramienta": "sii.reclamos.consultar",
    "caseid": "xxxxx"
  }
}