Critical Software S.A. Especificação de Requisitos de
Software Ficheiro de Sinistros Automóvel
©2015 Copyright Critical Software S.A. Todos Os Direitos Reservados.
REFERÊNCIA CONTRATO:
N/A
Código Projeto: SEGFSA
Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Data: 2015-03-20
Páginas: 54
Estado: Aprovado
Acesso: Confidencial Projeto
Versão: 14
SALVAGUARDA - Documento sob contrato com Associação Portuguesa de
Seguradores . O trabalho descrito no presente documento foi desenvolvido sob contrato com Associação Portuguesa de
Seguradores. A responsabilidade pelo seu conteúdo é do autor ou organização que o preparou.
Parceiros:
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 2/54
Aprovação
Versão Revisão Nome Funções Assinatura Data
14 1.44 Pedro Martins Gestor Técnico 2015-03-20
Autores e Contribuintes
Nome Contacto Descrição Data
Francisco Veiga [email protected] Autor 2010-07-30
Décio Sousa [email protected] Autor 2010-07-30
Tiago Neto Rodrigues [email protected] Contribuinte e Revisor 2010-08-02
Marcus Neves [email protected] Revisor 2010-08-03
Roberto Cortez [email protected] Contribuinte e Revisor 2010-08-04
Pedro Martins [email protected] Contribuinte e Revisor 2012-11-29
David Carvalho [email protected] Contribuinte 2014-02-10
Lista de Acesso
Acesso Interno
Direção, Dep. Qualidade, Equipa de Projeto
Accesso Externo
Associação Portuguesa de Seguradores
O conteúdo do presente documento é copyright da Critical Software S.A.; Este documento é distribuído sob condição
de não ser copiado no seu todo ou em parte, ou reproduzido de qualquer outra forma (seja por meio fotográfico ou
qualquer outro meio) e o seu conteúdo não deverá ser em caso algum divulgado a qualquer pessoa ou entidade não
referida nas listas de acesso interna e externa sem prévio consentimento por escrito das entidades envolvidas.
Histórico de Revisões
Versão Revisão Data Descrição Autor
1.1-1.2 2010-07-30 Primeira versão do documento. Décio Sousa
Francisco Veiga
1.3 2010-07-30 Versão final para revisão. Décio Sousa
Francisco Veiga
1.4 2010-08-02 Actualização do template utilizado. Tiago Neto Rodrigues
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 3/54
Histórico de Revisões
Revisão do documento.
1.5 2010-08-04 Revisão do documento Roberto Cortez
1.6 2010-08-05 Compilação das revisões Tiago Rodrigues, Roberto
Cortez e Marcus Neves.
Inserção do Anexo C.
Francisco Veiga
1.7 2010-08-06 Inclusão Anexo D - Tabelas de Referência Francisco Veiga
1.8 2010-08-06 Actualização do documento e adição das secções 4 e 5.
Revisão das questões pendentes.
Tiago Neto Rodrigues
01 1.9 2010-08-06 Revisão final e aprovação Critical Software. Francisco Veiga
1.10 2010-08-08 Pequenas correcções. Tiago Neto Rodrigues
02 1.11 2010-08-09 Aprovação do documento. Marcus Neves
1.12 2010-09-27 Revisão com inclusão dos comentários e alterações por
parte da APS.
Francisco Veiga
1.13 2010-09-30 Actualização dos índices e inserção da figura do
protótipo das Estatísticas.
Francisco Veiga
1.14 2010-10-01 Actualização da Matriz, imagens e requisitos fora de
âmbito (UC-FSA-CF-0009 e UC-FSA-CF-0010).
Francisco Veiga
1.15 2010-10-01 Revisão das alterações efectuadas. Tiago Neto Rodrigues
1.16 2010-10-06 Ligeira correcção na nota da matriz de rastreabilidade. Décio Sousa
03 1.17 2010-10-06 Revisão Final e Aprovação da Versão 03 Francisco Veiga
04 1.18 2010-10-08 Alteração ao documento após comentários da APS via
telefone:
Considerar fora do âmbito e não estimar requisitos
B0-0002, B0-0005, B0-0006, B0-0007 e B0-0008
Alteração ao comentário sobre o refrescamento
Inclusão dos requisitos de Webservice no requisito
UC-FSA-COM-0002
Alteração da imagem de detalhe do sinistro para não
incluir a palavra 'Fraude'
Francisco Veiga
05 1.19 2011-04-27 Alteração dos seguintes requisitos para inclusão dos
comentários enviados pela APS:
UC-FSA-PESQ-0001
Décio Sousa
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 4/54
Histórico de Revisões
Pressuposto 3
UC-FSA-PESQ-0003
UC-FSA-WS-0003 e 0004
06 1.22 2012-08-10 Revisão completa ao documento:
Removidos anexos do Ficheiro XML, Tabela de Erros e
Autenticação WebServices (passaram para o
documento de especificação da mensagem FSA).
Removida a secção de Requisitos Fora de Âmbito (os
requisitos aqui listados passaram a fazer parte do
âmbito).
Removida a secção Funcionalidades não estimadas.
Removida a secção Protótipos Validados (os
protótipos passaram a estar junto do caso de uso a
que dizem respeito).
Removida a secção Matriz de Rastreabilidade.
Revisão de todos os casos de uso e pressupostos (as
revisões efectuadas não têm impacto na lógica de
negócio / funcionamento do sistema).
Aprovação da versão 06 do documento.
Roberto Cortez
1.23 2012-08-31 Pequenas correções ao documento. Tiago Neto Rodrigues
1.24 2012-09-13 Atualização do diagrama de arquitetura. Tiago Neto Rodrigues
1.25 2012-09-17 Alteração ao documento após comentários da APS:
Revisto o texto do requisito UC-FSA-PESQ-0002 - Ver
Resultados da Pesquisa.
Corrigidos os campos do requisito UC-FSA-PESQ-
0004 - Visualizar detalhe de Histórico. Não estavam
de acordo com o protótipo.
Alterado o requisito UC-FSA-EST-0001 - Exportar
Base de Dados para disponibilizar o CSV por Batch.
Actualizado o requisito UC-FSA-BO-0002 - Gerir
Tabelas de Referência.
Roberto Cortez
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 5/54
Histórico de Revisões
07 1.27 2012-09-17 Aprovação da versão 07 do documento. Roberto Cortez
1.28 2012-11-22 Alteração do requisito UC-FSA-PESQ-0003 - Consultar
Detalhe do Sinistro para colocar de acordo com
protótipo.
Marco Ribeiro
1.29 2012-11-29 Alterados os requisitos:
UC-FSA-PESQ-0003 – Retirada indicação de tabela
não paginada
UC-FSA-PESQ-0004 – Adição do campo código postal
UC-FSA-COM-0002 – Descrição da suspensão
manual do protocolo
Pedro Martins
1.30 2012-12-14 Actualizados os requisitos:
UC-FSA-PESQ-0001 - Pesquisar Sinistros: indicação
do bold na pesquisa.
UC-FSA-PESQ-0003 - Consultar Detalhe do Sinistro:
parametrização de número de sinistros a carregar.
UC-FSA-BO-0003 - Configurar parâmetros de FSA:
adicionados parâmetros de configuração em falta.
Roberto Cortez
08 1.31 2012-12-14 Aprovação da versão 08 do documento. Roberto Cortez
1.32 2014-02-10 Alteração do requisito UC-FSA-PESQ-0004 – adição de
novos campos de detalhe dos sinistros.
David Carvalho
09 1.33 2014-02-17 Aprovação da versão 09 do documento. Pedro Martins
1.34 2014-02-26 Atualização das tabelas de referência David Carvalho
10 1.35 2014-02-28 Aprovação da versão 10 do documento. Pedro Martins
11 1.36 2014-04-14 Atualizados os requisitos:
UC-FSA-CF-0010 – Inclusão dos campos a exportar
UC-FSA-EST-0001 – Inclusão dos campos a exportar
Pedro Martins
1.37 2014-07-31 Atualizados os requisitos:
UC-FSA-BO-0003 – Remoção da obrigatoriedade do
campo “Indemnização Paga” e remoção da
obrigatoriedade da informação de
terceiros/coberturas das configurações.
UC-FSA-PESQ-0001:
o Aumento do tamanho do campo Matrícula.
o Inserção do novo critério de pesquisa (data do
David Carvalho
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 6/54
Histórico de Revisões
sinistro).
UC-FSA-CF-0002 – Inclusão da informação de, nos
casos em que não existe matrícula, o campo poder ser
substituído pelo chassis do veículo.
UC-FSA-PESQ-0004:
o Adição do novo campo (País) no detalhe do sinistro.
o Adição do novo campo (Número de Apólice) no
detalhe do sinistro.
o Remoção da informação de % de Responsabilidade
nos intervenientes do sinistro.
UC-FSA-WS-0003:
o Inserção da informação do novo critério de pesquisa
(data do sinistro).
o Adição da descrição do novo método de pesquisa por
WS (listagem de identificadores de sinistro).
o Adição da informação da nova configuração para
definir se uma companhia recebe apenas a resposta
ou o pedido por inteiro de volta.
o Adição da informação da nova configuração para
definir o número máximo de registos devolvidos numa
pesquisa.
UC-FSA-WS-0004:
o Adição da informação, via WS, de anexos
(configuração por companhia).
o Adição da disponibilização do código da seguradora
no detalhe do sinistro.
UC-FSA-EST-0001:
o Adição do novo campo (País) no detalhe dos dados
exportados.
o Adição do no campo (Número de Apólice) no detalhe
dos dados exportados.
UC-FSA-WS-0002 – Adição da informação, no retorno
da resposta do campo “Identificador do sinistro”.
Inclusão de novos requisitos:
UC-FSA-EST-0001 – Relatório de pesquisa de
Sinistros.
UC-FSA-WS-0006:
o Obtenção de Anexos de um Sinistro.
o Adição da informação de um procedimento, no
módulo de manutenção, para a eliminação de anexos.
12 1.38 2014-08-01 Aprovação da versão 12 do documento. Pedro Martins
13 1.39 2014-08-07 Atualização de valores nas tabelas de referência. Pedro Martins
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 7/54
Histórico de Revisões
Adição de anexo A4 - Tabela de países
Inclusão de novos requisitos:
UC-FSA-WS-0007 – Pesquisar Ids de Sinistros
UC-FSA-WS-0008 – Obter Registos Potencialmente
Duplicados
Aprovação da versão 13 do documento.
1.40
1.41
2014-09-12 Atualização das tabelas de referência David Carvalho
1.42 2014-09-26 Atualização da tabela de Países David Carvalho
1.43 2015-03-09 Atualização da tabela de Enquadramentos David Carvalho
14 1.44 2015-03-20 Aprovação versão 14 Pedro Martins
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 8/54
Índice
1 Introdução .......................................................................................................................... 10 1.1 Objetivo .................................................................................................................................... 10 1.2 Âmbito ...................................................................................................................................... 10 1.3 Audiência ................................................................................................................................. 10 1.4 Definições e acrónimos ............................................................................................................. 10 1.5 Estrutura do documento ............................................................................................................ 11 1.6 Documentos aplicáveis ............................................................................................................. 11 1.7 Documentos de referência ......................................................................................................... 12
2 Domínio do projeto ............................................................................................................. 13 2.1 Caracterização do Cliente e do negócio ..................................................................................... 13 2.2 Caracterização do problema ...................................................................................................... 13 2.3 Principais metas do projeto ....................................................................................................... 13 2.4 Lista de utilizadores chave ......................................................................................................... 14
3 Normas, convenções, procedimentos e ferramentas ............................................................ 15 3.1 Normas de desenho .................................................................................................................. 15 3.2 Ferramentas de software ........................................................................................................... 15 3.3 Reutilização .............................................................................................................................. 15
4 Arquitetura do sistema ........................................................................................................ 16 5 Pressupostos ...................................................................................................................... 17
5.1 Pressuposto 1 - Acesso PSP ...................................................................................................... 17 5.2 Pressuposto 2 - Migração de Dados ........................................................................................... 17 5.3 Pressuposto 3 - Fraudes ............................................................................................................ 17 5.4 Pressuposto 4 - Templates de E-Mail ......................................................................................... 18 5.5 Pressuposto 5 - Dimensionamento ............................................................................................ 18 5.6 Pressuposto 6 - Ficheiros XML ................................................................................................... 18
6 Catálogo de Casos de Uso (Use Cases) ................................................................................ 19 6.1 Comuns .................................................................................................................................... 19
6.1.1 UC-FSA-COM-0001 - Disponibilizar Perfis .......................................................................... 19 6.1.2 UC-FSA-COM-0002 - Suspender Acesso ao Protocolo ...................................................... 20 6.1.3 UC-FSA-COM-0003 - Integrar com módulo SCF ................................................................. 21 6.1.4 UC-FSA-COM-0004 - Disponibilizar Ajuda Online ............................................................... 21
6.2 Pesquisas e Consultas .............................................................................................................. 21 6.2.1 UC-FSA-PESQ-0001 - Pesquisar Sinistros .......................................................................... 22 6.2.2 UC-FSA-PESQ-0002 - Ver Resultados da Pesquisa ........................................................... 23 6.2.3 UC-FSA-PESQ-0003 - Consultar Detalhe do Sinistro ......................................................... 25 6.2.4 UC-FSA-PESQ-0004 - Visualizar detalhe de Histórico ....................................................... 26
6.3 Carregamento de Ficheiros ........................................................................................................ 28 6.3.1 UC-FSA-CF-0002 - Carregar registos via ficheiro XML ....................................................... 28 6.3.2 UC-FSA-CF-0008 - Validar estrutura de ficheiro ................................................................ 29 6.3.3 UC-FSA-CF-0003 - Processar registos de Criação ............................................................. 30 6.3.4 UC-FSA-CF-0004 - Processar registos de Modificação...................................................... 30 6.3.5 UC-FSA-CF-0005 - Processar registos de Eliminação........................................................ 31 6.3.6 UC-FSA-CF-0006 - Identificar registos homólogos............................................................. 31 6.3.7 UC-FSA-CF-0007 - Identificar registos duplicados ............................................................. 32 6.3.8 UC-FSA-CF-0009 - Identificar registos potencialmente duplicados.................................. 32 6.3.9 UC-FSA-CF-0010 - Processar registos potencialmente duplicados .................................. 33 6.3.10 UC-FSA-CF-0001- Gerar Ficheiro de Erros ......................................................................... 34
6.4 Web-Services ............................................................................................................................ 35 6.4.1 UC-FSA-WS-0001 - Disponibilizar Web-Services ................................................................ 35
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 9/54
6.4.2 UC-FSA-WS-0005 - Autenticar Utilizadores ........................................................................ 36 6.4.3 UC-FSA-WS-0002 - Enviar Registos FSA............................................................................. 36 6.4.4 UC-FSA-WS-0003 - Pesquisar Sinistro ............................................................................... 37 6.4.5 UC-FSA-WS-0004 - Consultar Detalhe Registo .................................................................. 37 6.4.6 UC-FSA-WS-0006 – Obtenção de Anexos de um Sinistro ................................................. 38 6.4.7 UC-FSA-WS-0007 – Pesquisar IDs de Sinistros ................................................................. 38 6.4.8 UC-FSA-WS-0008 – Obter registos potencialmente duplicados ....................................... 38
6.5 Estatísticas ............................................................................................................................... 39 6.5.1 UC-FSA-EST-0001 - Exportar Base de Dados ..................................................................... 39 6.5.2 UC-FSA-EST-0002 – Relatório de pesquisa de Sinistros .................................................. 41
6.6 Backoffice ................................................................................................................................ 42 6.6.1 UC-FSA-BO-0001 - Consultar parâmetros do FSA ............................................................. 42 6.6.2 UC-FSA-BO-0002 - Gerir Tabelas de Referência ................................................................ 43 6.6.3 UC-FSA-BO-0003 - Configurar parâmetros de FSA ............................................................ 43 6.6.4 UC-FSA-BO-0004 - Configurar templates de emails .......................................................... 44
Anexo A – Tabelas de Referência ..................................................................................................... 44 A.1 – Tabela de Cobertura ...................................................................................................................... 44 A.2 – Tabela de Tipos de Dano ................................................................................................................ 45 A.3 – Tabela de Códigos de Enquadramentos ......................................................................................... 46 A.4 – Tabela de Países ........................................................................................................................... 46
Índice de Tabelas
Tabela 1: Definições ..................................................................................................................................... 10 Tabela 2: Acrónimos ..................................................................................................................................... 11 Tabela 3: Documentos aplicáveis .................................................................................................................. 11 Tabela 4: Documentos de referência ............................................................................................................. 12 Tabela 5: Lista de ferramentas a utilizar no projeto ........................................................................................ 15 Tabela 6 - Tabela de coberturas .................................................................................................................... 45 Tabela 7 - Tabela de tipos de danos .............................................................................................................. 46 Tabela 8 - Tabela de Códigos de Enquadramentos ......................................................................................... 46 Tabela 9 - Tabela de Países ........................................................................................................................... 53
Índice de Figuras
Figura 1: Arquitetura de alto nível do sistema ................................................................................................ 16 Figura 2: Comuns ......................................................................................................................................... 19 Figura 3: Pesquisas e Consultas .................................................................................................................... 21 Figura 4: UC-FSA-PESQ-0001 - Pesquisar Sinistros ....................................................................................... 23 Figura 5: UC-FSA-PESQ-0002 - Ver Resultados da Pesquisa .......................................................................... 25 Figura 6: Carregamento de Ficheiros ............................................................................................................. 28 Figura 7: Web-Services ................................................................................................................................. 35 Figura 8: Estatísticas .................................................................................................................................... 39 Figura 9: UC-FSA-EST-0001 - Exportar Base de Dados................................................................................... 41 Figura 10: Backoffice ................................................................................................................................... 42
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 10/54
1 Introdução 1.1 OBJETIVO
O presente documento apresenta a especificação de requisitos de software para o módulo Ficheiro de
Sinistros Automóvel, doravante designado por FSA, da Plataforma Segurnet de acordo com a proposta
apresentada à APS em resposta à sua solicitação.
1.2 ÂMBITO
O módulo FSA, especificado neste documento, registará todos os sinistros e coberturas afectadas, bem
como situações de fraude detectadas no ramo automóvel que estejam comprovadas.
É de salientar que os deliverables denominados “Especificação Funcional” e “Especificação de
Arquitectura”, referidos na proposta, deixaram de existir por solicitação da APS.
1.3 AUDIÊNCIA
Constitui-se como audiência deste documento todos os responsáveis pela plataforma Segurnet, quer do
lado da Critical Software, SA como da Associação Portuguesa de Seguradores.
1.4 DEFINIÇÕES E ACRÓNIMOS
A Tabela 1 apresenta a lista de definições usadas neste documento. As definições apresentadas em
[AD-1] são também aplicáveis.
Nome Descrição
Documento Aplicável Um documento é considerado aplicável se complementar este
documento. Todo o seu conteúdo é diretamente aplicável como se
tivesse sido escrito como anexo deste documento.
Documento de Referência Um documento é considerado de referência se neste documento
existem referências ao seu conteúdo, mas este não é totalmente
aplicável. Os documentos de referência são principalmente utilizados
para fornecer leitura e recursos adicionais.
Tabela 1: Definições
A Tabela 2 apresenta a lista de acrónimos usados neste documento. Os acrónimos apresentados em
[AD-1] são também aplicáveis.
Acrónimo Descrição
APS Associação Portuguesa de Seguradores
FSA Ficheiro de Sinistros Automóvel
CSV Comma-Separated Values
CSW Critical Software, S.A.
CVS Concurrent Versions System
FNM Ficheiro Nacional de Matrículas
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 11/54
Acrónimo Descrição
IMTT Instituto da Mobilidade e dos Transportes Terrestres
JEE Java 2 Platform, Enterprise Edition
PDF Portable Document Format
PSP Polícia de Segurança Pública
QMS Quality Management System
RDBMS Relational Database Management System
SCF Situação de Carregamento de Ficheiros
SGBD Sistema de Gestão de Base de Dados
TBC A confirmar
TBD A definir
UML Unified Modeling Language
Tabela 2: Acrónimos
1.5 ESTRUTURA DO DOCUMENTO
A secção 1 (Introdução), apresenta uma descrição geral do conteúdo deste documento.
Na secção 2 (Domínio do projeto), apresenta-se uma visão global do projeto, as suas principais metas e
contexto.
Na secção 3 (Normas, convenções, procedimentos e ferramentas), encontram-se as normas,
convenções, procedimentos e ferramentas a serem utilizadas no projeto em causa.
Na secção 4 (Arquitetura do sistema), é apresentado o diagrama geral simplificado da arquitetura do
Sistema.
Na secção 5 (Pressupostos), são apresentados todo os pressupostos nos quais a especificação e
desenvolvimento do sistema especificado neste documento serão baseados.
Na secção 6 (Catálogo de Casos de Uso (Use Cases)), são apresentados a lista de actores e casos de
uso.
1.6 DOCUMENTOS APLICÁVEIS
A Tabela 3 apresenta a lista de documentos aplicáveis a este documento. Um documento é considerado
aplicável se complementar este documento. Todo o seu conteúdo é diretamente aplicável como se
tivesse sido escrito como anexo deste documento.
Documento aplicável Número do documento
[AD-1] CSW Glossary, Critical Software, S.A. CSW-QMS-2002-GLS-0353
Tabela 3: Documentos aplicáveis
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 12/54
1.7 DOCUMENTOS DE REFERÊNCIA
A Tabela 4 apresenta a lista de documentos de referência a este documento. Um documento é
considerado de referência se neste documento existem referências ao seu conteúdo, mas este não é
totalmente aplicável. Os documentos de referência são principalmente utilizados para fornecer leitura e
recursos adicionais.
Documento de referência Número do documento
[RD-1] Proposta técnica, Evolução da Arquitectura da Plataforma Segurnet
– Migração e Manutenção, Critical Software SA, 2007
CSW-2007-PRL-1209-03
[RD-2] Requisitos Funcionais Segurnet - Ficheiro de Sinistros Automóvel,
APS, 2010
aps-req-fsa-1-5-20100624
Tabela 4: Documentos de referência
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 13/54
2 Domínio do projeto Nesta secção pretende-se apresentar uma visão global do projecto FSA, descrevendo as suas
funcionalidades, apresentando as principais metas a atingir e a forma de interacção entre a Critical
Software S.A. e a APS. Deste modo pretende-se facilitar a integração de novos elementos no projecto.
2.1 CARACTERIZAÇÃO DO CLIENTE E DO NEGÓCIO
A APS é uma associação Patronal fundada em 1982, sem fins lucrativos, que reúne as companhias de
seguros e resseguros que operam no mercado português. Actualmente o conjunto das Associadas da
APS representa mais de 99% do mercado segurador.
A Segurnet é uma plataforma de comunicações para o sector segurador, criada por iniciativa da APS.
Com a sua implementação, pretendeu a APS superar carências em matéria de comunicação entre os
vários operadores que desenvolvem a sua actividade neste sector, impulsionando um modelo
colaborativo de desenvolvimento da actividade.
Apesar de numa fase inicial as aplicações fornecidas nesta plataforma destinarem-se, em exclusivo, ao
ramo automóvel, progressivamente têm vindo a ser incorporadas novas funcionalidades de outros
ramos ou áreas, o que conta com elevada adesão das associadas.
2.2 CARACTERIZAÇÃO DO PROBLEMA
Actualmente, a plataforma Segurnet assume uma abrangência nacional, constituindo-se elo
fundamental entre as várias associadas. Assente nas tecnologias universais da Internet e potenciada
pela plataforma JEE e SGBD Oracle, a Segurnet permite a veiculação de informação entre os diferentes
sistemas que equipam hoje as seguradoras.
No que diz respeito ao Ficheiro de Sinistros Automóvel (FSA), existe a necessidade por parte de cada
uma das companhias seguradoras de aceder a um conjunto de informação sobre sinistralidade
automóvel que lhes permita retirar dados importantes para o evoluir dos seus negócios. Actualmente, as
companhias já fazem uso dessa informação mas apenas localmente, recorrendo às suas próprias bases
de dados para recolher métricas e estatísticas acerca dos sinistros em que são envolvidos os seus
segurados.
Pretende-se com o FSA criar um ficheiro global e transversal a todas as companhias de modo a alargar o
universo de informação recolhida e desta forma potenciar a obtenção de estatísticas mais abrangentes,
fiáveis e completas.
Actualmente existe já um módulo FSA na plataforma Segurnet. No entanto, este possui lacunas de
informação muito relevantes que impossibilitam o cumprimento integral dos objectivos referidos. O que
se pretende com o desenvolvimento deste novo módulo é fazer uma renovação integral do existente,
dotando o sistema de capacidades e funcionalidades que permitam satisfazer as necessidades do
negócio segurador, no que toca à obtenção de informação acerca da sinistralidade automóvel em
Portugal.
2.3 PRINCIPAIS METAS DO PROJETO
O Ficheiro de Sinistros Automóvel (FSA) é um módulo Segurnet que pretende integrar todos os sinistros
automóveis reportados às companhias seguradoras aderentes a este mesmo protocolo.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 14/54
Pretende-se com este módulo que as seguradoras tenham acesso rápido e fácil a todos os sinistros
ocorridos em Portugal com o objectivo de analisar padrões e tendências de sinistros, gerar estatísticas,
etc.
De forma a alimentar este repositório de sinistros, as companhias seguradoras aderentes a este
protocolo enviam periodicamente um ficheiro com todos os registos de sinistro ocorridos desde o último
envio. O envio deste ficheiro irá criar, alterar ou mesmo eliminar registos existentes.
A criação de um novo registo corresponde ao envio de informação que a companhia possui sobre um
sinistro. No entanto, do ponto de vista do sistema, essa informação poderá ser integrada num sinistro
previamente informado por outra companhia (registo homólogo), ou dar origem a um novo sinistro.
Sinistros dados sem efeito não devem ser enviados para a Segurnet. Caso tenham sido previamente
enviados, a companhia deverá enviar registo de Eliminação.
A modificação de um registo (por exemplo para alteração de uma matrícula, para correcção de um nº de
carta de condução, etc.) irá gerar um histórico de alterações, passível de ser consultado por todos os
utilizadores deste protocolo.
A eliminação de um registo por parte de uma companhia corresponde à eliminação do conjunto de todo
o histórico de alterações previamente informada por ela sobre um sinistro. A eliminação do sinistro
propriamente dito só acontecerá quando todas as companhias envolvidas no sinistro eliminarem o seu
histórico de alterações relativo a esse sinistro.
O repositório criado através da informação enviada pelas companhias será pesquisável e consultável
online e através de Web Services.
Este repositório servirá ainda para a extracção de estatísticas e relatórios, que constituem um dos
principais propósitos de todo o sistema.
2.4 LISTA DE UTILIZADORES CHAVE
Os principais pontos de contacto com a APS, no âmbito do projeto BDNS, encontram-se descritos de
seguida.
Maria Manuel Silva – responsável pela gestão do projeto Segurnet, incluindo aceitação /
validação dos requisitos;
Manuel Magrinho – responsável pela aceitação / validação dos requisitos;
Hugo Duro - responsável pela aceitação / validação dos requisitos.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 15/54
3 Normas, convenções, procedimentos e ferramentas Para atingir um elevado grau de homogeneidade em todos os resultados do projeto, promover a adesão
a boas práticas, maximizar capacidades de reutilização, minimizar riscos e custos de manutenção e
assegurar uma elevada qualidade do produto, a Critical Software S.A. utiliza um processo padronizado
de desenvolvimento de software - Software Development Process [AP-1].
As secções seguintes listam standards, convenções, procedimentos e ferramentas a serem seguidas e
utilizadas no projeto.
3.1 NORMAS DE DESENHO
Este projeto segue as normas de desenho impostas pela Critical Software SA, nomeadamente:
Uso de normas UML v.1.x para todas as necessidades de desenho;
Aplicação dos processos e templates do QMS da CSW aplicáveis ao projeto.
3.2 FERRAMENTAS DE SOFTWARE
De seguida apresenta-se uma descrição geral de todas as ferramentas que serão utilizadas durante o
decorrer do projeto.
Acrónimo Versão Descrição
MS Office 2007, 2010 Edição de texto, Matrizes, Plano do Projeto
CVS 1.3 Repositório e ferramenta de gestão de versões
Enterprise Architect 9.0 Ferramenta de modelização UML
JEE 1.6 Java 2 Standard Edition
Maven 2.2.1 Build management
Oracle 11g RDBMS
JBoss 4.2.3 Application Server
Idea 11 IDE para desenvolvimento Java
SoapUI 4.0.1 Pro Web service testing tool and automation
Tabela 5: Lista de ferramentas a utilizar no projeto
3.3 REUTILIZAÇÃO
O projeto FSA faz parte integrante da plataforma Segurnet, sendo assim irá reutilizar toda a arquitetura
base da plataforma.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 16/54
4 Arquitetura do sistema De seguida apresenta-se o diagrama geral da arquitetura de alto nível com todos os componentes
envolvidos.
FSA
Segurnet
«datastore»Base de Dados
Segurnet
Sistema de FicheirosWeb
Web-Service
Batch
Segurnet Common
Reporting
Workflow
IMTT SCF
«flow»
«flow»
«flow»
Figura 1: Arquitetura de alto nível do sistema
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 17/54
5 Pressupostos Durante a análise e desenvolvimento deste projeto serão assumidos os pressupostos descritos de
seguida.
5.1 PRESSUPOSTO 1 - ACESSO PSP
Pressuposto 1 - Acesso PSP
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
O acesso ao protocolo FSA para os utilizadores da Polícia de Segurança Publica (PSP) será feito através da
companhia "Outros".
É assumido que apenas existem gestores de utilizadores da companhia "Outros" pertencentes à APS e que será
destes a exclusiva responsabilidade de garantir que o perfil FSA apenas é activado para os utilizadores
pretendidos.
Do ponto de vista de sistema nada será feito para garantir que apenas utilizadores PSP nesta companhia terão
acesso ao perfil FSA.
5.2 PRESSUPOSTO 2 - MIGRAÇÃO DE DADOS
Pressuposto 2 - Migração de Dados
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
É assumido que os dados existentes na aplicação actualmente existente (versão da Accenture) serão totalmente
descartados.
É ainda assumido que existirá um carregamento total de dados das companhias aquando da entrada do novo
sistema em produção.
5.3 PRESSUPOSTO 3 - FRAUDES
Pressuposto 3 - Fraudes
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
É assumido que as fraudes indicadas no sistema pelas companhias são sempre fraudes comprovadas.
Não é enviado qualquer comprovativo por parte das companhias em relação às fraudes indicadas, pelo que o
sistema não faz qualquer tipo de verificação sobre estes dados. É sempre assumido que as companhias ao
enviarem a fraude verificaram e comprovaram a mesma.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 18/54
5.4 PRESSUPOSTO 4 - TEMPLATES DE E-MAIL
Pressuposto 5 - Templates de E-Mail
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Antes da instalação do sistema serão enviados para a APS os templates de e-mail criados para sua verificação e
eventual modificação.
5.5 PRESSUPOSTO 5 - DIMENSIONAMENTO
Pressuposto 6 - Dimensionamento
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Para efeitos de desenvolvimento, definição de arquitectura e desenho de projecto, é assumido que o sistema terá
uma dimensão inicial de aproximadamente 4 milhões de registos de sinistros e conta com crescimento estimado
de 1 milhão de registos ao ano.
Os valores apresentados anteriormente são valores meramente informativos, não existindo nenhum requisito de
performance e/ou load associado.
Não está previsto nenhum limite máximo nem qualquer funcionalidade de remoção (purga) de registos antigos.
5.6 PRESSUPOSTO 6 - FICHEIROS XML
Pressuposto 7 - Ficheiros XML
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Assume-se que todos os ficheiros que interagem com o novo módulo FSA estão em formato XML (quer ficheiros de
entrada, quer de resposta por parte do sistema).
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 19/54
6 Catálogo de Casos de Uso (Use Cases) Esta secção tem como objetivo definir os casos de uso associados ao sistema BDNS de uma forma
simples e objetiva.
6.1 COMUNS
Figura 2: Comuns
6.1.1 UC-FSA-COM-0001 - DISPONIBILIZAR PERFIS
UC-FSA-COM-0001 - Disponibilizar Perfis
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
O sistema deverá disponibilizar os seguintes perfis para acesso às funcionalidades do módulo FSA:
APS: Acede a todas as áreas do sistema. Pode fazer pesquisas sem restrições. Pode ver e alterar as
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 20/54
UC-FSA-COM-0001 - Disponibilizar Perfis
configurações. Pode aceder à área de estatísticas e visualizar os relatórios existentes.
FSA: Este perfil apenas permite a pesquisa e consulta dos sinistros existentes na base de dados FSA.
Não permite visualização/gestão de quaisquer estatísticas nem de quaisquer configurações.
6.1.2 UC-FSA-COM-0002 - SUSPENDER ACESSO AO PROTOCOLO
UC-FSA-COM-0002 - Suspender Acesso ao Protocolo
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
O sistema deve suspender o acesso às funcionalidades de pesquisa (UC-FSA-PESQ-0001) e consulta online (UC-
FSA-PESQ-0002,0003,0004) às companhias que num prazo de 15 dias (de calendário)* a contar da última data
de processamento de ficheiros, não tenham enviado novo ficheiro.
Será possível no entanto o envio de registos via webservice (UC-FSA-WS-0002 - Enviar Registos FSA) ou batch (UC-
FSA-CF-0002 - Carregar registos via ficheiro XML)
Nenhum dos utilizadores das companhias em falta poderá aceder às funcionalidades acima descritas, até ao
momento em que seja reposto o carregamento dos dados.
Exemplo:
Assumindo que o último ficheiro processado foi dia 1, a companhia perde acesso dia 16 do mesmo mês às 00h, se
não enviar mais nenhum ficheiro até essa data.
Esta suspensão não é automática. Três dias úteis antes da suspensão (valor configurável), é enviada uma
notificação para a companhia e para a APS indicando que se a companhia não enviar nenhum ficheiro, o protocolo
será suspenso. A APS e a companhia serão novamente notificados aquando da data de suspensão, cabendo à APS
proceder manualmente à suspensão do protocolo através do módulo de GU.
Os utilizadores da companhia suspensa serão alertados para tal facto ao aceder ao módulo FSA da plataforma
SEGURNET.
A companhia "Outros" está excluída desta suspensão, visto que esta nunca enviará ficheiros para processamento.
* Este valor poderá ser configurado em Backoffice.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 21/54
6.1.3 UC-FSA-COM-0003 - INTEGRAR COM MÓDULO SCF
UC-FSA-COM-0003 - Integrar com módulo SCF
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
O sistema deverá integrar com o módulo de Situação de Carregamento de Ficheiros (SCF) actualmente existente
na plataforma Segurnet.
Sempre que seja carregado um ficheiro com sucesso ou processado um registo através de Web Service sem serem
produzidos erros, esta informação deverá ficar registada no módulo SCF, e a situação de carregamento da
companhia em causa actualizada (ícone verde e data do último envio).
A data limite será a que obedece à regra definida em UC-FSA-COM-0002.
6.1.4 UC-FSA-COM-0004 - DISPONIBILIZAR AJUDA ONLINE
UC-FSA-COM-0004 - Disponibilizar Ajuda Online
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
O Sistema deverá disponibilizar uma ajuda online do módulo FSA aos utilizadores (com perfil FSA e APS). A ajuda
online deverá descrever as funcionalidades gerais do sistema acessíveis ao utilizador via Web-Browser.
6.2 PESQUISAS E CONSULTAS
Figura 3: Pesquisas e Consultas
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 22/54
6.2.1 UC-FSA-PESQ-0001 - PESQUISAR SINISTROS
UC-FSA-PESQ-0001 - Pesquisar Sinistros
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Os utilizadores com perfil FSA ou APS poderão pesquisar os sinistros existentes em base de dados. Para isso
deverão preencher os seguintes campos:
(+) Matrícula:
▪ Campo de preenchimento livre até 30 caracteres. Possibilidade de utilização de wildcard através
do caracter "?" que substitui apenas um caractere.
▪ Ao efectuar a pesquisa deverão ser ignorados os espaços (" "), hífenes ("-") e CAPS.
▪ Nos casos em que não existe matrícula (por exemplo as alfaias agrícolas) este campo deverá estar
preenchido com o número de chassis do veículo.
Exemplo:
Uma pesquisa por "XX-00-00" deverá retornar exactamente os mesmos resultados que uma pesquisa por
"xx0000".
(+) Carta de Condução do Condutor (para efeito de seguro de carta/garagista):
▪ Campo de texto livre até 20 caracteres.
▪ Possibilidade de utilização de wildcard através do caracter "?" que substitui apenas um caractere.
▪ Ao efectuar a pesquisa deverão ser ignorados os espaços (" "), hífenes ("-") e CAPS.
Exemplo:
Uma pesquisa por "C-123 4" deverá retornar exactamente os mesmos resultados que uma pesquisa por
"c1234".
Datas de Sinitro (Intervalo de Datas):
Pesquisa realizada sobre a data de ocorrência do sinistro, relativo ao período inserido.
Cobertura afectada: Deverá poder ser seleccionada uma cobertura a partir dos valores existentes na
tabela de referência configurável em BackOffice (ver UC-FSA-BO-0002).
(+): Pelo menos um destes campos terá que ser obrigatoriamente preenchido.
Nota:
Os campos "Carta de Condução do Condutor" e "Cobertura Afectada" deverão ser considerados como
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 23/54
UC-FSA-PESQ-0001 - Pesquisar Sinistros
campos de pesquisa avançada;
Ao pesquisar por matrícula e carta de condução, devem ser devolvidos sinistros em que constem ambos
os campos matrícula e a carta de condução, ainda que em intervenientes diferentes.
Os registos que correspondem à pesquisa serão diferenciados com bold no ecrã.
Figura 4: UC-FSA-PESQ-0001 - Pesquisar Sinistros
6.2.2 UC-FSA-PESQ-0002 - VER RESULTADOS DA PESQUISA
UC-FSA-PESQ-0002 - Ver Resultados da Pesquisa
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Ao efectuar uma pesquisa de sinistros, deverão ser apresentados os resultados da pesquisa sob forma de tabela
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 24/54
UC-FSA-PESQ-0002 - Ver Resultados da Pesquisa
com as seguintes colunas:
Data do Sinistro
Intervenientes no Sinistro
▪ Deverão ser apresentados todas as matrículas intervenientes no sinistro.
▪ Para aquelas que foram informadas as coberturas afectadas e respectivas responsabilidades,
devem ainda ser apresentadas juntamente na listagem dentro da mesma coluna.
A pesquisa deverá retornar apenas os resultados que coincidam com os critérios especificados de uma forma
cumulativa, ou seja, só serão retornados os sinistros que contenham todos os campos especificados.
Se o utilizador efetuar uma pesquisa indicando matrícula e carta de condução, apenas serão devolvidos os
sinistros que tenham essa matrícula e carta de condução mesmo que associados a interveniente diferentes.
Devem ser devolvidos, por sinistro, todos os seus intervenientes, mesmo que não cumpram os critérios de
pesquisa.
Exemplo:
Critérios de pesquisa:
▪ Matrícula: XX-00-00
▪ Carta: C-12345 5
▪ Cobertura afectada: Responsabilidade Civil
Exemplo de sinistro retornado:
▪ Data: 2010-10-10
▪ Interveniente 1: XX-00-00 (carta: L-54331 1, cobertura: roubo)
▪ Interveniente 2: XX-00-01 (carta: C-12345 5, cobertura: Danos Próprios),
▪ Interveniente 3: XX-00-02 (carta: C-44444 2, cobertura: Responsabilidade Civil)
Exemplo de sinistro excluído:
▪ Data: 2011-11-11
▪ Interveniente 1: XX-00-00 (carta: C-12345 5, cobertura: roubo)
Características da Listagem a apresentar:
Listagem ordenável apenas por data de sinistro;
Listagem paginada (10 resultados por página);
Para cada sinistro apresentado deve ser possível aceder ao seu detalhe;
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 25/54
Figura 5: UC-FSA-PESQ-0002 - Ver Resultados da Pesquisa
6.2.3 UC-FSA-PESQ-0003 - CONSULTAR DETALHE DO SINISTRO
UC-FSA-PESQ-0003 - Consultar Detalhe do Sinistro
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Ao aceder ao detalhe de um sinistro através de uma listagem obtida numa pesquisa (ver UC-FSA-PESQ-0002) será
apresentado um ecrã com as seguintes informações do sinistro:
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 26/54
UC-FSA-PESQ-0003 - Consultar Detalhe do Sinistro
Dados do Sinistro:
Data do Sinistro: data de ocorrência do sinistro;
Concelho: concelho de ocorrência do sinistro tal como informado pelas companhias intervenientes. No
caso dos concelhos informados por cada uma das companhias intervenientes ser diferente, deve ser
apresentada a informação de que os concelhos são diferentes e esta informação deve ser sinalizada com um
sinal de warning.
(*) Dados dos Intervenientes (ocorre tantas vezes como o número de intervenientes que informaram o sinistro):
Histórico das Posições: deve ser mostrada uma tabela contendo todas as alterações que uma
companhia efectuou à informação enviada. Esta tabela deve ter as seguintes colunas:
▪ Data da Alteração: Data em que foi enviado o último registo;
▪ Nº totais intervenientes: Número total de intervenientes presentes no registo;
▪ Nº processo de sinistro na companhia: Número do processo de sinistro na companhia em causa;
▪ Nº carta de condução do condutor do veículo na altura do sinistro.
Para cada uma das linhas apresentadas nesta tabela deverá ser possível aceder ao seu detalhe (ver UC-FSA-PESQ-
0004) numa lógica master-detail, ou seja, ao seleccionar uma linha devem ser apresentados os dados a ela
referentes. Por omissão, deve estar imediatamente visível o detalhe da última alteração informada pela
companhia.
Esta tabela deve estar ordenada por data de alteração, sendo primeiro visível a mais recente.
(*) - Cada um destes blocos corresponde a um registo homólogo (ver UC-FSA-CF-0006).
Ao visualizar o detalhe de um sinistro deverá ser possível voltar à listagem (resultado de pesquisa) que lhe deu
origem.
Se o número de intervenientes for superior a 2 (valor parametrizável), então o detalhe não é carregado.
6.2.4 UC-FSA-PESQ-0004 - VISUALIZAR DETALHE DE HISTÓRICO
UC-FSA-PESQ-0004 - Visualizar detalhe de Histórico
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Ao visualizar o detalhe de um sinistro (ver UC-FSA-PESQ-0003) é possível visualizar o detalhe de alterações
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 27/54
UC-FSA-PESQ-0004 - Visualizar detalhe de Histórico
efectuadas por cada uma das companhias intervenientes. Assim, o detalhe de cada registo de histórico deverá
apresentar a seguinte informação:
Nº Processo de Sinistro na Companhia;
Carta de Condução do Condutor do veículo;
Número de Apólice;
Indemnização Paga: (Sim / Não);
Concelho do Sinistro;
País: Identificação do País da ocorrência do sinistro.
Data de Encerramento;
Enquadramento;
Morada: morada da ocorrência do sinistro tal como informado pelas companhias intervenientes;
Localidade: localidade da ocorrência do sinistro tal como informado pelas companhias intervenientes;
Código-Postal: código postal da ocorrência do sinistro tal como informado pelas companhias
intervenientes;
Extensão do Código Postal;
Localidade Postal: Localidade Postal da ocorrência do de acordo com o Código Postal informado;
Latitude: latitude da ocorrência do sinistro;
Longitude: longitude da ocorrência do sinistro;
Data de Recuperação do Veículo (este campo só é apresentado caso existe a cobertura afectada do tipo
"roubo");
Coberturas Afectadas: tabela contendo todas as coberturas indicadas pela companhia, com a respectiva
% de responsabilidade e tipos de dano (podem ser N por cada cobertura);
Intervenientes no Sinistro: Tabela contendo todas as matrículas intervenientes informadas (incluindo a
própria) e respectivas coberturas, responsabilidades e danos afectados. Deve ainda ser possível aceder
ao detalhe IMTT de cada uma delas (sob a forma de pop-up).
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 28/54
6.3 CARREGAMENTO DE FICHEIROS
Figura 6: Carregamento de Ficheiros
6.3.1 UC-FSA-CF-0002 - CARREGAR REGISTOS VIA FICHEIRO XML
UC-FSA-CF-0002 - Carregar registos via ficheiro XML
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
O sistema deve proceder ao carregamento de ficheiros XML enviados pelas companhias aderentes ao protocolo
FSA.
O nome do ficheiro a ser enviado pelas seguradoras com a informação deverá obedecer à seguinte regra, caso
contrário será ignorado.
Exemplo:
Ficheiro com o nome: FSACCCCAAAAMMDDNNNN.EXT (DAT|DAT.INP|INP)
FSA - Nome da transacção (fixo);
CCCC - Código da seguradora remetente;
AAAA - Ano a que corresponde o ficheiro;
MM - Mês a que corresponde o ficheiro;
DD - Dia a que corresponde o ficheiro;
NNNN - Numero sequencial dentro do dia;
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 29/54
UC-FSA-CF-0002 - Carregar registos via ficheiro XML
EXT - Extensão do ficheiro. Poderá ser DAT, DAT.INP ou INP
A estrutura interna do ficheiro terá de corresponder ao definido num XSD específico para o efeito. Estes ficheiros
poderão conter N registos de 3 tipos distintos:
(C)riação: Registo que permite a criação de novos registos de sinistros;
(M)odificação: Registo que permite modificar um registo previamente criado;
(E)liminação: Registo que permite eliminar um registo previamente criado.
Identificação unívoca de registo
Independentemente do tipo de registo, este será sempre univocamente identificado pelos seguintes campos:
Companhia;
Data de Sinistro;
Matrícula;
Nº de Processo.
Nos casos em que não existe matrícula (por exemplo as alfaias agrícolas) a matrícula poderá ser substituída pelo
número de chassis do veículo.
Estes 4 campos servirão para identificar, no caso de registos do tipo M e E, os registos a modificar e eliminar
respectivamente.
6.3.2 UC-FSA-CF-0008 - VALIDAR ESTRUTURA DE FICHEIRO
UC-FSA-CF-0008 - Validar estrutura de ficheiro
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Ao iniciar o carregamento de um ficheiro XML, o sistema deverá validar a estrutura e tipos de dados presentes em
todos os registos do ficheiro através da utilização de um XSD.
Este XSD será definido oportunamente com base na estrutura do ficheiro também a definir.
Quaisquer erros encontrados nesta fase farão com que o ficheiro seja rejeitado sem que sejam analisados os
registos enviados.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 30/54
6.3.3 UC-FSA-CF-0003 - PROCESSAR REGISTOS DE CRIAÇÃO
UC-FSA-CF-0003 - Processar registos de Criação
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-30
Tipo: N/A
Ao processar um ficheiro enviado por uma companhia, o sistema irá processar os eventuais registos de criação
(tipo C) que existam nesse ficheiro. Todos os registos deste tipo que não dêem origem a nenhum erro irão criar um
novo registo de sinistro na base de dados.
6.3.4 UC-FSA-CF-0004 - PROCESSAR REGISTOS DE MODIFICAÇÃO
UC-FSA-CF-0004 - Processar registos de Modificação
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Ao processar um ficheiro enviado por uma companhia, o sistema irá processar os eventuais registos de
modificação (tipo M) que existam nesse ficheiro.
Um registo de modificação irá alterar os campos de um registo identificado através dos seguintes campos:
Companhia
Matrícula do Segurado
Data de Sinistro
Nº de Processo
No caso de não existir nenhum registo coincidente com estes 4 campos na base de dados será produzido um erro
indicando que não foi encontrado o registo a modificar.
Se for encontrado um registo coincidente com os 4 campos indicados, todos os seus campos serão actualizados
para os valores presentes no registo de modificação, à excepção dos 4 campos identificativos que não poderão ser
modificados. No caso de uma companhia querer alterar um dos 4 campos que identificam o registo, deverá
proceder a uma eliminação do registo existente (ver UC-FSA-CF-0005) e à criação de um novo registo (ver UC-FSA-
CF-0003).
Sempre que seja processado um registo deste tipo deverá ser guardado histórico das alterações efectuadas, para
que, possa ser visualizado o estado do registo antes de ter ocorrido a modificação, ou seja, devem ser sempre
guardados todos os campos do registo antes da modificação.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 31/54
6.3.5 UC-FSA-CF-0005 - PROCESSAR REGISTOS DE ELIMINAÇÃO
UC-FSA-CF-0005 - Processar registos de Eliminação
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Ao processar um ficheiro enviado por uma companhia, o sistema irá processar os eventuais registos de eliminação
(tipo E) que existam nesse ficheiro.
Um registo de eliminação irá apagar um registo identificado através dos seguintes campos:
Companhia
Matrícula do Segurado
Data de Sinistro
Nº de Processo
No caso de não existir nenhum registo coincidente com estes 4 campos na base de dados será produzido um erro
indicando que não foi encontrado o registo a eliminar.
Ao eliminar um registo, devem ainda ser eliminados todos os registos de histórico associados (ou seja, todos os
registos associados aquele sinistro, enviados pela companhia em causa), e estes devem deixar de estar
disponíveis online.
Nota:
Nenhum registo deve ser fisicamente eliminado da base de dados. Embora os registos alvo de
eliminação passem a não ser pesquisáveis nem o seu detalhe disponível online nem via Web Service, deve
sempre permanecer a possibilidade de consulta directa na base de dados para efeitos de auditoria
No caso de ser eliminado um registo e posteriormente criado um novo registo igual (4 campos
identificativos iguais), o eventual histórico eliminado do primeiro registo não deve ser considerado, ou seja, não
deve voltar a aparecer na aplicação quando se efectua uma pesquisa.
6.3.6 UC-FSA-CF-0006 - IDENTIFICAR REGISTOS HOMÓLOGOS
UC-FSA-CF-0006 - Identificar registos homólogos
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-30
Tipo: N/A
Ao processar registos do tipo C ou M (ver UC-FSA-CF-0003 e 0004 respectivamente) o sistema deve ter sempre em
conta a possibilidade de existência de registos homólogos.
Definição de registos homólogos
Dois registos são homólogos se se referem ao mesmo sinistro. No caso de sinistros que têm mais que um
interveniente, as diversas companhias seguradoras dos vários intervenientes poderão/deverão ambas enviar
registos referentes ao mesmo sinistro. O sistema deverá detectar estas situações e agrupar esses registos no
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 32/54
UC-FSA-CF-0006 - Identificar registos homólogos
mesmo sinistro.
São considerados registos pertencentes ao mesmo sinistro (homólogos) todos aqueles que tiverem:
A mesma data de sinistro;
Pelo menos 2 matrículas intervenientes iguais.
Para a consideração de registos homólogos apenas são considerados os registos actuais, descartando quaisquer
registos de histórico.
6.3.7 UC-FSA-CF-0007 - IDENTIFICAR REGISTOS DUPLICADOS
UC-FSA-CF-0007 - Identificar registos duplicados
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Ao processar cada registo de criação ou modificação, o sistema procede à verificação da existência de um
eventual registo duplicado, ou seja, verifica se o registo que está a ser criado já existe em base de dados, ou, em
caso de modificação, verifica se o registo enviado coincide exactamente com um registo já existente em base de
dados.
Para o caso da criação de um registo é considerado duplicado no caso de já existir um registo em base de dados
que tenha todos os seguintes campos iguais ao registo a ser criado:
Companhia
Matrícula
Data de Sinistro
Nº Processo
No caso de existir um registo duplicado o sistema deverá produzir um erro.
6.3.8 UC-FSA-CF-0009 - IDENTIFICAR REGISTOS POTENCIALMENTE DUPLICADOS
UC-FSA-CF-0009 - Identificar registos potencialmente duplicados
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-10-01
Tipo: N/A
Ao processar cada registo de criação ou modificação, o sistema procede à verificação da existência de registos
potencialmente duplicados. Este são registos que, pelo facto das companhias intervenientes não possuírem toda a
informação acerca dos mesmos (nomeadamente em relação aos outros intervenientes), foram informados apenas
com um interveniente quando na realidade tiveram outros. Nestes casos é impossível ao sistema discernir se se
tratam de registos homólogos ou sinistros diferentes. Assim, torna-se necessário avisar as companhias para que
possam averiguar se se tratam de sinistros diferentes ou se está em falta alguma informação.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 33/54
UC-FSA-CF-0009 - Identificar registos potencialmente duplicados
São considerados registos potencialmente duplicados aqueles que têm os seguintes campos iguais:
Data de ocorrência do sinistro
Uma e só uma matrícula interveniente igual
Se ao processar um registo de criação ou modificação o sistema encontrar em base de dados algum registo com
estes campos iguais o sistema deve agendar o envio de um aviso para a companhia que apenas informou um
interveniente alertando para a possibilidade de eventualmente faltar informar outros intervenientes.
Os avisos agendados serão processados e enviados à posteriori pelo sistema às companhias em causa (ver UC-
FSA-CF-0010).
Adicionalmente, o sistema deverá ainda verificar se já existe algum outro registo no sistema (registos actuais,
descartando histórico) com os campos Companhia, Data de Sinistro e Matrícula iguais, ainda que com Nº de
Processo diferente. Caso exista, o sistema deverá enviar produzir um aviso para a companhia que está a informar o
registo, alertando para a possibilidade de estar a informar um registo duplicado. Não haverá qualquer forma de
confirmação posterior por parte da companhia.
Nota:
Registos de criação ou modificação considerados potencialmente duplicados, serão inseridos
normalmente na base de dados do FSA.
6.3.9 UC-FSA-CF-0010 - PROCESSAR REGISTOS POTENCIALMENTE DUPLICADOS
UC-FSA-CF-0010 - Processar registos potencialmente duplicados
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-30
Tipo: N/A
Diariamente o sistema irá processar os avisos agendados para registos potencialmente duplicados (ver UC-FSA-
CF-0009). O sistema irá gerar um ficheiro para cada companhia contendo todos os avisos existentes. Estes avisos
serão marcados como enviados para que não voltem a ser enviados.
Do ficheiro gerado faram parte os seguintes campos:
Nº Processo;
Matrícula;
Data Sinistro
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 34/54
6.3.10 UC-FSA-CF-0001- GERAR FICHEIRO DE ERROS
UC-FSA-CF-0001- Gerar Ficheiro de Erros
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Para todos os ficheiros processados será gerado um ficheiro de erros contendo as mensagens que originaram erros
de validação acompanhadas dos respetivos códigos de erro, caso existam. Mesmo no caso em que não tenham
sido identificados erros o sistema deverá criar este ficheiro que seguirá para as companhias como acknowledge da
mensagem. Neste caso o ficheiro deverá conter a mensagem original e a string acknowledge.
O nome do ficheiro de erros será o nome do ficheiro original mas com a extensão alterada para ERR.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 35/54
6.4 WEB-SERVICES
Figura 7: Web-Services
6.4.1 UC-FSA-WS-0001 - DISPONIBILIZAR WEB-SERVICES
UC-FSA-WS-0001 - Disponibilizar Web-Services
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
O sistema deverá disponibilizar sob a forma de Web Service diferentes operações a um utilizador com perfil FSA ou
APS.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 36/54
UC-FSA-WS-0001 - Disponibilizar Web-Services
As várias operações disponíveis (descritas nos próximos Use Cases) deverão ser independentes, para que seja
possível desactivar uma mantendo as outras activas.
6.4.2 UC-FSA-WS-0005 - AUTENTICAR UTILIZADORES
UC-FSA-WS-0005 - Autenticar Utilizadores
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
O sistema deve autenticar os utilizadores dos Web Services, através do envio das credenciais de autenticação.
Deverá ser sempre utilizado um utilizador do tipo sistema com o perfil FSA ou APS para utilizar as operações
disponibilizadas pelos Web Services.
6.4.3 UC-FSA-WS-0002 - ENVIAR REGISTOS FSA
UC-FSA-WS-0002 - Enviar Registos FSA
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Deverá ser disponibilizado um Web Service que permita a Criação, Modificação e Eliminação de um registo FSA.
A lógica (UC-FSA-CF-0003, UC-FSA-CF-0004, UC-FSA-CF-0005, UC-FSA-CF-0006, UC-FSA-CF-0007) e campos
(Anexo A) serão exactamente iguais ao processamento por batch de carregamento de ficheiros.
Será implementada uma solução síncrona, em que as companhias enviam apenas um registo por invocação.
Os eventuais erros gerados no processamento do registo serão retornados imediatamente na resposta do Web Service sem que seja assim necessário gerar qualquer ficheiro de erros. Não existirá nenhuma interacção entre
Web Services e ficheiros.
Nota: Na resposta devolvida (ACK), será incluído o Identificador do Sinistro (identificador único Segurnet, que
serve para poder ser consultado o detalhe do Sinistro através de Web-Service (ver UC-FSA-WS-0004)). Esta
informação será sempre incluída e devolvida quer por WS, quer por Batch.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 37/54
6.4.4 UC-FSA-WS-0003 - PESQUISAR SINISTRO
UC-FSA-WS-0003 - Pesquisar Sinistro
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Deverá ser disponibilizado um Web Service que permita pesquisar sinistros por matrícula ou carta de condução
(para efeito de seguro de carta/garagista) e, opcionalmente, data do sinistro e cobertura afectada. A lógica e
formato da pesquisa são iguais à lógica da versão online (UC-FSA-PESQ-0001).
A informação retornada consistirá numa listagem com os seguintes campos:
Identificador do Sinistro: identificador único Segurnet, que serve para poder ser consultado o detalhe do
Sinistro através de Web-Service (ver UC-FSA-WS-0004)
Data do Sinistro
Matrículas dos Intervenientes e respectivas coberturas associadas (as matrículas podem ser N por
sinistro, e as coberturas podem ser N por matrícula).
Nota:
Existe uma configuração, por companhia, em que é possível indicar se a companhia apenas recebe a
resposta sem todo o pedido de volta, ou não.
Existe também outra configuração que permite definir o número máximo de registos devolvidos numa
pesquisa.
Deverá ser igualmente disponibilizado um Web Service que permita pesquisar sinistros por matrícula ou carta de
condução (para efeito de seguro de carta/garagista) e, opcionalmente, data de sinistro ou cobertura afectada, à
semelhança do anterior, mas em que a informação devolvida consistirá numa listagem apenas com os
identificadores do sinistro.
6.4.5 UC-FSA-WS-0004 - CONSULTAR DETALHE REGISTO
UC-FSA-WS-0004 - Consultar Detalhe Registo
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Deverá ser disponibilizado um Web-Service que permita consulta de detalhe de um sinistro através do
identificador obtido na pesquisa (ver UC-FSA-WS-0003).
O detalhe retornado será o mesmo que o definido em UC-FSA-PESQ-0003.
Adicionalmente será mostrado no detalhe devolvido o código da seguradora.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 38/54
UC-FSA-WS-0004 - Consultar Detalhe Registo
Nota:
Não há garantia que o identificador de um sinistro se mantenha inalterado ao longo do tempo, no
entanto os identificadores antigos continuarão a estar disponíveis para consultar o detalhe do sinistro.
Existe uma configuração, por companhia, em que é possível definir se a companhia recebe ou não
anexos via WS. Em caso negativo, deverá existir um campo informativo da existência, ou não, de anexos.
6.4.6 UC-FSA-WS-0006 – OBTENÇÃO DE ANEXOS DE UM SINISTRO
UC-FSA-WS-0005 – Obtenção de Anexos de um Sinistro
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Deverá ser disponibilizado um Web-Service que permita a obtenção de todos os anexos de um determinado
sinistro através do identificador obtido na pesquisa (ver UC-FSA-WS-0003).
Nota: Para eliminar um anexo deverá ser efetuado um pedido junto da APS.
6.4.7 UC-FSA-WS-0007 – PESQUISAR IDS DE SINISTROS
UC-FSA-WS-0005 – Obtenção de Anexos de um Sinistro
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-08-07
Tipo: N/A
Deverá ser disponibilizado um Web-Service que permite pesquisar sinistros pelos mesmos critérios dos definidos
em UC-FSA-WS-0003.
Na listagem obtida, no entanto, serão apenas devolvidos os ids dos sinistros, devendo depois ser o invocado o
método de consultar detalhe de registo (UC-FSA-WS-0004) para a obtenção de mais informação sobre um sinistro.
6.4.8 UC-FSA-WS-0008 – OBTER REGISTOS POTENCIALMENTE DUPLICADOS
UC-FSA-CF-0010 - Processar registos potencialmente duplicados
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-08-07
Tipo: N/A
Deverão ser disponibilizados dois Web-services que permitam obter os registos potencialmente duplicados (ver
UC-FSA-CF-0009):
- Registos ainda não enviados – este método devolverá os ids dos sinistros potencialmente duplicados e
ainda não enviados para a seguradora
- Registos para um dia – este método devolverá os ids dos sinistros potencialmente duplicados
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 39/54
UC-FSA-CF-0010 - Processar registos potencialmente duplicados
detectados num determinado dia, independentemente de já terem sido ou não enviados para a seguradora.
6.5 ESTATÍSTICAS
Figura 8: Estatísticas
6.5.1 UC-FSA-EST-0001 - EXPORTAR BASE DE DADOS
UC-FSA-EST-0001 - Exportar Base de Dados
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
A funcionalidade para extracção de todos os registos de sinistros da base de dados deve estar apenas disponível
para perfil APS.
O sistema deverá assim permitir a extracção (em formato CSV) de toda a informação relativa aos registos de
sinistros. O utilizador deverá indicar obrigatoriamente o período temporal. Adicionalmente, o utilizador poderá
também filtrar os dados a extrair tendo por base:
Número de Matrícula;
Número de Carta de Condução (para efeito de seguro de carta/garagista);
Tipo de Cobertura afectada;
Companhia
A exportação será feita assincronamente, através de um processamento por batch que irá disponibilizar o relatório
gerado no SFT da APS.
O ficheiro csv será composto pelos seguintes campos:
Companhia;
Numero Processo;
Matrícula;
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 40/54
UC-FSA-EST-0001 - Exportar Base de Dados
Número de Apólice;
Carta Condução;
Data Sinistro;
% Resp;
Cod Postal;
Ext Cod Postal;
Concelho;
País;
Nº Total Intervenientes;
Enquadramentos;
Data Recuperação;
Indemnização Paga;
Data Encerramento;
Coberturas;
Intervenientes
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 41/54
Figura 9: UC-FSA-EST-0001 - Exportar Base de Dados
6.5.2 UC-FSA-EST-0002 – RELATÓRIO DE PESQUISA DE SINISTROS
UC-FSA-EST-0002 – Geração de Relatórios de Sinistros
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
Deverá ser disponibilizado um Batch que permita verificar, com uma periodicidade diária, a existência de ficheiros
novos no SFT para a geração de um relatório (em formato CSV), com a listagem de matrículas. O relatório gerado
conterá toda a informação relativa aos registos de sinistros associados a essas matrículas.
Esta funcionalidade estará disponível para todas as companhias.
O processamento do Batch irá disponibilizar o relatório gerado no SFT da respectiva companhia.
O ficheiro csv será composto pelos seguintes campos:
Companhia;
Numero Processo;
Matrícula;
Número de Apólice;
Carta Condução;
Data Sinistro;
% Resp;
Cod Postal;
Ext Cod Postal;
Concelho;
País;
Nº Total Intervenientes;
Enquadramentos;
Data Recuperação;
Indemnização Paga;
Data Encerramento;
Coberturas;
Intervenientes
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 42/54
6.6 BACKOFFICE
Figura 10: Backoffice
6.6.1 UC-FSA-BO-0001 - CONSULTAR PARÂMETROS DO FSA
UC-FSA-BO-0001 - Consultar parâmetros do FSA
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
Deverá ser disponibilizada uma área de configuração de parâmetros (os parâmetros configuráveis encontram-se
descritos nos casos de uso seguintes), disponível apenas a perfis APS, permitindo a consulta e alteração de
parâmetros.
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 43/54
6.6.2 UC-FSA-BO-0002 - GERIR TABELAS DE REFERÊNCIA
UC-FSA-BO-0002 - Gerir Tabelas de Referência
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
A APS terá a possibilidade de gerir as seguintes tabelas de referência que serão usadas pelo sistema para nas
validações das mensagens XML e nos filtros das pesquisas:
Tabela de Coberturas
Tabela de Tipos de Dano
Tabela de Códigos de Fraude
A gestão de tabelas irá reutilizar o componente já existente na plataforma Segurnet. O componente permite a
edição dos seguintes atributos:
Código: numérico (2)
Descrição: alfanumérico (40)
Visibilidade do Registo
6.6.3 UC-FSA-BO-0003 - CONFIGURAR PARÂMETROS DE FSA
UC-FSA-BO-0003 - Configurar parâmetros de FSA
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2014-07-31
Tipo: N/A
A APS poderá gerir os seguintes parâmetros referentes ao módulo FSA:
Obrigatoriedade (SIM ou NÃO) de preenchimento dos seguintes campos nos registos enviados pelas companhias
(quer através de ficheiro quer Web Service):
Nº do Processo
Código do concelho
Número de resultados por página na pesquisa
Número máximo de sinistros que se podem comparar simultaneamente
Número de sinistros a apresentar por defeito
Número de resultados por página nas tabelas de detalhe
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 44/54
6.6.4 UC-FSA-BO-0004 - CONFIGURAR TEMPLATES DE EMAILS
UC-FSA-BO-0004 - Configurar templates de emails
Versão: 1.0 Fase: 1.0 Estado: Proposed Data: 2010-09-27
Tipo: N/A
A APS poderá configurar o template de notificação de erro (em texto) no processamento de ficheiros através de
uma entrada específica no painel de BackOffice.
Poderá configurar os seguintes campos:
Assunto do e-mail
Corpo do e-mail
Nota:
As variáveis disponíveis para inclusão tanto no assunto como no corpo da notificação serão combinadas com a
APS oportunamente e, uma vez acordadas, serão fixas, não sendo possível utilizar outras que não as definidas.
Anexo A – Tabelas de Referência De seguida são apresentados os dados presentes nas tabelas de referência indicadas.
A.1 – TABELA DE COBERTURA
Código Descrição/Significado
1 Responsabilidade Civil ou R.C. Obrigatória
2 R.C. Facultativa
3 Choque, Colisão e Capotamento - CCC
4 Incêndio, Raio e Explosão
5 Ocupantes
6 Furto ou Roubo
7 Quebra Isolada de Vidros - QIV ou Quebra de Vidros
8 Perda Total
9 Actos de Vandalismo ou Riscos Sociais e Políticos
10 Fenómenos da Natureza ou Forças da Natureza
11 Valor em Novo
12 Extras
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 45/54
Código Descrição/Significado
13 R.C. Cruzado
14 Assistência em Viagem
15 Proteção Jurídica
16 Bagagens e Objetos Pessoais
17 Proteção ao Condutor
18 Privação de Uso ou Veículo de Substituição
19 Responsabilidade Civil da Carga
20 Defesa e Reclamação de Danos
21 Imersão, Submersão e Atolagem
22 Choque entre Atrelados
23 Responsabilidade Civil Laboração (Tractores e Máquinas
Agrícolas)
24 Incêndio, Raio e Explosão em Laboração (Tractores e
Máquinas Agrícolas)
25 Danos à Máquina em Laboração (Tractores e Máquinas
Agrícolas)
26 Danos à Máquina - Via pública
27 Furto ou Roubo em Laboração
Tabela 6 - Tabela de coberturas
A.2 – TABELA DE TIPOS DE DANO
Código Descrição/Significado
1 Danos Corporais – Condutor
2 Danos Corporais – Ocupantes
3 Danos Corporais – Terceiros Condutor
4 Danos Corporais – Terceiro Ocupante
5 Danos Corporais – Segurado Ocupante
6 Danos Corporais – Peão ou Ciclista
7 Danos em objetos transportados no veículo terceiro
8 Danos em coisas (como casas ou muros)
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 46/54
Código Descrição/Significado
9 Danos em infraestruturas viárias ou de iluminação
10 Danos na Viatura – Perda Total Técnica
11 Danos na Viatura – Perda Total Económica
12 Danos na Viatura – Reparações
13 Imobilização em Dinheiro
14 Imobilização em Veículo de Substituição
15 Imobilização em Veículo de Cortesia
16 Danos em Objetos Transportados no Veículo Seguro
Tabela 7 - Tabela de tipos de danos
A.3 – TABELA DE CÓDIGOS DE ENQUADRAMENTOS
Código Descrição/Significado
A Sinistro Declinado em RC ou Declinado em DP
B Sinistro Excluído (em coberturas facultativas)
C Sinistro enquadrado no nº 1 do artigo 36 do DL
291/2007
D Sinistro enquadrado na alínea a) do nº 6 do artigo 36 do
DL 291/2007 - com direito de regresso do artigo 27
E Sinistro regularizado não conforme com o nº 10 do
artigo 29 do DL 291/2007
F Sinistro recusado - artigo 22 do DL 291/2007
G Sinistro encerrado fora do prazo do artigo 36 do DL
291/2007 - base nº 8
H Em averiguação
Tabela 8 - Tabela de Códigos de Enquadramentos
A.4 – TABELA DE PAÍSES
Código Nome
A Áustria
AFG Afeganistão
AG Antigua e Barbuda
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 47/54
Código Nome
AL Albânia
AM Armenia
AND Andorra
ANG Angola
ARK Antártida
ARU Aruba
AUS Austrália
AZ Azerbaijan
B Belgium
BD Bangladesh
BDS Barbados
BF Burkina Faso
BG Bulgária
BHT Butão
BIH Bosnia and Herzegovina
BOL Bolívia
BR Brasil
BRN Bahrain
BRU Brunei Darussalam
BS Bahamas
BU Burundi
BVI Virgin Islands
BW Botswana
BY Bielorussia
BZ Belize
CAM Camarões
CDN Canada
CGO Republica Democrática do Congo
CH Suiça
CI Costa do Marfim
CL Sri Lanka
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 48/54
Código Nome
CN Republica Popular da China
CO Colombia
COM Comoras
CR Costa Rica
CU Cuba
CV Cabo Verde
CY Chipre
CZ Republica Checa
D Alemanha
DJI República do Djibouti
DK Dinamarca
DOM Republica Dominicana
DY Benin
DZ Argelia
E Espanha
EAK Republica do Quenia
EAT Tanzania
EAU Uganda
EAZ Zanzibar
EC Equador
ER Eritreia
ES El Salvador
EST Estónia
ET Egipto
ETH Etiopia
F France
FIN Finlandia
FJI Fiji
FL Liechtenstein
FO Faroe Islands
FSM Micronésia
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 49/54
Código Nome
G Gabon
GB Reino Unido
GBA Alderney
GBG Guernsey
GBJ Jersey
GBM Isle of Man
GBZ Gibraltar
GCA Guatemala
GE Geórgia
GH Republica do Gana
GQ Guiné Equatorial
GR Grecia
GUY Guiana
GW Guiné-Bissau
H Hungria
HK Hong-Kong
HKJ Jordania
HN Honduras
HR Croacia
I Italia
IL Israel
IND India
IR Irão
IRL Irlanda
IRQ Iraque
IS Islandia
J Japão
JA Jamaica
KH Camboja
KIR República do Kiribati
KN Gronelandia
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 50/54
Código Nome
KP Coreia do Norte
KS Quirguistão
KSA Arabia Saudita
KWT Kuwait
KZ Cazaquistão
L Luxemburgo
LAO Republica do Laos
LAR Libia
LB Libéria
LS Lesoto
LT Lituania
LV Letonia
M Malta
MA Marrocos
MAL Malásia
MC Mónaco
MD Moldavia
MEX México
MGL Mongólia
MH Ilhas Marshall
MK Macedonia
MNE Montenegro
MO Macau
MOC Moçambique
MS Ilhas Mauricias
MV Maldivas
MW Malaui
MYA Birmania
N Noruega
NA Antilhas (Holandesas)
NAM Namibia
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 51/54
Código Nome
NAU Nauru
NC Nova Caledónia
NEP Nepal
NIC Nicaragua
NL Paises Baixos
NZ Nova Zelandia
OM Oman
P Portugal
PA Panamá
PAL Republica do Palau
PE Peru
PK Paquistão
PL Polónia
PNG Papua Nova Guiné
PR Puerto Rico
PS Palestina
PY Paraguai
Q Qatar
RA Argentina
RC Taiwan
RCA Republica Centro-Africana
RCB Congo
RCH Chile
RG Guiné
RH Haiti
RI Indonesia
RIM Mauritania
RKS Kosovo
RL Líbano
RM Madagáscar
RMM Mali
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 52/54
Código Nome
RN Nigeria
RNR Zâmbia
RO Roménia
ROK Coreia do Sul
RP Filipinas
RSM São Marino
RT Togo
RU Burundi
RUS Russia
RWA Ruanda
S Suécia
SCN Federação de São Cristovão e Neves
SD Suazilandia
SGP Singapura
SK Eslovaquia
SLO Eslovenia
SME Suriname
SN Senegal
SO Somália
SOL Ilhas Salomão
SRB Serbia
STP São Tomé e Principe
SUD Sudão
SY Seychelles
SYR Siria
T Tailandia
TCH Chade
TG Togo
TJ Tajiquistão
TL Timor Oriental
TM Turquemenistão
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 53/54
Código Nome
TN Tunisia
TR Turquia
TT Trinidade e Tobago
TUV Tuvalu
UA Ucrania
UAE Emiratos Arabes Unidos
USA Estados Unidos
UY Uruguai
UZ Uzebequistão
V Vaticano
VN Vietname
VU Vanuatu
WAG Gambia
WAL Serra Leoa
WAN Nigeria
WD Dominica
WG Granada
WL Santa Luzia
WS Samoa
WSA República Árabe Saharaui Democrática
WV São Vicente e Grenadinas
YAR Yemen
YV Venezuela
Z Zambia
ZA Africa do Sul
ZW Zimbabwe
Tabela 9 - Tabela de Países
Ficheiro de Sinistros Automóvel
Especificação de Requisitos de Software
Impresso: 2015-03-22 Ref. Doc.: CSW-SEGFSA-2010-SRS-03051
Template: CSW-QMS-2009-TPL-03083 v2.0.0
©2015 Copyright Critical Software S.A. Todos Os Direitos
Reservados. 54/54
COIMBRA HEADQUARTERS, PORTUGAL
Parque Industrial de Taveiro, Lote 48
3045-504 Coimbra, Portugal
Tel.: +351 239 989 100
Fax: +351 239 989 119
LISBON OFFICE, PORTUGAL
Campus do Lumiar, Edifício M8
Estrada do Paço do Lumiar
1649-038 Lisboa, Portugal
Tel.: +351 217 145 430
Fax: +351 217 145 432
OPORTO OFFICE, PORTUGAL
Rua Eng.º Frederico Ulrich, nº 2650
4470-605 Moreira da Maia, Portugal
Tel.: +351 229 446 927/8
Fax: +351 229 446 929
SÃO PAULO, BRAZIL
Parque Tecnológico UNIVAP
Av. Shishima Hifumi 2911 - Urbanova
S. José dos Campos, S. Paulo
SP - CEP: 12244-000, Brazil
Tel: +55 12 3949 2512
SAN JOSE OFFICE, USA
111 North Market Street, 6th floor, San Jose
California, USA, 95113
Tel.: +1 (408) 351 33 53
Fax: +1 (408) 351 33 30
SOUTHAMPTON OFFICE, UK
2 Venture Road
Southampton Science Park
Southampton SO16 7NP, UK
Tel.: +44 (0) 23 8011 1339
Fax: +44 (0) 870 762 2487
YEOVIL OFFICE, UK
Yeovil Innovation Centre
Barracks Close, Copse Road
Yeovil, Somerset BA22 8RN, UK
Tel.: +44 (0)1935 385911
Fax: +44 (0)870 762 2487
MAPUTO OFFICE, MOZAMBIQUE
Rua Pereira Marinho, 179
Bairro da Sommerchield
Maputo, Mozambique
Tel.: +258 826 038 600