Web Service “BSCotizarAutoFlotaCobAmpWS”

Operación “CotizarAutoFlotaCobAmp”
Contenido
Definición ............................................................................................................................................ 3
Descripción .......................................................................................................................................... 3
Parámetros de Entrada Servicio Web ................................................................................................. 3
Listado de Valores para los Parámetros de Entrada Servicio Web ..................................................... 4
Parámetros de Salida Servicio Web .................................................................................................... 4
Funcionamiento .................................................................................................................................. 5
Datos del Procedure ............................................................................................................................ 5
Parámetros de Entrada y Salida Procedure ........................................................................................ 5
Manejo de Errores............................................................................................................................... 7
Valores por Defecto ............................................................................................................................ 7
Definición

Nombre del Servicio: BSCotizarAutoFlotaCobAmpWS

Nombre de la Operación: CotizarAutoFlotaCobAmp

Descripción

El Servicio Web y su operación permite la Cotización de una Póliza de Cobertura

Amplia para Automóvil, partiendo de una Póliza de Flota Existente.

Datos del Servicio

Ítem Valor
Desplegado en
Nombre Aplicación bscotizarautoflotacobampws
Nombre del Servicio BSCotizarAutoFlotaCobAmpWS
Nombre de la Operación cotizarAutoFlotaCobAmp
Procedimiento Invocado P_COTIZAR_AUTO_FLOTA_CA
URL del wsdl
Tabla 1: Datos del Servicio

Parámetros de Entrada Servicio Web

Parámetro Tipo Dato Descripción Opcionalidad

cdUsuario String Login de Usuario BSO *
claveUsuario String Clave de Usuario BSO *
cdSucursal Integer Código de Sucursal de Póliza Padre *
cdRamo Integer Código de Ramo de Póliza Padre *
nuPoliza Integer Número de la Póliza Padre *
nacionalidad String Nacionalidad del Cliente *
cedulaRif String Número de Identificación del Cliente *
primerApellido String Primer Apellido del Cliente *
segundoApellido String Segundo Apellido del Cliente O
primerNombre String Primer Nombre o Razón Social del Cliente *
segundoNombre String Segundo Nombre del Cliente
fecNacReg String Fecha Nacimiento o Registro Compañía *
estadoCivil String Estado Civil del Cliente *
sexo String Sexo del Cliente *
nuevo String Indica si el Vehículo es 0 Kms. *
marca String Marca del Vehículo a Cotizar *
modelo String Modelo del Vehículo a Cotizar *
transmision String Transmisión del Vehículo a Cotizar *
anio String Año del Vehículo a Cotizar *
version String Versión del Vehículo a Cotizar *
clase String Clase del Vehículo a Cotizar *
grupo String Grupo del Vehículo a Cotizar *
tonelada String Toneladas del Vehículo a Cotizar o
tipo String Tipo de Vehículo a Cotizar *
Tabla 2: Parámetros de Entrada Servicio Web

Listado de Valores para los Parámetros de Entrada Servicio Web

Parámetro Descripción Valores

cdUsuario
claveUsuario
cdSucursal Máximo 3 Caracteres
cdRamo Máximo 2 Caracteres
nuPoliza Máximo 7 Caracteres
nacionalidad Venezolano, Jurídico, Pasaporte, Extranjero V,J,P,E
cedulaRif Máximo 9 Caracteres
primerApellido Máximo 20 Caracteres
segundoApellido Máximo 20 Caracteres
primerNombre Máximo 100 Caracteres
segundoNombre Máximo 20 Caracteres
fecNacReg Formato de la Fecha DD-MM-YYYY
estadoCivil Casado, Divorciado, No Aplica, Otros, Soltero, Viudo C,D,N,O,S,V
sexo Masculino, Femenino, No Aplica M,F,N
nuevo Si, No S,N
marca Dato INMA
modelo Dato INMA
transmision Dato INMA Automático, Sincrónico A,S
anio Dato INMA
version Dato INMA
clase Dato INMA Particular, Carga 1,2
grupo Dato INMA
tonelada Máximo 60 Caracteres
tipo Dato INMA
Tabla 3: Listado de Valores Parámetros de Entrada Servicio Web

Parámetros de Salida Servicio Web

Parámetro Tipo Dato Descripción

mensaje String Mensaje que almacena el error
 conseguido, ya sea a nivel de
parámetros o del procedimiento
coberturas String Texto en formato XML que
contiene el listado de las
coberturas.
nuCotizacion String Número de la cotización
generada

Tabla 4: Parámetros de Salida Servicio Web

Funcionamiento

El Web Service recibe los parámetros, encripta la clave de usuario, verifica si el usuario Existe, está
activo y tiene rol de Intermediario, en cuyo caso obtiene el Número de productor asociado; De no
existir se retorna el mensaje: “Usuario no Autorizado”.

Se verifica la existencia, validez y correspondencia al productor, de la póliza padre, en cuyo caso

obtiene el PlanRCV para ser usado en la cotización; De no existir se retorna el mensaje: “Póliza no
Válida”

Se invoca al procedimiento PKG_VALIDACION_IBSOF_COTIZA.ENVIAR_SOLICITUD para realizar la

cotización pasando los parámetros correctamente, luego se almacena la cotización para obtener el
número y los resultados son devueltos al servicio web.

Se almacena la solicitud en la tabla de operaciones.

Datos del Procedure

P_COTIZAR_AUTO_FLOTA_CA.

Parámetros de Entrada y Salida Procedure

Parámetro WS Parámetro BD TIPO DATO TIPO Descripción

cdUsuario p_cd_usuario VARCHAR2(20) IN
claveUsuario p_clave_usuario VARCHAR2(255) IN
cdSucursal p_cd_sucursal NUMBER(3) IN
cdRamo p_cd_ramo NUMBER(2) IN
nuPoliza p_nu_poliza NUMBER(7) IN
nacionalidad p_nacionalidad NVARCHAR2(1) IN
cedulaRif p_cedula_rif NVARCHAR2(9) IN
primerApellido p_primer_apellido NVARCHAR2(20) IN
segundoApellido p_segundo_apellido NVARCHAR2(20) IN
primerNombre p_primer_nombre NVARCHAR2(100) IN
segundoNombre p_segundo_nombre NVARCHAR2(20) IN
fecNacReg p_fec_nac_reg NVARCHAR2(10) IN
estadoCivil p_estado_civil NVARCHAR2(1) IN
sexo p_sexo NVARCHAR2(1) IN
nuevo p_nuevo NVARCHAR2(1) IN
marca p_marca NVARCHAR2(60) IN
modelo p_modelo NVARCHAR2(60) IN
transmision p_transmision NVARCHAR2(60) IN
anio p_anio NVARCHAR2(60) IN
version p_version NVARCHAR2(60) IN
clase p_clase NVARCHAR2(60) IN
grupo p_grupo NVARCHAR2(60) IN
tonelada p_tonelada NVARCHAR2(60) IN
tipo p_tipo NVARCHAR2(60) IN
mensaje p_mensaje NVARCHAR2(200) OUT Error a nivel del
Procedure
P_COTIZAR_AUTO_
FLOTA_CA
coberturas p_arrayrc ARRAY_RC_EXTR OUT Listado de Coberturas
ANET
RC_EXTRANET_T
YPE
DE_COBERTURA
NVARCHAR2(60),
MT_SUMA_ASEG
URADA
NUMBER(12),
MT_PRIMA_ANUA
L NUMBER(13,2)
errorres p_arrayrerr ARRAY_R_ERRO OUT Errores en la Cotización
RES 
R_ERRORES_TYP
E
CODIGO
NUMBER(5),
DESCRIPCION
NVARCHAR2(500)
nuCotizacion p_nu_cotizacion NVARCHAR2(20) OUT Número de la Cotización
Tabla 5: Parámetros de Entrada y Salida Procedure
Manejo de Errores

Se puede tener dos tipos de errores

 Error de pre procesamiento

Éstos errores se presentan a causa de:
o Error de Conexión: No es posible la conexión a la base de datos de
Rector.
o Usuario no Autorizado: Ya sea porque no existe, no está activo, no
coincide la clave o no tiene el rol de intermediario.
o Póliza no Válida: Ya sea porque no existe, no está vigente o no
pertenece al Productor asociado al usuario.

Éstos errores son almacenados en el parámetro de salida: mensaje

 Error de procesamiento

Éstos errores son generados por el procedimiento que realiza la cotización

que pueden incluir:

o Error de parámetros: Alguno de los parámetros no coincide con lo

que se esperaba, ya que el objeto que los almacena por ser genérico
permite cadenas de 60 caracteres, sin embargo dependiendo del tipo
de dato se espera que sea numérico, de fecha con formato
específico, un listado de valores fijos, etc.
o Error de cotización: Error propio de la lógica de negocio

Éstos errores son almacenados en el parámetro de salida: errorres

Valores por Defecto

Adicional a los parámetros de entrada solicitados a nivel del servicio web, el

procedimiento que ejecuta la cotización requiere de otros parámetros que deben
ser configurados a nivel del llamado.
Parámetro Descripción Valor por Defecto
P_FE_TRANSACCION Fecha de la Transacción SYSDATE
P_PRIORIDAD 1
P_IDUNIPET Id único de la BSExxxxxxxx-xxxx-xxxx-xxxx
Transacción con formato
UUID
P_CODCANORI Canal de venta BSE o BSEWS
TP_PERSONA Tipo de Persona T
CD_PRODUCTO Código del Producto 260100
FE_SOLICITUD Fecha de Solicitud SYSDATE
FE_DESDE Fecha de Solicitud SYSDATE
FR_PAGO A
CD_MONEDA Moneda 01
CD_AGENCIA Código de Agencia 277
DE_AGENCIA Descripción de Agencia SUCURSAL
PLATAFORMA LA
PRIMERA
TP_MERCADO Tipo de Mercado 13
TP_BIEN_ASEG Tipo de Bien VEH
CODIGO_PLAN Codigo Plan (CobAmp) 6
VALOR_PLAN Valor Plan (CobAmp) 6
PO_PARTICIPACION % Participación Prod 100
Tabla 6: Valores por defecto para la cotización

La cotización requiere adicional a los datos del Cliente, Póliza y Vehículo unos
datos del tipo de plan de cobertura que se requiere, éstos han sido establecidos
de forma estática.

Parámetro Descripción Valor por Defecto

cobRoboAccesorio Cobertura por Robo de SI
Accesorios
poRoboAccesorio % S.A. Robo Accesorios 1
indDiariaRobo S.A. Indemnización Diaria 70
por Robo
poDeducible % de Deducible 0
planRCV Cobertura Adicional Plan Plan de la Póliza Matriz
RCV
Tabla 7: Valores de plan por defecto