Integración de Casa del Libro Sistemas y Computadores y Siscar para la Alcaldía de Riohacha
Descripción Técnica
Código PC26-362
Manizales, 24 de septiembre de 2026
El presente documento describe la implementación de una integración mediante consumo de API REST entre el Sistema de Información Siscar y la Casa del Libro de Sistemas y Computadores para el Municipio de Riohacha, con el fin de ampliar los canales de acceso del contribuyente a la información y gestión de sus obligaciones tributarias.
Alcance de la integración
La presente integ|ración aplica exclusivamente para las siguientes rentas: impuesto predial, industria y comercio, Reteica, Degüello, Delineación Urbana, Publicidad exterior visual, Multas de polícia y control urbano, Estampillas.
Consulta de estado de cuenta — el contribuyente podrá consultar desde Casa del Libro, ingresando el documento de identidad, el estado de cuenta de sus impuestos, tanto deuda como pagos realizados, podrá seleccionar el hecho generador y la vigencia que desea pagar, e imprimir el recibo para pago físico o realizar el pago electrónico, en ambos casos Siscar generará el número recibo de pago con el valor seleccionado por el contribuyente. Para el caso de los impuestos declarativos (industria y comercio (ICA) – ReteICA, Degüello, Estampillas), la consulta del estado de cuenta desde Casa del Libro solo estará disponible una vez el contribuyente haya presentado su declaración. La presentación de la declaración se realiza, en todos los casos, exclusivamente a través del portal tributario de Siscar, y no podrá efectuarse desde Casa del Libro.
Notificación de Recaudo — notificación a Siscar de los pagos realizados por el contribuyente, con aplicación automática del recaudo en Siscar en línea y en tiempo real. Se debe garantizar por parte de Casa del Libro la notificación a Siscar del 100% de los pagos realizados desde la pantalla de Casa del Libro.
Generación de paz y salvo — generación del paz y salvo del contribuyente en formato PDF, desde la pantalla de Casa de Libro.
Impresión de estado de cuenta — generación del documento de estado de cuenta del contribuyente, para impresión desde la aplicación.
Metodología de Implementación
El desarrollo de la integración entre Siscar y Casa del Libro se realizará conforme a las siguientes actividades, las cuales requerirán una duración total de 60 días calendario contados a partir de la firma del acta de inicio:
1. Diseño de API Definición de la especificación técnica de los end point a exponer, incluyendo estructura de datos, métodos de autenticación y protocolos de comunicación.
2. Entrega de documentación a Casa del Libro Entrega a Casa del Libro de la documentación técnica de la API, necesaria para el desarrollo del consumo de los servicios desde su aplicación.
3. Desarrollo de la integración Desarrollo, por parte de DataSoft y de Sistemas y Computadores, de los servicios web expuestos desde Siscar conforme a la especificación definida.
4. Pruebas en ambiente de preproducción Ejecución de pruebas conjuntas entre DataSoft y Casa del Libro sobre el ambiente de preproducción, validando el correcto funcionamiento de cada uno de los servicios.
5. Certificación de ambiente de preproducción Validación final y certificación de que la integración cumple con los criterios de calidad, seguridad e integridad de la información, como requisito previo al despliegue en producción.
6. Despliegue en ambiente productivo Puesta en producción de la integración, habilitando los end points para su operación real.
7. Seguimiento Acompañamiento posterior a la salida a producción, dentro del periodo de garantía establecido, para la atención de ajustes sobre las funcionalidades entregadas.
Seguridad
La comunicación entre Casa del Libro y Siscar se realiza bajo protocolo HTTPS, con un mecanismo de autenticación mediante token / API Key, que garantiza que únicamente solicitudes autorizadas puedan consumir los servicios expuestos por Siscar.
Responsabilidad de Desarrollo
La integración se realiza vía web service, exponiendo los servicios correspondientes desde Siscar. El desarrollo del lado de Casa del Libro para el consumo de dichos servicios será responsabilidad exclusiva del tercero propietario de la aplicación.
