Integração entre o sistema de gestão imobiliária e a corretora de seguros
Aplicação que liga o Properfy, o sistema onde a mediadora gere os contratos, à API da Grazon, a corretora que emite os seguros. Os dois lados passam a ser vistos lado a lado, e as cotações deixam de ser feitas fora do sistema.
O problema
O seguro de incêndio associado a um arrendamento vive em dois sítios ao mesmo tempo. O contrato e o imóvel estão no Properfy. A apólice, a cotação e o prémio estão na corretora. Não havia ligação nenhuma entre os dois, e por isso não havia forma de responder a perguntas simples: quantos contratos ativos estão sem seguro, que apólices existem na corretora sem contrato correspondente, e onde é que os valores divergem.
Para pedir uma cotação nova, alguém copiava à mão os dados do inquilino e do imóvel do Properfy para o portal da corretora. É o mesmo tipo de trabalho de transcrição que já tinha resolvido noutro projeto, agora com a diferença de que aqui existia API dos dois lados.
O que construí
Uma aplicação própria, com servidor e base de dados, que sincroniza os seguros da corretora, cruza-os com os dados do Properfy e apresenta o conjunto numa única listagem. A partir daí é possível cotar, efetivar, cancelar, descarregar propostas e apólices, e exportar relatórios, sem sair da ferramenta.
A autenticação é feita com o token do próprio utilizador no Properfy. Isso não é um detalhe técnico: significa que a ferramenta nunca mostra mais do que aquilo a que aquela pessoa já tem acesso, e que não existe uma conta partilhada com permissões de todos.
Como funciona
Entrar com a conta do Properfy
Não há utilizadores próprios da ferramenta. Quem entra, entra com as credenciais do Properfy, e as permissões de lá aplicam-se aqui.
A listagem conjunta
Depois da sincronização, os seguros aparecem numa lista que mostra, na mesma linha, o estado do lado da corretora e o estado do lado do Properfy. Os contadores no topo dividem a carteira pelo que interessa: quantos existem só na corretora, quantos existem em ambos, quantos existem só no Properfy.
Esse último número é o que normalmente ninguém consegue produzir, e é o que aponta os contratos a descoberto.
Dois ambientes, quatro paletas
A ferramenta tem um ambiente de produção, com dados reais, e um ambiente de teste com dados fictícios. Como as duas parecem iguais e fazem coisas diferentes, a cor de fundo muda com o ambiente, e há uma variante clara e outra escura de cada, escolhida automaticamente conforme o tema do computador.
É uma precaução barata contra o erro mais caro que esta ferramenta pode cometer, que é mexer em produção julgando estar a testar.
Cotar sem sair da ferramenta
O formulário de cotação reproduz o que a corretora exige. Para não repetir a transcrição que motivou o projeto, o número de contribuinte procura o cliente diretamente no Properfy e traz os contratos encontrados, e há um botão para copiar os dados do segurado para o beneficiário quando são a mesma pessoa.
Painel e exportação
O painel resume a carteira por estado e por prémio. A exportação de relatórios corre em segundo plano e aceita os mesmos filtros da listagem, o que evita gerar o relatório completo quando a pergunta é sobre uma fatia dele.
Um relatório completo de produção pode demorar mais de duas horas, e isso não é um defeito da ferramenta: é o tempo que a API da corretora leva a devolver os dados completos de cada contrato. Vale a pena ser dito ao utilizador antes de ele começar a esperar, e por isso está escrito na documentação.
Decisões que vale a pena explicar
Modo de visualização por omissão. Ações que alteram dados na corretora só ficam disponíveis depois de ligar explicitamente o modo de edição. Cancelar uma proposta por engano custa dinheiro a alguém.
Registo de tudo, geral e por item. Cada ação fica gravada com o utilizador, o momento, o método e a descrição. Numa ferramenta que escreve em dois sistemas de terceiros, o histórico é o que permite reconstruir o que aconteceu.
Documentação entregue com o produto. Escrevi o manual de utilização junto com a ferramenta, incluindo as limitações que vêm da API da corretora e não têm solução do meu lado. Uma ferramenta que só eu sei usar é uma dependência.
Instalação
A aplicação corre num servidor Linux do cliente, que também configurei. Ficou com base de dados própria, o que lhe permite guardar histórico e comparações que nenhum dos dois sistemas de origem conserva.