Empieza aquí

Con tu asistente de IA

El texto que le entregas a ChatGPT, Claude o Cursor para que arme tu software sobre Emisso 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 Emisso, 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 Emisso. 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

  1. Crea una clave de API en connect.emisso.ai/api-keys y marca las conexiones de las empresas que va a usar tu software. La clave queda de solo lectura: lee los datos de esas conexiones y nada más. Si todavía no conectas ninguna empresa, el formulario te pide conectar una primero. Si tu software va a emitir facturas, notas, guías o boletas en el SII, abre «Configuración avanzada» y empieza desde «Lectura + emisión»: agrega los permisos sii:write y sii:boletas:write. Con una clave de solo lectura, emitir responde scope_not_granted. 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 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 Emisso y sigue con la nueva.

¿Quieres usar Emisso desde Claude o ChatGPT, sin programar?

Eso no necesita clave ni código: se conecta con una sola dirección. En Claude, los permisos se eligen al autorizar, y con los de emisión también emite en el SII, sin API key. 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.

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…» y envíalo.

¿Usas otra IA?

Lo que le pide a tu IA

  1. Que te pregunte dos cosas antes de escribir: dónde va a correr el software y para qué empresa.
  2. Que guarde la clave sin verla: te explica cómo dejarla como EMISSO_CONNECT_API_KEY en tu entorno y nunca te la pide.
  3. Que lea la documentación de Emisso y llame por REST, sin instalar nada.
  4. Que parta con una prueba: revisar a qué conexiones alcanza la clave. Después, un plan en pasos cortos.

Qué hace el prompt por ti

Le ordena al asistentePor qué importa
Leer /llms.txt, la guía de la primera llamada y el contrato OpenAPI antes de escribir códigoSin 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 imprimirlaLa clave abre todas tus empresas conectadas; un chat no es un lugar donde guardarla
Empezar por conexiones.estado.consultarDe 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 indiquesLa 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 elijasLa 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ésConsultar 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 emitirNo 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_idCada 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: listar las conexiones a las que alcanza tu clave, con conexiones.estado.consultar. Si aparecen las empresas que elegiste al crearla, la clave funciona; después el asistente te ayuda a elegir una y a leer sus datos con los permisos de esa clave.

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 lista de las conexiones a las que alcanza tu clave, por REST, para comprobarla 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.

En esta página