Documento de Definicin de Servicios Web

PROPUESTA ARQUITECTURA WEB SERVICES

FORTALEZA SEGUROS

Elaborado por: Ing. Marcelo Guardia V.

Analista Especialista en Desarrollo Web

Documento de Definicin de Servicios Web

Documento de Definicin de Servicios Web

Servicios Web de Fortaleza Seguros para la emisin de plizas IMCRUZ - KIEFFER
(Fecha: 4/12/2015)

1. Esquema de Propuesta para la provisin de servicios

A continuacin se muestra el esquema para provisin de servicios web por parte de Fortaleza, tanto para la
fase de pruebas como para la implementacin final.

Base de Datos ACSEL

Core Fortaleza Serguros ACSEL

Web Services

https

Base de Datos Corredor

Core Sistema de Corredor

2. Emisin de plizas nuevas

El procedimiento de emisin de plizas nuevas est compuesto por varios mensajes sncronos, debido a que
es necesario que el servidor de Fortaleza reciba la respuesta antes de seguir con los siguientes mensajes.
A continuacin se explica el procedimiento y cada mensaje:

Documento de Definicin de Servicios Web

:Encargado Kieffer - IMCRUZ

:Sistema KIEFFER

:Sistema ACSEL

buscarCliente (CI/NIT)
buscarCliente(CI/NIT)
return. buscarCliente (codCli/Nulo)
return, buscarCliente(codCli/Nulo)
registrarCliente (datosCli)
registrarCliente (datosCli)
return. registrarCliente (codCli/Nulo)
return, registrarCliente(codCli/Nulo)
registrarPoliza (datosPol)

registrarPolza (datosPol)
return. registrarPoliza (codPol, idePol, placaAut, ideAut, primaFact, planPagos)
return. registrarPoliza (codPol, idePol, placaAut, ideAut, primaFact, planPagos)
activarPoliza (idPol)
actvarPoliza(idPol)
return. activarPoliza (0/1)
return. activarPoliza (0/1)

1.

El primer paso es: buscarCliente, este se refiere a buscar si el cliente ya existe en la base de datos
del sistema ACSEL de Fortaleza a travs del NIT o CI; con este dato el servicio web devolver el
cdigo nico de cliente de Fortaleza. En caso de no encontrar al cliente, retornar nulo indicando
que el cliente debe ser creado.

2.

El segundo paso es: registrarCliente, este se refiere a la creacin del cliente en la base de datos
del sistema ACSEL de Fortaleza con la informacin que debe enviarse como mnimo y que se detalla
en la estructura de servicios web ms adelante. Este servicio retornar el cdigo de cliente
generado si termina con xito y nulo si genera algn error.

3.

El tercer paso es: registrarPoliza, este se refiere al registro de los datos de la pliza: matera
asegurada (vehculo), producto, valor asegurado, vigencia y forma y plan de pagos en la base de
datos ACSEL. Este servicio retornar el cdigo e identificador de la pliza, placa e identificador del
vehculo, prima neta y plan de pagos (nmero de cuota, monto, fecha de vencimiento) si es al
crdito.

4.

El cuarto paso es: activarPoliza, este se refiere a la activacin de la pliza para su impresin
enviando el identificador de la misma, una vez aceptado todas las condiciones anteriores. Este
servicio retornar 0 en caso de error y 1 en caso de xito.

3. Emisin de plizas renovadas

Este procedimiento incluye 2 mtodos adicionales:

Documento de Definicin de Servicios Web

:Encargado Kieffer - IMCRUZ

:Sistema KIEFFER

:Sistema ACSEL

buscarCliente (CI/NIT)
buscarCliente(CI/NIT)
return. buscarCliente (codCli/Nulo)
return, buscarCliente(codCli/Nulo)
actualizarCliente (datosCli)
actualizarCliente (datosCli)
return. actualizarCliente (0/1)
return, actualizarCliente(0/1)
actualizarVehiculo (datosAut)

actualizarVehiculo (datosAut)
return. actualizarVehiculo (placaAut, ideAut, primaFact, planPagos)
return. actualizarVehiculo (placaAut, ideAut, primaFact, planPagos)
activarPoliza (idPol)
actvarPoliza(idPol)
return. activarPoliza (0/1)
return. activarPoliza (0/1)

1.

El primer paso es: actualizarClientes, se refiere a la actualizacin de datos del cliente que se
pueden modificar o actualizar manteniendo la consistencia de la informacin. Este servicio
retornar 0 en caso de error y 1 en caso de xito.

2.

El segundo paso es: actualizarVehculo, se refiere a la actualizacin de datos del vehculo y sobre
todo de la suma asegurada para el clculo de la nueva prima.

4. Estructura de los Servicios Web

A continuacin se detallan los mtodos a implementarse y ser expuestos para el consumo del Sistema de
Comisiones:
Nombre del Metodo
BUSCAR CLIENTE

Nombre
criterioBusqueda
valorBusqueda

Parametros de entrada
Tipo
String
String

Longitud
30
10

Valores
[CI, CodCLiente, etc]

Nombre
error
mensaje
codCliente

Parametros de salida
Tipo
Integer
String
String

Longitud
400
15

Documento de Definicin de Servicios Web

Nombre del Metodo

REGISTRAR CLIENTE

Nombre del Metodo

REGISTRAR POLIZA

Nombre del Metodo

ACTIVAR POLIZA

Nombre
tipoId
numId
ciudadId

Parametros de entrada
Tipo
String
String
String

Longitud
10
10
10

serieId

Integer

nombreCliente
apellidoCliente
codPais
codDepartamento
codCiudad
codMunicipio
direccionCliente
nroDireccionCLiente
numTefl1
numTefl2
numTefl3
emailCliente
tipCliente
generoCiente
fecNacimientoCliente
sectorCLiente
personaPublica
nombreConyuge
actividadPrincipal
lugarTrabajo
cargoTrabajo
fecIngresoTrabajo
lugarTrabajo

String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String

200
200
10
10
10
10
200
10
15
15
15
100
4
1
8
1
1
200
60
60
60
8
60

Nombre
codProducto
codMoneda
codCliente
iniVigencia
finVigencia
codOficina
formaPago
fechaPrimerPago
codPlan
descVehiculo
codMarca
ano
codModelo
numMotor
numChasis
categoria
usoVehiculo
tipCombustible
placaVehiculo
accesoriosVehiculo
franquiciaVehiculo
numConductores
numOcupantes
sumAsegurada
colorVehiculo

Parametros de entrada
Tipo
String
String
String
String
String
String
String
String
String
Striing
String
Integer
String
String
String
String
String
String
String
Integer
Double
Integer
Integer
Double
String

Nombre
idePoliza

Parametros de entrada
Tipo
String

Longitud
10
4
15
8
8
10
1
8
10
100
10
*
10
30
30
1
10
1
10
*
*
*
*

[NIT/CI]

Nombre
error
mensaje
codCliente

Parametros de salida
Tipo
Integer
String
String

Nombre
error
mensaje
poliza
idePoliza
placaVehiculo
idVehiculo
primaNeta
[] numCuota
[] montoFactura
[] fecVencFactura

Parametros de salida
Tipo
Integer
String
String
String
String
String
Double
Integer
Double
String

Nombre
error
mensaje

Parametros de salida
Tipo
Integer
String

Longitud
150
15

[11=Beni, 12=Cochabamba, 13=Chuquisaca,

14=La Paz, 15=Oruro, 16=Pando, 17=Potos,
18=Santa Cruz, 19=Tarija, 20=No Aplica]

ANEXO 1
ANEXO 1
ANEXO 1
ANEXO 1

[P=Persona, E=Empresa]
[M=Masculino, F=Femenino]
DDMMYYYY
[E, P]
[P=Publica, N=No Publica]

DDMMYYYY

DDMMYYYY
DDMMYYYY
ANEXO 2
[C=Credito, E=Efectivo]
DDMMYYYY
[1,2,3,4]

Longitud
400
15
15
10
15
*
*
8

[P=Particular, P=Publico]

10

Longitud
10

Longitud
400

Documento de Definicin de Servicios Web

Nombre del Metodo

ACTUALIZAR CLIENTE

Nombre del Metodo

Nombre
codCliente
codPais
codDepartamento
codCiudad
codMunicipio
direccionCliente
nroDireccionCLiente
numTefl1
numTefl2
numTefl3
emailCliente
tipCliente
sectorCLiente
personaPublica
nombreConyuge
actividadPrincipal
lugarTrabajo
cargoTrabajo
fechIngresoTrabajo
lugarTrabajo

Nombre
idVeihculo
[] usoVehiculo
[] tipCombustible
[] accesoriosVehiculo
ACTUALIZAR VEHCULO [] franquiciaVehiculo
[] numConductores
[] numOcupantes
[] sumAsegurada
[] colorVehiculo

Parametros de entrada
Tipo
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String

Longitud
10
10
10
10
10
200
10
15
15
15
100
1
1
1
200
60
60
60
8
60

Parametros de entrada
Tipo
String
String
String
Integer
Double
Integer
Integer
Double
String

Longitud
15
10
1
*
*
*
*
*
10

ANEXO 1
ANEXO 1
ANEXO 1
ANEXO 1

Nombre
error
mensaje

Parametros de salida
Tipo
Integer
String

Nombre
error
[] placaVehiculo
[] idVehiculo
[] primaNeta

Parametros de salida
Tipo
Integer
String
String
Double

Longitud
400

[P=Persona, E=Empresa]
[E, P]
[P=Publica, N=No Publica]

DDMMYYYY

[P=Particular, P=Publico]

Longitud
10
15
*