Emisso Connect

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.

Antes de pegarlo

Crea una clave de API en connect.emisso.ai/api-keys. El perfil «Solo lectura» alcanza para empezar. El texto de la clave se muestra una sola vez.
Guárdala con el nombre EMISSO_CONNECT_API_KEY en 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.

El prompt

Envíalo completo, incluidas las tres reglas del final, como primer mensaje de una conversación nueva.

Dale estas instrucciones a tu IA

Se abre con el texto ya escrito: lo revisas y lo envías tú. No lleva ninguna clave.

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.

¿Usas otra IA?

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_KEY en 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.

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
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.

Con tu asistente de IA