# SII SDK (Devlas): reglas para agentes de código

Este proyecto usa SII SDK, la librería TypeScript de Devlas para emitir documentos tributarios electrónicos ante el SII de Chile. Antes de escribir código que la use, lee la documentación en Markdown.

## Dónde leer

- Toda la documentación en un archivo: https://sii.devlas.cl/llms-full.txt
- Índice: https://sii.devlas.cl/llms.txt
- Servidor MCP de documentación: https://sii.devlas.cl/mcp
- Introducción a SII SDK: https://sii.devlas.cl/docs/introduccion.md
- Niveles y paquetes: https://sii.devlas.cl/docs/tiers.md
- Instalación: https://sii.devlas.cl/docs/instalacion.md
- Primeros pasos: emitir una boleta: https://sii.devlas.cl/docs/primeros-pasos.md
- Usar con agentes y MCP: https://sii.devlas.cl/docs/usar-con-agentes.md

## Reglas

1. Node.js 24 o superior, solo ESM. Los paquetes son @devlas-cl/* desde GitHub Packages; usa el .npmrc del proyecto y el token en la variable NODE_AUTH_TOKEN, nunca en el repositorio.
2. Instala todos los paquetes @devlas-cl con la misma etiqueta de versión.
3. Las operaciones devuelven Resultado<T, ErrorSii> y no lanzan por datos del usuario ni del SII. Revisa siempre `ok` antes de usar `valor`.
4. El texto del SII llega literal en el error. No lo reinterpretes ni lo recortes; muéstralo o guárdalo tal cual.
5. La librería no guarda datos ni agenda tareas. Tu sistema decide dónde viven los CAF, el XML firmado y el estado de cada envío, y cuándo volver a consultar.
6. Folios: ante un bloqueo, reobtener lo ya autorizado antes de pedir más; anular folios es irreversible y es el último recurso.
7. No inventes funciones ni campos: usa solo lo que aparece en la referencia de la API.
8. No redistribuyas la librería ni su código a terceros.

## Contacto

WhatsApp +56 9 7226 9035, correo ti@devlas.cl.