Preguntas Frecuentes
Encuentra respuestas rápidas a las preguntas más comunes sobre MATIAS API, integración y facturación electrónica
Preguntas Frecuentes
Resuelve tus dudas sobre MATIAS API y facturación electrónica
MATIAS API es una API REST que te permite integrar facturación electrónica, nómina electrónica y documentos soporte en tu software con conexión directa a la DIAN bajo modalidad Software Propio. Sin intermediarios ni Proveedores Tecnológicos (PT), tu sistema se comunica directamente con los sistemas de la DIAN.
MATIAS API es compatible con cualquier lenguaje que pueda hacer peticiones HTTP/REST: Node.js, PHP, Python, Java, C#, Go, Ruby, Visual FoxPro, Visual Basic, Delphi, y más. Proporcionamos ejemplos de código en los lenguajes más populares en nuestra documentación.
Un desarrollador experimentado puede tener una integración básica funcionando en 1-2 días. La integración completa puede tomar 1-2 semanas. Esto es significativamente más rápido que desarrollar una integración directa con la DIAN desde cero (4-6 meses).
Sí, para facturar electrónicamente en Colombia necesitas un certificado digital. Los Planes PYME incluyen el certificado digital sin costo adicional. En las modalidades Paquete por NIT y Casa de Software, el certificado se adquiere por separado con tarifa preferencial según volumen. Nosotros te asesoramos en todo el proceso de obtención y configuración.
Nos encargamos de mantener la compatibilidad con todos los cambios normativos de la DIAN. Cuando hay cambios en las resoluciones o especificaciones técnicas, actualizamos la API automáticamente. Tú no necesitas modificar tu código.
Todos los planes incluyen envíos de correo electrónico: Los Planes PYME incluyen 4 correos por cada documento (4x), por ejemplo 500 docs = 2.000 correos. Los Paquetes Casa de Software incluyen 6 correos por documento (6x), por ejemplo 10K docs = 60K correos. Los correos adicionales cuestan $1.200 COP por cada 1.000 envíos.
Para optimizar el almacenamiento, el sistema ejecuta una limpieza automática todos los días a las 04:00 AM. Se eliminan PDFs, códigos QR y archivos temporales. Los XML originales se conservan permanentemente (cumplimiento DIAN) y los archivos eliminados pueden regenerarse bajo demanda vía API en cualquier momento.
Los Planes PYME tienen una cuota anual de documentos (500, 1.200, 3.000 u 8.000 docs/año). Al consumir la cuota, la API detiene la emisión automáticamente. Para continuar, debes renovar o actualizar tu plan. Los Paquetes por NIT y Casa de Software funcionan de la misma manera con sus cuotas específicas. No se cobran documentos adicionales.
El Plan NIT es para una empresa individual con documentos fijos. El Plan Casa de Software te da un paquete de documentos que puedes distribuir libremente entre múltiples clientes. Tú decides cuántos documentos asignar a cada uno y cuánto cobrarles. Es ideal cuando tienes 5+ clientes.
Sí, MATIAS API es REST estándar. Cualquier lenguaje que pueda hacer peticiones HTTP puede usarla. Tenemos clientes activos con sistemas en Visual FoxPro, Visual Basic, Delphi, Clipper y otros lenguajes legacy. Solo necesitas poder enviar/recibir JSON vía HTTP.
Sí, cada empresa (NIT) que emita documentos electrónicos requiere su propio certificado digital. El paquete de documentos no incluye certificados. Se debe adquirir una Suscripción Anual de Firma Digital por cada NIT conectado a tarifa preferencial de distribuidor: $104.000 COP/año por NIT (IVA incluido). La activación es express mediante validación biométrica. Si requieres el certificado exportable (.p12), consulta las tarifas de Certificate Manager.
Al consumir la cuota de documentos, la API detiene la emisión automáticamente. Para continuar facturando, puedes renovar tu plan actual o actualizar a un plan superior con mayor volumen. El cambio se aplica de inmediato y no hay penalización ni tiempos de espera.
Una vez integrado, el proceso de habilitación es casi automático. MATIAS API ejecuta el set de pruebas requerido por la DIAN en menos de 1 minuto. El paso más largo es obtener el certificado digital (1-2 días hábiles). Nosotros te guiamos en todo el proceso.
Incluye soporte técnico directo a tu equipo de desarrollo vía WhatsApp, email y tickets. Horario: Lunes a viernes 7:30am-6:00pm. El soporte es para TI, no para usuarios finales. Tú das soporte a tus clientes, nosotros te damos soporte a ti.
Sí, contamos con un entorno Sandbox aislado donde puedes probar todos los endpoints sin afectar producción ni consumir documentos de tu paquete. API: sandbox-api.matias-api.com | Portal Web: sandbox-auth.matias-api.com. Consulta la guía de Quickstart en docs.matias-api.com/docs/sandbox/quickstart para integrar en 5 minutos.
Debes contar con un mínimo de 3 clientes habilitados en el API en un plazo máximo de seis (6) meses para mantener la tarifa de distribuidor. Esto garantiza que realmente operas como casa de software. Si no cumples este requisito, tu cuenta podría migrar a plan NIT individual.
¿Tienes más preguntas?
Consulta las preguntas frecuentes específicas de cada plan o contáctanos directamente
¿No encuentras la respuesta que buscas?
Nuestro equipo de soporte está disponible para resolver todas tus dudas sobre integración, funcionalidades o cualquier aspecto técnico de MATIAS API