Qué es foliios

foliios es un motor de facturación electrónica ante la DIAN (Colombia), ofrecido como servicio. Tú envías el contenido de una venta; foliios lo valida, lo numera, lo convierte al formato que exige la DIAN, lo firma con el certificado de tu empresa, lo transmite, atiende los reintentos y la contingencia, y entrega el resultado al comprador por correo.

Las piezas

Pieza	Para qué sirve
API REST v1	Emitir facturas, notas crédito y notas débito; consultar su estado; corregir rechazos; descargar el XML y el PDF; gestionar contingencias. Es el contrato principal.
Servidor MCP	Las mismas operaciones como herramientas para un agente de IA, con confirmación para lo que tiene efecto fiscal y borradores que una persona aprueba.
Portal	Donde una persona crea la cuenta, las empresas, las claves, sube el certificado, registra el software y las resoluciones, corre el set de habilitación, aprueba borradores y ve el buzón de pruebas.
Sandbox	Un ambiente simulado, sin efecto fiscal y sin correos reales, para integrar sin riesgo.
Webhooks	Avisos firmados que foliios envía a tu sistema cuando cambia un documento.

Qué recibe tu sistema

Cuando emites, la API responde enseguida con el documento en estado pending. Después, de forma asíncrona, la DIAN valida el documento y este pasa a accepted o rejected. Tu sistema se entera consultando el documento o recibiendo un webhook. Lo que sigue (entrega al comprador por correo) tiene su propio estado, separado del de la DIAN. Ver estados del documento.

Por dónde seguir

Inicio rápido: una factura aceptada en el sandbox.
Ambientes y claves: qué hace cada tipo de clave.
Emitir una factura.