Agente de IA: Cotización GMM en HDI - Insurance Boosters API

El agente de cotización GMM de HDI recibe los datos del titular, selecciona el producto y las condiciones solicitadas, y devuelve todas las opciones de pago que muestra el portal. La selección de catálogos es exacta de forma predeterminada. Puedes habilitar explícitamente la selección numérica más cercana cuando el monto solicitado no exista.

Requisito previo

Registra una credencial de tipo hdi.portal para el mismo tenant:

Campo de la credencial	Contenido
`code`	Clave de acceso del portal HDI.
`password`	Contraseña del portal HDI.
`profileType`	Tipo de acceso configurado para la credencial.

La configuración del agente guarda únicamente el credentialId. El agente usa code como usuario de acceso y no devuelve valores de la credencial.

Campos requeridos

Campo	Tipo	Descripción
`credentialId`	`string`	ID de una credencial `hdi.portal` del mismo tenant.
`nombre`	`string`	Nombre del titular.
`apellidoPaterno`	`string`	Primer apellido.
`apellidoMaterno`	`string`	Segundo apellido.
`edad`	`integer`	Edad de 18 a 74.
`residencia`	`string`	Lugar de residencia disponible en el portal.
`sumaAsegurada`	`string`	Suma asegurada solicitada.
`deducible`	`string`	Deducible solicitado.
`coaseguro`	`string`	Porcentaje de coaseguro solicitado.

Campos opcionales y predeterminados

Campo	Predeterminado	Descripción
`producto`	`MEDICA VITAL`	Producto exacto del catálogo.
`descuento`	`0%`	Descuento disponible.
`genero`	`Masculino`	`Masculino` o `Femenino`.
`mayorEdad`	`true`	Respuesta al indicador de mayoría de edad.
`integrantes`	`[]`	Hasta ocho integrantes adicionales con `relacion` y `edad`.
`asistenciaExtranjero`	`false`	Activa asistencia en el extranjero.
`tipoNegocio`	`Nuevo Negocio`	Tipo de negocio disponible.
`topeCoaseguro`	Portal	Tope solicitado; si se omite conserva la opción dinámica del portal.
`catalogMatchMode`	`exact`	`exact` o `nearest`.

Con catalogMatchMode: "exact", el agente falla si un monto no existe. Con nearest, selecciona de forma determinista el valor numérico más cercano; en un empate elige el menor. Por ejemplo, si el catálogo no contiene suma $1,500,000 ni deducible $15,000, puede seleccionar $1,000,000 y $16,000 únicamente cuando catalogMatchMode sea nearest.

Integrantes adicionales

Cada elemento de integrantes usa:

Campo	Tipo	Descripción
`relacion`	`string`	Relación exacta o equivalente normalizada del catálogo.
`edad`	`integer`	Edad de 1 a 74.

La cantidad del arreglo determina el número de integrantes configurados.

Output

El agente devuelve una cotización homologada con cuatro opciones de pago cuando el portal las muestra:

{
  "insurer_name": "HDI",
  "plan_name": "MEDICA VITAL",
  "quote_number": "<folio-cotizacion>",
  "currency": "MXN",
  "annual_price": 25260,
  "payment_options": [
    {
      "frequency": "annual",
      "installment_count": 1,
      "premium": 21000,
      "policy_fee": 800,
      "surcharge": null,
      "tax": 3460,
      "total": 25260,
      "first_payment": 25260,
      "subsequent_payment": null,
      "currency": "MXN"
    }
  ],
  "coverage": [
    {
      "code": "deductible",
      "name": "Deducible",
      "value": 16000,
      "unit": "currency",
      "currency": "MXN",
      "display_value": "$16,000"
    }
  ],
  "benefits": [],
  "recommended": false
}

annual_price corresponde al costo total anual, no únicamente a la prima. Los campos de recargo permanecen en null cuando el portal no los muestra por separado.

Limitaciones

Los datos del agente y oficina provienen de la cuenta del portal y no son inputs configurables.
Los catálogos pueden cambiar según producto, edad y residencia.
La fecha y los datos personales usados para verificar la cotización no forman parte del output homologado.

Errores

El agente falla si la credencial no corresponde a hdi.portal, si no puede iniciar sesión, si un valor exacto no existe y no se autorizó nearest, o si el portal no devuelve las opciones de pago esperadas.

​Requisito previo

​Campos requeridos

​Campos opcionales y predeterminados

​Integrantes adicionales

​Output

​Limitaciones

​Errores

​Relacionado