# Cotizar Buen Viaje

Calcula la cotización del seguro de viaje Buen Viaje para un destino y un grupo de personas.

Retorna tarifas y totales en USD y DOP, la tasa de cambio aplicada y, cuando corresponde,
un enlace PDF con el detalle de la cotización.

Flujo recomendado: Cotizar → Emitir → Pagar.

Endpoint: POST /v2/productos/buen-viaje/cotizaciones
Version: 1.0.0
Security: Ocp-Apim-Subscription-Key, x-user-key, x-codigo-mediador

## Request fields (application/json):

  - `destino` (object, required)
    Datos del viaje (según integración)

  - `asegurados` (array, required)

  - `asegurados.tipoAsegurado` (string, required)
    Rol del asegurado (ej. TITULAR, DEPENDIENTE)
    Example: "TITULAR"

  - `asegurados.fechaNacimiento` (string, required)
    Fecha de nacimiento en ISO-8601 UTC
    Example: "1990-01-15T00:00:00Z"

  - `asegurados.documento` (object, required)

  - `asegurados.documento.tipo` (string, required)
    Enum: "CEDULA", "PASAPORTE"

  - `asegurados.documento.numero` (string, required)
    Example: "AB1234567"

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.destino` (object, required)
    Datos del viaje (según integración)

  - `data.cotizacion` (object, required)

  - `data.cotizacion.tarifa` (object, required)

  - `data.cotizacion.tarifa.monto` (number, required)
    Example: 12.5

  - `data.cotizacion.tarifa.moneda` (string, required)
    ISO 4217
    Example: "USD"

  - `data.cotizacion.montos` (object, required)

  - `data.cotizacion.montos.usd` (object, required)

  - `data.cotizacion.montos.usd.descuento` (number, required)

  - `data.cotizacion.montos.usd.total` (number, required)
    Example: 12.5

  - `data.cotizacion.montos.dop` (object, required)

  - `data.cotizacion.tasaCambio` (number, required)
    Tasa aplicada para conversión USD→DOP
    Example: 58.35

  - `data.cotizacion.documentos` (object)

  - `data.cotizacion.documentos.pdfUrl` (string)
    URL del PDF si está disponible
    Example: "https://devapi.humano.com.do/files/buen-viaje/cotizacion-123.pdf"

  - `meta` (object, required)

  - `meta.timestamp` (string, required)
    Example: "2026-01-19T14:22:10Z"

  - `meta.requestId` (string, required)
    Example: "c8d0c2af-7e8f-4c8d-8d75-2b1c0aa3fd2c"

## Response 401 fields (application/json):

  - `statusCode` (integer, required)
    Código de estado HTTP que se aplica a este problema
    Example: 401

  - `message` (string, required)
    Explicación específica y detallada de esta ocurrencia del problema
    Example: "La fecha de inicio debe ser posterior a la fecha actual"

## Response 422 fields (application/json):

  - `statusCode` (integer, required)
    Código de estado HTTP que se aplica a este problema
    Example: 401

  - `message` (string, required)
    Explicación específica y detallada de esta ocurrencia del problema
    Example: "La fecha de inicio debe ser posterior a la fecha actual"

## Response 500 fields (application/problem+json):

  - `statusCode` (integer, required)
    Código de estado HTTP que se aplica a este problema
    Example: 401

  - `message` (string, required)
    Explicación específica y detallada de esta ocurrencia del problema
    Example: "La fecha de inicio debe ser posterior a la fecha actual"