Connect
API REST

Consultar totales del mes del RCV

Lee los totales del mes que el SII informa en el Registro de Compra-Venta sin detalle por documento: las boletas electrónicas (39), los comprobantes de pago con tarjeta (48) y otros tipos que sólo llegan como total. Un registro por mes y tipo, con la cantidad de documentos y sus montos. Para las ventas del mes, suma los documentos de 'sii.rcv.consultar' más los totales con 'sumable: true'; los pagos con tarjeta (48) vienen con 'sumable: false' porque pueden repetir ventas que ya tienen boleta o factura. Ojo con las boletas: el alcance 'boletas' ('sii.boletas.consultar') trae las mismas boletas día por día; usa una de las dos fuentes, no ambas. Lectura pura: NO dispara una sincronización ni contacta al SII; para datos nuevos usa 'sii.conexion.sincronizar' primero. Pagina con 'cursor'.

POST
/v1/tools/sii.rcv_totales.consultar/execute

Authorization

AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/sii.rcv_totales.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "totales": [      {        "perspectiva": "compras",        "periodo": "string",        "estado": "registro",        "tipoDte": -9007199254740991,        "nombreTipo": "string",        "cantidad": -9007199254740991,        "montoNeto": -9007199254740991,        "montoIva": -9007199254740991,        "montoExento": -9007199254740991,        "montoTotal": -9007199254740991,        "sumable": true,        "fuente": "resumen",        "sincronizadoEn": "string"      }    ],    "cursor": "string",    "sincronizacion": {      "sincronizadoEn": "string",      "completo": true,      "incompletos": -9007199254740991,      "fueraDeVentana": -9007199254740991,      "perspectivasFallidas": [        {          "perspectiva": "emitidas",          "code": "string"        }      ]    }  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}

Previsualizar anulación de honorarios (beta) POST

Consulta la previsualización del SII para una solicitud de anulación persistida, documento y motivo exactos. Requiere acceso dedicado del titular y scope sii:honorarios:annul. No anula ni reutiliza el consentimiento de emisión.

Consultar RCV del SII POST

Lee el Registro de Compra-Venta ya sincronizado para esta conexión, documento por documento, filtrable por período, perspectiva, tipo de documento (tipoDte) y estado del registro. Las boletas (39), los comprobantes de pago con tarjeta (48) y otros tipos que el SII informa sólo como TOTAL del mes no vienen aquí: léelos con 'sii.rcv_totales.consultar'. Las ventas del mes son estos documentos (las notas de crédito restan) más los totales con 'sumable: true'; los pagos con tarjeta (48) se suman según el caso (ver 'sii.rcv_totales.consultar'). Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el mes no está cargado, devuelve una lista vacía y 'sincronizacion: null': no es cero movimiento. Solo informes cero ventas si el mes está cargado completo y los totales del mes ('sii.rcv_totales.consultar') también son cero. Para traer datos nuevos, usa 'sii.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null, hay más filas. reenvía ese valor tal cual en 'cursor' para pedir la página siguiente; nunca lo construyas a mano.