Documento Especificaciones

Web Service generación de cotización

Individual de Automóvil (VivirSeguros)

Realizado por la Vicepresidencia de IT

 Tabla de contenido

I. Introducción.......................................................................................4

II. Proceso de llamada............................................................................ 4

II. Formato de Respuesta...................................................................... 7

Realizado por la Vicepresidencia de IT

 I. Introducción

El web service descrito a continuación tiene como finalidad el de generar

una cotización individual de Automóvil y entregar como respuesta las coberturas de

dicha cotización en formato JSON.

El web service funciona bajo la arquitectura RESTful y recibe sus

parámetros a través del método GET. Todas las respuestas son dadas en formato

JSON.

II. Proceso de llamada

La URL de invocación para el web service es la siguiente (ambiente de

calidad):

http://online.vivirseguros.web.ve/vivirCotizaTest-1.0.1/servicios/cotizarAUTO

Ambiente de producción:

http://online.vivirseguros.web.ve/vivirCotiza/servicios/cotizarAUTO

Los parámetros a enviar se especifican a continuación:

Parámetro Descripción Longitud/Tipo Obligatorio

ano Año de Fabricación del Vehículo VARCHAR2(4) SI

civi* Código CIVI del vehículo VARCHAR2 (10) SI

Sexo del conductor del vehículo ( F=Femenino, M =
sexo Masculino ) VARCHAR2 (1) SI
Estado civil del conductor del vehículo ( C = Casado,
edocivil D = Divorciado, S = Soltero ) VARCHAR2 (1) SI

fnacimiento** Fecha de nacimiento del conductor del vehículo VARCHAR2 (10) SI

estado**** Estado del país donde se utilizará el vehículo VARCHAR2 (10) SI

Plan a cotizar
10000001 – Cobertura Amplia
plan*** 10000006 – Buen Conductor VARCHAR2 (11) SI

Realizado por la Vicepresidencia de IT

 Nacionalidad del Conductor del Vehículo ( V=
nacionalidad Venezolano, E= extranjero ) VARCHAR2 (1) SI

cedularif Cedula/RIF del conductor del Vehículo VARCHAR2 (20) SI

nombre Nombre del conductor del vehículo VARCHAR2 (150) SI

apellido Apellido del conductor del vehículo VARCHAR2 (150) SI

Código de área del número telefónico fijo del
cdareaFijo conductor VARCHAR2 (5) SI
nutelefonoFijo Número telefónico fijo del conductor VARCHAR2 (10) SI
Código de área del número telefónico celular del
cdareaCel conductor VARCHAR2 (5) SI
nutelefonoCel Número telefónico celular del conductor VARCHAR2 (10) SI
email Correo electrónico del conductor VARCHAR2 (150) SI
usoveh****** Código de uso de vehículo VARCHAR2 (150) SI

cerokm Indicador de cero kilómetros (S o N) VARCHAR2 (150) SI

tipoveh***** Código de tipo de vehículo VARCHAR2 (150) SI

cdProductor Código del Productor que realiza la petición VARCHAR2 (5) SI

Tabla 1. Parámetros de cotizarAUTO

 * Formato de Código CIVI: 3 dígitos de Marca, 3 Dígitos de Modelo, 2 Dígitos

de Versión

 ** Formato de Fecha de Nacimiento: DD/MM/YYYY

 **** Descripción del Estado

NUMERO ESTADO
102 AMAZONAS
103 ANZOATEGUI
104 APURE
105 ARAGUA
106 BARINAS
107 BOLIVAR
108 CARABOBO
109 COJEDES

Realizado por la Vicepresidencia de IT

 110 DELTA AMACURO
125 DEPENDENCIAS FEDERALES
101 DISTRITO CAPITAL
111 FALCON
112 GUARICO
113 LARA
114 MERIDA
115 MIRANDA
116 MONAGAS
117 NUEVA ESPARTA
118 PORTUGUESA
119 SUCRE
120 TACHIRA
121 TRUJILLO
124 VARGAS
122 YARACUY
123 ZULIA

 ***** Descripción del Tipo de Vehículo

TIPO
PARTICULAR
RUSTICO

 ****** Descripción del Tipo de Uso de Vehículo

TIPO
PARTICULAR
TAXI
TRANSPORTE

III. Formato de Respuesta

En caso de que el proceso realizado culmine de manera satisfactoria, se

devolverá la Respuesta en formato JSON:

Se agregó el campo deducible a la estructura

 Cobertura Amplia

Realizado por la Vicepresidencia de IT

{
"numero": "6296013434",
"cotizacion": [
{
"cobertura": "COBERTURA AMPLIA / MOTIN Y/O DISTURBIOS
CALLEJEROS",
"suma": "307500",
"tasa": "5.64",
"prima": "17343",
"deducible": "0"
},
{
"cobertura": "INDEMNIZACION DIARIA",
"suma": "3000",
"tasa": "0",
"prima": "120",
"deducible": "0"
},
{
"cobertura": "EVENTOS CATASTROFICOS",
"suma": "307500",
"tasa": "0",
"prima": "227.19",
"deducible": "0"
},
{
"cobertura": "ASISTENCIA EN VIAJES",
"suma": "0",
"tasa": "0",
"prima": "670.04",
"deducible": "0"
},
{
"cobertura": "DANOS A PERSONAS",
"suma": "52959",
"tasa": "0",
"prima": "825.5",
"deducible": "0"
},
{
"cobertura": "DANOS A COSAS",
"suma": "42291",
"tasa": "0",
"prima": "0",
"deducible": "0"
},
{
"cobertura": "EXCESO DE LIMITE",
"suma": "1500000",
"tasa": "0",
"prima": "423.07",
"deducible": "0"
},

Realizado por la Vicepresidencia de IT

 {
"cobertura": "DEFENSA PENAL",
"suma": "20000",
"tasa": "0",
"prima": "104",
"deducible": "0"
},
{
"cobertura": "MUERTE DE CONDUCTOR Y/O PASAJEROS",
"suma": "30000",
"tasa": ".05",
"prima": "81",
"deducible": "0"
},
{
"cobertura": "INVALIDEZ DE CONDUCTOR Y/O PASAJEROS",
"suma": "30000",
"tasa": ".03",
"prima": "49.5"
},
{
"cobertura": "GASTOS MEDICOS DE CONDUCTOR Y/O PASAJEROS",
"suma": "3000",
"tasa": ".45",
"prima": "66.75",
"deducible": "0"
},
{
"cobertura": "ODONTOLOGICO MERCADEO MASIVO",
"suma": "0",
"tasa": "0",
"prima": "60",
"deducible": "0"
},
{
"cobertura": "ASISTENCIA DOMICILIARIA MERCADEO MASIVO",
"suma": "0",
"tasa": "0",
"prima": "60",
"deducible": "0"
},
{
"cobertura": "FUNERARIO MERCADEO MASIVO",
"suma": "15000",
"tasa": "1.13",
"prima": "168.75",
"deducible": "0"
},
{
"cobertura": "OFTALMOLOGICO MERCADEO MASIVO",
"suma": "0",
"tasa": "0",
"prima": "60",

Realizado por la Vicepresidencia de IT

 "deducible": "0"
},
{
"cobertura": "TOTAL PRIMA",
"suma": null,
"tasa": null,
"prima": "20258.8",
"deducible": "0"
}
],
"idError": null,
"mensajeError": null
"archivo":"http://srv-ccs-
oralinux:7777/repsalidas/COTAUTO6300013439.pdf"
"mensajePlan": null
}

 Buen Conductor

{
"numero": "44570013606",
"cotizacion": [
{
"cobertura": "VIDRIOS",
"suma": "14726250",
"tasa": "0",
"prima": "0",
"deducible": "0"
},
{
"cobertura": "INDEMNIZACION DIARIA",
"suma": "30000",
"tasa": "0",
"prima": "1200",
"deducible": "0"
},
{
"cobertura": "EVENTOS CATASTROFICOS",
"suma": "14726250",
"tasa": "0",
"prima": "2912.99958",
"deducible": "0"
},
{
"cobertura": "CASCO (BUEN CONDUCTOR)",
"suma": "14726250",
"tasa": "1.51",
"prima": "222366.38",
"deducible": "0"
},
{
"cobertura": "ASISTENCIA EN VIAJES",
"suma": "0",

Realizado por la Vicepresidencia de IT

 "tasa": "0",
"prima": "2408.33",
"deducible": "0"
},
{
"cobertura": "DANOS A PERSONAS",
"suma": "62550",
"tasa": "0",
"prima": "975",
"deducible": "0"
},
{
"cobertura": "DANOS A COSAS",
"suma": "49950",
"tasa": "0",
"prima": "0",
"deducible": "0"
},
{
"cobertura": "EXCESO DE LIMITE",
"suma": "1500000",
"tasa": "0",
"prima": "836.26",
"deducible": "0"
},
{
"cobertura": "DEFENSA PENAL",
"suma": "20000",
"tasa": "0",
"prima": "104",
"deducible": "0"
},
{
"cobertura": "ASISTENCIA LEGAL",
"suma": "0",
"tasa": "0",
"prima": "166.7",
"deducible": "0"
},
{
"cobertura": "MUERTE DE CONDUCTOR Y/O PASAJEROS",
"suma": "30000",
"tasa": ".05",
"prima": "81",
"deducible": "0"
},
{
"cobertura": "INVALIDEZ DE CONDUCTOR Y/O PASAJEROS",
"suma": "30000",
"tasa": ".03",
"prima": "49.5",
"deducible": "0"
},

Realizado por la Vicepresidencia de IT

 {
"cobertura": "GASTOS MEDICOS DE CONDUCTOR Y/O PASAJEROS",
"suma": "3000",
"tasa": ".45",
"prima": "66.75",
"deducible": "0"
},
{
"cobertura": "ODONTOLOGICO MERCADEO MASIVO",
"suma": "0",
"tasa": "0",
"prima": "212.5",
"deducible": "0"
},
{
"cobertura": "ASISTENCIA DOMICILIARIA MERCADEO MASIVO",
"suma": "0",
"tasa": "0",
"prima": "60",
"deducible": "0"
},
{
"cobertura": "FUNERARIO MERCADEO MASIVO",
"suma": "15000",
"tasa": "1.13",
"prima": "168.75",
"deducible": "0"
},
{
"cobertura": "OFTALMOLOGICO MERCADEO MASIVO",
"suma": "0",
"tasa": "0",
"prima": "212.5",
"deducible": "0"
},
{
"cobertura": "TOTAL PRIMA",
"suma": null,
"tasa": null,
"prima": "231820.66958",
"deducible": "0"
}
],
"idError": null,
"mensajeError": null,
"archivo":
"http://online.vivirseguros.web.ve:7780/repsalidas/COTAUTO44570013606.
pdf"
"mensajePlan": "Buen Conductor, Porque eres un conductor
cuidadoso. Pagas menos de la tarifa normal de cobertura Amplia. Ampara
un Daño parcial en exceso del deducible detallo en el cuadro póliza y
un Daño General (Pérdida Total). Accesorios No Originales y Vidrios
podrán ser amparados a través de un pago adicional de prima. Para

Realizado por la Vicepresidencia de IT

mayor información consulta la Página Web de Vivir Seguros, CA., su
intermediario o acérquese a un Centro Integral de Servicios de Seguros
para Clientes y Aliados."

En caso de que se origine un error en el proceso de cotización, la respuesta tendrá el

siguiente Formato:

{
"numero": "0","cotizacion": [
{
"cobertura": null,
"suma": null,
"tasa": null,
"prima": null, ,
"deducible": null
}
],
"idError": "1",
"mensajeError": "HA OCURRIDO EL SIGUIENTE ERROR: "
"archivo": null
"mensajePlan": null

Se debe realizar una petición por cada plan que se desee cotizar, cambiando el
valor del parámetro plan, según sea el caso.

Realizado por la Vicepresidencia de IT