Descripción
Plataforma web de gestión tributaria desarrollada para la Alcaldía de Segovia (Antioquia). Permite a los contribuyentes inscribirse en el Registro de Información Tributaria (RIT), presentar y firmar electrónicamente sus declaraciones de Industria y Comercio, autorretención y retención, y descargar los formularios oficiales en PDF.
Del lado del municipio, la Secretaría de Hacienda administra el catálogo de actividades económicas, revisa las declaraciones presentadas y exporta la información para su gestión interna.
Es un portal de uso exclusivo del municipio y sus contribuyentes, así que no se publica acceso, credenciales ni capturas de pantalla. Lo que sigue describe únicamente el alcance funcional y técnico del desarrollo.
Problema que Resuelve
La inscripción en el RIT y la presentación del impuesto de Industria y Comercio se hacían de forma presencial y en papel: el contribuyente debía desplazarse hasta la Alcaldía, liquidar a mano y esperar la revisión. Eso generaba filas, errores de liquidación, formularios sin firma válida y una base de contribuyentes desactualizada y difícil de auditar.
Solución Implementada
Se construyó un portal en Django 6 con módulos independientes para el RIT, las declaraciones de ICA, la autorretención y la retención. Cada declaración se liquida automáticamente a partir de las actividades económicas registradas, se firma con un código OTP enviado al correo del contribuyente y queda respaldada por un PDF generado con la plantilla oficial del municipio. El personal de la Alcaldía gestiona todo desde un panel administrativo con importación y exportación masiva. Además se desarrolló una app móvil en Flutter para las visitas de campo, conectada al portal por una API REST con autenticación JWT y sincronización offline.
Arquitectura
ICA_SEGOVIA/
├── djangocrud/ # Configuración Django
├── tasks/ # RIT, declaraciones ICA, autorretención, retención, OTP y PDF
├── api_movil/ # API REST (DRF + JWT) para la app de campo
├── catalogos/ # Actividades económicas (CIIU) y catálogos del municipio
├── static/ media/ # Recursos y archivos generados
└── requirements.txtPortal Tributario ICA — Alcaldía de Segovia
Portal de impuestos del municipio de Segovia: registro RIT, declaraciones de ICA y firma electrónica con OTP.
Tecnologías
Características
- Registro de Información Tributaria (RIT) en línea, con representantes legales, establecimientos y actividades económicas
- Declaración de Industria y Comercio (ICA) con liquidación automática
- Declaración de autorretención y certificados de retención de ICA
- Firma electrónica de las declaraciones mediante código OTP enviado por correo
- Generación de PDF oficiales con plantilla configurable por el municipio
- Catálogo de actividades económicas (CIIU) administrable
- Portal de contribuyente con historial de trámites y recuperación de contraseña
- Panel administrativo con importación y exportación masiva de datos
- Aplicación móvil de campo para funcionarios (visitas, fotografías y firma en sitio)
- API REST autenticada con JWT y sincronización offline de las visitas
- Censo de establecimientos consultable por NIT desde la app
Proyectos Relacionados
Conciliaciones Municipales
Plataforma multi-municipio que concilia declaraciones tributarias con sus pagos mediante un motor ETL en Pandas.
Ver proyectoPortal Tributario ICA — Alcaldía de Salgar
Portal de impuestos del municipio de Salgar: registro RIT, declaraciones de ICA y firma electrónica con OTP.
Ver proyectoPortal Tributario ICA — Alcaldía de Ciudad Bolívar
Portal de impuestos del municipio de Ciudad Bolívar: registro RIT, declaraciones de ICA y firma electrónica con OTP.
Ver proyecto