> ## Documentation Index
> Fetch the complete documentation index at: https://developers.insuranceboosters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agente de IA: Cotización GMM en HDI

> Genera una cotización de Gastos Médicos Mayores en HDI con coberturas y opciones de pago homologadas.

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:

```json theme={null}
{
  "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.

## Relacionado

* [Agentes preconfigurados para Seguros](/agentes/industrias/seguros)
* [Crear automatización](/automatizaciones/crear-automatizacion)
* [Consultar pasos de una ejecución](/automatizaciones/listar-pasos-ejecucion)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.