Consultar RCV del SII
Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. 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. Incluye otrosImpuestos (código, monto y tasa) e IVA no recuperable con su código, también en compras pendientes cuando el SII los informa. null indica detalle desconocido o todavía no sincronizado; [] y 0 son ausencia explícita de impuestos. 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.
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
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.
^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.consultar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": {} }'{ "data": { "documentos": [ { "tipoDte": -9007199254740991, "folio": "string", "rutEmisor": "string", "rutReceptor": "string", "razonSocial": "string", "fechaEmisionDate": "string", "fechaEmision": "string", "montoNeto": -9007199254740991, "montoIva": -9007199254740991, "montoTotal": -9007199254740991, "estado": "string", "periodo": "string", "montoExento": -9007199254740991, "otrosImpuestos": [ { "codigo": 1, "monto": -9007199254740991, "tasa": 0 } ], "montoIvaNoRecuperable": -9007199254740991, "codigoIvaNoRecuperable": 1, "fechaRecepcion": "string", "eventoReceptor": "string", "eventoReceptorCod": "string", "tipoDocRef": -9007199254740991, "folioDocRef": "string", "fechaAcuse": "string", "fechaReclamo": "string", "tipoTransaccion": "string", "perspectiva": "compras" } ], "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 }}Consultar totales del mes del RCV POST
Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. 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'.
Opciones del receptor en el SII POST
Devuelve lo que el Facturador Gratuito del SII muestra al escribir el RUT del receptor de una factura: razón social, giros y direcciones (sucursales incluidas), cada una con su comuna y ciudad. Úsala cuando 'sii.dte.previsualizar' responda que el receptor tiene varios giros o direcciones: elige uno de cada uno y envíalos en el receptor; la comuna y la ciudad salen de la dirección elegida. Puedes acotar las direcciones con 'comuna'. Consulta en vivo con la sesión de la conexión, no guarda nada y no emite. Requiere la emisión autorizada en la conexión.