Connect
API REST

Buscar contribuyente en el SII

Devuelve la razón social, los giros y el domicilio publicado de cualquier RUT, para completar el receptor de una factura. La razón social y los giros se consultan en vivo en la consulta pública de situación tributaria del SII; el domicilio sale de la nómina de domicilios de personas jurídicas que publica el SII, copiada por Connect, y no cubre personas naturales. No usa la clave de la conexión ni guarda lo que consulta. Revisa 'estado' antes de usar los datos: no_verificable no significa que el RUT no exista. El receptor de 'sii.dte.emitir' no se completa solo: elige un giro de la lista y envía el receptor completo. Límite: 10 búsquedas por minuto por organización; sobre eso responde rate_limited con la espera.

POST
/v1/tools/sii.contribuyente.buscar/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.contribuyente.buscar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "rut": "string"    }  }'
{  "data": {    "rut": "string",    "estado": "puede_emitir",    "nombre": "string",    "fechaInicioActividades": "string",    "giros": [      {        "codigo": "string",        "descripcion": "string",        "categoriaTributaria": "string",        "afectoIva": true,        "fechaInicio": "string"      }    ],    "domicilio": {      "direccion": "string",      "comuna": "string",      "fechaPublicacion": "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  }}

Verificar conexión SII POST

Prueba las credenciales de la conexión contra el SII haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.

Consultar documentos respaldados del SII POST

Lista los documentos tributarios (DTE) cuyo XML firmado ya se respaldó para esta conexión, filtrables por período, perspectiva y tipo de documento. Devuelve SOLO las columnas de cabecera: ni el XML ni el detalle de ítems viaja aquí. Para el detalle de UN documento (sus ítems con cantidad, unidad y precio, los giros y direcciones de emisor y receptor, y la forma de pago) usa 'sii.documentos.detallar' con el 'tipoDte', el 'folio' y el 'rutEmisor' de la fila correspondiente. 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. Para traer datos nuevos usa 'sii.conexion.sincronizar' primero, con el alcance 'documentos'. La fuente es Respaldo de Información XML del SII: que un DTE figure en el RCV no garantiza que su XML esté disponible en ese respaldo. Una sincronización completa acredita la cobertura del índice del respaldo, no de todo el RCV. Connect no filtra por el software de emisión del proveedor ni reconstruye XML desde el RCV. Este alcance requiere la clave tributaria de una persona que representa a la empresa; esa credencial no garantiza la disponibilidad de los XML. 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.