# Simplo > API de facturación electrónica (DTE) para Chile: emite facturas y boletas, administra folios (CAF), certificado digital y webhooks detrás de una API REST, con SDK TypeScript y acceso MCP de solo lectura para agentes. Para integrar: `npm install @simplohq/sdk` y sigue el playbook para coding agents (https://docs.simplo.cl/agentes/para-coding-agents/index.md). Lectura de datos por MCP: endpoint `https://api.simplo.cl/api/v1/mcp` (transporte HTTP, header `X-Api-Key`). El contrato OpenAPI 3.0 vive en https://docs.simplo.cl/openapi.yaml; las 27 operaciones también están en markdown en https://docs.simplo.cl/api-reference.md. Cada página de estas docs existe en markdown puro: agrega `index.md` al final de la URL (ej. https://docs.simplo.cl/comienza/quickstart/index.md). Importante: la escritura vía API key (emisión de DTE) está en beta privada — pide acceso en hola@simplo.cl. Nunca inventes API keys ni endpoints. In English: Simplo is a Chilean electronic invoicing (DTE) API. Install `@simplohq/sdk`, follow the agent playbook above; API write access is in private beta. ## Comienza - [Introducción](https://docs.simplo.cl/comienza/introduccion/index.md): Qué es la API de Simplo, qué es un DTE y qué necesitas para emitir tu primer documento tributario electrónico en Chile. - [Quickstart](https://docs.simplo.cl/comienza/quickstart/index.md): Emite tu primer DTE (factura electrónica chilena) contra la API REST de Simplo — con curl, C#, Java, Python o el SDK TypeScript — y sigue su estado en el SII. - [Autenticación](https://docs.simplo.cl/comienza/autenticacion/index.md): API keys de Simplo (sk_simplo_), el header X-Api-Key, creación, revocación e higiene de credenciales. - [Multi-empresa](https://docs.simplo.cl/comienza/multi-empresa/index.md): Cómo operar varias empresas con Simplo — una API key por empresa hoy, credenciales de plataforma en el roadmap. ## Referencia - [El contrato OpenAPI](https://docs.simplo.cl/referencia/contrato-openapi/index.md): La especificación OpenAPI 3.0 de la API de Simplo — descárgala, impórtala en Postman o genera un cliente C#, Java o TypeScript desde el contrato. - [Tipos de DTE](https://docs.simplo.cl/referencia/tipos-de-dte/index.md): Los 12 tipos de documento tributario electrónico que soporta la API de Simplo, con sus códigos SII y requisitos específicos. - [Estados](https://docs.simplo.cl/referencia/estados/index.md): El ciclo de vida de un DTE en la API de Simplo — los 8 estados públicos, desde borrador hasta el veredicto del SII. - [Emisión](https://docs.simplo.cl/referencia/emision/index.md): Emitir un DTE con la API de Simplo — el endpoint POST /api/v1/billing/dte, la Idempotency-Key obligatoria y el flujo asíncrono hacia el SII. - [Folios y CAF](https://docs.simplo.cl/referencia/folios-caf/index.md): Qué es un CAF, cómo se suben los folios autorizados por el SII a la API de Simplo y cómo evitar quedarte sin folios. - [Certificado digital](https://docs.simplo.cl/referencia/certificado-digital/index.md): El certificado digital que firma cada DTE — dónde se carga en Simplo y cómo monitorear su vigencia. - [Webhooks](https://docs.simplo.cl/referencia/webhooks/index.md): El contrato de webhooks de la API de Simplo — eventos del ciclo de vida DTE, registro de endpoints y verificación de firma Standard Webhooks. - [Errores](https://docs.simplo.cl/referencia/errores/index.md): Códigos de error de la API de Simplo, clases de error del SDK por status HTTP y las reglas de reintento automático. - [Paginación](https://docs.simplo.cl/referencia/paginacion/index.md): Paginación por cursor en la API de Simplo — Page, auto-paginación con for await y checkpoints manuales de cursor. - [Límites](https://docs.simplo.cl/referencia/limites/index.md): Rate limits de la API de Simplo — 120 llamadas por minuto por empresa, compartido entre REST y MCP, y cómo manejarlos. ## Agentes - [Conecta tu agente](https://docs.simplo.cl/agentes/conecta-tu-agente/index.md): Dale a un agente de IA acceso de solo lectura a tus datos de Simplo vía MCP — endpoint, Claude Code, Claude Desktop y preguntas que funcionan. - [Para coding agents](https://docs.simplo.cl/agentes/para-coding-agents/index.md): Playbook autocontenido para la tarea "integra la facturación electrónica de Simplo en esta app" — flujo canónico de emisión, errores, idempotencia, testing y checklist. - [SDK TypeScript](https://docs.simplo.cl/agentes/sdk/index.md): @simplohq/sdk — el SDK open source de Simplo: cero dependencias, tipos estrictos para los 12 tipos de DTE, idempotencia y reintentos automáticos. - [Agent Skill simplo-invoicing](https://docs.simplo.cl/.well-known/skills/index.json): skill instalable (`npx skills add https://docs.simplo.cl`) con el playbook de emisión, errores, tipos de DTE, multi-empresa y webhooks. - [Repo del SDK TypeScript](https://github.com/SimploHQ/simplo-sdk): `@simplohq/sdk` open source, con su propio AGENTS.md y llms.txt. ## Referencia API (endpoints) - [Contrato OpenAPI 3.0](https://docs.simplo.cl/openapi.yaml): la especificación completa de la API (fuente de la referencia). - [Referencia API en un solo markdown](https://docs.simplo.cl/api-reference.md): las 27 operaciones concatenadas (parámetros, schemas, ejemplos curl, respuestas). - [Listar DTEs (GET /api/v1/billing/dte)](https://docs.simplo.cl/api/operations/listardtes/index.md): Listado con paginación basada en cursor. - [Emitir DTE (POST /api/v1/billing/dte)](https://docs.simplo.cl/api/operations/emitirdte/index.md): Emite un Documento Tributario Electrónico. - [Obtener DTE por ID (GET /api/v1/billing/dte/{id})](https://docs.simplo.cl/api/operations/obtenerdte/index.md): Retorna el DTE completo con estado actual, tracking del envío al SII y último detalle de consulta de estado. - [Descargar PDF del DTE (GET /api/v1/billing/dte/{id}/pdf)](https://docs.simplo.cl/api/operations/descargardtepdf/index.md): Genera y retorna la representación impresa del DTE en PDF, con timbre electrónico PDF417 y datos tributarios. - [Descargar XML del DTE (GET /api/v1/billing/dte/{id}/xml)](https://docs.simplo.cl/api/operations/descargardtexml/index.md): Retorna el XML firmado del DTE en encoding ISO-8859-1. - [Listar CAFs (GET /api/v1/billing/caf)](https://docs.simplo.cl/api/operations/listarcafs/index.md): Lista los CAFs (Códigos de Autorización de Folios) de la empresa con la cantidad de folios disponibles por cada uno. - [Subir CAF XML (POST /api/v1/billing/caf)](https://docs.simplo.cl/api/operations/subircaf/index.md): Sube un Código de Autorización de Folios obtenido desde el SII. - [Detalle CAF (GET /api/v1/billing/caf/{id})](https://docs.simplo.cl/api/operations/obtenercaf/index.md): Retorna el detalle de un CAF con rango de folios y disponibilidad. - [Obtener empresa actual (GET /api/v1/billing/empresa)](https://docs.simplo.cl/api/operations/obtenerempresa/index.md): Retorna los datos tributarios de la empresa asociada a la credencial actual (JWT o API key). - [Actualizar datos empresa (PUT /api/v1/billing/empresa)](https://docs.simplo.cl/api/operations/actualizarempresa/index.md): Actualiza datos tributarios y de contacto de la empresa emisora. - [Ver estado certificado (GET /api/v1/billing/empresa/certificado)](https://docs.simplo.cl/api/operations/estadocertificado/index.md): Retorna el estado del certificado digital de firma (vigencia, RUT del firmante) sin exponer claves privadas. - [Subir certificado digital (PFX/P12) (POST /api/v1/billing/empresa/certificado/pfx)](https://docs.simplo.cl/api/operations/subircertificadopfx/index.md): Sube un certificado digital en formato `.pfx` o `.p12` vía `multipart/form-data`. - [Listar webhooks (GET /api/v1/billing/webhooks)](https://docs.simplo.cl/api/operations/listarwebhooks/index.md): Lista los webhooks registrados para la empresa. - [Registrar webhook (POST /api/v1/billing/webhooks)](https://docs.simplo.cl/api/operations/registrarwebhook/index.md): Registra una URL HTTPS para recibir eventos vía webhook. - [Eliminar webhook (DELETE /api/v1/billing/webhooks/{id})](https://docs.simplo.cl/api/operations/eliminarwebhook/index.md): Elimina un webhook registrado. - [Listar clientes (GET /api/v1/billing/clientes)](https://docs.simplo.cl/api/operations/listclientes/index.md): Listado de clientes con paginación basada en cursor. - [Crear cliente (POST /api/v1/billing/clientes)](https://docs.simplo.cl/api/operations/createcliente/index.md): Crea un cliente (receptor frecuente) en el catálogo de la empresa. - [Buscar clientes por nombre o RUT (GET /api/v1/billing/clientes/search)](https://docs.simplo.cl/api/operations/searchclientes/index.md): Búsqueda rápida de clientes por razón social o RUT. - [Obtener cliente por ID (GET /api/v1/billing/clientes/{id})](https://docs.simplo.cl/api/operations/getcliente/index.md): Retorna un cliente del catálogo por su UUID. - [Actualizar cliente (PUT /api/v1/billing/clientes/{id})](https://docs.simplo.cl/api/operations/updatecliente/index.md): Actualiza datos de un cliente existente. - [Eliminar cliente (soft delete) (DELETE /api/v1/billing/clientes/{id})](https://docs.simplo.cl/api/operations/deletecliente/index.md): Elimina un cliente del catálogo (soft delete). - [Listar productos (GET /api/v1/billing/productos)](https://docs.simplo.cl/api/operations/listproductos/index.md): Listado de productos con paginación basada en cursor. - [Crear producto (POST /api/v1/billing/productos)](https://docs.simplo.cl/api/operations/createproducto/index.md): Crea un producto o servicio en el catálogo de la empresa. - [Buscar productos por nombre o código (GET /api/v1/billing/productos/search)](https://docs.simplo.cl/api/operations/searchproductos/index.md): Búsqueda rápida de productos por nombre o código. - [Obtener producto por ID (GET /api/v1/billing/productos/{id})](https://docs.simplo.cl/api/operations/getproducto/index.md): Retorna un producto del catálogo por su UUID. - [Actualizar producto (PUT /api/v1/billing/productos/{id})](https://docs.simplo.cl/api/operations/updateproducto/index.md): Actualiza datos de un producto existente. - [Eliminar producto (soft delete) (DELETE /api/v1/billing/productos/{id})](https://docs.simplo.cl/api/operations/deleteproducto/index.md): Elimina un producto del catálogo (soft delete). ## Optional - [llms-small.txt](https://docs.simplo.cl/llms-small.txt): versión compacta de toda la documentación en un solo archivo. - [llms-full.txt](https://docs.simplo.cl/llms-full.txt): toda la documentación de guías en un solo archivo. - [Overview in English](https://docs.simplo.cl/en/index.md): Emit Chilean electronic tax documents (DTEs) with a typed API, a TypeScript SDK and docs designed for coding agents. - [Quickstart in English](https://docs.simplo.cl/en/comienza/quickstart/index.md): Install the Simplo SDK, emit your first DTE (Chilean electronic invoice) and follow its SII status in a few minutes.