Con tu asistente de IA
El texto que le entregas a ChatGPT, Claude o Cursor para que arme tu software sobre Connect sin pedirte nunca la clave. Pensado para quien no programa.
Si armas tu propio sistema apoyándote en un asistente de IA, esta página es el atajo: un texto que le entregas entero al asistente antes de pedirle nada. Le dice cómo se llama Connect, dónde está la documentación, cómo se hace una llamada y las tres reglas que se saltan casi todos los que empiezan.
No necesitas saber programar para usarlo. El texto le ordena al asistente que escriba él el código y que te explique cada paso en lenguaje simple, y que antes de escribir te pregunte dos cosas: dónde va a correr tu software y para qué empresa es.
0. Crea tu cuenta
Crea tu cuenta gratis en Connect. Completa el registro y los datos de tu organización para empezar tu prueba de 7 días, sin tarjeta. Entra al panel desde el enlace que recibirás por correo y luego vuelve a esta guía.
Si ya tienes una cuenta, inicia sesión y continúa con la API key.
1. Prepara tu API key
- Crea una clave de API en connect.emisso.ai/api-keys y elige
el perfil según lo que vas a hacer. Para leer datos basta «Solo lectura». Si tu software va a
emitir facturas, notas, guías o boletas en el SII, elige «Lectura + emisión»: agrega los permisos
sii:writeysii:boletas:write. Con una clave de solo lectura, emitir respondescope_not_granted. El texto de la clave se muestra una sola vez. - Guárdala con el nombre
EMISSO_CONNECT_API_KEYen el lugar de secretos del entorno donde vaya a correr tu software: «Secrets» en Colab y en Replit, «Propiedades del script» en Apps Script, variables de entorno en un servidor. El propio asistente te explica dónde, si le dices cuál usas. - No pegues la clave en el chat. El prompt no la contiene y le prohíbe al asistente pedírtela, escribirla en el código o imprimirla. Con esa clave cualquiera lee el SII y los bancos de todas tus empresas conectadas. Si se te escapó en una conversación, rótala en Connect y sigue con la nueva.
¿Solo quieres preguntarle a Claude o a ChatGPT por tus datos?
Eso no necesita clave ni código: se conecta con una sola dirección. El camino está en Instala el servidor MCP.
2. Envía las instrucciones a tu IA
Usa los botones de abajo para abrir las instrucciones en tu asistente. Si usas otra herramienta, copia el texto completo y pégalo en su chat. Revísalo y envíalo como primer mensaje de una conversación nueva, incluidas las tres reglas del final.
Dale estas instrucciones a tu IA
Se abre con el texto ya escrito: lo revisas y lo envías tú. No lleva ninguna clave.
- Abrir en Claudeclaude.ai (abre en una pestaña nueva)
- Abrir en ChatGPTchatgpt.com (abre en una pestaña nueva)
- Abrir en Cursorcursor.com (abre en una pestaña nueva)
Claude te mostrará un aviso de seguridad: lo pone en todo texto que llega por un enlace. Revisa que empiece con «Vas a ayudarme a construir un software sobre Emisso Connect…» y envíalo.
Lo que le pide a tu IA
- Que te pregunte dos cosas antes de escribir: dónde va a correr el software y para qué empresa.
- Que guarde la clave sin verla: te explica cómo dejarla como
EMISSO_CONNECT_API_KEYen tu entorno y nunca te la pide. - Que lea la documentación de Connect y llame por REST, sin instalar nada.
- Que parta con una prueba: la UF de hoy. Después, un plan en pasos cortos.
Vas a ayudarme a construir un software sobre Emisso Connect, el puente a los sistemas chilenos de mi organización: SII, bancos e indicadores del Banco Central. Asume que no soy programador: escribe tú el código y explícame cada paso en lenguaje simple.
Antes de escribir nada, pregúntame dos cosas: dónde va a correr el software (mi computador, Google Sheets con Apps Script, Colab, Replit, n8n, un servidor u otro) y para qué empresa es, por nombre o RUT.
La clave de acceso ya existe y se llama EMISSO_CONNECT_API_KEY. Explícame cómo guardarla con ese nombre en el lugar de secretos del entorno que te indique, y lee siempre el valor desde ahí. Nunca me pidas la clave, no la escribas en el código, no la imprimas en pantalla ni en logs; si te la muestro por error, dime que la rote en Connect.
Lee la documentación para máquinas antes de escribir: el índice es https://connect.emisso.ai/llms.txt, empieza por https://connect.emisso.ai/docs/empezar/primera-llamada.md y el contrato es https://connect.emisso.ai/docs/openapi.json. Si no puedes abrir enlaces, dímelo antes de escribir código y te pego el contenido.
Connect se llama por REST: POST https://connect.emisso.ai/api/v1/tools/<id de la herramienta>/execute con la cabecera Authorization: Bearer y el valor de esa variable, y el cuerpo {"input": {...}}. Usa la librería HTTP que ya trae el entorno (fetch, requests, UrlFetchApp); no instales ningún SDK ni paquete de Connect. Toda respuesta llega como {"data": ..., "meta": {"request_id": ...}} y todo error como {"error": {"code", "message", "request_id", "suggested_fix"}}. La lista de herramientas que ESTA clave puede usar sale de GET https://connect.emisso.ai/api/v1/tools; no inventes ninguna.
Tres reglas que no se pueden saltar:
- Empieza por conexiones.estado.consultar: devuelve las empresas conectadas, el connectionId de cada una y si ya tienen datos listos.
- connectionId es obligatorio en toda herramienta de un sistema conectado (SII, bancos, Previred, Notta, Mercado Público), incluso si hay una sola empresa; en REST viaja en la cabecera X-Connect-Connection. La conexión es la empresa: usa la que yo te indique, nunca la primera de la lista. La lista no trae el RUT y casi todas las conexiones se llaman como su sistema («SII»), así que no busques la empresa por nombre ni por RUT en el código: muéstrame la lista una vez, yo elijo, y guarda ese connectionId como configuración junto a la clave.
- Leer datos del SII, de un banco o de Previred son dos pasos: <sistema>.conexion.sincronizar trae los datos y vuelve al instante con un jobId, sin esperar el login; <recurso>.consultar lee lo ya guardado. Un .consultar nunca pregunta en vivo. Sincronizar requiere un plan activo: sin plan responde 402 subscription_required. Notta y los indicadores se leen directo.
Si te pido emitir documentos en el SII (facturas, notas, guías o boletas), lee antes https://connect.emisso.ai/docs/emitir.md. La clave necesita el permiso sii:write, y para boletas también sii:boletas:write; si una herramienta de emisión responde scope_not_granted, dime que cree la clave con el perfil «Lectura + emisión» en Connect. No hay ambiente de prueba: todo documento emitido es real y consume folio, así que previsualiza siempre, muéstrame la vista previa y espera mi confirmación antes de emitir.
Ante un error, sigue el suggested_fix si la respuesta lo trae; qué errores se pueden reintentar está en https://connect.emisso.ai/docs/referencia/errores.md, y lo demás no se reintenta. Si no lo reconoces, muéstrame el request_id.
Primera prueba: escribe el código que consulte indicadores.valor.actual con {"codigo":"UF"} y dime cómo lo corro yo para ver el valor. Después, un plan en pasos cortos para lo que quiero construir, avanzando de a uno.
Qué hace el prompt por ti
| Le ordena al asistente | Por qué importa |
|---|---|
Leer /llms.txt, la guía de la primera llamada y el contrato OpenAPI antes de escribir código | Sin eso inventa nombres de herramientas que no existen y después no sabe explicar el error |
| Leer la clave desde la variable de entorno, y nunca pedírtela ni imprimirla | La clave abre todas tus empresas conectadas; un chat no es un lugar donde guardarla |
Empezar por conexiones.estado.consultar | De ahí salen las empresas conectadas, el connectionId de cada una y si ya tienen datos listos |
Mandar siempre el connectionId de la empresa que tú le indiques | La conexión es la empresa. Elegir la primera de la lista es leerle los datos a otro cliente |
Mostrarte la lista de conexiones y guardar el connectionId que elijas | La lista no trae el RUT y casi todas se llaman como su sistema: un código que busque la empresa por nombre no la encuentra |
| Sincronizar primero y consultar después | Consultar lee lo ya guardado y nunca pregunta en vivo. Un listado vacío puede ser que todavía no sincronizó. Sincronizar requiere un plan activo |
Si vas a emitir, leer la guía de emisión, revisar que la clave tenga sii:write y mostrarte la vista previa antes de emitir | No hay ambiente de prueba: cada documento emitido es real, consume folio y le llega al SII y al receptor |
Seguir el suggested_fix del error y mostrarte el request_id | Cada llamada deja una fila en la bitácora con ese identificador, y es lo primero que pide soporte |
El texto termina pidiéndole una primera prueba concreta: el valor de la UF de hoy, que no necesita ninguna empresa conectada. Si esa prueba te devuelve un número, el camino completo funciona.
Si el asistente no puede abrir enlaces
Algunos asistentes no navegan. El prompt les pide que te avisen antes de escribir código; cuando pase,
abre /llms.txt y tu primera llamada, copia el contenido
y pégaselo en la conversación.
Próximos pasos
- Tu primera llamada: la UF de hoy por REST, para comprobar la clave por tu cuenta antes de delegarle nada al asistente.
- Conecta tu primera empresa: el enlace con el que tu cliente entrega su clave del SII, sin que pase por tu código.
- Sincronizar y consultar: por qué leer datos reales son dos pasos.