cs-visual-time-sapi icon

cs-visual-time-sapi

1.4.x
(0 reviews)
Esta API facilita el acceso seguro a los servicios de Visual Time, permitiendo realizar operaciones relacionadas con asegurados, gestión de pólizas, validación de documentos, movimientos contables y más.

🛡️ cs-visual-time-sapi

La API cs-visual-time-sapi es una API de Sistema (SAPI) que interactúa directamente con la API de Visual Time, permitiendo la integración controlada con los servicios del core de seguros para operaciones de gestión de clientes, pólizas, reclamaciones, facturación y productos de seguros.

Expone operaciones REST para:

  • Gestión de clientes individuales y personas jurídicas (asegurados, cancelaciones, migraciones)
  • Cotización, tarifas y emisión de pólizas de vida, incendio hogar, protección de tarjeta y protección de cuota
  • Gestión de reclamaciones, indemnizaciones y casos de asegurabilidad
  • Consulta de facturas, pagos y certificados de seguros
  • Consulta de catálogos de productos e información de pólizas

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
  • Versión: 1
  • Plataforma: MuleSoft Anypoint Platform
  • Tipo: System API
  • URL Base QA:https://cs-visual-time-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:

  1. Client ID Enforcement

    • Headers requeridos:

      • client_id
      • client_secret
    • Las credenciales son asignadas a la aplicación consumidora en MuleSoft Anypoint Platform.

  2. 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:

📋 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étodoEndpointDescripción
GET/participantsConsultar participantes
GET/customersConsultar clientes
POST/customers/legal-persons/insured/cancelCancelar asegurado de personas jurídicas
POST/customers/legal-persons/insured/migrationInclusión de asegurados en pólizas institucionales
PUT/customers/individual/insuredActualizar datos de asegurado individual
POST/insurability-casesCrear casos de asegurabilidad
GET/insurability-casesConsultar casos de asegurabilidad
PUT/insurability-cases/statusActualizar estado de caso de asegurabilidad
GET/billsConsultar facturas
POST/bills/paymentsRegistrar pagos de facturas
POST/insurances/generals/certificatesObtener certificados de seguros generales
POST/insurances/generals/v2/certificatesObtener certificados de seguros generales v2
POST/insurances/life/ratesObtener tarifas de seguros de vida
POST/insurances/life/quotesCotizar seguros de vida
POST/insurances/life/issuing-of-policyEmitir pólizas de seguros de vida
POST/insurances/life/issuing-of-policy-v1Emitir pólizas de seguros de vida v1
POST/insurances/life/issuing-of-policy-notifyEmitir pólizas de vida con notificación
POST/insurances/life/certificatesObtener certificados de seguros de vida
POST/insurances/life/v2/certificatesObtener certificados de seguros de vida v2
POST/insurances/card-protection/ratesObtener tarifas de protección de tarjeta
POST/insurances/card-protection/quotesCotizar protección de tarjeta
POST/insurances/card-protection/issuing-of-policyEmitir pólizas de protección de tarjeta
POST/insurances/home/fire/ratesObtener tarifas de seguro hogar incendio
POST/insurances/home/fire/quotesCotizar seguro hogar incendio
POST/insurances/home/fire/issuing-of-policyEmitir pólizas de seguro hogar incendio
POST/insurances/quota-protection/ratesObtener tarifas de protección de cuota
POST/insurances/quota-protection/quotesCotizar protección de cuota
POST/insurances/quota-protection/issuing-of-policyEmitir pólizas de protección de cuota
POST/insurances/policy/life/cancelCancelar póliza de vida
GET/insurances/policies-and-claim-incidentsConsultar pólizas e incidentes de reclamación
POST/insurances/policiesConsultar pólizas de seguros
POST/claimsGestionar reclamaciones
POST/claims/attach-supportAdjuntar documentos soporte a reclamaciones
POST/claims/creation-third-banking-informationCrear información bancaria de terceros
GET/policiesConsultar contratos/pólizas
GET/indemnitiesConsultar indemnizaciones
GET/documents-requiredConsultar documentos requeridos por reclamación
POST/v2/insurances/life/ratesObtener tarifas de seguros de vida v2
POST/catalog/productConsultar catálogo de productos
GET/catalog/product/lifeConsultar productos de vida desde Visual Time
GET/retrieveClaimByPolicyConsultar reclamaciones por póliza
GET/retrievePolicyInformationConsultar información detallada de póliza
POST/insurances-product-collectiveObtener producto colectivo de seguros
POST/insurances-issuing-of-policy-product-collectiveEmitir pólizas de producto colectivo de seguros
GET/obtain-policy-obConsultar registros de pólizas desde Object Store
POST/productInformationUpdateActualizar información de productos en base de datos

⚠️ 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ódigoEstadoDescripción
200OKSolicitud procesada correctamente
400Bad RequestSolicitud inválida o mal formada
401UnauthorizedCredenciales inválidas o ausentes
403ForbiddenClient ID sin permisos
404Not FoundRecurso no encontrado
405Method Not AllowedMétodo HTTP no permitido
415Unsupported Media TypeTipo de contenido no soportado
429Too Many RequestsLímite de solicitudes excedido
500Internal Server ErrorError interno inesperado
503Service UnavailableServicio temporalmente no disponible
504Gateway TimeoutTiempo 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 Visual Time.

Reviews