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 y los Paquetes por NIT incluyen el certificado digital sin costo adicional. En Casa de Software, el certificado de cada cliente (NIT) se adquiere por separado a través de MATICERTS con tarifa preferencial; en ILIMITADO puedes adquirirlos por separado o elegir la opción con cupo de certificados incluido. 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; el Plan PYME Pro incluye 6x (8.000 docs = 48.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 de Casa de Software no incluye certificados: se adquiere una Suscripción de Firma Digital por cada NIT conectado, con tarifas preferenciales escalonadas (IVA y comisiones de pasarela Wompi incluidas): de 1 a 99 NITs, $104.000 COP por 1 año o $196.000 COP por 2 años; desde 100 NITs, $99.000 COP por 1 año o $164.000 COP por 2 años. La activación toma de 1 a 5 horas hábiles desde que el titular completa la validación biométrica o documental asistida. El certificado queda en custodia para timbrado desatendido y se puede descargar libremente en formato .p12.
Sí. Si es tu primer plan de Casa de Software (incluida la migración desde un Plan PYME o Paquete por NIT) y adquieres un paquete desde 10.000 documentos, recibes sin costo un (1) certificado de firma digital de 1 año para tu primer cliente/NIT. Se otorga un (1) bono por cuenta; desde el segundo NIT aplica la tarifa preferencial.
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. Los paquetes de Casa de Software van de 5.000 a 2.000.000 de documentos al año; para volúmenes mayores se cotiza a la medida.
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 a 5 horas hábiles mediante validación biométrica). 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 8:00am-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.
Para mantener la tarifa de distribuidor debes contar con un mínimo de 3 clientes terceros habilitados en el API durante la vigencia anual del paquete; tu propio NIT no cuenta. A los seis (6) meses te notificamos el avance de la meta, y esta se verifica al cumplirse el año. Si no se cumple y renuevas, tu cuenta migra a un Plan PYME o Paquete por NIT; mientras tanto, tu saldo de documentos vigente se conserva hasta el vencimiento.
¿Tienes más preguntas?
Consulta las preguntas frecuentes específicas de cada plan o contáctanos directamente
Preguntas Frecuentes para Desarrolladores
Resuelve tus dudas técnicas y comerciales sobre el modelo Casa de Software
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. Además, como distribuidor accedes a tarifas preferenciales en certificados digitales MATICERTS.
Un desarrollador experimentado puede tener una integración básica funcionando en 1-2 días. La integración completa con manejo de errores, reintentos y todas las características puede tomar 1-2 semanas. Proporcionamos documentación completa, ejemplos de código en múltiples lenguajes y soporte técnico para acelerar el proceso.
Sí, cada empresa (NIT) que emita documentos electrónicos requiere su propio certificado digital. El paquete de documentos no incluye certificados. Se adquiere una Suscripción de Firma Digital MATICERTS por cada NIT conectado, con tarifas preferenciales escalonadas: (1-99 NITs) $104.000 COP/NIT a 1 año o $196.000 COP/NIT a 2 años; (100+ NITs) $99.000 COP/NIT a 1 año o $164.000 COP/NIT a 2 años. La activación es express: 1 a 5 horas hábiles contadas desde que el titular completa con éxito la validación biométrica o documental asistida; mientras esté pendiente, notificamos a la Casa de Software. El certificado se custodia por defecto en los servidores de LOPEZSOFT SAS para timbrado automatizado desatendido, pero tú o el emisor pueden descargarlo libremente en formato .p12. MATIAS API y la Casa de Software pueden revocarlo en tiempo real en caso de cancelación del servicio, mora o uso indebido.
¡Sí! Todo nuevo integrador que adquiera como primer plan de Casa de Software (incluida la migración desde un Plan PYME o Paquete por NIT) un paquete desde 10.000 documentos recibe sin costo un (1) Certificado de Firma Digital Integrada (Vigencia 1 Año) para conectar su primer cliente/NIT. Se otorga un (1) bono por cuenta y no aplica para renovaciones. A partir del segundo NIT integrado, aplica la tarifa preferencial estándar según tu escala.
Sí. La migración desde un Plan PYME o Paquete por NIT se trata como una nueva contratación, sin prorrateo ni devolución de dinero. Pagas el paquete de Casa de Software completo, los documentos no consumidos de tu plan anterior se suman a tu bolsa y, si el paquete es desde 10.000 documentos, recibes el Bono de Bienvenida (1 certificado de 1 año para tu primer cliente). Como es un cambio entre líneas, no hay prorrateo, reembolso ni crédito: el prorrateo solo aplica entre paquetes de la misma línea. Tu resolución, tus prefijos y tu certificado siguen activos, y tu propio NIT no cuenta para el mínimo de 3 clientes. Detalle en Términos y Condiciones §7.3.2.
Al agotar el cupo de documentos, la API detiene la emisión automáticamente. Para continuar facturando, debes adquirir un nuevo paquete. No hay penalización ni tiempos de espera. El nuevo paquete se activa de inmediato. La vigencia del contrato y los documentos es de un (1) año; si se agota el cupo antes, se adquiere un nuevo paquete. Para volúmenes superiores a 2.000.000 de documentos al año, se cotiza a la medida.
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.
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 MATICERTS (1 a 5 horas hábiles). Nosotros te guiamos en todo el proceso.
El soporte técnico es especializado 'Dev-to-Dev': se brinda exclusivamente al equipo de desarrollo de la Casa de Software vía WhatsApp, email y tickets. Horario: Lunes a viernes 8:00am-6:00pm. MATIAS API no ofrece mesa de ayuda a usuarios finales (emisores); dicha responsabilidad recae enteramente sobre el distribuidor. 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/intro para integrar en minutos.
Nosotros nos encargamos de actualizar la API para mantener compatibilidad con los cambios de la DIAN. Tu código no necesita modificaciones. Esta es una de las principales ventajas de usar MATIAS API vs desarrollar tu propia integración.
Para mantener la tarifa de distribuidor debes contar con un mínimo de 3 clientes terceros habilitados en el API durante la vigencia anual del paquete; tu propio NIT no cuenta. A los seis (6) meses te notificamos el avance de la meta, y esta se verifica al cumplirse el año. Si no se cumple y renuevas, tu cuenta migra a un Plan PYME o Paquete por NIT, sin prorrateo, crédito ni reembolso. Entre tanto, tu saldo de documentos vigente se conserva hasta el vencimiento de la anualidad.
Para garantizar la eficiencia del servicio, el sistema ejecuta una rutina de mantenimiento automático todos los días a las 04:00 AM, eliminando representaciones gráficas (PDF), códigos QR, archivos adjuntos y comprimidos (ZIP). Si necesitas un archivo posterior a su eliminación, puedes regenerarlo en tiempo real a través de los endpoints del API o desde la interfaz web; todo archivo regenerado es temporal y se elimina en la siguiente rutina. Los documentos adjuntos enviados en el payload se conservan de forma persistente en AWS S3 con el mismo tratamiento de custodia que los XMLs, sujetos a la cuota de almacenamiento de tu plan. Excedentes: $15.000 COP/año por cada GB adicional. Los correos de notificación: el cupo es 6x el volumen del paquete; excedentes a $1.200 COP por cada 1.000 envíos.
Sí. El certificado se aloja por defecto en custodia dentro de los servidores de LOPEZSOFT SAS para garantizar el timbrado automatizado desatendido. Sin embargo, la Casa de Software o el emisor pueden descargar libremente el archivo .p12 para otros usos. Dado que MATICERTS integra gestión de revocación en tiempo real, tanto MATIAS API como la Casa de Software mantienen la facultad de revocar inmediatamente la validez del certificado exportado en caso de cancelación, mora o uso indebido, garantizando la seguridad legal sin bloquear la portabilidad del usuario.
¿Tienes más preguntas técnicas?
Nuestro equipo de soporte está listo para ayudarte con la integración
¿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