cs-visual-time-sapi icon

cs-visual-time-sapi

1.4.x
(0 reviews)
API del sistema que se integra con CS Visual Time para recuperar registros de tiempo de los empleados, lo que permite el seguimiento, la generación de informes y la gestión de la fuerza laboral en tiempo real en todos los entornos.

🧾 CS Visual Time SAPI

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.

  • Soporta integración tanto para seguros individuales como para personas jurídicas.

  • Diseñada para ofrecer una integración fluida en operaciones de seguros y gestión de clientes, con alta seguridad y escalabilidad.

🌐 Información Base

  • Título de la API: CS Visual Time SAPI
  • Versión: v1
  • URL Base: https://cs-visual-time-sapi-{env}-v1.us-e1.cloudhub.io/api/
  • Entornos Disponibles: dev, qa, prod

🚀 Primeros Pasos

  1. Autenticación: Esta API utiliza client_id y token Bearer de OAuth 2.0 para autenticación.
  2. URL Base: Usa la URL base indicada (reemplaza {env} por tu entorno objetivo) como prefijo para todos los endpoints.
  3. Encabezados: Incluye los siguientes encabezados en cada petición:
client_id: TU_CLIENT_ID
Authorization: Bearer TU_ACCESS_TOKEN

🔄 Cómo Consumirla

Puedes explorar y probar esta API a través de las siguientes plataformas:

📍 Endpoints Disponibles

¡Perfecto! 🚀 Aquí tienes los 55 métodos y endpoints organizados en la estructura que pediste, listos para copiar y pegar:

MétodoEndpointDescripciónEnlace Exchange
GET/api/*Acceso general APILink
GET/console/*Consola internaLink
POST/BizagiSOAIntegración Bizagi SOALink
POST/customersGestión de clientesLink
GET/insurances/fire/ratesTarifas de incendioLink
POST/insurances/earthquake/issuing-of-policyEmisión pólizas terremotoLink
POST/insurances/fire/issuing-of-policyEmisión pólizas incendioLink
POST/insurances/earthquake/quotesCotización terremotoLink
POST/insurances/fire/quotesCotización incendioLink
GET/insurances/earthquake/ratesTarifas terremotoLink
POST/insurability-casesCasos de asegurabilidadLink
POST/claimsGestión de reclamacionesLink
POST/claims/attach-supportAdjuntar soportesLink
POST/claims/creation-third-banking-informationDatos bancarios tercerosLink
GET/insurances/policies-and-claim-incidentsPólizas e incidentesLink
GET/policiesGestión de pólizasLink
GET/insurances/policiesConsulta pólizasLink
GET/v2/insurances/life/ratesTarifas vida v2Link
POST/indemnitiesIndemnizacionesLink
POST/participantsGestión de participantesLink
POST/customers/legal-persons/insured/cancelCancelar asegurado jurídicoLink
POST/insurances/life/certificatesCertificados de vidaLink
POST/customers/individual/insuredAsegurados individualesLink
POST/customers/legal-persons/insured/migrationMigración asegurados jurídicosLink
GET/insurances/home/fire/ratesTarifas hogar incendioLink
POST/insurances/home/fire/quotesCotización hogar incendioLink
POST/insurances/home/fire/issuing-of-policyEmisión pólizas hogar incendioLink
GET/billsConsulta de facturasLink
POST/bills/paymentsPagos de facturasLink
GET/insurability-cases/statusEstado de casos asegurabilidadLink
GET/catalog/productCatálogo productosLink
GET/catalog/product/lifeCatálogo productos vidaLink
GET/insurances/quota-protection/ratesTarifas protección cuotaLink
POST/insurances/quota-protection/quotesCotización protección cuotaLink
POST/insurances/quota-protection/issuing-of-policyEmisión protección cuotaLink
POST/insurances/policy/life/cancelCancelación póliza vidaLink
GET/insurances/generals/certificatesCertificados generalesLink
GET/retrieveClaimByPolicyReclamo por pólizaLink
GET/retrievePolicyInformationInformación de pólizaLink
POST/insurances-product-collectiveProducto colectivo segurosLink
GET/insurances/card-protection/ratesTarifas protección tarjetaLink
POST/insurances/life/ratesTarifas vidaLink
POST/insurances/card-protection/issuing-of-policyEmisión protección tarjetaLink
POST/insurances/life/issuing-of-policyEmisión póliza vidaLink
POST/insurances/life/quotesCotización vidaLink
POST/insurances/card-protection/quotesCotización protección tarjetaLink
POST/insurances/life/issuing-of-policy-v1Emisión vida v1Link
POST/insurances/life/v2/certificatesCertificados vida v2Link
POST/insurances/generals/v2/certificatesCertificados generales v2Link
POST/insurances/life/v3/certificatesCertificados vida v3Link
POST/customers/individual/insured/cancelCancelar asegurado individualLink
POST/customers/legal-persons/insuredAsegurados personas jurídicasLink

📝 Notas Importantes

  • Formato de Fechas: Utilizar DD-MM-YYYY o DD/MM/YYYY
  • Tipos de Documento: Valores comunes: CC (Cédula de Ciudadanía), TI (Tarjeta de Identidad), etc.
  • Límites de Consumo: Las llamadas están sujetas a límites de uso para garantizar estabilidad.
  • Validación de Datos: Todos los datos ingresados se validan contra reglas de negocio antes de ser procesados.

📤 Ejemplo de Petición (Genérico)

curl -X POST "https://cs-visual-time-sapi-qa-v1.us-e1.cloudhub.io/api/insureds" \
-H "client_id: TU_CLIENT_ID" \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "insured_id": "12345",
  "insured_name": "Juan Pérez",
  "insurance_type": "Vida",
  "policy_number": "POL123456"
}'

⚠️ Manejo de Errores

Códigos de estado HTTP estándar:

  • 200 OK – Solicitud exitosa
  • 400 Bad Request – Parámetros faltantes o inválidos
  • 401 Unauthorized – Falló la autenticación
  • 403 Forbidden – Acceso denegado
  • 404 Not Found – Recurso no encontrado
  • 429 Too Many Requests – Exceso en el límite de peticiones
  • 500 Internal Server Error – Error inesperado en el servidor

📞 Soporte

Para preguntas, incidencias o soporte de integración, contacta a:

Coordinación de Servicios e Integraciones de Aplicaciones

📧 epalma@fgs.co

📅 Notas

  • Documentación actualizada: Septiembre 2025
  • Para futuras actualizaciones, consulta el Portal de Exchange

Reviews