MCP para facturación electrónica en Colombia: guía técnica para integrar DIAN

Por Ing. Carlos Méndez | 16 de septiembre de 2026

Ing. Carlos Méndez es arquitecto de software con más de 10 años integrando sistemas fiscales en América Latina. Ha liderado implementaciones de facturación electrónica en Colombia, México y Centroamérica para ISVs de mediana y gran escala.

La integración con la DIAN vía REST tradicional requiere que el ISV implemente firma XAdES-BES, generación del CUFE, autenticación con certificado digital y manejo de los webservices de la DIAN, más la lógica de eventos RADIAN si los clientes hacen acuse de recibo electrónico. El Model Context Protocol (MCP) cambia esta ecuación: encapsula toda esa complejidad en herramientas que el ISV consume como llamadas de función simples, sin mantener la lógica de bajo nivel.

Esta guía explica qué es MCP en el contexto de la DIAN, cómo difiere de la integración REST, las ventajas técnicas para ISVs colombianos y cómo está disponible hoy para producción.

El contexto técnico: qué requiere integrar la DIAN hoy

La DIAN exige que los documentos electrónicos (facturas, notas de crédito, notas de débito, nómina) cumplan el estándar UBL 2.1 con firma XAdES-BES, generen un CUFE (Código Único de Factura Electrónica) y sean transmitidos al servicio de validación de la DIAN. Adicionalmente, los eventos RADIAN (acuse de recibo, rechazo, aval, endoso) requieren endpoints y flujos adicionales sobre el documento ya emitido.

El resultado es que una integración REST completa con DIAN + RADIAN requiere implementar y mantener 5-8 endpoints distintos, cada uno con lógica de firma y autenticación que debe actualizarse cuando la DIAN publica nuevas versiones de sus documentos técnicos. Para equipos de desarrollo de ISVs medianos, esto puede representar 2-4 semanas de integración inicial y carga de mantenimiento recurrente.

¿Qué es MCP fiscal?

MCP (Model Context Protocol) es un protocolo abierto que estandariza cómo los sistemas de software y los agentes de IA interactúan con herramientas externas. Un servidor MCP para DIAN Colombia expone operaciones fiscales como herramientas tipadas: emit_factura, emit_nota_credito, emit_nomina, radian_acuse_recibo, anular_documento. Cada herramienta tiene un esquema de input y output documentado que cualquier cliente MCP puede descubrir automáticamente mediante la operación tools/list.

Lo que hace MCP fiscal: toma el payload de datos del negocio (cliente, productos, montos, impuestos), construye el UBL 2.1, aplica la firma XAdES-BES, genera el CUFE y transmite a la DIAN. El ISV solo provee los datos de negocio; el servidor MCP maneja todo el protocolo fiscal.

MCP vs REST para DIAN Colombia: comparativa técnica

text

Dimensión                      | REST tradicional DIAN          | MCP fiscal DIAN
-------------------------------|--------------------------------|-------------------------------
Firma XAdES-BES                | Implementada por el ISV        | Encapsulada en el tool
Generación del CUFE            | Calculada por el ISV           | Encapsulada en el tool
Construcción UBL 2.1           | Construida por el ISV          | Encapsulada en el tool
Autenticación DIAN             | OAuth2 gestionado por ISV      | Manejada por servidor MCP
Eventos RADIAN                 | 4-6 endpoints adicionales      | Tools RADIAN incluidos
Actualización de esquemas       | ISV modifica su código          | ISV actualiza versión MCP
Compatibilidad con agentes IA  | Requiere wrapper manual        | Nativa
Tiempo de integración estimado | 2-4 semanas (con RADIAN)       | 1-2 días (herramientas)

Ventajas técnicas concretas para ISVs colombianos

RADIAN sin complejidad adicional

Con integración REST, agregar soporte de eventos RADIAN (acuse de recibo, rechazo, aval, endoso en propiedad) es un proyecto de integración adicional: nuevos endpoints, nueva lógica de firma para cada tipo de evento, nuevos parsers de respuesta DIAN. Con MCP, los eventos RADIAN son herramientas del servidor con el mismo contrato de llamada: el ISV llama radian_acuse_recibo con el CUFE del documento y recibe la confirmación. La complejidad del protocolo está dentro del servidor MCP.

Aislamiento frente a actualizaciones de la DIAN

Cuando la DIAN actualiza la versión de su documento técnico — cambios en el XSD del UBL 2.1, nuevos tipos de error, modificaciones en el cálculo del CUFE — el ISV que usa REST debe actualizar su código de construcción de documentos. El ISV que usa MCP actualiza la versión del servidor MCP sin modificar su código de integración. Este aislamiento tiene impacto directo en el tiempo de respuesta a cambios regulatorios: horas vs días.

Compatibilidad con agentes de IA

ISVs que usan agentes de IA para extraer datos de documentos (PDF de órdenes de compra, correos electrónicos de clientes) y generar facturas automáticamente pueden conectar el agente directamente al servidor MCP. El agente identifica los datos del documento, llama emit_factura con esos datos y el servidor MCP genera el UBL 2.1, aplica la firma y transmite a la DIAN. Sin MCP, el agente necesita un wrapper que traduzca su output a la especificación REST de la DIAN.

Alanube MCP para DIAN Colombia

Alanube tiene disponible un servidor MCP para facturación electrónica en Colombia, cubriendo facturas, notas de crédito, notas de débito, nómina electrónica y eventos RADIAN. El servidor MCP de Alanube está diseñado para integrarse tanto con agentes de IA (Claude, OpenAI Agents) como con sistemas backend de ISVs via protocolo MCP estándar. Para más información sobre la implementación, consultar la documentación de Alanube para Colombia.

Preguntas frecuentes

¿Qué es MCP fiscal y cómo funciona para la facturación electrónica DIAN en Colombia?

MCP (Model Context Protocol) es un protocolo que expone operaciones de la API DIAN como herramientas tipadas que cualquier sistema o agente de IA puede llamar con datos simples del negocio. El servidor MCP construye el UBL 2.1, aplica la firma XAdES-BES, calcula el CUFE y transmite a la DIAN. El ISV solo provee los datos del documento; la complejidad del protocolo fiscal está dentro del servidor MCP.

¿Cómo puedo integrar MCP DIAN en un sistema que ya tiene integración REST funcionando?

La integración MCP es incremental: el ISV puede mantener la integración REST existente y agregar el servidor MCP en paralelo para nuevos flujos, especialmente aquellos que involucran agentes de IA o generación automática de documentos. No es necesario migrar la integración REST existente para usar MCP en flujos nuevos.

¿Qué diferencia hay entre RADIAN con MCP vs RADIAN con integración REST directa?

Con REST, cada evento RADIAN (acuse de recibo, rechazo, aval, endoso) requiere implementar un endpoint separado con su propia lógica de firma XAdES-BES. Con MCP, los eventos RADIAN son herramientas del servidor con el mismo contrato de llamada que la emisión de facturas. El ISV llama radian_acuse_recibo con el CUFE y recibe la respuesta; el servidor MCP maneja el protocolo completo del evento RADIAN.

¿Es posible usar MCP para nómina electrónica DIAN con el mismo servidor que la facturación?

Sí, si el servidor MCP del PSFE incluye las herramientas de nómina electrónica. Alanube incluye soporte para nómina electrónica DIAN en su servidor MCP para Colombia, lo que permite que el ISV use el mismo protocolo de integración para facturación, notas, nómina y eventos RADIAN desde un único servidor MCP con un único contrato de autenticación.

Sobre el autor