# foliios > API y MCP para facturación electrónica ante la DIAN (Colombia). Esta es la documentación para agentes de código: cada página tiene una versión en Markdown. Si una persona te pidió integrar su proyecto con foliios en sandbox, empieza por https://docs.dev.foliios.com/agentes/manual-agente.md y síguelo fase por fase. El contenido completo de todas las páginas, en un solo archivo: https://docs.dev.foliios.com/llms-full.txt. ## Empezar - [Ambientes y claves](https://docs.dev.foliios.com/empezar/ambientes-y-claves.md): Los tres ambientes de foliios (sandbox, habilitación y producción), la clave de cada uno y cómo cuidarlas. - [CUFE y CUDE](https://docs.dev.foliios.com/empezar/codigos-de-validacion.md): Qué son el CUFE y el CUDE, de dónde salen, dónde los ves y para qué los necesitas. - [Empresas](https://docs.dev.foliios.com/empezar/empresas.md): Cómo se organizan las cuentas, las empresas emisoras y sus ambientes, y qué se configura en el portal. - [Estados del documento](https://docs.dev.foliios.com/empezar/estados-del-documento.md): Los estados por los que pasa un documento, qué significa cada uno, qué hacer en cada caso y cuál es el estado de la entrega. - [Numeración y series NC y ND](https://docs.dev.foliios.com/empezar/numeracion-y-series.md): Cómo se numera cada documento, qué es una resolución, por qué las notas crédito y débito tienen series propias y cuándo se libera un número. - [Qué es foliios](https://docs.dev.foliios.com/empezar/que-es-foliios.md): Qué hace foliios, para quién es y cómo se relacionan sus piezas. - [Inicio rápido](https://docs.dev.foliios.com/inicio-rapido.md): Emite tu primera factura en el sandbox de foliios en cinco minutos, con curl y con Python. ## Guías - [Borradores y aprobación](https://docs.dev.foliios.com/guias/borradores-y-aprobacion.md): Cómo un agente prepara un documento que una persona aprueba antes de emitirse, qué se valida, qué pasa con la numeración y qué límites se aplican. - [Contingencia](https://docs.dev.foliios.com/guias/contingencia.md): Qué pasa cuando la DIAN no responde (contingencia tipo 04), qué hace foliios por ti, cómo probarla en el sandbox y en qué se diferencia de la contingencia del facturador. - [Emitir una factura](https://docs.dev.foliios.com/guias/emitir-factura.md): Cómo emitir una factura electrónica por la API, con comprador identificado y a consumidor final, y cómo seguir su estado. - [Entrega por correo](https://docs.dev.foliios.com/guias/entrega-por-correo.md): Cómo foliios entrega el documento al comprador, cómo leer el estado de la entrega, reenviarla, descargar el PDF y el contenedor y qué pasa con los rebotes. - [Factura de papel (contingencia del facturador)](https://docs.dev.foliios.com/guias/factura-de-papel.md): Cómo declarar una contingencia del facturador, transcribir cada factura de talonario o papel, cerrar el período y cumplir el plazo de transmisión. - [Habilitación ante la DIAN](https://docs.dev.foliios.com/guias/habilitacion.md): De la cuenta a tu primera factura en el ambiente de habilitación (test): software, resolución, certificado, set de pruebas y clave sk_test. - [Idempotencia y reintentos](https://docs.dev.foliios.com/guias/idempotencia-y-reintentos.md): Cómo reintentar una emisión sin duplicar documentos, qué hace la Idempotency-Key y cómo reaccionar ante 429 y 503. - [Notas crédito y débito](https://docs.dev.foliios.com/guias/notas-credito-debito.md): Cómo corregir una factura aceptada con una nota crédito o una nota débito, con su referencia, sus conceptos y sus series propias. - [Paso a producción](https://docs.dev.foliios.com/guias/paso-a-produccion.md): Qué debe estar listo antes de usar una clave sk_live, qué cambia respecto del sandbox y de la habilitación, y qué comprobar en el primer documento real. - [Rechazos y reenvío](https://docs.dev.foliios.com/guias/rechazos-y-reenvio.md): Cómo leer un rechazo de la DIAN, corregir el documento y reenviarlo, cómo provocarlo en el sandbox y qué hacer con un documento failed. - [Verificación de integración](https://docs.dev.foliios.com/guias/verificacion-integracion.md): Cómo saber si tu integración con foliios en el sandbox está completa, qué comprueba cada chequeo, cuánto dura la evidencia y cómo leer la respuesta. - [Verificar la firma de un webhook](https://docs.dev.foliios.com/guias/verificar-firma.md): Cómo comprobar que un aviso viene de foliios, con la cabecera X-Webhook-Signature (HMAC-SHA256), ejemplos en Python y Node y una prueba con un vector conocido. - [Webhooks](https://docs.dev.foliios.com/guias/webhooks.md): Cómo recibir los avisos de foliios en tu sistema, qué cabeceras traen, cómo se reintentan, cómo deduplicar y cómo probarlos en el sandbox. ## Para agentes de código - [Manual del agente](https://docs.dev.foliios.com/agentes/manual-agente.md): Cómo integrar un proyecto con foliios en sandbox, fase por fase, hasta que la verificación diga complete true. - [Plantilla de instrucciones para tu proyecto](https://docs.dev.foliios.com/agentes/plantilla-instrucciones-agente.md): Texto para copiar en el archivo de instrucciones del proyecto de la persona, para que cualquier agente respete las reglas de la integración con foliios. ## Recetas por stack - [Receta de Google Sheets (Apps Script)](https://docs.dev.foliios.com/recetas/apps-script.md): Integra foliios en sandbox desde una planilla de Google con Apps Script, sin librerías, hasta que la verificación diga complete true. - [Receta de Node y TypeScript](https://docs.dev.foliios.com/recetas/node.md): Integra foliios en sandbox con Node 24.2 o superior y TypeScript sin compilar ni dependencias, hasta que la verificación diga complete true. - [Receta de Python](https://docs.dev.foliios.com/recetas/python.md): Integra foliios en sandbox con Python 3.10 o superior y solo la biblioteca estándar, hasta que la verificación diga complete true. ## Referencia generada del código - [API v1](https://docs.dev.foliios.com/referencia/_generated/api-v1.md): Operaciones de la API REST pública, generadas desde el documento OpenAPI. - [Campos del documento](https://docs.dev.foliios.com/referencia/_generated/campos.md): Cada campo del cuerpo de emisión: qué es, de dónde sale el valor y cómo cae en el UBL. - [Errores y reglas de la DIAN](https://docs.dev.foliios.com/referencia/_generated/errores.md): Códigos de error de la API y del MCP, y las reglas de la DIAN conocidas con su guía. - [Escenarios del sandbox](https://docs.dev.foliios.com/referencia/_generated/escenarios.md): Cómo pedirle al sandbox cada respuesta de la DIAN simulada, sus reglas y sus límites. - [Eventos de webhook](https://docs.dev.foliios.com/referencia/_generated/eventos-webhook.md): Los eventos que foliios envía a tu endpoint, con su payload de ejemplo. - [Herramientas del MCP](https://docs.dev.foliios.com/referencia/_generated/herramientas.md): Las herramientas del servidor MCP de foliios, con sus parámetros. ## Normativa - [Marco normativo](https://docs.dev.foliios.com/normativa/marco-normativo.md): Las resoluciones de la DIAN y los artículos que sustentan el comportamiento de foliios, cada afirmación con su fuente oficial y su estado de revisión. - [Qué hace foliios por el emisor y qué no](https://docs.dev.foliios.com/normativa/responsabilidades.md): El reparto de responsabilidades entre foliios y la empresa que factura, con lo que foliios automatiza, lo que sigue siendo del emisor y lo que está pendiente de revisión legal. ## Legal (borrador) - [Política de privacidad](https://docs.dev.foliios.com/legal/privacidad.md): Borrador de la política de tratamiento de datos personales de foliios, pendiente de revisión legal. - [Términos del servicio](https://docs.dev.foliios.com/legal/terminos.md): Borrador de los términos del servicio de foliios, pendiente de revisión legal. ## Novedades - [Novedades](https://docs.dev.foliios.com/novedades.md): Registro de cambios de la API v1 de foliios, con la política de versiones y los cambios de comportamiento.