05 Integración con Copsis
Qué necesita cada agente de Copsis
Copsis abrió dos caminos distintos hacia quattroCRM: la colección pública de APIs y —esto es
nuevo— el procedimiento TI-88, que da acceso directo de solo lectura a la base de datos por medio de
vistas SQL. Ese segundo canal cambia el diagnóstico: cierra de golpe la brecha más grande que teníamos
identificada —que ningún agente podía descubrir sobre qué trabajar— y pone al alcance siniestros y
comisiones, que la API no documenta. A continuación se cruza, agente por agente, lo que cada uno necesita
contra lo que hoy existe por cualquiera de los dos canales.
2
Canales de integración que abre Copsis
API REST · vistas SQL de solo lectura
6
Vistas ya programadas, con 202 campos
Clientes · Pólizas · Endosos · Recibos · Siniestros ×2
24
Brechas que las vistas cierran de inmediato
De las 40 que estaban por solicitar
22
Peticiones que siguen abiertas
Casi todas de escritura y de eventos
Dos fuentes. La colección pública «Copsis APIs» en
apidoc.copsis.com ↗,
con base productiva en
api.quattrocrm.mx y pruebas en
apiuat.quattrocrm.mx; y el documento interno
TI-88 «Conexión a Vistas por Power BI» —confidencial, versión 1—, que describe el procedimiento por el cual Copsis
programa vistas a la medida sobre la base de quattroCRM y entrega credenciales de lectura directa.
La colección advierte que
la mayoría de los servicios requiere token autorizado y que se entrega
sin garantía de disponibilidad; el TI-88, por su parte, condiciona el acceso a que Gamex declare las IPs
desde las que se conectará y especifique qué vistas quiere.
Dos canales, y hacen cosas distintas
No compiten: se complementan. Uno lee en masa pero no escribe; el otro escribe y opera pero solo sabe
responder si ya se conoce el ID exacto del registro. Un agente autónomo necesita los dos.
Canal 1 · Lo que ya conocíamos
API REST de quattroCRM
api.quattrocrm.mx · apiuat.quattrocrm.mx
Seis módulos y cuarenta y cuatro llamados. Es el canal que actúa: emite, cotiza, abre folios,
registra pagos, lee PDFs y envía notificaciones.
- Escribe sobre la plataforma: es la única forma de que un agente deje algo registrado
- Flujo de Autos completo: catálogos, cotización, homologación y emisión
- Consulta puntual y por ID: no lista, no filtra, no pagina
- No cubre siniestros ni comisiones
Canal 2 · Lo que aporta el TI-88
Vistas SQL de solo lectura
MySQL · vistas a la medida sobre quattroCRM
Seis vistas ya programadas con 202 campos entre todas. Es el canal que permite ver: la cartera
completa, filtrable, agregable y consultable como cualquier base de datos.
- Lee en masa: por fin un agente puede descubrir qué vence, qué no se ha pagado y quién tiene un solo producto
- Incluye siniestros —diversos y salud— y el porcentaje de comisión de cada recibo
- Devuelve texto, no IDs: aseguradora, ramo, vendedor y estatus vienen ya legibles
- No escribe nada y no avisa de nada: es una fotografía que hay que ir a consultar
La combinación es la que sirve. El TI-88 se redactó pensando en Power BI, pero lo que entrega es una
conexión MySQL estándar: la plataforma de HAILO se conecta exactamente igual. El patrón de trabajo queda
claro —la vista descubre sobre qué actuar y la API actúa—. Con eso, ocho de los diez agentes tienen ya
resuelto el lado de la lectura; lo que sigue pendiente es, casi por completo, poder escribir de vuelta.
Canal 1 · Lo que Copsis ya publicó como API
Seis módulos, cuarenta y cuatro llamados. Es una base sólida para el portal, la lectura de PDFs y todo el
flujo de Autos; queda corta en cartera consultable, cobranza, siniestros y comisiones.
CRM 8 llamados
Folios de seguimiento ligados a póliza, recibo, siniestro, cliente o endoso; bitácora de texto por folio;
tareas con responsable y compromiso; y envío de notificaciones a app, correo, SMS y webhooks.
api.quattrocrm.mx/crm
Pólizas 3 llamados
Consulta puntual de póliza, recibo y endoso. Los tres funcionan únicamente por ID: no hay búsqueda por
cliente, por vigencia ni por estatus.
api.quattrocrm.mx/polizas
PDFs 3 llamados
Lectura de carátulas de póliza y de certificados a JSON uniforme, más lectura de la Constancia de Situación
Fiscal del SAT —esta última todavía en ambiente de pruebas—.
api.quattrocrm.mx/pdf/lector-pdf
quattroAutos 8 llamados
El módulo más completo: catálogos de marca, tipo y versión, búsqueda de vehículo, código postal,
homologación de claves entre aseguradoras, cotización y emisión.
api.quattrocrm.mx/autos
Móvil · Peem 14 llamados
El backend de portal y app: alta y login de usuarios, carga de pólizas —individual y masiva—, pólizas
compartidas, adjuntos y registro del pago de recibos.
api.quattrocrm.mx/peem/v2
BiiBiiC 8 llamados
Movimientos de asegurados en Salud —altas, bajas y cambios—, adjuntos de soporte, consulta de endoso,
cotización de Casa y de Salud grupal, y consulta de pólizas por nómina.
apiuat.quattrocrm.mx/operaciones · /biibiic
Servicios que Copsis menciona pero no documenta. La propia descripción del módulo quattroAutos enumera
servicios que no aparecen en la colección: pasarela de pago de recibos, obtención de PDFs de pólizas,
consulta de recibos, consulta de pólizas, consulta de número de serie asegurada y
consulta de capa de negocio. Varios son justamente los que la cobranza y el portal necesitan: conviene
pedir su documentación antes que nada, porque probablemente ya existen.
Canal 2 · Las seis vistas que Copsis ya tiene programadas
El TI-88 publica el diccionario de datos completo de seis vistas. No son ejemplos: son las vistas que Copsis
ya construyó, con nombre de campo, tipo de dato y función de cada uno. Entre las seis suman 202 campos y
cubren cliente, póliza, endoso, recibo y siniestro —el ciclo completo de una correduría—.
Clientes 22 campos
El padrón completo: identidad, dirección derivada del código postal, contacto, demografía y a qué vendedor,
equipo y grupo pertenece cada cliente.
cliente_idrfccorreotelefonofec_nacimientosexocpmunicipioEstadovendedorequipostatus
DesbloqueaContacto multicanal sin pedirle el dato a nadie, segmentación demográfica y la llave cliente_id que une al cliente con toda su cartera.
Polizas 50 campos
La cartera entera con vigencias, primas, aseguradora, ramo, estatus, motivo de cancelación, flotillas,
nómina, serie del vehículo y la última bitácora registrada.
no_polizacliente_idfec_vig_astatusprimatotalaseguradoraramonuevarenovecolectividadmotivoCancelacion
DesbloqueaEl listado de vencimientos a 90, 60 y 30 días; la medición real de retención vía status y renove; y la cartera agrupada por cliente.
Endosos 22 campos
Todos los movimientos de cada póliza, con tipo, concepto, prima del endoso, estatus del trámite y su liga
directa a la póliza de origen.
endoso_idpoliza_idno_endosostatusEndosonombreconceptoEndosoendosoPrimafec_creacioncreador
DesbloqueaEl histórico de endosos por póliza y la detección de trámites atorados en PENDIENTE o PROCESO desde hace demasiados días.
RecibosBI 50 campos
La vista más valiosa. Cada recibo con vencimiento, estatus, importes, quién pagó, cuándo se registró el
pago, si está conciliado y —clave— el porcentaje de comisión.
recibo_idfec_vencestatusRecibototalprimacomisionPorcentajeconciliadofechaPagoregistroPagopagadorclaveAgenteformaCobro
DesbloqueaLa cobranza completa —qué vence y qué no se ha pagado— y el lado interno de la conciliación de comisiones, que era la mayor brecha del diagnóstico.
SiniestrosDiversos 32 campos
Siniestros de autos y daños con montos reclamado, procedente, deducible, coaseguro y pagado; fechas de todo
el trámite, responsables asignados y entrada y salida de taller.
no_polizatiporeclamadoprocedentededuciblepagadostatusfec_siniestrofec_promesapagoRealfecUltimoPasoentradaTallerUlt_Bitacora
DesbloqueaEl seguimiento de siniestros, que la API no documenta en absoluto: estatus, tiempos, casos atorados y siniestralidad por cliente.
SiniestrosSalud 26 campos
Gastos médicos con el mismo detalle de montos y tiempos, más el asegurado afectado y el tipo de trámite
—reembolso, programación o pago directo—.
no_polizaaseguradotiporeclamadoprocedentecoaseguropagadostatusfec_reportefec_promesaresponsableUlt_Bitacora
DesbloqueaEl expediente de GMM —el segundo ramo de Gamex— y la vigilancia de promesas de pago incumplidas.
Los catálogos vienen incluidos. El propio diccionario documenta los estatus con su valor numérico. Es un
detalle menor en apariencia, pero significa que no hay que pedirle a Copsis un catálogo aparte para
interpretar la cartera: los agentes pueden razonar sobre estos estados desde el primer día.
Estatus de póliza
Pendiente1Proceso2Vigente3Anticipada4Gracia5Desprotegida6Vencida7Terminada8Renovada9Precancelada10Cancelada11
Estatus de recibo
Pendiente1Pagado2Conciliado3Cancelado4Vencido5
Estatus de endoso
Pendiente1Proceso2Activo3Cancelado11
Cómo se activa el canal de vistas
El TI-88 describe un procedimiento corto y, sobre todo, de trámite, no de desarrollo. Lo importante es
el paso 3: las vistas son a la medida —Gamex indica el nombre y los campos que quiere—, así que la lista
de seis no es un techo, es el punto de partida.
1
Gamex
Solicita formalmente a Copsis el acceso a su propia información con fines de análisis.
2
Gamex
Entrega las IPs desde las que se conectará. Requiere IP fija: hay que definirla con HAILO.
3
Gamex
Indica qué vistas quiere y qué campos lleva cada una. Aquí se piden las que hoy faltan.
4
Copsis
Programa las vistas en el tiempo acordado. Conviene fijar ese plazo por escrito.
5
Copsis
Entrega IP del servidor, usuario y contraseña. Con eso la plataforma ya lee.
Qué falta preguntar sobre este canal. El documento resuelve el «cómo» pero deja tres cosas sin definir, y
las tres importan para diseñar bien: si se lee de producción o de una réplica —determina cada cuánto se
puede consultar sin afectar la operación—, si existe una columna de última modificación en cada vista
—sin ella no hay extracción incremental y hay que releer todo— y si hay límites de concurrencia o de
volumen. Ninguna es un obstáculo: son preguntas de una sola conversación.
Tablero por agente
Cada tablero lista lo que el agente necesita para cumplir su ciclo, cómo se resuelve hoy —por API, por vista o
por ninguna de las dos— y el estado de esa pieza.
Cómo leer los tableros
DisponibleAPI documentada y lista para consumir
Vista SQLlo resuelve el canal de vistas del TI-88
Parcialexiste pero limitado —un ramo, solo UAT o solo por ID—
Por solicitarno lo cubre ninguno de los dos canales
Agente 01
Cobranza
4 disponibles3 por vista2 parciales2 por solicitar
El agente que más gana con las vistas. Antes podía consultar un recibo solo si conocía su ID;
ahora RecibosBI le da la lista completa
de lo que vence, con importe, estatus y contacto del cliente. Lo único que le falta es cobrar.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Listado de recibos por vencer | VISTARecibosBI
fec_vence statusRecibo | Detectar los recibos pendientes por rango de fechas y estatus: es lo que dispara todo el ciclo | Vista SQL |
| Consulta de recibo | GET/polizas/recibos/:reciboID | Importe, vigencia y estatus del recibo a cobrar | Disponible |
| Consulta de la póliza | GET/polizas/:polizaID | Contexto de la póliza a la que pertenece el recibo | Disponible |
| Recibos de una póliza | VISTARecibosBI por no_poliza | Estado de cuenta del cliente y recibos subsecuentes, con serie y total de la serie | Vista SQL |
| Datos de contacto del cliente | VISTAClientes
correo telefono | Teléfono, WhatsApp y correo para el contacto multicanal | Vista SQL |
| Apertura del folio de gestión | POST/crm/ | Abre el expediente de cobranza ligado al recibo y la póliza | Disponible |
| Bitácora de cada contacto | POST/crm/texto | Deja registro de cada llamada, mensaje y respuesta | Disponible |
| Notificación al cliente | POST/crm/webhooks/send/:tipo | Avisos por los canales de la plataforma; la voz y WhatsApp los aporta HAILO | Parcial |
| Enlace de pago del recibo | — mencionada sin documentar | Cobrar en línea dentro del mismo flujo, sin salir de la conversación | Por solicitar |
| Registro del pago | PUT/peem/v2/recibos/pago/:poliza,:socio | Marca el recibo como pagado; hoy solo sobre el módulo móvil, no sobre la cartera | Parcial |
| Aviso de recibo pagado | — no publicada
VISTAfechaPago conciliado | No hay webhook; la vista permite conciliar por sondeo, pero no en el momento en que ocurre el pago | Por solicitar |
Agente 02
Renovación y Retención
4 disponibles3 por vista3 parciales2 por solicitar
Re-cotizar Autos ya era posible de punta a punta; lo que faltaba era la pieza inicial —saber
qué vence a 90, 60 y 30 días—, y la vista Polizas
la resuelve. Queda pendiente la cobertura de los demás ramos.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Listado de pólizas por vencer | VISTAPolizas
fec_vig_a status | Detectar la cartera que vence a 90, 60 y 30 días: dispara el ciclo | Vista SQL |
| Medición real de la retención | VISTAstatus renove motivoCancelacion | Saber qué se renovó, qué se terminó y qué se canceló —y por qué—: el número que hoy nadie tiene | Vista SQL |
| Consulta de la póliza vigente | GET/polizas/:polizaID | Vigencias, prima y datos que se re-cotizan | Disponible |
| Re-cotización de Autos | POST/autos/publics/cotizacion | Vuelve a poner la unidad en el mercado | Disponible |
| Homologación entre aseguradoras | POST/autos/publics/homologacion | Comparar la misma unidad entre compañías; hoy solo en ambiente de pruebas | Parcial |
| Re-cotización de otros ramos | POST/aseguradoras/externo/cotizacion/casa
POST/operaciones/proceso/poliza/plan/tarifa/asegurado | Solo Casa con paquetes fijos y Salud grupal; falta GMM individual, Vida y Daños | Parcial |
| Emisión de la renovación | POST/autos/emision | Emite la póliza nueva; disponible únicamente para Autos | Parcial |
| Renovación heredando la póliza | — no publicada | Renovar sin recapturar los datos del asegurado y del riesgo | Por solicitar |
| Datos de contacto del cliente | VISTAClientes
correo telefono | Contactar por voz, WhatsApp y correo antes del vencimiento | Vista SQL |
| Folio y bitácora del seguimiento | POST/crm/ · POST/crm/texto | Registra cada intento hasta obtener respuesta | Disponible |
| Notificación al cliente | POST/crm/webhooks/send/:tipo | Aviso anticipado del vencimiento | Disponible |
| Cobro de la renovación | — mencionada sin documentar | Enlace de pago para cerrar la renovación en el mismo contacto | Por solicitar |
Agente 03
Portal de Clientes
7 disponibles2 por vista1 parcial2 por solicitar
El agente mejor cubierto: el módulo Móvil (Peem) es literalmente el backend de un portal, y
las vistas resuelven los listados que le faltaban. Lo que queda son dos documentos: la carátula
descargable y el pago en línea.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Alta y edición del usuario | POST/peem/v2/ · PUT/peem/v2/:peemID | Crear la cuenta de cada cliente en el portal | Disponible |
| Localizar al cliente por correo | GET/peem/v2/correo/:correo | Reconocerlo al entrar y evitar cuentas duplicadas | Disponible |
| Login y validación de registro | POST/peem/v2/login · POST/peem/v2/login/valida | Acceso con código de verificación | Disponible |
| Carga de pólizas al portal | POST/peem/v2/polizas · POST/peem/v2/polizas/multiple | Poblar el portal con la cartera del cliente, una a una o de golpe | Disponible |
| Consulta de póliza del portal | GET/peem/v2/polizas/:polizaID
GET/peem/v2/polizas/nopoliza/:peem,:noPoliza | Detalle de cada póliza que el cliente abre | Disponible |
| Listado de pólizas y recibos del cliente | VISTAPolizas + RecibosBI
por cliente_id | La pantalla «Mis pólizas» necesita listar, no consultar de uno en uno | Vista SQL |
| Pólizas compartidas | POST/peem/v2/polizas/comparte | Vista para familias y para responsables dentro de una empresa | Disponible |
| Vista consolidada corporativa | VISTAPolizas
grupo Grupo2 colectividad nomina | Cobertura de toda la plantilla sin depender de BiiBiiC ni del número de nómina | Vista SQL |
| Documentos del cliente | POST/peem/v2/adjuntos · GET/peem/v2/adjuntos/:peemID | Subir y consultar documentos desde el portal | Disponible |
| Descarga de la carátula en PDF | — mencionada sin documentar | El botón «Descargar carátula» del portal | Por solicitar |
| Pago en línea del recibo | — mencionada sin documentar | El botón «Pagar en línea»: hoy solo se puede registrar un pago ya hecho | Por solicitar |
| Registro del pago | PUT/peem/v2/recibos/pago/:poliza,:socio | Deja constancia del pago; no lo cobra | Parcial |
Agente 04
Cotizador
6 disponibles1 por vista4 parciales5 por solicitar
El agente que menos cambia con las vistas, porque su trabajo es escribir: cotizar y
emitir. En Autos el flujo está completo; fuera de Autos la cobertura cae, y sigue faltando cerrar el tramo
final —alta del cliente y cobro—.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Catálogo de marca, tipo y versión | POST/autos/publics/busqueda/marca · /tipo · /version | Guiar la captura del vehículo en la conversación | Disponible |
| Búsqueda de vehículo por descripción | POST/autos/publics/busqueda/descripcion | Obtener la clave del vehículo a partir de lo que dice el cliente | Disponible |
| Código postal y colonias | GET/autos/publics/codigo-postal/:cp | Dato obligatorio para tarificar y emitir | Disponible |
| Homologación de claves | POST/autos/publics/homologacion | Comparativo homologado entre aseguradoras; hoy solo en pruebas | Parcial |
| Cotización de Autos | POST/autos/publics/cotizacion | Cotiza los paquetes configurados para el negocio de Gamex | Disponible |
| Emisión de Autos | POST/autos/emision | Emite la póliza a partir de la cotización elegida | Disponible |
| Cotización de Casa | POST/aseguradoras/externo/cotizacion/casa | Ramo Daños; limitado a paquetes preconfigurados y código postal | Parcial |
| Cotización de Salud grupal | POST/operaciones/proceso/poliza/plan/tarifa/asegurado
GET/operaciones/proceso/poliza/plan | Alta a colectivos; exige una póliza grupal vigente como base | Parcial |
| Cotización de GMM individual | — no publicada | El segundo ramo de Gamex; hoy no hay forma de cotizarlo por API | Por solicitar |
| Emisión de GMM, Vida y Daños | — no publicada | Cerrar el flujo completo fuera de Autos | Por solicitar |
| Datos fiscales del contratante | POST/traductor/lector-constancia | Lee la constancia del SAT y autocompleta RFC y régimen; solo en pruebas | Parcial |
| Consulta de cotización por ID | — no publicada | Recuperar y reenviar un comparativo días después | Por solicitar |
| ¿Ya es cliente de Gamex? | VISTAClientes por rfc
+ Polizas por cliente_id | Reconocer al prospecto que ya tiene cartera: cambia por completo el tono de la conversación y evita duplicarlo | Vista SQL |
| Alta del cliente en la cartera | — no publicada | Dar de alta al cliente al emitir, sin recaptura; la vista lo encuentra pero no lo puede crear | Por solicitar |
| Enlace de pago de la póliza | — mencionada sin documentar | Cobrar la póliza recién emitida | Por solicitar |
| Registro del prospecto | POST/crm/ | El folio acepta prospecto, cotización y opción: sirve como embudo | Disponible |
Agente 05
Siniestros
4 disponibles3 por vista1 parcial3 por solicitar
El giro más grande del diagnóstico. Seguía sin existir un módulo de siniestros en la API, pero
el TI-88 trae dos vistas completas —diversos y salud— con montos, tiempos, responsables y bitácora. El
agente pasa de no poder ver nada a vigilar el trámite completo; lo que no puede todavía es dar de alta
el reporte.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Alta del siniestro | — no publicada | Registrar el reporte del asegurado en el sistema: lo único que las vistas no pueden hacer, por ser de solo lectura | Por solicitar |
| Consulta y estatus del siniestro | VISTASiniestrosDiversos
SiniestrosSalud | Seguir el dictamen de la aseguradora hasta el pago, con estatus, último paso y última bitácora del caso | Vista SQL |
| Montos del caso | VISTAreclamado procedente
deducible coaseguro pagado | Explicarle al asegurado —con números— qué procede, qué le descuentan y cuánto va a recibir | Vista SQL |
| Tiempos y casos atorados | VISTAfec_siniestro fec_reporte
fec_promesa pagoReal fecUltimoPaso | Detectar solo el expediente que lleva días sin moverse o la promesa de pago que ya se venció | Vista SQL |
| Folio por siniestro | GET/crm/?siniestroID= · POST/crm/ | Abrir y recuperar el expediente de gestión del caso | Disponible |
| Bitácora del caso | POST/crm/texto · GET/crm/texto/:crmID | Registro de cada gestión con el asegurado y la aseguradora | Disponible |
| Consulta de la póliza afectada | GET/polizas/:polizaID | Validar coberturas, deducible y vigencia al momento del siniestro | Disponible |
| Carga de documentos del expediente | POST/peem/v2/adjuntos
POST/operaciones/proceso/endoso/adjunto | Hay adjuntos del portal y de BiiBiiC, pero ninguno ligado a un siniestro | Parcial |
| Checklist documental por ramo | — no publicada | Saber qué exige cada aseguradora para armar el expediente completo | Por solicitar |
| Aviso de cambio de estatus | — no publicada
VISTAfecUltimoPaso | No hay webhook del dictamen; con la vista se detecta por sondeo, con el retraso que eso implica | Por solicitar |
| Notificación al asegurado | POST/crm/webhooks/send/:tipo | Informar avances en el peor momento del cliente | Disponible |
Agente 06
Servicio y Endosos
3 disponibles2 por vista3 parciales3 por solicitar
El endoso se puede consultar —y ahora también vigilar, con la vista
Endosos completa por póliza—, pero
sigue sin poderse solicitar. Los únicos movimientos que se originan por API son los de Salud en
colectivos, y están en ambiente de pruebas.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Solicitud de endoso | — no publicada | Capturar el cambio: placas, domicilio, conductor, suma asegurada, beneficiarios | Por solicitar |
| Consulta de endoso | GET/polizas/endosos/:endosoID
GET/endosos/consulta/:endosoID | Ver el endoso ya emitido; la segunda ruta solo en ambiente de pruebas | Disponible |
| Movimientos de asegurados | POST/operaciones/proceso/asegurado/movimientos | Altas, bajas y cambios masivos; solo ramo Salud y solo en pruebas | Parcial |
| Adjuntos de soporte del cambio | POST/operaciones/proceso/endoso/adjunto | Documentos que respaldan el movimiento; hoy solo dentro de BiiBiiC | Parcial |
| Histórico de endosos de una póliza | VISTAEndosos por poliza_id | Ver todos los cambios de una póliza, no solo uno por ID | Vista SQL |
| Trámites atorados | VISTAstatusEndoso fec_creacion | Levantar solo los endosos que llevan demasiados días en PENDIENTE o PROCESO, sin revisar la bandeja completa | Vista SQL |
| Carátula actualizada en PDF | — mencionada sin documentar | Reenviar al cliente la póliza con el cambio ya aplicado | Por solicitar |
| Aviso de endoso emitido | — no publicada
VISTAstatusEndoso | Sin webhook, el cierre del trámite se detecta sondeando la vista, no en el momento en que la aseguradora responde | Por solicitar |
| Folio y bitácora del trámite | POST/crm/ · POST/crm/texto | Registro de qué se pidió, cuándo y en qué va | Disponible |
| Confirmación al cliente | POST/crm/webhooks/send/:tipo | Avisar que el endoso quedó aplicado | Disponible |
| Lectura de la carátula emitida | POST/pdf/lector-pdf | Verificar que el cambio quedó reflejado antes de enviarla | Parcial |
Agente 07
Comisiones
2 disponibles3 por vista1 parcial2 por solicitar
Era el agente con la mayor brecha —no existe módulo de comisiones en la API— y deja de serlo.
RecibosBI trae
comisionPorcentaje,
conciliado y las fechas de pago:
todo el lado interno del cruce ya se puede calcular. Lo que falta es el otro lado, que no es de Copsis:
el estado de cuenta que manda cada aseguradora.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Comisión devengada por recibo | VISTARecibosBI
comisionPorcentaje prima total | El importe esperado contra el cual se concilia, recibo por recibo: la pieza que faltaba para que el agente exista | Vista SQL |
| Recibos cobrados por periodo | VISTAfechaPago registroPago
conciliado statusRecibo | Todo lo efectivamente cobrado en el mes, con lo ya conciliado marcado aparte | Vista SQL |
| Cancelaciones y devoluciones | VISTAstatusRecibo statusPoliza
motivoCancelacion | Ajustar la comisión por recibos que se cayeron, con el motivo registrado | Vista SQL |
| Esquema de comisión por negocio | VISTAcomisionPorcentaje agregado
por aseguradora y ramo | El porcentaje viene a nivel recibo, así que el esquema se puede reconstruir; no hay catálogo formal por conducto | Parcial |
| Estado de cuenta de la aseguradora | — fuera de Copsis | Lo que cada compañía reporta como pagado: es el otro lado del cruce y no vive en quattroCRM | Por solicitar |
| Layout de pago de la aseguradora | — fuera de Copsis | El archivo mensual contra el que se concilia; HAILO puede leerlo, pero hay que conseguirlo de cada compañía | Por solicitar |
| Consulta de recibo | GET/polizas/recibos/:reciboID | Prima e importe base del cálculo, recibo por recibo | Disponible |
| Consulta de póliza | GET/polizas/:polizaID | Aseguradora, ramo y conducto que determinan la comisión | Disponible |
Agente 08
Copiloto de Dirección
3 disponibles2 por vista3 parciales
Para responder «¿cómo va la cobranza esta semana?» hacía falta leer la cartera completa: era
la brecha de fondo de toda la integración, y las vistas son exactamente eso. Ya no queda nada en rojo;
lo que queda son afinaciones —el incremental y el histórico de bitácoras—.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Lectura masiva de la cartera | VISTAlas 6 vistas | Pólizas, recibos, clientes y siniestros completos: es precisamente para lo que sirve una conexión SQL | Vista SQL |
| Indicadores de negocio | VISTAprima total status
vendedor equipo grupo | Producción, cobranza, retención y siniestralidad cortadas por vendedor, equipo, ramo o aseguradora | Vista SQL |
| Extracción incremental | VISTAfec_creacion bitacora_fec
fecUltimoPaso | Hay fechas aprovechables, pero ninguna vista trae una columna de última modificación: hay que pedirla | Parcial |
| Catálogos de la plataforma | VISTAtexto ya resuelto
— falta tipos de siniestro | Las vistas devuelven aseguradora, ramo y estatus en texto, así que casi no hacen falta catálogos; el tipo de siniestro sí remite a uno que no se publicó | Parcial |
| Consulta puntual de un caso | GET/polizas/:polizaID · /recibos/:reciboID · /endosos/:endosoID | Verificar un expediente concreto cuando la dirección pregunta por él | Disponible |
| Folios y bitácoras | GET/crm/:crmID · GET/crm/texto/:crmID
VISTAbitacora_texto Ult_Bitacora | Las vistas traen la última bitácora de cada póliza, recibo y siniestro; para el histórico completo sigue haciendo falta ir folio por folio | Parcial |
| Alta de tareas y recordatorios | POST/crm/ | El folio acepta tarea, responsable, fecha programada y compromiso | Disponible |
| Envío de avisos y reportes | POST/crm/webhooks/send/:tipo | Distribuir lo que la dirección pide por correo, SMS o app | Disponible |
Agente 09
Inteligencia y Venta Cruzada
2 disponibles4 por vista1 parcial
Detectar «quién tiene Autos pero no Gastos Médicos» exige leer la cartera agrupada por cliente,
y la API no permitía llegar del cliente a sus pólizas. Con
cliente_id presente en
Clientes y en
Polizas, ese cruce es una consulta
de una línea. El agente queda prácticamente completo.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Pólizas agrupadas por cliente | VISTAPolizas por cliente_id
cortado por ramo | La consulta que revela quién tiene un solo producto: el corazón de la venta cruzada | Vista SQL |
| Padrón de clientes | VISTAClientes
fec_nacimiento sexo cp municipio | Datos demográficos y de contacto para priorizar y abordar; 22 campos por cliente | Vista SQL |
| Pólizas de un asegurado | VISTAPolizas
nomina grupo colectividad | Ya no hace falta pasar por BiiBiiC ni por el número de nómina | Vista SQL |
| Detalle de cada póliza | GET/polizas/:polizaID | Enriquecer la oportunidad con prima, vigencia y coberturas | Disponible |
| Histórico de siniestralidad | VISTASiniestrosDiversos + SiniestrosSalud
reclamado pagado | Calificar la oportunidad y evitar ofrecer donde no conviene, con la siniestralidad real del cliente | Vista SQL |
| Alta de la oportunidad | POST/crm/ | El folio admite prospecto, cotización y opción: sirve para entregar al embudo | Disponible |
| Cotización del producto sugerido | POST/autos/publics/cotizacion | Aterrizar la oportunidad en una oferta; hoy solo si es Autos | Parcial |
Agente 10
Extractor de Pólizas
2 disponibles1 por vista3 parciales3 por solicitar
El agente donde mejor se ve el límite del canal de vistas. La mitad difícil ya está resuelta
—Copsis lee la carátula y devuelve JSON— y la vista permite verificar duplicados antes de cargar. Pero
escribir lo extraído en la cartera sigue sin ser posible: la vista es de solo lectura y las APIs de
escritura publicadas alimentan el portal, no el sistema.
| Lo que necesita el agente | Cómo se resuelve hoy | Para qué | Estado |
|---|
| Lectura de la carátula en PDF | POST/pdf/lector-pdf | Convierte la carátula en datos estructurados: el corazón del agente | Disponible |
| Lectura de certificados | POST/pdf/lector-pdf/lectorCertificados | Colectivos y certificados individuales dentro de una póliza grupal | Disponible |
| Lectura de constancia fiscal | POST/traductor/lector-constancia | Datos fiscales del contratante desde el PDF o la foto del SAT; solo en pruebas | Parcial |
| Cobertura de la lectura | POST/pdf/lector-pdf | Falta el listado de aseguradoras y formatos soportados para saber qué queda fuera | Parcial |
| Alta de la póliza en la cartera | POST/peem/v2/polizas · /multiple | Lo publicado carga la póliza al portal móvil, no al sistema de cartera | Parcial |
| Escritura de póliza en el sistema | — no publicada | Cargar lo extraído donde vive la cartera: el fin de la doble captura | Por solicitar |
| Alta de los recibos de la póliza | — no publicada | Para que la cobranza arranque sola en cuanto se carga la póliza | Por solicitar |
| Alta y vinculación del cliente | — no publicada | Relacionar la póliza con su titular en el padrón | Por solicitar |
| Validación contra duplicados | VISTAPolizas por no_poliza
Clientes por rfc | Buscar por número de póliza y por RFC antes de cargar, para no duplicar la cartera | Vista SQL |
Lo que hay que pedirle a Copsis
La lista cambió de forma. Lo que antes encabezaba la petición —las consultas por filtro y los listados— ya no
hace falta pedirlo: lo resuelve el canal de vistas. Lo que queda, consolidado y sin repetir, se concentra en dos
cosas: poder escribir de vuelta y que la plataforma avise cuando algo pasa.
Crítico · primer paso, y es de trámite
Activar el canal de vistas para Gamex
- Presentar la solicitud formal de acceso a la información de Gamex, según el TI-88
- Definir y entregar las IPs fijas desde las que se conectará la plataforma
- Confirmar las seis vistas ya documentadas y acordar el plazo de entrega
- Recibir IP del servidor, usuario y contraseña de solo lectura
- Es la petición más barata de todas y la que más desbloquea: no requiere desarrollo de Copsis
Crítico · ahora es la brecha principal
Escritura sobre la cartera
- Alta de póliza y de sus recibos en el sistema de cartera
- Alta y vinculación del cliente o prospecto
- Alta del siniestro desde el reporte del asegurado, con sus adjuntos
- Solicitud de endoso para todos los ramos: placas, domicilio, conductor, suma asegurada, beneficiarios
- Lo publicado escribe sobre el portal móvil (Peem), no sobre la cartera; y las vistas, por definición, no escriben nada
Crítico · ya existen, faltan documentar
Los servicios que la colección enumera
- Pasarela de pago de recibos — cobranza y portal dependen de ella, y ninguna vista puede cobrar
- Obtención de PDFs de pólizas — carátula descargable y reenvío tras un endoso
- Número de serie asegurada y capa de negocio
- Aparecen listados en la descripción de quattroAutos sin endpoint publicado: es lo primero que conviene preguntar
Alta · define la calidad del dato
Condiciones técnicas de las vistas
- Columna de última modificación en cada vista: sin ella no hay extracción incremental y hay que releer la cartera completa cada vez
- Si se lee de producción o de una réplica, y con qué retraso se refresca
- Límites de concurrencia, de volumen por consulta y ventana horaria recomendada
- Compromiso de aviso previo si cambia la estructura de una vista
Alta · aprovechar que son a la medida
Vistas adicionales que conviene pedir
- Estado de cuenta de comisiones si quattroCRM lo registra: cerraría el agente por completo
- Bitácoras completas, no solo la última de cada póliza, recibo y siniestro
- Folios y tareas del CRM, para leer la gestión sin ir folio por folio
- Cotizaciones generadas, para recuperar y reenviar un comparativo después
- El paso 3 del TI-88 dice que Gamex indica nombre y campos: la lista de seis no es un techo
Alta
Webhooks de eventos
- Recibo pagado · póliza emitida · endoso emitido
- Siniestro actualizado · póliza cancelada o no renovada
- Las vistas permiten detectar todo esto por sondeo, pero con retraso y releyendo de más
- Con eventos, el agente reacciona en el momento; sin ellos, en el siguiente ciclo de lectura
Media · amplía el alcance
Cotización y emisión fuera de Autos
- GMM individual: cotización y emisión —el segundo ramo de Gamex—
- Vida y Daños más allá del paquete de Casa
- Renovación que herede los datos de la póliza vigente
- Requisitos documentales de siniestro por ramo y aseguradora
Media · habilitadores
Catálogos que siguen faltando
- Tipos de siniestro: el diccionario dice «en base a catálogo adjunto» y el catálogo no viene
- Status y tipos de folio del CRM —el propio ejemplo dice «en base a catálogo» sin publicarlo—
- Aseguradoras y formatos que cubre el lector de PDFs
- Los de póliza, recibo y endoso ya no hacen falta: vienen documentados en el TI-88
Media · condiciones del servicio
Credenciales, ambientes y operación
- Token de producción para Gamex y esquema de autenticación por módulo —hoy conviven Basic, x-api-key y Authorization—
- Qué servicios están en producción y cuáles solo en UAT: homologación, constancia fiscal, movimientos de Salud y varios de BiiBiiC apuntan a ambiente de pruebas
- Límites de uso, tiempos de respuesta y compromiso de disponibilidad: la colección se entrega «sin ningún tipo de garantía»
- Ambiente de pruebas con datos de Gamex para desarrollar sin tocar producción
Lectura de fondo. El diagnóstico original decía que ningún agente podía descubrir sobre qué actuar
—qué vence, qué no se ha pagado, quién tiene un solo producto—. El TI-88 resuelve eso de un golpe, y de la forma
más barata posible: no hay que construir nada, hay que tramitarlo. Con las vistas activas, ocho de los diez
agentes ya pueden ver toda la operación de Gamex, y dos de los que parecían imposibles —Siniestros y Comisiones—
dejan de serlo. Lo que queda pendiente es de una sola naturaleza: escribir de vuelta. Y ahí la estrategia no
cambia —de hecho se refuerza—: mientras Copsis abre esos servicios, la plataforma escribe en su propia base,
lee de Copsis lo que necesita y opera sin quedarse esperando.
Operado por Regina · voz, WhatsApp y correo
Operado por Lucía · chat dentro del portal
