# Con tu asistente de IA

> El texto que le entregas a ChatGPT, Claude o Cursor para que arme tu software sobre Emisso con SUNAT y tus bancos, sin pedirte nunca la clave.



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 Emisso, dónde está la
documentación, cómo se hace una llamada y las reglas que se saltan casi todos los que empiezan.

No necesitas saber programar. El texto le ordena al asistente que escriba él el código, que te explique
cada paso en lenguaje simple y que antes te pregunte dónde va a correr tu software y para qué empresa es.

## 1. Crea tu cuenta y conecta tu empresa [#1-crea-tu-cuenta-y-conecta-tu-empresa]

[Crea tu cuenta](https://connect.emisso.ai/sign-up?pais=PE) y elige Perú. Después conecta
[SUNAT](/docs/peru/sunat-preparacion) o [tu banco](/docs/peru/bancos) desde el panel.

## 2. Prepara tu API key [#2-prepara-tu-api-key]

1. **Crea una clave de API** en [connect.emisso.ai/api-keys](https://connect.emisso.ai/api-keys) y marca
   las conexiones que va a usar tu software. La clave lee los datos de esas conexiones y nada más. El
   texto de la clave se muestra una sola vez.
2. **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.
3. **No pegues la clave en el chat.** El texto no la contiene y le prohíbe al asistente pedírtela,
   escribirla en el código o imprimirla. Si se te escapó en una conversación, rótala en Emisso.

<Callout type="info" title="¿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](/docs/agentes/mcp).
</Callout>

## 3. Envía las instrucciones a tu IA [#3-envía-las-instrucciones-a-tu-ia]

Copia el texto completo y envíalo como primer mensaje de una conversación nueva. Es el mismo que muestra
Emisso al crear una API key en una organización de Perú.

```text
Vas a ayudarme a construir un software sobre Emisso, el puente a los sistemas peruanos de mi organización: SUNAT y bancos. 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 RUC.

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

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

Emisso 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 Emisso. 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:
1. Empieza por conexiones.estado.consultar: devuelve las empresas conectadas, el connectionId de cada una y si ya tienen datos listos.
2. connectionId es obligatorio en toda herramienta de un sistema conectado (SUNAT y bancos), 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 RUC y casi todas las conexiones se llaman como su sistema («SUNAT»), así que no busques la empresa por nombre ni por RUC en el código: muéstrame la lista una vez, yo elijo, y guarda ese connectionId como configuración junto a la clave.
3. Los datos los sincroniza Emisso: las herramientas <recurso>.consultar leen lo ya guardado y nunca preguntan en vivo. Si una consulta llega vacía o con sincronizacion en null, todavía no hay una lectura guardada de ese período: dímelo y no lo trates como cero documentos. Si falta un período, lo pido a Emisso.

Emisso no emite comprobantes ni presenta libros o declaraciones ante SUNAT: si te pido algo así, dime que no está disponible.

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: consulta conexiones.estado.consultar con {} para comprobar a qué conexiones alcanza esta clave. Después, ayúdame a elegir una de esas conexiones y ejecutar una lectura de sus datos entre las herramientas autorizadas. Un plan en pasos cortos, avanzando de a uno.
```

## Qué hace el texto por ti [#qué-hace-el-texto-por-ti]

| Le ordena al asistente                                                                                            | Por qué importa                                                                                            |
| ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Leer `/llms.txt`, [tu primera llamada](/docs/peru/primera-llamada) y el contrato OpenAPI antes de escribir código | Sin eso inventa nombres de herramientas que no existen                                                     |
| 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` y mandar siempre el `connectionId` que tú elijas                        | La conexión es la empresa. Elegir la primera de la lista es leerle los datos a otra                        |
| Leer con las herramientas `.consultar` y no tratar una lectura vacía como cero documentos                         | Emisso sincroniza los datos; una consulta sin lectura guardada todavía no tiene información de ese período |
| No intentar emitir comprobantes ni presentar libros                                                               | Emisso no lo hace en Perú                                                                                  |

## Si el asistente no puede abrir enlaces [#si-el-asistente-no-puede-abrir-enlaces]

Algunos asistentes no navegan. El texto les pide que te avisen antes de escribir código; cuando pase,
abre [`/llms.txt`](/llms.txt) y [tu primera llamada](/docs/peru/primera-llamada), copia el contenido y
pégaselo en la conversación.


---

Esta página es parte de la documentación de Emisso Connect. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/peru/con-tu-asistente-de-ia.