Banca Seguros
home
🛡️ cs-visual-time-banca-seguros-sapi
La API cs-visual-time-banca-seguros-sapi es una System API (SAPI) que interactúa directamente con los sistemas Visual Time y base de datos PostgreSQL, especializada en la gestión integral de pólizas de banca seguros, incluyendo emisión, cotizaciones, reclamos, cancelaciones y operaciones especializadas del sector asegurador.
Expone operaciones REST para:
- Emisión y actualización de pólizas de seguros
- Gestión de cotizaciones y procesos de emisión
- Manejo de reclamos y coberturas afectadas
- Cancelación de pólizas y registros
- Operaciones directas con PostgreSQL para asignación y control
- Consultas de trazabilidad y logs de transacciones
- Integración con Visual Time para operaciones de banca seguros
La API actúa como una System API (SAPI), gestionada desde MuleSoft Anypoint Platform.
🌐 Información Básica
- Nombre de la API: cs-visual-time-banca-seguros-sapi
- Versión: 1.0
- Plataforma: MuleSoft Anypoint Platform
- Runtime: Mule 4.4.0
- Tipo: System API
- URL Base QA:
https://cs-visual-time-banca-seguros-sapi-qa-v1.us-e1.cloudhub.io/api/ - Protocolo: HTTPS / REST
- Formato de Datos: JSON
🔐 Autenticación
Para consumir esta API, el consumidor debe enviar obligatoriamente en cada solicitud los siguientes mecanismos de seguridad:
Client ID Enforcement
Headers requeridos:
client_idclient_secret
- Las credenciales son asignadas a la aplicación consumidora en MuleSoft Anypoint Platform.
Bearer Token (OAuth 2.0)
Header requerido:
Authorization: Bearer <access_token>
- El token debe ser obtenido desde el servicio corporativo de autenticación.
- El token debe estar vigente al momento de la solicitud.
Ambos mecanismos son requeridos para que la solicitud sea aceptada por la plataforma.
🔒 Aviso de Seguridad
Las credenciales (client_id,client_secret) y los tokens OAuth son información sensible y no deben compartirse ni almacenarse en repositorios públicos.
🚀 Cómo Consumir
La API se encuentra publicada en las siguientes plataformas:
- 🔗 MuleSoft Exchange – cs-visual-time-banca-seguros-sapi https://anypoint.mulesoft.com/exchange/portals/fundacion-grupo-social/2b26d155-74f8-4cf2-aaea-ec3c05e8433a/cs-visual-time-banca-seguros-sapi/
- 🔗 Portal Público FGS https://anypoint.mulesoft.com/exchange/portals/fundacion-grupo-social/
📋 Para consultar detalles de cada método:
1. Navegar en el menú izquierdo de la documentación
2. Expandir la sección "Summary"
3. Seleccionar el método específico que requiere consultar
📍 Endpoints Disponibles
| Método | Endpoint | Descripción |
|---|---|---|
| GET | /issuing-of-policy-status | Consultar estado de emisión de póliza |
| GET | /issuing-of-policy-range-hour | Consultar emisión de póliza por rango horario |
| PUT | /issuing-of-policy-update | Actualizar información de emisión de póliza |
| DELETE | /issuing-of-policy-remove-registry | Eliminar registros de emisión de póliza |
| POST | /issuing-of-policy-get-documentNumber | Obtener número de documento asociado a póliza |
| POST | /issuing-of-policy-post-create-policy-to-reinject-db | Crear póliza y reinsertarla en base de datos |
| GET | /claim/coverage-affected | Consultar cobertura afectada por reclamo |
| GET | /quoting/issuing-of-policy-status | Estado de emisión en proceso de cotización |
| GET | /quoting/issuing-of-policy-range-hour | Consultar por rango horario en cotización |
| PUT | /quoting/issuing-of-policy-update | Actualizar póliza en proceso de cotización |
| POST | /cancellation-of-policies | Cancelación de pólizas |
| DELETE | /cancel-issuing-of-policy | Cancelar emisión de póliza |
| GET | /vt-policy-assigner-canceled-range-datetime | Consultar pólizas canceladas por rango de fecha/hora |
| PUT | /update-policy-assigner-set-issued | Actualizar estado de póliza a emitida |
| POST | /execute-query | Ejecutar consulta personalizada en sistema |
| POST | /posgresql/issuing-of-policy-assigned-number-quoting | Obtener número asignado de póliza en cotización |
| POST | /posgresql/policy-assigner-quoting | Asignar póliza en proceso de cotización |
| PUT | /posgresql/releaseOrIssuanceOfPolicy | Liberar o emitir póliza en base de datos |
| PUT | /posgresql/updateModulebysalechannel | Actualizar módulo por canal de venta |
| GET | /posgresql/obtainInformation-modulebysalechannel | Obtener información de módulo por canal de venta |
| POST | /posgresql/creation-of-insured-persons | Crear registros de asegurados en PostgreSQL |
| POST | /retrivePolicyLifeIssueMatriz | Recuperar matriz de emisión de pólizas de vida |
| POST | /logs-trace-mule | Insertar logs de trazabilidad de transacciones |
| POST | /loadingPoliciesFromDifferentOrigins | Cargar pólizas desde orígenes diferentes |
| PUT | /updateJsonRequestBS | Actualizar solicitud JSON de banca seguros |
| POST | /storageDocumentPolicySigned | Almacenar documento de póliza firmado electrónicamente |
| POST | /createPolicyTransaction | Crear transacción de póliza |
| POST | /webcheckout | Procesar transacciones al gateway de pagos PayU |
⚠️ Manejo de Errores
La API utiliza códigos HTTP estándar para indicar el resultado del procesamiento de las solicitudes.
Estos códigos representan condiciones de autenticación, autorización, formato o disponibilidad del servicio, y no validaciones funcionales propias del negocio.
| Código | Estado | Descripción |
|---|---|---|
| 200 | OK | Solicitud procesada correctamente |
| 400 | Bad Request | Solicitud inválida o mal formada |
| 401 | Unauthorized | Credenciales inválidas o ausentes |
| 403 | Forbidden | Client ID sin permisos |
| 404 | Not Found | Recurso no encontrado |
| 405 | Method Not Allowed | Método HTTP no permitido |
| 415 | Unsupported Media Type | Tipo de contenido no soportado |
| 429 | Too Many Requests | Límite de solicitudes excedido |
| 500 | Internal Server Error | Error interno inesperado |
| 503 | Service Unavailable | Servicio temporalmente no disponible |
| 504 | Gateway Timeout | Tiempo de espera agotado |
📞 Soporte
Para soporte técnico o incidencias relacionadas con la integración:
Coordinación de Servicios de Integración y Aplicaciones
📅 Información Adicional
Documentación creada en Enero 2026 – Fundación Grupo Social – Colmena
© 2026 Fundación Grupo Social – Colmena
Esta documentación se mantiene actualizada conforme se incorporan nuevos servicios o endpoints relacionados con Visual Time y la gestión de banca seguros.