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