# Cotizar Seguro de Automóvil

Genera una cotización para un seguro de automóvil basándose en las características del vehículo y del asegurado.

Nota importante: La fecha de cotización (fechaDesde) debe ser la fecha del día en que se envía la petición.

Vigencias disponibles:
- M - Mensual (renueva mensualmente)
- B - Bimestral (renueva cada dos meses)
- T - Trimestral (renueva cada tres meses)
- C - Cuatrimestral (renueva cada cuatro meses)
- S - Semestral (renueva cada seis meses)
- N - 9 meses (renueva cada nueve meses)
- A - Anual (renueva al año) - Recomendado
- U - Única (renueva al año)
- BA - Bianual (renueva cada dos años)

Monedas disponibles:
- 1 - Peso Dominicano (RD$)
- 2 - Dólar Americano (US$)
- 3 - Euro (€)

Endpoint: POST /cotizacion/productos/cotizar
Version: 1.0.0
Security: Ocp-Apim-Subscription-Key, x-user-key, x-codigo-mediador

## Request fields (application/json):

  - `codigoMoneda` (integer, required)
    Código de la moneda:
* 1 - Peso Dominicano (RD$)
* 2 - Dólar Americano (US$)
* 3 - Euro (€)
    Enum: 1, 2, 3

  - `fechaDesde` (string, required)
    Fecha en que se realiza la cotización. Debe ser la fecha del día en que se envía la petición
    Example: "2025-11-07"

  - `direccionIp` (string, required)
    Dirección IP de la máquina/cliente desde donde se envía la petición
    Example: "172.24.214.139"

  - `codigoVigencia` (string, required)
    Código de vigencia:
* M - Mensual, B - Bimestral, T - Trimestral
* C - Cuatrimestral, S - Semestral, N - 9 meses
* A - Anual (recomendado), U - Única, BA - Bianual
    Enum: "M", "B", "T", "C", "S", "N", "A", "U", "BA"

  - `datos` (array, required)
    Datos del vehículo y del asegurado. Todos los objetos en este array son obligatorios

  - `datos.codigoDato` (integer, required)
    Identificador del dato. Códigos fijos:
* 250091 - Plan
* 250000 - Marca Vehículo
* 250001 - Modelo Vehículo
* 250004 - Versión
* 250003 - Año de Fabricación
* 250015 - Uso del Vehículo
* 250016 - Valor del Vehículo
* 250069 - Fecha de Nacimiento
* 250320 - Edad del Asegurado
* 250321 - Estado Civil
* 250322 - Sexo
* 250323 - Zona de Circulación
* 250105 - R.C. Exceso
* 250088 - Suma Asegurada Auto Exceso
    Example: 250091

  - `datos.valorDato` (string, required)
    Valor del dato (variable según el codigoDato):

Plan (250091):
* 0 - Mi Auto Premier (Todo Riesgo Cero Deducible)
* 1 - Mi Auto Full (Todo Riesgo Con Deducible)
* 2 - Mi Auto Básico (Seguro de Ley)
* 3 - Mi Auto Flex (Todo Riesgo Perdida Total)
* 4 - Mi Moto Básico

Uso del Vehículo (250015):
* 1 - Ambulancia
* 2 - De Renta (Alquiler)
* 3 - Placa Exhibición
* 4 - Privado
* 5 - Público
* 6 - Taxi
* 7 - Transporte Priv. de Personal
* 8 - Transporte Escolar
* 9 - Vehículo Fúnebre
* 10 - Transporte Dinero y Valores
* 11 - Transporte Turístico
* 12 - Empresa Contratista
* 13 - Transporte de Combustible
* 14 - Transporte Mercancia Inflamable
* 15 - Transporte Mercancia no Inflamable
* 16 - Recogida de Basura
* 17 - Escuela de Aprendizaje

Zona de Circulación (250323):
* 1 - Santo Domingo
* 2 - Zona Norte
* 3 - Zona Este
* 4 - Zona Sur

Estado Civil (250321):
* S - Soltero
* C - Casado

Sexo (250322):
* M - Masculino
* F - Femenino
* N - No Aplica

Otros campos: valores numéricos o alfanuméricos según corresponda
    Example: "1"

  - `datos.label` (string, required)
    Etiqueta para identificar a qué hace referencia el codigoDato
    Example: "Plan"

  - `datos.numeroBien` (integer, required)
    Número del bien asegurado (siempre 1 para automóvil)
    Example: 1

  - `tipoDocumentoReferidor` (string)
    Tipo de documento de la persona que refiere (opcional)
    Enum: "CED", "RNC", "PAS"

  - `numeroDocumentoReferidor` (string)
    Número de documento de la persona que refiere (requerido si se especifica tipoDocumentoReferidor)
    Example: "22312345678"

## Response 200 fields (application/json):

  - `codigoError` (string,null, required)
    Si la petición fue exitosa, devolverá null. Si hay error, contendrá el mensaje de error

  - `fechaHasta` (string,null, required)
    Fecha fin de vigencia
    Example: "2026-11-07T00:00:00.000-04:00"

  - `datos` (array, required)
    Datos con los que se cotizó, basados en lo enviado en la petición y valores establecidos según el plan

  - `datos.codigoDato` (integer, required)
    Identificador del dato. Códigos fijos:
* 250091 - Plan
* 250000 - Marca Vehículo
* 250001 - Modelo Vehículo
* 250004 - Versión
* 250003 - Año de Fabricación
* 250015 - Uso del Vehículo
* 250016 - Valor del Vehículo
* 250069 - Fecha de Nacimiento
* 250320 - Edad del Asegurado
* 250321 - Estado Civil
* 250322 - Sexo
* 250323 - Zona de Circulación
* 250105 - R.C. Exceso
* 250088 - Suma Asegurada Auto Exceso
    Example: 250091

  - `datos.valorDato` (string, required)
    Valor del dato (variable según el codigoDato):

Plan (250091):
* 0 - Mi Auto Premier (Todo Riesgo Cero Deducible)
* 1 - Mi Auto Full (Todo Riesgo Con Deducible)
* 2 - Mi Auto Básico (Seguro de Ley)
* 3 - Mi Auto Flex (Todo Riesgo Perdida Total)
* 4 - Mi Moto Básico

Uso del Vehículo (250015):
* 1 - Ambulancia
* 2 - De Renta (Alquiler)
* 3 - Placa Exhibición
* 4 - Privado
* 5 - Público
* 6 - Taxi
* 7 - Transporte Priv. de Personal
* 8 - Transporte Escolar
* 9 - Vehículo Fúnebre
* 10 - Transporte Dinero y Valores
* 11 - Transporte Turístico
* 12 - Empresa Contratista
* 13 - Transporte de Combustible
* 14 - Transporte Mercancia Inflamable
* 15 - Transporte Mercancia no Inflamable
* 16 - Recogida de Basura
* 17 - Escuela de Aprendizaje

Zona de Circulación (250323):
* 1 - Santo Domingo
* 2 - Zona Norte
* 3 - Zona Este
* 4 - Zona Sur

Estado Civil (250321):
* S - Soltero
* C - Casado

Sexo (250322):
* M - Masculino
* F - Femenino
* N - No Aplica

Otros campos: valores numéricos o alfanuméricos según corresponda
    Example: "1"

  - `datos.label` (string, required)
    Etiqueta para identificar a qué hace referencia el codigoDato
    Example: "Plan"

  - `datos.numeroBien` (integer, required)
    Número del bien asegurado (siempre 1 para automóvil)
    Example: 1

  - `cotizaciones` (array)
    Listado de cotizaciones generadas (usualmente un solo registro)

  - `cotizaciones.numeroCotizacion` (integer, required)
    Número de la cotización generada
    Example: 2256835231

  - `cotizaciones.numeroItem` (integer, required)
    Número de ítem

  - `cotizaciones.codigoPlan` (integer, required)
    Código del plan
    Example: 100

  - `cotizaciones.descripcionPlan` (string, required)
    Descripción del plan
    Example: "Vehículo"

  - `cotizaciones.montoPrimaAnual` (number, required)
    Monto de la prima anual, representado en la moneda en que se cotizó
    Example: 43332.36

  - `cotizaciones.montoComponenteAnual` (number, required)
    Monto impuesto anual
    Example: 6933.18

  - `cotizaciones.montoTotalAnual` (number, required)
    Monto total anual (Prima + Impuesto)
    Example: 50265.54

  - `cotizaciones.montoPrimaProrrata` (number, required)
    Monto prima prorrata
    Example: 43332.36

  - `cotizaciones.montoComponenteProrrata` (number, required)
    Monto impuesto prorrata
    Example: 6933.18

  - `cotizaciones.montoTotalProrrata` (number, required)
    Monto total prorrata
    Example: 50265.54

  - `cotizaciones.planesDePago` (array, required)
    Planes de pago disponibles

  - `cotizaciones.planesDePago.codigoPlanPago` (integer, required)
    Código del plan de pago
    Example: 204

  - `cotizaciones.planesDePago.descripcionPlanPago` (string, required)
    Descripción del plan de pago
    Example: "Anual"

  - `cotizaciones.planesDePago.numeroTotalCuotas` (integer, required)
    Número total de cuotas al año
    Example: 1

  - `cotizaciones.planesDePago.montoPrimaPago` (number, required)
    Monto de prima a pagar
    Example: 50265.54

  - `cotizaciones.planesDePago.seleccion` (integer, required)
    Indicador de plan seleccionado al cotizar (1 = seleccionado, 0 = no seleccionado)
    Enum: 0, 1

  - `cotizaciones.planesDePago.montoSiguienteCuota` (number, required)
    Monto de la siguiente cuota

## Response 400 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 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"