Integrar con tu agente de IA

Si programas con Claude, Cursor, ChatGPT o cualquier asistente con acceso a la web, no necesitas leer esta documentación entera ni pasarle archivos adjuntos. Hay una URL que le da todo el contexto de una vez.

El comando

redcumbre:init — Lee https://docs.redcumbre.cl/llms.txt y ejecuta el protocolo de arranque.

Cópialo y pégalo en una ventana nueva de tu asistente. No hace falta que agregues nada más.

Qué recibe tu agente

Ese archivo es un mapa del ecosistema escrito para que lo lea una máquina: la URL base, cómo autenticarse, qué dominios existen con su prefijo de rutas, y las reglas que aplican a todos los endpoints (paginación, idempotencia, forma de los errores).

No lo contiene todo. Lo que hace es decirle dónde está el resto.

Cuando tu agente necesita…	Va solo a…
Entender el panorama y elegir por dónde empezar	`llms.txt` — el archivo de arriba
El detalle narrativo de un dominio, con ejemplos	La guía correspondiente, enlazada desde ahí
Todas las guías juntas, en texto plano	`llms-full.txt`
Los campos exactos, tipos y validaciones	La especificación OpenAPI
Ubicar una ruta rápido, sin bajar el spec	El índice de rutas

Los dos últimos los genera el API en tiempo real, así que nunca están desactualizados respecto de lo que la plataforma realmente expone.

Qué va a pasar cuando lo pegues

El archivo trae un protocolo de arranque, así que tu agente no se queda esperando instrucciones. En este orden:

Comprueba que su copia esté vigente y la actualiza si hace falta, para no integrar contra una definición que ya cambió.
Saluda de inmediato, sin credenciales ni configuración. Una llamada real a producción —GET /hola— que responde un apodo distinto en cada invocación, tipo chungungo-turquesa-4821. Tu agente te lo dice, y ahí sabes que la integración ya está hablando con la plataforma.
Te pregunta qué quieres integrar y te ofrece las opciones: facturas, boletas de honorarios, boletas de terceros, consulta de RUT, webhooks o carga masiva. Ahí también mira qué credencial tienes: desde agosto de 2026 no queda ningún endpoint de datos abierto sin credencial —el catálogo global de UF, IVA, dólar, regiones y comunas vive en /global/… y exige una API key válida, aunque no exige ningún rol en particular—. Si tu proyecto ya tiene una configurada, la usa; si no, te lo dice en vez de inventar una.
Va directo a la receta del dominio que elijas.
Anota el avance en .redcumbre/estado.json de tu proyecto, para que la próxima vez —o desde otra conversación— no vuelva a preguntarte lo que ya sabe.

Ese archivo de estado guarda el nombre de la variable de entorno donde tienes la API key, nunca su valor, y va al .gitignore.

Cuando algo no calza: `redcumbre:issue`

redcumbre:issue — Reporta a Redcumbre el problema que acabamos de encontrar.

Es la otra línea copiable. Tu agente la reconoce igual que redcumbre:init, y también la ofrece por su cuenta cuando se topa con un error del servidor, con una guía que contradice el comportamiento real o con una ruta documentada que lo rechaza.

Qué se envía: la clasificación del problema, qué esperaba y qué pasó, la evidencia técnica de las llamadas involucradas y tu correo, para que puedan responderte. La empresa y la credencial las toma el servidor de la propia petición, así que no hay nada que tu agente pueda equivocar ahí.

Siempre te pregunta antes de enviar — cada vez, no una vez por conversación —, y después te entrega un número de caso. Guárdalo: es lo que tienes que citar si escribes a soporte.

Redcumbre revisa estos reportes para estabilizar la plataforma. El registro queda en un repositorio interno, así que no vas a poder consultarlo directamente; el número de caso es el handle.

Si no tienes API key todavía, este canal no aplica: escribe por el formulario de contacto.

Detalle completo, con el árbol de decisión de cuándo corresponde reportar y cuándo el problema es de la propia petición: Reportar un problema.

Si tu asistente no tiene terminal

ChatGPT, Claude.ai y Copilot Chat no van a poder ejecutar el paso 1. No es una falla de tu asistente ni de la plataforma: navegando la web no alcanzan el API.

El protocolo completo funciona en asistentes con acceso a una línea de comandos: Claude Code, Cursor, Codex CLI, Copilot en el IDE. Si estás en un chat web, pídele el resto del protocolo igual —el menú, las recetas, el código— y ejecuta tú mismo el curl del saludo cuando quieras comprobar la conexión.

Si ya sabes qué quieres hacer, díselo junto con la URL y se salta el menú. Para eso están los prompts de abajo.

Prompts listos para copiar

Los tres funcionan tal cual. Solo reemplaza lo que va entre <corchetes> por tus datos.

1. Integrar la emisión desde cero

Es el caso más común: ya tienes tu sistema andando y quieres que emita documentos tributarios.

Necesito integrar la facturación electrónica de Redcumbre en mi sistema.

Toda la información de la API está acá:
https://docs.redcumbre.cl/llms.txt

Léela primero, y sigue los enlaces que necesites para el detalle.

Mi caso: cuando el cliente aprieta el botón <"Confirmar pedido"> en mi aplicación,
quiero que se emita una <factura electrónica afecta> con los datos de esa venta.

Mi stack es <Node.js / PHP / Python / …> y los datos del cliente y las líneas del
pedido los tengo en <describe brevemente dónde: tu base de datos, tu modelo, etc.>.

Antes de escribir código, dime qué necesito tener configurado de mi lado y qué
datos me van a hacer falta para armar la petición.

2. Migrar desde otro proveedor

Si ya emites con otro sistema y quieres reemplazar esa capa.

Estoy migrando mi emisión de documentos tributarios electrónicos desde
<nombre del proveedor actual> hacia Redcumbre.

La documentación está acá:
https://docs.redcumbre.cl/llms.txt

Este es el código que hoy hace la emisión:

<pega acá tu función o módulo actual>

Quiero que me digas, en este orden:
1. Qué campos de mi payload actual tienen equivalente directo en la API
2. Cuáles no lo tienen, y qué hago con ellos
3. Qué campos exige la API que hoy no estoy enviando
4. Recién después, el código de reemplazo

No asumas equivalencias por el nombre del campo: confírmalas contra la
especificación OpenAPI.

3. Entender antes de escribir código

Cuando todavía estás evaluando, o necesitas explicarle el flujo a alguien.

Estoy evaluando integrar Redcumbre para emitir <liquidaciones factura /
facturas / boletas de honorarios>.

La documentación está acá: https://docs.redcumbre.cl/llms.txt

Explícame:
- El flujo completo de una emisión, de principio a fin
- Qué necesito tener configurado antes de la primera llamada
- Qué puede salir mal y cómo me entero
- Qué diferencia hay entre los modos de emisión y cuál me conviene

No escribas código todavía.

Si tu agente se traba

Suele ser porque se quedó con el mapa y no siguió los enlaces. Estas tres frases lo destraban:

Lee la especificación OpenAPI completa en https://api.redcumbre.cl/api-docs-json antes de asumir el nombre o el tipo de un campo.

Consulta la guía específica de este dominio, enlazada en la tabla de dominios del llms.txt.

Si necesitas todas las guías juntas, están en https://docs.redcumbre.cl/llms-full.txt

Y si lleva rato en una conversación larga y sospechas que quedó con una versión vieja de la documentación:

Vuelve a ejecutar el paso 0 del protocolo: pide https://docs.redcumbre.cl/llms-version.txt y compara el hash con el de tu copia.

Y un aviso que vale la pena adelantarle, porque es el error que más vemos:

El sandbox no es un servidor distinto. Hay una sola URL base y el modo sandbox es una propiedad de la API key. No inventes un host de sandbox.

Lo que tu agente no va a poder hacer

Estas tres cosas no se resuelven por API, y ningún asistente las va a conseguir por su cuenta. Si te dice que existe un registro automático, está alucinando:

Para	Necesitas
Llamar cualquier endpoint	Una API Key emitida para tu tenant
Usar un módulo concreto	Que el servicio esté habilitado en tu tenant
Emitir documentos tributarios	Un emisor DTE configurado, con certificado digital vigente y folios CAF

Escríbele a tu contacto en REDCUMBRE para cualquiera de las tres. Con la API Key en la mano, el resto tu agente lo puede hacer solo.

Recomendaciones

Pídele una key de sandbox para empezar. Una API Key de sandbox no llega al SII ni genera cobros, y su respuesta viene marcada con sandbox: true. El flag no se puede cambiar después: para producción se emite una key nueva. Ver Entornos y sandbox.

Que la primera llamada sea whoami. GET /{tenantSlug}/whoami confirma de una vez que la key es válida, que el tenantSlug es el correcto, qué roles tienes y si estás en sandbox. Ahorra la mitad de los problemas de configuración.

Pídele que use idempotencyKey. Protege contra emisiones duplicadas por timeout o doble click, y no todos los agentes lo agregan si no se lo pides.

Revisa que guarde el folio que devuelve la API. Es el error de integración más caro: el sistema guarda su propio correlativo interno y descarta el folio del SII, y después ninguna consulta encuentra nada.