Floid Developers Contáctanos

sii.rcv.consultar

Registro de compras y ventas (versión 2, más rápida). Indicar periodo, meses o historico.

Lectura Credencial SII Paginable 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_empresa requerido texto RUT de la empresa consultada, con guion.
tipo requerido texto Qué documentos traer.
Valores: Compras Ventas Compra_Venta Compra_registro Compra_pendientes Compra_no_incluir Compra_reclamos
periodo texto Período tributario YYYYMM (por ejemplo 202403).
meses entero Últimos N meses exactos.
Valores: 2 6 12 24
historico entero Últimos 12 o 24 períodos.
Valores: 12 24
liviano booleano Respuesta resumida.
formato_unificado booleano Mismo formato de documento para compras y ventas.
offset entero Desde qué elemento devolver (0 = el primero).
limite entero Cuántos elementos devolver por página.
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.rcv.consultar",
  "parametros": {
    "credencial_token": "<credencial_token>",
    "rut_empresa": "77777777-7",
    "tipo": "Compras"
  }
}

Terminal

curl https://mcp.floid.app/sandbox/v1/ejecutar \
  -H "Authorization: Bearer $FLOID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "herramienta": "sii.rcv.consultar",
  "parametros": {
    "rut": "11111111-1",
    "clave": "1234",
    "rut_empresa": "77777777-7",
    "tipo": "Compras"
  }
}'

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.rcv.consultar',
     'parametros': {'rut': '11111111-1',
                    'clave': '1234',
                    'rut_empresa': '77777777-7',
                    'tipo': 'Compras'}},
    timeout=300,
)
print(respuesta.json())

Respuesta

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

{
  "data": [
    {
      "nro": "1",
      "periodo": "202501",
      "tipo_doc": "43",
      "nombre_doc": "Liquidación-Factura Electrónica",
      "tipo_dte": "venta",
      "estado_dte": "",
      "rut_entidad": "77777777-7",
      "razon_social": "EMPRESA S.A.",
      "folio": "23468",
      "cantidad_de_documentos": "1",
      "fecha_docto": "2025-01-07",
      "fecha_recepcion": "2025-01-07T12:00:00",
      "fecha_acuse": "",
      "fecha_reclamo": "",
      "monto_exento": "0",
      "monto_neto": "5200000",
      "monto_iva": "1000000",
      "iva_uso_comun": "",
      "iva_no_retenido": "",
      "monto_iva_no_recuperable": "",
      "monto_total": "6200000",
      "evento_dte": "",
      "folio_referencia": "",
      "tipo_doc_referencia": "0"
    },
    {
      "nro": "2",
      "periodo": "202501",
      "tipo_doc": "43",
      "nombre_doc": "Liquidación-Factura Electrónica",
      "tipo_dte": "venta",
      "estado_dte": "",
      "rut_entidad": "77777777-7",
      "razon_social": "EMPRESA S.A.",
      "folio": "14628",
      "cantidad_de_documentos": "1",
      "fecha_docto": "2025-01-09",
      "fecha_recepcion": "2025-01-09T14:00:00",
      "fecha_acuse": "",
      "fecha_reclamo": "",
      "monto_exento": "0",
      "monto_neto": "7000000",
      "monto_iva": "1120000",
      "iva_uso_comun": "",
      "iva_no_retenido": "",
      "monto_iva_no_recuperable": "",
      "monto_total": "8120000",
      "evento_dte": "",
      "folio_referencia": "",
      "tipo_doc_referencia": "0"
    }
  ],
  "meta": {
    "herramienta": "sii.rcv.consultar",
    "caseid": "ca6528ed-ded1-43cb-81b8-201919c8f6bf"
  }
}