cs-visual-time-sapi-v2
home
🛡️ cs-visual-time-sapi-v2
La API cs-visual-time-sapi-v2 provee una solución integral para la gestión de seguros y emisión de pólizas, permitiendo la interacción directa con el sistema Visual Time y su base de datos para el procesamiento de transacciones seguras.
Expone operaciones REST para:
- Emisión de pólizas de vida individual y colectiva
- Procesamiento de seguros generales y matriz de productos
- Gestión completa de asegurados, dependientes y beneficiarios
- Procesamiento de endosos, ajustes retroactivos y reservas
- Emisión y liberación de objeciones y autorizaciones
- Consulta de información de pólizas y certificados
- Generación de condiciones de texto y carátulas
- Gestión de cuotas, acumulación, scoring y pagos
- Integración con billeteras virtuales y procesamiento automático de siniestros
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-sapi-v2
- Versión: 1.0.0
- Plataforma: MuleSoft Anypoint Platform
- Runtime: Mule 4.x
- Tipo: System API
- URL Base QA:
https://cs-visual-time-sapi-qa-v2.us-e1.cloudhub.io/api/ - URL Base Producción:
https://cs-visual-time-sapi-prod-v2.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.
X-Correlation-ID (Requerido)
Header adicional para trazabilidad:
X-Correlation-ID: <identificador_unico>
- Permite el seguimiento de transacciones para auditoría y troubleshooting.
Todos estos 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. Las transacciones quedan registradas para auditoría y cumplimiento normativo.
🚀 Cómo Consumir
La API se encuentra publicada en las siguientes plataformas:
- 🔗 MuleSoft Exchange – cs-visual-time-sapi-v2 https://anypoint.mulesoft.com/exchange/portals/fundacion-grupo-social/2b26d155-74f8-4cf2-aaea-ec3c05e8433a/cs-visual-time-sapi-v2/
- 🔗 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 | /send-payments-orders | Obtener órdenes de pago para procesamiento |
| POST | /receive-payments-orders | Recibir resultado final de órdenes procesadas por billeteras virtuales |
| POST | /quoting/issuing-of-policy | Obtener cotización de seguro para emisión de póliza |
| GET | /quoting/release-or-issuance-of-Policy | Liberación o emisión de póliza |
| POST | /creation-of-insured-persons | Inclusión de personas aseguradas en pólizas institucionales |
| PUT | /update-of-insured-amounts | Actualizar montos asegurados |
| PUT | /client-newness | Actualizar datos de asegurados, dependientes y beneficiarios |
| GET | /obtain-information/modulebysalechannel | Consultar información en BD tabla vt_core_modulebysalechannel |
| PUT | /update-modulebysalechannel | Actualizar estado de frecuencias de pago en tabla vt_core_modulebysalechannel |
| POST | /addRemoveDependentInsureds | Agregar/remover asegurados dependientes |
| PUT | /updatePolicyBeneficiaries | Actualizar beneficiarios de póliza |
| GET | /obtainPolicyAndCertificates/{insurArea}/{branch}/{product}/{policy}/{certificate} | Consulta de información de pólizas de seguros generales y vida |
| GET | /obtainPolicyAndCertificatByCode/{insurArea}/{codeHash} | Consultar producto de cumplimiento mediante código de verificación |
| GET | /quotaAccumulationScore | Servicio de consulta de cuota, acumulación y score |
| POST | /retriveIssueCompliancePolicy | Recuperar emisión de póliza de cumplimiento |
| POST | /retriveEndorsementCompliance | Recuperar cumplimiento de endoso |
| PUT | /reserve-adjustment | Ajuste de reserva |
| POST | /textConditions | Condiciones de texto para carátulas |
| POST | /claim-beneficiary | Reclamación de beneficiario |
| PUT | /retroactive-endorsement-adjustment | Ajuste de endoso retroactivo |
| PUT | /release-reserve-objection | Liberación de objeción de reserva |
| POST | /standardIssue/retriveStandardLifeIssue | Servicio emisión estándar de vida |
| POST | /standardIssue/retriveStandardGeneralIssue | Servicio emisión estándar generales |
| GET | /standardIssue/enablePolicyIssuanceBS | Habilitar emisión de póliza banca seguros |
| POST | /standardIssue/retriveStandardIssueMatriz | Servicio emisión estándar colectivo vida (matriz) |
| POST | /automatic-claims-payments | Procesamiento automático de pagos de siniestros |
| POST | /payment-order-authorization | Autorización de órdenes de pago |
⚠️ 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, disponibilidad del servicio y validaciones funcionales del sistema Visual Time.
| 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 |
| 422 | Unprocessable Entity | Operación rechazada por validaciones |
| 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 actualizada en Febrero 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 la gestión de seguros y el sistema Visual Time.