# Docs ## Cuándo usar Emisso Connect Usa Emisso Connect cuando la tarea necesita un dato real de una empresa chilena, o emitir un documento tributario a su nombre: - Calcular o declarar el IVA de una empresa: el Registro de Compras y Ventas (RCV) del SII trae cada documento que emitió y recibió. - Revisar boletas electrónicas de venta, guías de despacho o boletas de honorarios que una empresa emitió o recibió, o el XML firmado de cualquiera de esos documentos. - Emitir una factura, o una nota de crédito o débito, a nombre de una empresa ante el SII, con folio y timbre real. - Consultar el saldo o los movimientos de una cuenta corriente de empresa en BCI PyME, Banco Security, BICE Empresas, Banco de Chile o BancoEstado. - Revisar las nóminas de pago o las transferencias de una empresa en Banco Security, o su cartola mensual ya emitida en Banco de Chile. - Ver las cotizaciones previsionales de una empresa: qué planillas pagó, cuánto cotizó cada trabajador, si tiene deuda, o el archivo para pedir el Certificado F30-1, todo en Previred. - Convertir un monto con la UF, el dólar, el euro, el IPC o la UTM de una fecha. - Auditar quién pidió qué dato, cuándo y con qué resultado: cada llamada por API key queda registrada. No uses Emisso Connect para: - Sistemas fuera de Chile. No hay conectores para el fisco ni la banca de otros países. - Un sistema chileno que no está en la lista de arriba. No hay ERP, POS ni banca personal, y en cotizaciones previsionales solo está Previred. - Escribir en el sistema externo más allá de emitir documentos por Notta. El resto de los conectores es de solo lectura: ninguno transfiere plata, paga cotizaciones ni carga una nómina. - El dato más nuevo al segundo. Las tools `.consultar` responden con la última sincronización guardada, no con una consulta en vivo. Sincroniza la conexión primero si necesitas el dato más fresco posible. - [Emisso Connect](/docs): Un endpoint para los sistemas chilenos. Conecta tu backend o tu agente con el SII, los bancos de empresa y los indicadores del Banco Central, con auditoría completa de cada llamada. - Empieza aquí - [Tu primera llamada](/docs/empezar/primera-llamada): El valor de la UF de hoy por REST, SDK o MCP, en cerca de 2 minutos. No requiere conectar ningún sistema. - [Conecta tu primera empresa](/docs/empezar/conectar): De cero a leer el Registro de Compra-Venta de un cliente real, con un enlace de un solo uso, una sincronización y una consulta. - [Autenticación](/docs/empezar/autenticacion): API keys con permisos explícitos para tu backend, OAuth 2.1 para clientes MCP: cómo se autentica cada llamada al gateway. - Conceptos - [Conexiones](/docs/conceptos/conexiones): La conexión es la empresa: la unidad con la que Connect autoriza, sincroniza y factura cada sistema externo. - [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar): En Connect ninguna consulta pregunta en vivo al SII ni a un banco. Leer datos reales son dos pasos, y esta página explica por qué. - [Los dos planos](/docs/conceptos/planos): Acción efímera y lectura persistente: qué declara cada tool y por qué leer un banco son dos pasos. - [La bitácora](/docs/conceptos/bitacora): Cada llamada deja exactamente una fila inmutable: auditoría, correlación con soporte y fuente de verdad de la facturación. - Sistemas - [Sistemas](/docs/sistemas): Qué se puede conectar hoy, qué credencial pide cada sistema y qué conviene saber de cada portal antes de la primera sincronización. - [SII](/docs/sistemas/sii): Una conexión al SII lee los cinco módulos tributarios de una empresa con un solo login, registro de compras y ventas, boletas, guías de despacho, boletas de honorarios y el XML de cada documento. - [Notta](/docs/sistemas/notta): Emite facturas y notas ante el SII desde tus agentes. La conexión se aprovisiona sola: no hay ninguna API key que crear ni pegar. - [BCI PyME](/docs/sistemas/bci-pyme): Conecta el portal de empresas de BCI y obtén saldos y movimientos en una caché que se consulta al instante, sin tocar al banco. - [Banco Security](/docs/sistemas/banco-security): Transferencias, nóminas de pago, saldos y movimientos del portal de Banco Security, servidos al instante desde la caché de Connect. - [BICE Empresas](/docs/sistemas/bice-empresas): Saldos y movimientos de BICE Empresas, sincronizados a la caché de Connect. El desafío de navegador del portal lo resuelve la sincronización, no tú. - [Banco de Chile Empresas](/docs/sistemas/bch-empresas): Saldos, movimientos y cartolas mensuales del Portal Empresas de Banco de Chile, sincronizados a la caché de Connect. El login es HTTP puro: no hay desafío de navegador que resolver. - [BancoEstado Empresas](/docs/sistemas/banco-estado): Saldos y movimientos de cuenta corriente del portal de BancoEstado Empresas, servidos al instante desde la caché de Connect. - [Previred](/docs/sistemas/previred): Planillas de cotizaciones pagadas, el desglose por trabajador, la deuda previsional y el archivo para el F30-1, sincronizados a la caché de Connect. Con el comprobante en PDF. - [Indicadores](/docs/sistemas/indicadores): UF, dólar, euro, IPC y UTM del almacén de referencia: tres tools gratis, sin conexión, y un canal público para probar sin cuenta. - Para agentes - [Servidor MCP](/docs/agentes/mcp): Connect es MCP-nativo, con dos herramientas que no cambian nunca, search_docs para descubrir y execute para correr, sobre el catálogo completo. - [Recursos máquina-legibles](/docs/agentes/recursos): Todo el sitio existe en markdown y contratos: pega una URL y descubre el API entero. - Operar - [Enlace hosted de conexión](/docs/operar/enlace-hosted): Un enlace de un solo uso para que un tercero entregue la clave del SII o del banco: sin cuenta, sin acceso al dashboard y sin que la credencial pase por tu aplicación. - [Conecta a tus clientes](/docs/operar/plataformas): El caso plataforma, un producto que conecta a muchos clientes finales, con el modelo de datos, el alta embebida y los topes que importan a escala. - [Webhooks](/docs/operar/webhooks): Un aviso firmado cuando una sincronización termina o un enlace de conexión se usa, sin sondear. El webhook nunca es load-bearing: el estado real siempre se puede consultar. - [Manejo de errores](/docs/operar/errores): Cada error de Connect llega con un código estable, una acción sugerida y un correlativo de soporte. Esta guía enseña a manejarlos; el catálogo completo vive en la referencia. - [Límites](/docs/operar/limites): El tamaño máximo de petición, la emisión de enlaces, la cola de sincronizaciones y el cupo de llamadas por conexión. Cada número de esta página existe como constante en el código que lo aplica. - [Seguridad](/docs/operar/seguridad): Dónde queda la clave del banco, cómo se cifra, cómo se aísla cada organización, qué guarda la auditoría y qué se puede revocar al instante. - [SDK de TypeScript](/docs/sdk): En camino a npm. El contrato de @emisso/connect, el cliente tipado y sus reglas de reintento, documentados para cuando se publique. - [API de control](/docs/api-control): La referencia REST de todo lo que no es una tool: catálogo, conexiones, sesiones, sincronizaciones y webhooks. - Referencia - [Referencia](/docs/referencia): El catálogo completo: cada tool con su contrato, su ejemplo en tres canales y sus errores. - [Catálogo de errores](/docs/referencia/errores): Todos los códigos que la API puede emitir, con su status HTTP, su semántica de reintento y qué hacer con cada uno. - **Abiertos** - Core - [Core](/docs/referencia/core): Las 1 tools de Core en el plan gratuito. - [Hora del servidor](/docs/referencia/core/timestamp-now): Devuelve la marca de tiempo actual del servidor (ISO-8601 UTC, epoch Unix) y la zona horaria solicitada. - Echo - [Echo](/docs/referencia/echo): Las 1 tools de Echo en el plan gratuito. - [Reflejar mensaje](/docs/referencia/echo/message-reflect): Devuelve el texto recibido junto con su longitud. - Indicadores económicos - [Indicadores económicos](/docs/referencia/indicadores): Las 3 tools de Indicadores económicos en el plan gratuito. - [Serie histórica del indicador](/docs/referencia/indicadores/serie-consultar): Devuelve la serie de valores de un indicador entre dos fechas (AAAA-MM-DD), en orden ascendente, acotada por 'limite' (tope duro 1000), leída del almacén de referencia global. - [Valor actual del indicador](/docs/referencia/indicadores/valor-actual): Devuelve el ÚLTIMO valor disponible de un indicador económico chileno (UF, DÓLAR, EURO, IPC, UTM), leído del almacén de referencia global; no consulta fuentes externas en tiempo real. - [Valor del indicador a una fecha](/docs/referencia/indicadores/valor-consultar): Devuelve el valor de un indicador vigente a una fecha dada (AAAA-MM-DD) CON ARRASTRE: si esa fecha no tiene dato propio (un fin de semana, un feriado, o una fuente que no se ha actualizado) devuelve el último valor anterior. - **Conectores** - BancoEstado Empresas - [BancoEstado Empresas](/docs/referencia/banco_estado): Las 4 tools de BancoEstado Empresas en el plan pagado. - [Sincronizar conexión BancoEstado](/docs/referencia/banco_estado/conexion-sincronizar): Inicia sesión en BancoEstado Empresas y persiste los alcances pedidos (saldos, movimientos) para un período, en UNA sola sesión (un login, un logout). - [Verificar conexión BancoEstado Empresas](/docs/referencia/banco_estado/conexion-verificar): Prueba las credenciales de la conexión contra BancoEstado Empresas haciendo un login real (y su logout, a cargo del pipeline). - [Consultar movimientos de BancoEstado](/docs/referencia/banco_estado/movimientos-consultar): Lee los movimientos de BancoEstado YA sincronizados de esta conexión, del más reciente al más antiguo. - [Consultar saldos de BancoEstado](/docs/referencia/banco_estado/saldos-consultar): Lee los saldos de BancoEstado YA sincronizados de esta conexión, del más reciente al más antiguo. - Banco Security Empresas - [Banco Security Empresas](/docs/referencia/banco_security): Las 7 tools de Banco Security Empresas en el plan pagado. - [Sincronizar conexión Banco Security](/docs/referencia/banco_security/conexion-sincronizar): Sincroniza los alcances solicitados (transferencias, nóminas, saldos, movimientos) para un período en una sola sesión (un login, un logout). - [Verificar conexión Banco Security](/docs/referencia/banco_security/conexion-verificar): Prueba las credenciales de la conexión contra Banco Security haciendo un login real (y su logout, a cargo del pipeline). - [Consultar movimientos de Banco Security](/docs/referencia/banco_security/movimientos-consultar): Lee la caché ya sincronizada; NO contacta al banco. - [Consultar los pagos de una nómina de Banco Security](/docs/referencia/banco_security/nomina_pagos-consultar): Lee la caché ya sincronizada; NO contacta al banco. - [Consultar nóminas de pago de Banco Security](/docs/referencia/banco_security/nominas-consultar): Lee la caché ya sincronizada; NO contacta al banco. - [Consultar saldos de Banco Security](/docs/referencia/banco_security/saldos-consultar): Lee la caché ya sincronizada; NO contacta al banco. - [Consultar transferencias de Banco Security](/docs/referencia/banco_security/transferencias-consultar): Lee la caché ya sincronizada; NO contacta al banco. - Banco de Chile Empresas - [Banco de Chile Empresas](/docs/referencia/bch_empresas): Las 5 tools de Banco de Chile Empresas en el plan pagado. - [Consultar cartolas emitidas de Banco de Chile](/docs/referencia/bch_empresas/cartolas-consultar): Lee las cartolas (extractos mensuales) ya sincronizadas de esta conexión, la más reciente primero, filtrables por período de búsqueda (AAAA-MM) y por cuenta. - [Sincronizar conexión Banco de Chile](/docs/referencia/bch_empresas/conexion-sincronizar): Sincroniza los alcances solicitados (saldos, movimientos, cartolas) para un período en una sola sesión de portal (un login, un logout). - [Verificar conexión Banco de Chile](/docs/referencia/bch_empresas/conexion-verificar): Prueba las credenciales de la conexión contra Banco de Chile haciendo un login real (y su logout, a cargo del pipeline). - [Consultar movimientos de Banco de Chile](/docs/referencia/bch_empresas/movimientos-consultar): Lee los movimientos ya sincronizados de esta conexión, del más reciente al más antiguo, filtrables por período (AAAA-MM) y por cuenta. - [Consultar saldos de Banco de Chile](/docs/referencia/bch_empresas/saldos-consultar): Lee los saldos ya sincronizados de esta conexión, con el snapshot más reciente primero. - Banco BCI Empresas - [Banco BCI Empresas](/docs/referencia/bci_pyme): Las 4 tools de Banco BCI Empresas en el plan pagado. - [Sincronizar conexión BCI](/docs/referencia/bci_pyme/conexion-sincronizar): Sincroniza los alcances solicitados (saldos, movimientos) para un período en una sola sesión (un login, un logout). - [Verificar conexión BCI](/docs/referencia/bci_pyme/conexion-verificar): Prueba las credenciales de la conexión contra BCI haciendo un login real (y su logout, a cargo del pipeline). - [Consultar movimientos de BCI](/docs/referencia/bci_pyme/movimientos-consultar): Lee la caché ya sincronizada; NO contacta al banco. - [Consultar saldos de BCI](/docs/referencia/bci_pyme/saldos-consultar): Lee la caché ya sincronizada; NO contacta al banco. - Banco BICE Empresas - [Banco BICE Empresas](/docs/referencia/bice_empresas): Las 4 tools de Banco BICE Empresas en el plan pagado. - [Sincronizar conexión BICE](/docs/referencia/bice_empresas/conexion-sincronizar): Sincroniza los alcances solicitados (saldos, movimientos) para un período en una sola sesión de portal. - [Verificar conexión BICE](/docs/referencia/bice_empresas/conexion-verificar): Prueba las credenciales de la conexión contra BICE haciendo un login real (y su logout, a cargo del pipeline). - [Consultar movimientos de BICE Empresas](/docs/referencia/bice_empresas/movimientos-consultar): Lee los movimientos ya sincronizados de esta conexión, del más reciente al más antiguo, filtrables por período (AAAA-MM), por cuenta y por 'type' (el eje credit/debit del libro del banco: 'debit' para los abonos, 'credit' para los cargos). - [Consultar saldos de BICE Empresas](/docs/referencia/bice_empresas/saldos-consultar): Lee los saldos ya sincronizados de esta conexión, con el snapshot más reciente primero. - Conexiones de Emisso Connect - [Conexiones de Emisso Connect](/docs/referencia/conexiones): Las 3 tools de Conexiones de Emisso Connect en el plan gratuito. - [Crear un enlace para conectar un sistema](/docs/referencia/conexiones/enlace-crear): Crea un enlace de un solo uso donde la persona entrega sus credenciales del sistema para conectarlo. - [Consultar el estado de las conexiones](/docs/referencia/conexiones/estado-consultar): Dice en qué va cada conexión: si la credencial quedó vinculada, qué sincronizaciones corrieron y si YA HAY DATOS para consultar ('datosListos'). - [Listar los sistemas que se pueden conectar](/docs/referencia/conexiones/sistemas-listar): Devuelve el catálogo de sistemas chilenos que esta organización puede conectar (bancos, SII) con el estado de cada uno: si ya está conectado, sus conexiones, los módulos de datos que ofrece y las herramientas que quedan disponibles al conectarlo. - Notta - [Notta](/docs/referencia/notta): Las 6 tools de Notta en el plan pagado. - [Verificar conexión Notta](/docs/referencia/notta/conexion-verificar): Prueba las credenciales de la conexión contra Notta haciendo un login real (y su logout, a cargo del pipeline). - [Consultar un DTE](/docs/referencia/notta/dte-consultar): Consulta el estado actual de un DTE en Notta por su id. - [Descargar el XML o el PDF de un DTE](/docs/referencia/notta/dte-descargar): Devuelve el XML firmado o el PDF de un DTE como base64. - [Emitir DTE (factura o nota)](/docs/referencia/notta/dte-emitir): Emite un DTE ante el SII vía Notta: factura afecta (33), exenta (34), nota de débito (56) o nota de crédito (61, que exige references[] al documento original, y este solo puede ser una factura 33 o 34). - [Listar los DTEs recientes](/docs/referencia/notta/dte-listar): Lista los DTEs MÁS RECIENTES emitidos por esta empresa en Notta (del más nuevo al más antiguo). - [Reenviar un DTE por correo](/docs/referencia/notta/dte-reenviar): Reenvía el PDF y el XML de un DTE ya emitido al correo del receptor. - Previred - [Previred](/docs/referencia/previred): Las 8 tools de Previred en el plan pagado. - [Consultar certificados de cotizaciones de Previred](/docs/referencia/previred/certificados-consultar): Lee los certificados oficiales de cotizaciones ya emitidos para esta conexión, uno por trabajador. - [Sincronizar conexión Previred](/docs/referencia/previred/conexion-sincronizar): Sincroniza los alcances solicitados (planillas, cotizaciones, deuda, f301) para un período en una sola sesión de portal. - [Verificar conexión Previred](/docs/referencia/previred/conexion-verificar): Prueba las credenciales de la conexión contra Previred haciendo un login real (y su logout, a cargo del pipeline). - [Consultar cotizaciones por trabajador de Previred](/docs/referencia/previred/cotizaciones-consultar): Lee las cotizaciones ya sincronizadas de esta conexión, por trabajador, período e institución. - [Consultar deuda previsional en Previred](/docs/referencia/previred/deuda-consultar): Lee la deuda previsional ya sincronizada de esta conexión, y responde la pregunta del mes: ¿está al día? Trae las dos mitades. - [Consultar empresas de la credencial de Previred](/docs/referencia/previred/empresas-consultar): Lista las empresas que la credencial de esta conexión administra en Previred. - [Consultar archivos para el F30-1 de Previred](/docs/referencia/previred/f301-consultar): Lee los archivos ya sincronizados con que la Dirección del Trabajo emite el Certificado F30-1 de Cumplimiento de Obligaciones Laborales y Previsionales, el que una empresa contratista tiene que entregarle a su mandante para que le paguen. - [Consultar planillas pagadas de Previred](/docs/referencia/previred/planillas-consultar): Lee las planillas de cotizaciones ya sincronizadas de esta conexión, de la más reciente a la más antigua, filtrables por período (AAAA-MM) y por institución. - Servicio de Impuestos Internos - [Servicio de Impuestos Internos](/docs/referencia/sii): Las 8 tools de Servicio de Impuestos Internos en el plan pagado. - [Consultar boletas de honorarios del SII](/docs/referencia/sii/boletas_honorarios-consultar): Lee las boletas de honorarios electrónicas (BHE) ya sincronizadas para esta conexión, filtradas por período y/o perspectiva (emitidas = las que emitió esta empresa; recibidas = las que le emitieron, donde esta empresa es el agente retenedor). - [Consultar boletas electrónicas del SII](/docs/referencia/sii/boletas-consultar): Lee el resumen diario de boletas electrónicas ya sincronizado para esta conexión, filtrado por período. - [Sincronizar conexión SII](/docs/referencia/sii/conexion-sincronizar): Sincroniza los alcances solicitados (rcv, boletas, guias, boletas_honorarios, documentos) para un período en una sola sesión (un login, un logout). - [Verificar conexión SII](/docs/referencia/sii/conexion-verificar): Prueba las credenciales de la conexión contra el SII haciendo un login real (y su logout, a cargo del pipeline). - [Consultar documentos respaldados del SII](/docs/referencia/sii/documentos-consultar): Lista los documentos tributarios (DTE) cuyo XML firmado ya se respaldó para esta conexión, filtrables por período, perspectiva y tipo de documento. - [Detallar un documento respaldado del SII](/docs/referencia/sii/documentos-detallar): Devuelve UN documento tributario respaldado, con su detalle completo: los ítems (nombre, cantidad, unidad, precio unitario y monto), los giros, direcciones y comunas de emisor y receptor, y la forma de pago. - [Consultar guías de despacho del SII](/docs/referencia/sii/guias-consultar): Lee las guías de despacho electrónicas (DTE 52) ya sincronizadas para esta conexión, filtradas por período y/o perspectiva (emitidas = las que emitió esta empresa; recibidas = las que le emitieron). - [Consultar RCV del SII](/docs/referencia/sii/rcv-consultar): Lee el Registro de Compra-Venta ya sincronizado para esta conexión, filtrable por período, perspectiva, tipo de documento (tipoDte) y estado del registro. - API REST - [API REST](/docs/api): Una página interactiva por operación, generada del contrato OpenAPI del catálogo documentado. - [Sincronizar conexión BancoEstado](/docs/api/banco_estado__conexion__sincronizar): Inicia sesión en BancoEstado Empresas y persiste los alcances pedidos (saldos, movimientos) para un período, en UNA sola sesión (un login, un logout). Es el ÚNICO camino que trae datos del banco: las tools de consulta leen lo ya guardado. `saldos` es una foto del momento, no del período, así que sólo se sincroniza pidiendo el período corriente. Puede tardar cerca de un minuto, y mientras corre el titular no va a poder entrar al portal: BancoEstado admite una sola sesión activa por usuario. - [Verificar conexión BancoEstado Empresas](/docs/api/banco_estado__conexion__verificar): Prueba las credenciales de la conexión contra BancoEstado Empresas haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven. - [Consultar movimientos de BancoEstado](/docs/api/banco_estado__movimientos__consultar): Lee los movimientos de BancoEstado YA sincronizados de esta conexión, del más reciente al más antiguo. Lectura pura: NO contacta al banco ni dispara una sincronización, así que si falta un período usa 'banco_estado.conexion.sincronizar' primero. Los montos vienen como NÚMERO: 'monto' es la magnitud SIN signo, 'type' dice si sale ('credit') o entra ('debit') plata según el libro del banco (al revés de como se lee una cartola), y 'display' es ese monto ya formateado a la chilena con su signo. 'saldo' es el saldo arrastrado: es un balance, no lleva 'type' y conserva su propio signo. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual. - [Consultar saldos de BancoEstado](/docs/api/banco_estado__saldos__consultar): Lee los saldos de BancoEstado YA sincronizados de esta conexión, del más reciente al más antiguo. Lectura pura: NO contacta al banco ni dispara una sincronización, así que si nunca se sincronizó devuelve una lista vacía. Para traer datos nuevos usa 'banco_estado.conexion.sincronizar' primero. Los saldos son una foto POR DÍA y vienen como NÚMERO conservando su signo: un sobregiro es negativo, y un saldo no lleva 'type' porque no es una operación. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual y nunca lo construyas a mano. - [Sincronizar conexión Banco Security](/docs/api/banco_security__conexion__sincronizar): Sincroniza los alcances solicitados (transferencias, nóminas, saldos, movimientos) para un período en una sola sesión (un login, un logout). `saldos` es una foto del momento, no del período: solo se sincroniza cuando se pide el período corriente. `movimientos` cubre cualquier período: el conector elige solo la cartola que corresponde (la del mes en curso o la histórica) y las dos escriben la misma tabla, así que un mismo movimiento traído por las dos NO se duplica. - [Verificar conexión Banco Security](/docs/api/banco_security__conexion__verificar): Prueba las credenciales de la conexión contra Banco Security haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven. - [Consultar movimientos de Banco Security](/docs/api/banco_security__movimientos__consultar): Lee la caché ya sincronizada; NO contacta al banco. Devuelve los movimientos de cuenta corriente guardados de esta conexión, del más reciente al más antiguo, filtrables por período (AAAA-MM). Exige el alcance 'movimientos' habilitado. Sin 'periodo' devuelve todos los períodos sincronizados. Si el período nunca se sincronizó, devuelve una lista vacía (lo que NO significa que no haya movimientos): usa 'banco_security.conexion.sincronizar' primero. El banco sirve el mes en curso y los meses ya cerrados por dos cartolas distintas, pero eso es interno: las dos escriben esta misma caché con la misma identidad por movimiento, así que un mes de solape NO aparece duplicado y los resultados se pueden sumar sin miedo. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola) y 'display' es ese monto ya formateado a la chilena con su signo. Un saldo NO lleva 'type': es un balance y conserva su propio signo. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar los pagos de una nómina de Banco Security](/docs/api/banco_security__nomina_pagos__consultar): Lee la caché ya sincronizada; NO contacta al banco. Devuelve las LÍNEAS DE PAGO de UNA nómina: el 'idNomina' es obligatorio y sale de 'banco_security.nominas.consultar'. Exige el alcance 'nominas' habilitado (el mismo que las cabeceras). Las líneas salen en orden ascendente de 'linea'. Si esa nómina nunca se sincronizó, devuelve una lista vacía. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola) y 'display' es ese monto ya formateado a la chilena con su signo. Un saldo NO lleva 'type': es un balance y conserva su propio signo. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar nóminas de pago de Banco Security](/docs/api/banco_security__nominas__consultar): Lee la caché ya sincronizada; NO contacta al banco. Devuelve SOLO las CABECERAS de las nóminas de pago masivas guardadas de esta conexión, de la más reciente a la más antigua, filtrables por período (AAAA-MM). Exige el alcance 'nominas' habilitado. Cada cabecera trae 'numRegistros' para que dimensiones antes de pedir el detalle: las líneas de pago se piden aparte con 'banco_security.nomina_pagos.consultar' pasándole el 'idNomina' de la cabecera (hay nóminas de más de mil líneas, por eso no vienen aquí). Si el período nunca se sincronizó, devuelve una lista vacía: usa 'banco_security.conexion.sincronizar' primero. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola) y 'display' es ese monto ya formateado a la chilena con su signo. Un saldo NO lleva 'type': es un balance y conserva su propio signo. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar saldos de Banco Security](/docs/api/banco_security__saldos__consultar): Lee la caché ya sincronizada; NO contacta al banco. Devuelve los saldos guardados de esta conexión (contable, disponible y provisorio), con el snapshot más reciente primero. Exige el alcance 'saldos' habilitado. Si nunca se sincronizó, devuelve una lista vacía (eso NO significa que la empresa no tenga cuentas); usa 'banco_security.conexion.sincronizar' primero. Los saldos son un snapshot POR DÍA, así que sin filtro de fecha la primera página ya son los más recientes que hay guardados. Los tres saldos vienen como NÚMERO ya normalizado (antes eran la celda cruda del banco, '$ 12.345.678'), y conservan su signo: un sobregiro es negativo. Un saldo no lleva 'type': no es una operación. 'ultimaLecturaEn' dice cuándo se leyó esa fila del banco: si es vieja, la conexión puede estar pausada. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas. reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar transferencias de Banco Security](/docs/api/banco_security__transferencias__consultar): Lee la caché ya sincronizada; NO contacta al banco. Devuelve las transferencias TEF guardadas de esta conexión, de la más reciente a la más antigua, filtrables por período (AAAA-MM) y por dirección. Exige el alcance 'transferencias' habilitado. Omitir 'direccion' trae enviadas y recibidas juntas; el campo 'direction' de cada fila las distingue ('issued' = enviada, 'received' = recibida). Si el período nunca se sincronizó, devuelve una lista vacía: usa 'banco_security.conexion.sincronizar' primero. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola) y 'display' es ese monto ya formateado a la chilena con su signo. Un saldo NO lleva 'type': es un balance y conserva su propio signo. 'numeroTransaccion' sí es texto (tiene 14 dígitos y no entra en un entero de 32 bits). 'ultimaLecturaEn' dice cuándo se leyó esa fila del banco. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas. reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar cartolas emitidas de Banco de Chile](/docs/api/bch_empresas__cartolas__consultar): Lee las cartolas (extractos mensuales) ya sincronizadas de esta conexión, la más reciente primero, filtrables por período de búsqueda (AAAA-MM) y por cuenta. Lectura pura: NO contacta al banco ni dispara una sincronización. Para traer datos nuevos, usa 'bch_empresas.conexion.sincronizar' primero. Una cartola es un OBJETO propio, no una vista de 'movimientos': sus saldos de apertura y cierre pueden no cuadrar exactamente con la suma de movimientos del mismo mes porque el extracto encadena por fecha contable y el feed vivo por fecha del movimiento. 'numeroCartola' es TEXTO siempre (convertirlo a número pierde ceros a la izquierda). Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas; reenvía ese valor tal cual, nunca lo construyas a mano. - [Sincronizar conexión Banco de Chile](/docs/api/bch_empresas__conexion__sincronizar): Sincroniza los alcances solicitados (saldos, movimientos, cartolas) para un período en una sola sesión de portal (un login, un logout). `saldos` es una foto del momento, no del período: solo se sincroniza cuando se pide el período corriente. `cartolas` son los extractos MENSUALES ya emitidos por el banco, un objeto propio que NO alimenta `movimientos`. - [Verificar conexión Banco de Chile](/docs/api/bch_empresas__conexion__verificar): Prueba las credenciales de la conexión contra Banco de Chile haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven. - [Consultar movimientos de Banco de Chile](/docs/api/bch_empresas__movimientos__consultar): Lee los movimientos ya sincronizados de esta conexión, del más reciente al más antiguo, filtrables por período (AAAA-MM) y por cuenta. Lectura pura: NO contacta al banco ni dispara una sincronización. Si el período nunca se sincronizó, devuelve una lista vacía, que NO significa que no haya movimientos. Para traer datos nuevos, usa 'bch_empresas.conexion.sincronizar' primero. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola), y 'display' es ese monto ya formateado a la chilena con su signo. 'saldoContable' es un balance: no lleva 'type' y conserva su propio signo. 'id' es la huella estable con la que se guardó el movimiento: el mismo movimiento visto en dos sincronizaciones solapadas trae el mismo 'id'. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas; reenvía ese valor tal cual, nunca lo construyas a mano. - [Consultar saldos de Banco de Chile](/docs/api/bch_empresas__saldos__consultar): Lee los saldos ya sincronizados de esta conexión, con el snapshot más reciente primero. Lectura pura: NO contacta al banco ni dispara una sincronización. Si nunca se sincronizó, devuelve una lista vacía. Para traer datos nuevos, usa 'bch_empresas.conexion.sincronizar' primero. Los saldos son un snapshot POR DÍA, así que sin filtro de fecha la primera página ya son los saldos más recientes que hay guardados. Los tres saldos vienen como NÚMERO y conservan su signo. Un saldo no lleva 'type' (no es una operación). 'saldoContable' puede venir null en filas sincronizadas antes del 2026-08-11, que es cuando se empezó a leer; desde entonces trae el saldo contable real, que difiere del disponible por retenciones y cheques en canje. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas; reenvía ese valor tal cual, nunca lo construyas a mano. - [Sincronizar conexión BCI](/docs/api/bci_pyme__conexion__sincronizar): Sincroniza los alcances solicitados (saldos, movimientos) para un período en una sola sesión (un login, un logout). `saldos` es una foto del momento, no del período: solo se sincroniza cuando se pide el período corriente. - [Verificar conexión BCI](/docs/api/bci_pyme__conexion__verificar): Prueba las credenciales de la conexión contra BCI haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven. - [Consultar movimientos de BCI](/docs/api/bci_pyme__movimientos__consultar): Lee la caché ya sincronizada; NO contacta al banco. Devuelve los movimientos guardados de esta conexión, del más reciente al más antiguo, filtrables por período (AAAA-MM) y por cuenta. Exige el alcance 'movimientos' habilitado. Si el período nunca se sincronizó, devuelve una lista vacía, que NO significa que no haya movimientos; usa 'bci_pyme.conexion.sincronizar' primero. 'completo' dice si el último sync de ESE período trajo todo: BCI corta en 1000 movimientos por cuenta y mes, y 'completo: false' significa que faltan filas. Sin filtro de 'periodo' vale null, o sea «no se sabe». Ojo con las correcciones del banco: un movimiento corregido entra como fila NUEVA en vez de reemplazar a la anterior, así que ante dos filas del mismo movimiento vale la de 'ultimaLecturaEn' mayor. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola) y 'display' es ese monto ya formateado a la chilena con su signo. 'saldoContable' es un balance: no lleva 'type' y conserva su propio signo. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar saldos de BCI](/docs/api/bci_pyme__saldos__consultar): Lee la caché ya sincronizada; NO contacta al banco. Devuelve los saldos guardados de esta conexión (contable, disponible, 9AM y retención), con el snapshot más reciente primero. Exige el alcance 'saldos' habilitado. Si nunca se sincronizó, devuelve una lista vacía: eso NO significa que la empresa no tenga cuentas. Para traer datos nuevos usa 'bci_pyme.conexion.sincronizar' primero. Los saldos son un snapshot POR DÍA, así que sin filtro de fecha la primera página ya son los más recientes que hay guardados. Los cuatro saldos vienen como NÚMERO ya normalizado y conservan su signo: un sobregiro es negativo. Un saldo no lleva 'type' (no es una operación). 'ultimaLecturaEn' dice cuándo se leyó esa fila del banco: si es vieja, la conexión puede estar pausada. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; nunca lo construyas a mano. - [Sincronizar conexión BICE](/docs/api/bice_empresas__conexion__sincronizar): Sincroniza los alcances solicitados (saldos, movimientos) para un período en una sola sesión de portal. `saldos` es una foto del momento, no del período: solo se sincroniza cuando se pide el período corriente. - [Verificar conexión BICE](/docs/api/bice_empresas__conexion__verificar): Prueba las credenciales de la conexión contra BICE haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven. - [Consultar movimientos de BICE Empresas](/docs/api/bice_empresas__movimientos__consultar): Lee los movimientos ya sincronizados de esta conexión, del más reciente al más antiguo, filtrables por período (AAAA-MM), por cuenta y por 'type' (el eje credit/debit del libro del banco: 'debit' para los abonos, 'credit' para los cargos). Lectura pura: NO contacta al banco ni dispara una sincronización. Si el período nunca se sincronizó, devuelve una lista vacía, que NO significa que no haya movimientos. Para traer datos nuevos, usa 'bice_empresas.conexion.sincronizar' primero. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola), y 'display' es ese monto ya formateado a la chilena con su signo. 'saldoContable' es un balance: no lleva 'type' y conserva su propio signo. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas. reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar saldos de BICE Empresas](/docs/api/bice_empresas__saldos__consultar): Lee los saldos ya sincronizados de esta conexión, con el snapshot más reciente primero. Lectura pura: NO contacta al banco ni dispara una sincronización. Si nunca se sincronizó, devuelve una lista vacía. Para traer datos nuevos, usa 'bice_empresas.conexion.sincronizar' primero. Los saldos son un snapshot POR DÍA, así que sin filtro de fecha la primera página ya son los saldos más recientes que hay guardados. Los dos saldos vienen como NÚMERO y conservan su signo: un sobregiro es negativo. Un saldo no lleva 'type' (no es una operación). Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; nunca lo construyas a mano. - [Crear un enlace para conectar un sistema](/docs/api/conexiones__enlace__crear): Crea un enlace de un solo uso donde la persona entrega sus credenciales del sistema para conectarlo. Devuelve el enlace SIEMPRE con su dominio completo visible y explicando quién lo pidió y para qué; nunca lo presentes como un aviso del banco ni del SII. La credencial se cifra en el vault de esta misma organización y no la ve nadie más, tampoco tú. El enlace vence y sirve una sola vez. Después de que la persona lo complete, usa 'conexiones.estado.consultar' para saber si ya hay datos. - [Consultar el estado de las conexiones](/docs/api/conexiones__estado__consultar): Dice en qué va cada conexión: si la credencial quedó vinculada, qué sincronizaciones corrieron y si YA HAY DATOS para consultar ('datosListos'). Úsala después de que la persona complete un enlace, y antes de intentar leer: un listado vacío no significa que no haya nada, puede ser que todavía no sincronizó. La primera sincronización de un sistema con navegador puede tardar cerca de un minuto. El campo 'herramientas' trae los ids que ya puedes invocar; si tu cliente MCP todavía no los muestra en su lista, invócalos con la herramienta 'execute' pasando el id en 'tool'. - [Listar los sistemas que se pueden conectar](/docs/api/conexiones__sistemas__listar): Devuelve el catálogo de sistemas chilenos que esta organización puede conectar (bancos, SII) con el estado de cada uno: si ya está conectado, sus conexiones, los módulos de datos que ofrece y las herramientas que quedan disponibles al conectarlo. Úsala SIEMPRE antes de crear un enlace, para obtener el código exacto del sistema, no lo adivines. Si un sistema aparece con 'conectado' en false, el camino es 'conexiones.enlace.crear'. - [Hora del servidor](/docs/api/core__timestamp__now): Devuelve la marca de tiempo actual del servidor (ISO-8601 UTC, epoch Unix) y la zona horaria solicitada. Prueba el camino E2E; no requiere credenciales. - [Reflejar mensaje](/docs/api/echo__message__reflect): Devuelve el texto recibido junto con su longitud. Conector de ejemplo que prueba que el patrón del registry generaliza; no requiere credenciales. - [Serie histórica del indicador](/docs/api/indicadores__serie__consultar): Devuelve la serie de valores de un indicador entre dos fechas (AAAA-MM-DD), en orden ascendente, acotada por 'limite' (tope duro 1000), leída del almacén de referencia global. - [Valor actual del indicador](/docs/api/indicadores__valor__actual): Devuelve el ÚLTIMO valor disponible de un indicador económico chileno (UF, DÓLAR, EURO, IPC, UTM), leído del almacén de referencia global; no consulta fuentes externas en tiempo real. 'último disponible' NO es lo mismo que 'el de hoy', y hay que mirar 'fecha' antes de usar el número: la UF y la UTM se publican por ADELANTADO, así que su fecha puede ser futura; y si la ingesta se atrasa, la fecha queda en el pasado. 'antiguedadDias' resuelve las dos de una vez: 0 = es el de hoy, positivo = días de atraso, negativo = está fechado en el futuro. - [Valor del indicador a una fecha](/docs/api/indicadores__valor__consultar): Devuelve el valor de un indicador vigente a una fecha dada (AAAA-MM-DD) CON ARRASTRE: si esa fecha no tiene dato propio (un fin de semana, un feriado, o una fuente que no se ha actualizado) devuelve el último valor anterior. La 'fecha' de la respuesta puede ser DISTINTA de la solicitada, y 'esArrastre' lo marca: false = ese día tiene dato propio; true = el valor corresponde a la 'fecha' devuelta, que es anterior. Pedir una fecha futura devuelve el último valor conocido con 'esArrastre: true', no un error. Todo se lee del almacén de referencia global. - [Verificar conexión Notta](/docs/api/notta__conexion__verificar): Prueba las credenciales de la conexión contra Notta haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven. - [Consultar un DTE](/docs/api/notta__dte__consultar): Consulta el estado actual de un DTE en Notta por su id. Es el seguimiento del flujo asíncrono que abre notta.dte.emitir: el estado avanza de 'queued' a 'EPR' (aceptado por el SII) o a un rechazo terminal (RFR/RCT/RSC), y en ese caso sii_glosa trae el motivo que dio el SII. Devuelve también folio, montos calculados y ambiente SII. - [Descargar el XML o el PDF de un DTE](/docs/api/notta__dte__descargar): Devuelve el XML firmado o el PDF de un DTE como base64. Para consumo programático (REST/SDK). En conversación prefiere notta.dte.reenviar: el base64 de un PDF es inmanejable en chat. Un documento recién emitido todavía no está firmado: hasta que lo esté, la descarga falla de forma reintentable. - [Emitir DTE (factura o nota)](/docs/api/notta__dte__emitir): Emite un DTE ante el SII vía Notta: factura afecta (33), exenta (34), nota de débito (56) o nota de crédito (61, que exige references[] al documento original, y este solo puede ser una factura 33 o 34). Cada item declara si es exento y su monto_item (cantidad × precio_unitario, ya con el descuento de la línea aplicado); los TOTALES del documento (neto, exento, IVA, total) los calcula Notta. Las NOTAS (56/61) exigen además rut_emisor (el RUT de la empresa de esta conexión, que Notta no deriva en esa ruta) y la nota de débito (56) exige nd_reason; a cambio, no llevan forma_pago ni descuento_global. La emisión es ASÍNCRONA: esta llamada devuelve el documento con folio asignado y estado 'queued'; haz el seguimiento con notta.dte.consultar hasta EPR (aceptado) o un rechazo. Si un intento anterior falló por transporte o timeout, revisa los documentos RECIENTES con notta.dte.listar antes de reintentar, para no duplicar. Con correo_receptor, Notta envía el PDF+XML al receptor cuando el SII acepta. - [Listar los DTEs recientes](/docs/api/notta__dte__listar): Lista los DTEs MÁS RECIENTES emitidos por esta empresa en Notta (del más nuevo al más antiguo). El API de Notta NO ofrece filtros por tipo, fecha, estado ni receptor: solo un límite de cuántos traer, así que si buscas uno concreto pide más documentos y descarta tú los que no son. Úsalo como red antes de reintentar una emisión que falló por transporte o timeout: si el documento ya aparece entre los recientes, no lo vuelvas a emitir. Devuelve menos campos que notta.dte.consultar (sin neto, IVA ni ambiente): para el detalle completo consulta por id. - [Reenviar un DTE por correo](/docs/api/notta__dte__reenviar): Reenvía el PDF y el XML de un DTE ya emitido al correo del receptor. Sin correo_receptor usa el que ya tiene guardado el documento; con él, lo envía a esa dirección y la recuerda. Es el camino conversacional para entregar un documento: no descarga nada, lo envía. No emite ni modifica el DTE. - [Consultar certificados de cotizaciones de Previred](/docs/api/previred__certificados__consultar): Lee los certificados oficiales de cotizaciones ya emitidos para esta conexión, uno por trabajador. Es el documento que Previred firma y que una persona pide para probar lo que se le cotizó: 'certificadoUrl' es un enlace firmado para descargarlo. Hay un certificado VIGENTE por trabajador, que cada sincronización reemplaza, y cubre la ventana máxima que Previred admite terminando en el período sincronizado; 'periodoDesde' y 'periodoHasta' dicen cuál es. Si lo que buscas son los montos y no el documento, 'previred.cotizaciones.consultar' los tiene sin descargar nada. Lectura pura: NO contacta a Previred ni dispara una sincronización. Si el período nunca se sincronizó devuelve una lista vacía, que NO significa que no haya datos en Previred. Para traer datos nuevos, usa 'previred.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual; nunca lo construyas a mano. - [Sincronizar conexión Previred](/docs/api/previred__conexion__sincronizar): Sincroniza los alcances solicitados (planillas, cotizaciones, deuda, f301) para un período en una sola sesión de portal. Es el ÚNICO camino que trae datos de Previred: las tools '.consultar' leen lo que esto haya guardado. 'deuda' es el estado del momento y no del período, así que solo se sincroniza cuando se pide el período corriente. 'f301' trae el archivo de 106 campos con que la Dirección del Trabajo emite el Certificado F30-1 de ese período. 'certificados' emite el certificado oficial de cotizaciones de CADA trabajador y por eso es el alcance más caro: cuesta una petición al portal por persona. 'empresas' lista las empresas que la credencial administra y no cuesta ninguna petición: ese listado ya llega al iniciar sesión. - [Verificar conexión Previred](/docs/api/previred__conexion__verificar): Prueba las credenciales de la conexión contra Previred haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven. - [Consultar cotizaciones por trabajador de Previred](/docs/api/previred__cotizaciones__consultar): Lee las cotizaciones ya sincronizadas de esta conexión, por trabajador, período e institución. Es la materia prima del «certificado de cotizaciones» que emite Previred: el certificado en sí es un PDF que se genera para el rango que se pida, así que aquí viven los HECHOS (quién cotizó cuánto, a qué institución, en qué mes) y no el documento. Un mismo trabajador y mes trae varias filas, una por institución. Lectura pura: NO contacta a Previred ni dispara una sincronización. Si el período nunca se sincronizó devuelve una lista vacía, que NO significa que no haya datos en Previred. Para traer datos nuevos, usa 'previred.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar deuda previsional en Previred](/docs/api/previred__deuda__consultar): Lee la deuda previsional ya sincronizada de esta conexión, y responde la pregunta del mes: ¿está al día? Trae las dos mitades. 'dnp' son declaraciones sin pago, con su institución y sus cargos legales. 'por_pagar' son las nóminas cuyo plazo CORRE y aún no se pagan: ahí 'institucion' es "Todas" y solo viene 'montoTotal', porque el portal da un total por nómina sin desglosarlo. Recuerda el calendario: el plazo vence el día 13 del mes siguiente al de las remuneraciones. Ojo con 'montoTotal': Previred lo recalcula según la fecha en que efectivamente se pague, así que el valor guardado es el del momento de la sincronización (por eso cada fila trae 'observadoEn') y NO una cifra a la que uno pueda comprometerse. Lectura pura: NO contacta a Previred ni dispara una sincronización. Si el período nunca se sincronizó devuelve una lista vacía, que NO significa que no haya datos en Previred. Para traer datos nuevos, usa 'previred.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar empresas de la credencial de Previred](/docs/api/previred__empresas__consultar): Lista las empresas que la credencial de esta conexión administra en Previred. Sirve para saber qué OTRAS empresas se podrían conectar con la misma clave, que es la pregunta típica de un contador con varias empresas a cargo. Ojo: cada conexión de Connect es UNA empresa, así que ver una empresa aquí no significa poder leer sus datos; para eso hay que crear su propia conexión. Lectura pura: NO contacta a Previred ni dispara una sincronización. Si el período nunca se sincronizó devuelve una lista vacía, que NO significa que no haya datos en Previred. Para traer datos nuevos, usa 'previred.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar archivos para el F30-1 de Previred](/docs/api/previred__f301__consultar): Lee los archivos ya sincronizados con que la Dirección del Trabajo emite el Certificado F30-1 de Cumplimiento de Obligaciones Laborales y Previsionales, el que una empresa contratista tiene que entregarle a su mandante para que le paguen. Cada fila es el archivo de 106 campos de un período y una nómina, y 'archivoUrl' es un enlace firmado para descargarlo y subirlo al sitio de la Dirección del Trabajo. Connect NO emite el certificado: entrega el archivo con que se pide. Lectura pura: NO contacta a Previred ni dispara una sincronización. Si el período nunca se sincronizó devuelve una lista vacía, que NO significa que no haya datos en Previred. Para traer datos nuevos, usa 'previred.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar planillas pagadas de Previred](/docs/api/previred__planillas__consultar): Lee las planillas de cotizaciones ya sincronizadas de esta conexión, de la más reciente a la más antigua, filtrables por período (AAAA-MM) y por institución. Un pago de un período se abre en VARIAS planillas, una por cada institución previsional (AFP, Fonasa o Isapre, AFC, mutual, CCAF): por eso un mismo período trae varias filas y eso es lo normal, no una duplicación. Cada fila trae su 'folio', que es el identificador con que Previred la direcciona, y 'comprobanteUrl' cuando el PDF ya está descargado. Lectura pura: NO contacta a Previred ni dispara una sincronización. Si el período nunca se sincronizó devuelve una lista vacía, que NO significa que no haya datos en Previred. Para traer datos nuevos, usa 'previred.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas, reenvía ese valor tal cual; nunca lo construyas a mano. - [Consultar boletas de honorarios del SII](/docs/api/sii__boletas_honorarios__consultar): Lee las boletas de honorarios electrónicas (BHE) ya sincronizadas para esta conexión, filtradas por período y/o perspectiva (emitidas = las que emitió esta empresa; recibidas = las que le emitieron, donde esta empresa es el agente retenedor). Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el período nunca se sincronizó, devuelve una lista vacía y 'sincronizacion: null'. Para traer datos nuevos, usa 'sii.conexion.sincronizar' primero. El filtro tributario canónico es 'estado' distinto de 'S' sobre el código crudo: 'V' (anulación pendiente), 'R' y 'U' (observadas) siguen VIGENTES; solo 'S' está anulada: nunca filtres por 'estadoNormalizado' igual a 'vigente'. El 'estado' es el observado en la última sincronización del período, no el estado final: una BHE puede anularse, o revertir de anulación pendiente a vigente, hasta el 1 de marzo del año siguiente, y por petición administrativa sin plazo después. Resincroniza el período para refrescarlo; 'ultimaLecturaEn' dice cuándo se observó cada fila. La suma de 'retencion_receptor' es el insumo para cuadrar el F29 código 151, no el código 151: ese además incluye las retenciones por BTE y se imputa al mes del pago. 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. - [Consultar boletas electrónicas del SII](/docs/api/sii__boletas__consultar): Lee el resumen diario de boletas electrónicas ya sincronizado para esta conexión, filtrado por período. Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el período nunca se sincronizó, devuelve una lista vacía y 'sincronizacion: null'. Para traer datos nuevos, use '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. - [Sincronizar conexión SII](/docs/api/sii__conexion__sincronizar): Sincroniza los alcances solicitados (rcv, boletas, guias, boletas_honorarios, documentos) para un período en una sola sesión (un login, un logout). - [Verificar conexión SII](/docs/api/sii__conexion__verificar): 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](/docs/api/sii__documentos__consultar): 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 período nunca se sincronizó, devuelve una lista vacía y 'sincronizacion: null'; para traer datos nuevos usa 'sii.conexion.sincronizar' primero. Este respaldo es lo que el RCV no tiene y no puede tener: el RCV dice qué documentos EXISTEN, este respaldo trae el documento. Sólo lo sirven las conexiones cuya credencial es la clave tributaria de una persona que representa a la empresa. 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. - [Detallar un documento respaldado del SII](/docs/api/sii__documentos__detallar): Devuelve UN documento tributario respaldado, con su detalle completo: los ítems (nombre, cantidad, unidad, precio unitario y monto), los giros, direcciones y comunas de emisor y receptor, y la forma de pago. El documento se identifica con las tres partes que lo hacen único ('tipoDte', 'folio' y 'rutEmisor'), y las tres salen de una fila de 'sii.documentos.consultar'. Lectura pura: NO contacta al SII, lee el XML que ya se respaldó y lo parsea en el momento. Si ese documento no está sincronizado, devuelve 'documento: null'. No es un error: es que no lo tenemos, así que sincroniza su período con 'sii.conexion.sincronizar' y vuelve a preguntar. El XML firmado sólo viaja si se pide 'incluirXml: true'; sin eso la respuesta trae el detalle ya estructurado, que es lo que casi siempre se necesita. Un ítem con 'cantidad', 'unidad' o 'precioUnitario' en null es un ítem que no los declaró (un flete, un descuento): no debe leerse como cero. - [Consultar guías de despacho del SII](/docs/api/sii__guias__consultar): Lee las guías de despacho electrónicas (DTE 52) ya sincronizadas para esta conexión, filtradas por período y/o perspectiva (emitidas = las que emitió esta empresa; recibidas = las que le emitieron). Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el período nunca se sincronizó, devuelve una lista vacía y 'sincronizacion: null'. Para traer datos nuevos, use 'sii.conexion.sincronizar' primero. Ojo: el SII solo conserva el detalle de guías de los últimos 6 meses, así que un período más viejo no se puede sincronizar aunque exista. 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. - [Consultar RCV del SII](/docs/api/sii__rcv__consultar): Lee el Registro de Compra-Venta ya sincronizado para esta conexión, filtrable por período, perspectiva, tipo de documento (tipoDte) y estado del registro. Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el período nunca se sincronizó, devuelve una lista vacía y 'sincronizacion: null'. Para traer datos nuevos, use '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. - [Changelog](/docs/changelog): Qué cambió en el catálogo y qué garantiza que construir encima sea seguro. - [Política de privacidad](/docs/privacidad): Qué datos trata Emisso Connect, cómo los protege, con quién los comparte y cómo se eliminan. ## Recursos máquina-legibles - Contrato OpenAPI completo (todos los conectores): [/docs/openapi.json](/docs/openapi.json) - Toda la documentación como Markdown: [/llms-full.txt](/llms-full.txt) - Cada página de arriba como Markdown: agrega .md a su URL, por ejemplo [/docs/empezar/conectar.md](/docs/empezar/conectar.md)