Nos complace anunciar la versión 3.1.0 de MATIAS API, la cual trae una expansión sin precedentes a nuestro ecosistema de pruebas. Hemos escuchado el feedback de la comunidad de desarrolladores y hemos transformado nuestro Sandbox en una herramienta de simulación de grado empresarial.

A partir de hoy, nuestro Sandbox ya no solo simula facturas electrónicas estándar, sino que soporta el 100% de los documentos electrónicos autorizados por la DIAN y eleva nuestra capacidad de simulación a 32 escenarios de error (Magic Values).

Estamos extremadamente orgullosos de anunciar la versión 3.0.7 de la plataforma, que trae consigo el hito técnico más esperado del roadmap: el Lanzamiento Oficial de nuestro ambiente Sandbox. A partir de hoy, los integradores cuentan con una suite completa de pruebas aisladas, simulaciones de estados DIAN en tiempo real y recursos listos para automatizar integraciones con un esfuerzo mínimo.

Publicamos la versión 3.0.6 de la documentación de la API de Facturación Electrónica. Esta entrega introduce soporte documentado para el nuevo parámetro position dentro del arreglo de extra_data de las líneas de ítem (linea->extra_data). Ahora podrás posicionar de forma dinámica tus columnas personalizadas (como código de barras, lote, fecha de vencimiento, etc.) exactamente donde lo necesites en la representación gráfica del PDF.

Se publica la versión 3.0.4 de la documentación de la API de Facturación Electrónica. Esta entrega es una actualización de gran envergadura centrada completamente en la Experiencia del Desarrollador (DX/UX), facilitando la integración técnica desde el primer minuto.

Publicamos de forma inmediata la versión 3.0.5 de la documentación de la API. Esta actualización de parche corrige una inconsistencia crítica en la nomenclatura de los campos del nodo de archivos adjuntos (attachments), previniendo errores de validación (422 Unprocessable Entity) durante las pruebas de integración de nuestros desarrolladores.

Se publica la versión 3.0.3 de la documentación de la API de Facturación Electrónica. Esta entrega incorpora el soporte del campo extra_data dentro del objeto customer, permitiendo incluir información adicional del cliente en la representación gráfica del documento.

Se publica la versión 3.0.2 de la documentación de la API de Facturación Electrónica. Esta entrega se enfoca en la correcta integración de impuestos sobre licores y bebidas, cubriendo tanto la modalidad Ad Valorem (porcentual) como la modalidad Nominal (valor fijo por unidad), de acuerdo con el estándar UBL 2.1 y las reglas de validación de la DIAN.

Nos complace anunciar la versión 3.0.1 de nuestra API de Facturación Electrónica, que expande las capacidades del sistema de membresías introducido en v3.0.0.

Esta actualización incluye:

• 📦 Asignación de Cuotas - Distribuye documentos a tus clientes (casas de software)
• 📈 Resumen de Membresía - Consulta completa de límites, consumo y cuotas asignadas
• 📖 Documentación Mejorada - Ejemplos cURL y esquemas de respuesta detallados

Nos complace anunciar el lanzamiento de la versión 3.0.0 de nuestra API de Facturación Electrónica, que representa un cambio significativo en cómo los desarrolladores interactúan con nuestro servicio.

Esta versión introduce tres pilares fundamentales:

• 🔑 Personal Access Tokens (PAT) - Autogestión completa de credenciales
• 🔔 Webhooks - Notificaciones en tiempo real
• 📊 Sistema de Membresías - Límites transparentes y escalabilidad

¡Nos complace anunciar el lanzamiento de la Versión 1.4.0 de Matias API Documentation! Esta es una actualización integral que proporciona documentación completa y profesional de todos los marcos regulatorios de DIAN para facturación electrónica.

📊 Cambios Principales​

✨ Nuevo: Marco Regulatorio DIAN Integrado​

Esta versión incluye la documentación más completa jamás creada para los cuatro documentos electrónicos principales regulados por DIAN:

1. Factura Electrónica v1.9 (Resolución 000165/2024)​

• 📖 Anexo Técnico Oficial: Especificación técnica completa con 450+ líneas
• 📋 Tablas de Equivalencias: 18 tablas de referencia consolidadas con índices
• ❓ FAQ Completo: 50+ preguntas frecuentes con respuestas detalladas
• 🎯 Casos Especiales: 12 escenarios especiales de implementación y validación

Total: 1,337 líneas de documentación técnica

2. Nómina Electrónica v3.0 (Resolución 0000040/2024)​

• 📚 Guía Introductoria: Especificación v3.0 con 688 líneas
• 💼 Ejemplos Prácticos: 5 casos de uso reales de nóminas completas
• 🔧 Guía de Campos: Descripción detallada de todos los campos soportados
• 📊 Novedades y Cambios: Cambios laborales y movimientos de nómina
• 🧮 Cálculos: Fórmulas y métodos para devengos y deducciones

Total: 2,910 líneas de documentación

3. RADIAN v2.0 (Resolución 000198/2024)​

• 🌐 Sistema de Radicación: Descripción completa del sistema RADIAN
• 🔄 Flujos Técnicos: Procesos y flujos de integración técnica
• 📐 Matriz de Implementación: Guía paso a paso para implementación
• 📋 Casos de Uso: Escenarios reales de implementación RADIAN

Total: 2,128 líneas de documentación

4. Documento Soporte v1.1 (Resolución 000160/2024)​

• 📄 Especificación Técnica: Introducción y requisitos técnicos
• 📝 Ejemplos de Documentos: 5 ejemplos completos de documentos soporte
• ✅ Validaciones: Reglas y restricciones de validación completas

Total: 2,124 líneas de documentación

5. Recursos Centrales​

• 📑 Tablas de Referencia: Consolidación de todas las tablas DIAN en un único lugar (896 líneas)
• 📥 Descargas PDF: Enlaces directos a todos los anexos técnicos de DIAN (679 líneas)
• 🎯 Overview: Resumen ejecutivo del marco regulatorio

Total: 2,275 líneas de documentación

📈 Estadísticas de Contenido​

🚀 Mejoras Técnicas​

Compilación y Validación​

• ✅ Todas las compilaciones exitosas sin errores MDX
• ✅ Validación completa de enlaces internos
• ✅ Estructura optimizada para performance
• ✅ Totalmente compatible con Docusaurus 3.9.2

Arquitectura de Documentación​

• 🏗️ Estructura Modular: Cada documento electrónico en su propia sección
• 🔗 Referencias Cruzadas: Enlaces inteligentes entre documentos relacionados
• 📊 Tablas Optimizadas: Tablas de referencia consolidadas y fáciles de consultar
• 🎯 Casos de Uso: Ejemplos prácticos en cada sección

📚 Cómo Acceder a la Nueva Documentación​

Navegación Principal​

Marco Regulatorio DIAN
├── Factura Electrónica v1.9
│   ├── Introducción
│   ├── Anexo Técnico
│   ├── Tablas Equivalencias
│   ├── FAQ
│   ├── Casos Especiales
│   └── Ejemplos
├── Nómina Electrónica v3.0
│   ├── Introducción
│   ├── Campos
│   ├── Ejemplos
│   ├── Novedades
│   └── Cálculos
├── RADIAN v2.0
│   ├── Introducción
│   ├── Flujos Técnicos
│   ├── Matriz Implementación
│   └── Casos Uso
├── Documento Soporte v1.1
│   ├── Introducción
│   ├── Ejemplos
│   └── Validaciones
└── Recursos Centrales
    ├── Tablas Referencia
    ├── Descargas PDF
    └── Overview

Acceso Rápido a Documentos​

• 📖 Campos del Documento
• 💼 Nómina Electrónica
• 🌐 Eventos RADIAN
• 📄 Documento Soporte
• 📑 Glosario

🔧 Resolución de Problemas​

Correcciones en v1.4.0​

1. ✅ Error MDX Resuelto: Operadores de comparación reemplazados por descripciones textuales
2. ✅ Enlaces Validados: Todos los enlaces internos y externos verificados
3. ✅ Compilación: Build completa sin errores o advertencias críticas

🎯 Casos de Uso Principales​

Para Desarrolladores​

• Implementar facturación electrónica en aplicaciones
• Integrar nómina electrónica con sistemas de RRHH
• Conectar con sistema RADIAN para radicación de documentos
• Crear documentos de soporte electrónico

Para Empresas​

• Entender requisitos normativos de DIAN
• Automatizar procesos de generación de documentos
• Cumplir con obligaciones de facturación electrónica
• Optimizar procesos de nómina

Para Consultores​

• Consultar especificaciones técnicas oficiales
• Resolver dudas normativas frecuentes
• Acceder a casos de uso prácticos
• Validar implementaciones contra especificaciones

📊 Resoluciones DIAN Cubiertas​

Esta versión cubre completamente las siguientes resoluciones vigentes:

🔄 Compatibilidad​

• ✅ Docusaurus: v3.8.1 y superiores
• ✅ Node.js: v18.0 y superiores
• ✅ Navegadores: Todos los navegadores modernos
• ✅ Dispositivos: Responsive en desktop, tablet y mobile

💡 Próximas Mejoras Planeadas​

• 📱 Aplicación móvil con acceso offline a documentación
• 🔍 Buscador mejorado con índices de regulaciones
• 🤖 Asistente IA integrado para consultas normativas
• 📊 Herramientas interactivas para validación de documentos
• 🌐 Traducción a idiomas adicionales (en)

🙏 Agradecimientos​

Esta versión fue desarrollada con la colaboración de:

• DIAN (Dirección de Impuestos y Aduanas Nacionales)
• Equipo de desarrollo de Matias
• Comunidad de usuarios y desarrolladores

📞 Soporte​

¿Tienes preguntas sobre la nueva documentación?

• 📧 Email: support@matias-api.com
• 💬 Chat: Contacto en línea
• 📚 Documentación: Guía de Inicio
• 🐛 Reportar Errores: GitHub Issues

Versión: 1.4.0
Fecha: Octubre 17, 2025
Status: ✅ Producción
Descargas: npm | GitHub

¡Esperamos que disfrutes de la nueva documentación del Marco Regulatorio DIAN!