cs-visual-time-sapi-v2 icon

cs-visual-time-sapi-v2

1.0.x
(0 reviews)
API del sistema para interactuar con los servicios de Visual Time. Soporta el procesamiento de pagos, emisión de pólizas, gestión de datos de asegurados y actualización de beneficios dentro de los flujos de trabajo del seguro institucional

🛡️ cs-visual-time-sapi-v2

Solución integral de gestión de seguros y emisión de pólizas que permite interactuar directamente con el sistema Visual Time y base de datos. Incluye endpoints para:

  • Emisión de pólizas de vida individual y colectiva
  • Procesamiento de seguros generales y matriz de productos
  • Gestión completa de asegurados y beneficiarios
  • Procesamiento de endosos y ajustes retroactivos
  • Emisión y liberación de reservas y objeciones
  • Consulta de información de pólizas y certificados
  • Generación de condiciones de texto y carátulas
  • Gestión de cuotas, acumulación y scoring

Todos los servicios exponen operaciones REST con soporte JSON y proporcionan integración robusta con Visual Time API para transacciones seguras de alto volumen en el sector asegurador.

🌐 Información Base

  • Título de la API: cs-visual-time-sapi-v2
  • Versión: 1.0.0
  • Plataforma: MuleSoft Anypoint Platform
  • URL Base Producción: https://cs-visual-time-sapi-prod-v2.us-e1.cloudhub.io/api/
  • URL Base QA: https://cs-visual-time-sapi-qa-v2.us-e1.cloudhub.io/api/
  • Protocolo: REST (HTTPS)
  • Formato de Datos: JSON
  • Autenticación: OAuth 2.0 + Client ID Enforcement

🚀 Cómo Comenzar

  1. Autenticación: Asegúrate de tener el client_id y client_secret requeridos junto con el token Bearer OAuth 2.0 para acceso seguro.
  2. URL Base: Usa la URL Base proporcionada como prefijo para todos los endpoints de la API.
  3. Encabezados: Agrega los siguientes encabezados en tus solicitudes de API:
-H "Content-Type: application/json"
-H "client_id: TU_CLIENT_ID"
-H "client_secret: TU_CLIENT_SECRET"
-H "Authorization: Bearer TU_ACCESS_TOKEN"
-H "X-Correlation-ID: TU_CORRELATION_ID"  # Requerido para trazabilidad

🚀 Cómo Consumir

Puedes acceder y consumir esta API a través de las siguientes plataformas:

📍 Endpoints Disponibles

MétodoEndpointDescripción
GET/api/send-payments-ordersObtener órdenes de pago para procesamiento
POST/api/receive-payments-ordersRecibir resultado final de órdenes procesadas por billeteras virtuales
POST/api/quoting/issuing-of-policyObtener cotización de seguro para emisión de póliza
GET/api/quoting/release-or-issuance-of-PolicyLiberación o emisión de póliza
POST/api/creation-of-insured-personsInclusión de personas aseguradas en pólizas institucionales
PUT/api/update-of-insured-amountsActualizar montos asegurados
PUT/api/client-newnessActualizar datos de asegurados, dependientes y beneficiarios
GET/api/obtain-information/modulebysalechannelConsultar información en BD tabla vt_core_modulebysalechannel
PUT/api/update-modulebysalechannelActualizar estado de frecuencias de pago en tabla vt_core_modulebysalechannel
POST/api/addRemoveDependentInsuredsAgregar/remover asegurados dependientes
PUT/api/updatePolicyBeneficiariesActualizar beneficiarios de póliza
GET/api/obtainPolicyAndCertificates/{insurArea}/{branch}/{product}/{policy}/{certificate}Consulta de información de pólizas de seguros generales y vida
GET/api/obtainPolicyAndCertificatByCode/{insurArea}/{codeHash}Consultar producto de cumplimiento mediante código de verificación
GET/api/quotaAccumulationScoreServicio de consulta de cuota, acumulación y score
POST/api/retriveIssueCompliancePolicyRecuperar emisión de póliza de cumplimiento
POST/api/retriveEndorsementComplianceRecuperar cumplimiento de endoso
PUT/api/reserve-adjustmentAjuste de reserva
POST/api/textConditionsCondiciones de texto para carátulas
POST/api/claim-beneficiaryReclamación de beneficiario
PUT/api/retroactive-endorsement-adjustmentAjuste de endoso retroactivo
PUT/api/release-reserve-objectionLiberación de objeción de reserva
POST/api/standardIssue/retriveStandardLifeIssueServicio emisión estándar de vida
POST/api/standardIssue/retrivePolicyLifeIssueMatrizServicio emisión estándar colectivo vida (matriz)
POST/api/standardIssue/retriveStandardGeneralMatrizIssueServicio emisión matriz productos generales

⚠️ Manejo de Errores

Se utilizan códigos de estado HTTP estándar para el manejo de errores:

📊 Códigos de Respuesta

CódigoEstadoDescripciónCausa ComúnAcción Recomendada
200✅ OKOperación procesada exitosamenteEmisión/consulta aprobada por Visual TimeContinuar con el flujo de negocio
400❌ Bad RequestParámetros faltantes o inválidosDatos de póliza incorrectos, montos negativosRevisar estructura del JSON y validar campos requeridos
401🔒 UnauthorizedAutenticación fallidaToken expirado o client_id inválidoRenovar token de autenticación OAuth
403🚫 ForbiddenSin permisos suficientesClient_id sin permisos para emisión de pólizasVerificar permisos y configuración del usuario
404🔍 Not FoundRecurso no encontradoPóliza inexistente, certificado no encontradoVerificar números de póliza y referencias
422⚠️ Unprocessable EntityOperación rechazada por Visual TimeDatos inconsistentes, reglas de negocio violadasVerificar datos y cumplir reglas de emisión
429⏰ Rate LimitedDemasiadas solicitudesExceso de requests por minutoImplementar retry con exponential backoff
500💥 Internal Server ErrorError inesperado en el servidorFallo interno del sistema Visual TimeContactar soporte técnico con correlation ID
503🛠️ Service UnavailableServicio temporalmente no disponibleMantenimiento Visual Time, BD caídaReintentar más tarde, notificar al usuario
504⏱️ Gateway TimeoutTimeout en Visual Time APIRespuesta lenta del sistema coreConsultar estado de operación antes de reintentar

📞 Soporte

Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.

Correo electrónico: epalma@fgs.co

📅 Información Adicional

  • Documentación actualizada por última vez: Septiembre 2025
  • Para actualizaciones adicionales, consulta el Portal de Exchange de API

Documentación generada y actualizada en Diciembre 2025 por epalma@fgs.co - Edna Nayibe Palma

© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-visual-time-sapi-v2

📋 Nota Importante: Esta documentación se actualiza continuamente. Para la versión más reciente y cambios en tiempo real, consulta siempre el Portal de Exchange oficial.

🔒 Aviso de Seguridad: Nunca compartas credenciales de API en repositorios públicos o documentación. Usa siempre variables de entorno para información sensible. Cumple con normativas de protección de datos personales al manejar información de asegurados.

🏥 Aviso Legal: Las emisiones de pólizas están sujetas a términos y condiciones de la aseguradora. Las operaciones pueden estar sujetas a validaciones regulatorias según el tipo de seguro y jurisdicción. Todas las transacciones quedan registradas para auditoría y cumplimiento normativo.

Reviews