Boletim Eletrônico de Registro de Acidente de Trânsito sem Vítimas

(1)

Boletim Eletrônico de Registro de Acidente de Trânsito sem Vítimas

EBRAT CONSULTAS

Manual do Produto Versão 2.2

Junho/2017

(2)

Índice

1. Informações gerais sobre o produto ... 3

1.1 Contexto ... 3

1.2 Objetivo ... 3

1.3 Nome... 3

1.4 Endereço do arquivo WSDL ... 3

1.5 Requisitos e orientações para o acesso ... 3

2. Informações detalhadas do serviço ... 3

2.1 Acesso via Browser ... 4

2.1.1 Endereço/Link de acesso ... 4

2.1.2 Telas ... 4

2.1.2.1 Consulta por Dados do Acidente ... 5

2.1.2.2 Consulta Protocolo ... 5

2.1.3 Exemplos: ... 6

2.1.3.1 Exemplo de consultas realizadas com sucesso ... 6

2.1.3.2 Exemplo de retorno com erro na consulta ... 9

2.1.3.2.1 Parâmetro Inválido ... 9

2.1.4 Possíveis retornos com erro na consulta: ... 9

2.1.4.1 Retornos específicos deste produto ... 9

2.1.4.2 Retornos gerais ... 9

2.2 Acesso Webservice ... 10

2.2.1 Protocolo de Comunicação ... 10

2.2.2 Nome das consultas do serviço ... 10

2.3 Informações sobre o retorno das consultas ... 10

2.3.1 Parâmetros de retorno: caso de sucesso ... 10

2.3.1.1 Estrutura dos Dados ... 10

2.3.2 Exemplos de retorno: caso de sucesso ... 12

2.3.3 Informações de retorno: caso de erro ... 14

2.3.3.1 Parâmetros de retorno: caso de erro ... 14

2.3.3.2 Exemplo de retorno: caso de erro ... 14

2.4 Parâmetros de entrada das consultas ... 14

2.4.1 Consulta por Dados do Acidente ... 14

2.4.2 Consulta por Protocolo ... 15

(3)

1. Informações gerais sobre o produto 1.1 Contexto

O E-Brat Consultas foi criado através de um convênio firmado entre a Fenaseg/CNseg e a PMERJ, onde foi desenvolvido um sistema para registro OnLine de acidentes de trânsito, sem vítimas, envolvendo até cinco veículos, no estado do Rio de Janeiro.

Contém as informações sobre os dados da ocorrência, do veículo principal, de proprietário e condutor, veículos envolvidos e testemunhas caso tenha sido declarado, e informações complementares sobre o acidente. É possível também a inclusão de fotos.

Diariamente a Fenaseg/CNseg recebe informações sobre os Boletins de Ocorrência registrados.

1.2 Objetivo

Permitir às seguradoras e aos parceiros acesso aos registros de acidentes de trânsito sem vítimas, disponibilizados no banco de dados do e-Brat.

1.3 Nome

Boletim Eletrônico de Registro de Acidente de Trânsito sem Vítimas.

1.4 Endereço do arquivo WSDL



Homologação:

http://centraldeservicos-hmlg.cnseg.org.br/consultaebrat/service.asmx?wsdl

 Produção:

http://centraldeservicos.cnseg.org.br/consultaebrat/service.asmx?wsdl

1.5 Requisitos e orientações para o acesso

Para entrar em contato com a Superintendência Executiva de Negócios da CNseg, seja em caso de dúvida, reclamações, sugestões ou para solicitação de informações sobre nossas soluções, acione o Canal de Atendimento ao Cliente.

Para utilizar o Canal de Atendimento ao Cliente, acesse cnseg.org.br clicando no banner Soluções Tecnológicas para o Mercado e, em seguida, no banner Atendimento ao Cliente.

Informamos que o login é o seu e-mail e no seu primeiro acesso você deverá solicitar uma

senha, clicando em recuperar senha.

(4)

Os novos usuários deverão solicitar seu acesso a um usuário já cadastrado no Canal de Atendimento ao Cliente, conforme abaixo:

Após o primeiro acesso é possível alterar sua senha, através dos passos a seguir:

1º Passo: Após logar, na primeira tela apresentada, no menu superior clique em “Alterar Senha”.

2º Passo: Preencha com a senha de sua escolha e clique em “Concluir Abertura” para finalização.

2. Informações detalhadas do serviço

2.1 Acesso via Browser 2.1.1 Endereço/Link de acesso



Homologação: http://centraldeservicos-hmlg.cnseg.org.br/



Produção: http://centraldeservicos.cnseg.org.br/

2.1.2 Telas

(5)

2.1.2.1 Consulta por Dados do Acidente

2.1.2.2 Consulta Protocolo

(6)

2.1.3 Exemplos:

2.1.3.1 Exemplo de consultas realizadas com sucesso

(7)

(8)

(9)

2.1.3.2 Exemplo de retorno com erro na consulta

2.1.3.2.1

Parâmetro Inválido

Indica que um ou mais campos estão nulos ou inválidos

2.1.4 Possíveis retornos com erro na consulta:

2.1.4.1 Retornos específicos deste produto

Retorno Descrição

Deve ser informado outro parâmetro além da

data Indica que a consulta não pode ser realizada

informando-se apenas o campo data

2.1.4.2 Retornos gerais

Retorno Descrição

Usuário ou Senha Inválido Indica que o usuário e/ou a senha informada são inválidos

Parâmetro inválido Indica que um ou mais campos estão nulos ou inválidos

Não há retorno para esta consulta Indica que não foi encontrado nenhum registro para os campos informados

Sua consulta não foi realizada, entre em contato

com o suporte Indica que ocorreu um erro inesperado e é

preciso que entre em contato com o suporte Cliente não possui permissão para o método Indica que o usuário não tem permissão para

realizar a consulta

Acesso não permitido para o IP Indica que a consulta foi realizada a partir de um IP não cadastrado para a empresa do usuário Cliente não possui crédito disponível Indica que a consulta não pode ser realizada, pois

não há saldo suficiente Cliente já utilizou todas as consultas do Contrato

de Experiência de Uso para esse método

Indica que o contrato da empresa é de

Experiência de Uso e a quantidade máxima de consultas permitidas já foi atingida.

Contrato inativo ou fora do período de vigência Indica que a empresa não possui nenhum contrato ativo e/ou vigente para o produto.

(10)

Método inválido Indica que esta consulta não está disponível.

Produto inválido Indica que esta consulta não está disponível.

Produto em desenvolvimento Indica que esta consulta não está disponível.

2.2 Acesso Webservice

2.2.1 Protocolo de Comunicação

O protocolo de comunicação com o webservice é o SOAP 1.1. Esse protocolo aceita apenas requisições POST.

2.2.2 Nome das consultas do serviço

A tabela a seguir apresenta as consultas disponíveis para consumo e o nome da operação na interface do serviço.

Descrição da Consulta Nome da Operação

Consulta por Dados do Acidente consultaEbrat

Consulta Protocolo consultaEbratUnico

2.3 Informações sobre o retorno das consultas

Esta seção apresenta estruturas e exemplos dos retornos de cada consulta.

2.3.1 Parâmetros de retorno: caso de sucesso

Informações detalhadas sobre os parâmetros de retorno para consultas ao BDV realizadas com sucesso.

2.3.1.1 Estrutura dos Dados

Nome do Campo Tipo Tamanho Descrição do Campo

Dados da Ocorrência

DataOcorrencia Char 10 Data da ocorrência do Brat

HoraOcorrencia Char 5 Hora da ocorrência do Brat

LocalOcorrencia Char 200 Local da ocorrência do Brat

EspecificacaoLocal Char 200 Especificação do local da ocorrência

Cep Char 8 CEP do endereço da ocorrência

Logradouro Char 100 Logradouro do endereço da ocorrência

Numero Char 10 Número do endereço da ocorrência

Bairro Char 50 Bairro do endereço da ocorrência

Cidade Char 50 Cidade do endereço da ocorrência

Uf Char 2 UF do endereço da ocorrência

Complemento Char 100 Complemento do endereço da ocorrência

PontoReferencia Char 100 Ponto de referência do endereço da ocorrência

Visibilidade Char 20 Condição da visibilidade no momento da ocorrência

Pista Char 20 Condição da pista no momento da ocorrência

Sinalizacao Char 20 Condição da sinalização no momento da ocorrência

TipoAcidente Char 200 Tipo do acidente

(11)

Descricao Char 4000 Texto descritivo do acidente ocorrido

Email Char 100 E-mail do criador do Brat

Fotos Char 100 Foto

ProtocoloBrat Char 20 Protocolo identificador do Brat

Dados dos Veículos

Placa Char 7 Placa do Veículo

Renavam Char 11 Renavam do Veículo

TipoVeiculo Char 20 Indica se o veículo é o principal ou envolvido na

ocorrência

MarcaModelo Char 25 Marca e modelo do Veículo

Cor Char 15 Cor do Veículo

Chassi Char 20 Chassi do Veículo

UfVeiculo Char 2 UF do Veículo

AnoFabricacao Number 4 Ano de fabricação do Veículo

AnoModelo Number 4 Ano do modelo do Veículo

DanoLD Number 1 Indicador de dano lateral direito do Veículo.

0 – Sem dano 1 – Com dano

DanoLE Number 1 Indicador de dano lateral esquerdo do Veículo.

DanoDD Number 1 Indicador de dano dianteiro direito do Veículo.

DanoDE Number 1 Indicador de dano dianteiro esquerdo do Veículo.

DanoTD Number 1 Indicador de dano traseiro direito do Veículo.

DanoTE Number 1 Indicador de dano traseiro esquerdo do Veículo.

0 – Sem dano 1 – Com dano Dados dos Motoristas (ligados aos Veículos)

NomeMotorista Char 8000 Nome do Motorista

SexoMotorista Number 1 Sexo do Motorista

EstadoCivilMotorista Char 20 Estado civil do Motorista

CpfCnpjMotorista Char 1000 CPF ou CNPJ do Motorista

DataNascimentoMotorista Char 10 Data de nascimento do Motorista

TipoMotorista Char 20 Indica se o motorista é condutor ou proprietário do

veículo

Cep Char 8 CEP do endereço do Motorista

Logradouro Char 100 Logradouro do endereço do Motorista

Numero Char 10 Número do endereço do Motorista

Bairro Char 50 Bairro do endereço do Motorista

Cidade Char 50 Cidade do endereço do Motorista

Uf Char 2 UF do endereço do Motorista

Complemento Char 100 Complemento do endereço do Motorista

Dados das Testemunhas

NomeTestemunha Char 8000 Nome da testemunha

CpfTestemunha Char 1000 CPF da testemunha

TelefoneFixoTestemunha Char 1000 Número do telefone fixo da testemunha

TelefoneMovelTestemunha Char 1000 Número do telefone móvel da testemunha

EnderecoTestemunha Char 8000 Endereço da testemunha

(12)

Protocolo Char 20 Número de protocolo da consulta

Saldo Decimal 13,2 Saldo só deve ser considerado para contratos Pré-pago

2.3.2 Exemplos de retorno: caso de sucesso

Exemplos de XML de retorno para consultas realizadas com sucesso.

<EBRAT>

<LocalOcorrencia>Numa via urbana</LocalOcorrencia>

<EspecificacaoLocal>Numa via de mão dupla</EspecificacaoLocal>

<Bairro>centro</Bairro>

<Cidade>itaborai</Cidade>

<PontoReferencia>esquina com 101</PontoReferencia>

</EnderecoOcorrencia>

<Pista>Deficiente</Pista>

<Sinalizacao>Sem Sinalização</Sinalizacao>

</Condicoes>

<TipoAcidente>Colisão</TipoAcidente>

<TipoVeiculo>Principal</TipoVeiculo>

<MarcaModelo>MARCA/MODELO</MarcaModelo>

<Cor>PRATA</Cor>

<Danos>

</Danos>

<NomeMotorista>NOME DO MOTORISTA</NomeMotorista>

<EstadoCivilMotorista>Solteiro(a)</EstadoCivilMotorista>

<DataNascimentoMotorista>16/08/1950

</DataNascimentoMotorista>

(13)

<TipoMotorista>Proprietário</TipoMotorista>

<Logradouro>Rua Constantina</Logradouro>

<Bairro>João Caetano (Itambi)</Bairro>

<Cidade>Itaboraí</Cidade>

</EnderecoMotorista>

</Motorista>

</Motoristas>

</Veiculo>

<TipoVeiculo>Envolvido</TipoVeiculo>

<Cor>branco</Cor>

<NomeMotorista>viação</NomeMotorista>

<TipoMotorista>Condutor</TipoMotorista>

<Cep />

<Logradouro>avenida</Logradouro>

<Bairro>BAIRRO</Bairro>

<Cidade>CIDADE</Cidade>

</EnderecoMotorista>

</Motorista>

</Motoristas>

</Veiculo>

</Veiculos>

<NomeTestemunha>NOME DA TESTEMUNHA</NomeTestemunha>

<EnderecoTestemunha>rua ABC numero 123, bairro</EnderecoTestemunha>

</Testemunha>

</Testemunhas>

<Descricao>O ônibus seguia pela rua 100 e eu condutor seguia no mesmo sentido, quando ao chegar na esquina da rua 101 parou para descer passageiros, e então engatou a marcha ré e bateu na veículo.</Descricao>

<Email>ricardofiuza007@ibest.com.br</Email>

(14)

</EBRAT>

</consulta>

2.3.3 Informações de retorno: caso de erro

Informações detalhadas de retorno para consultas realizadas com erro.

2.3.3.1 Parâmetros de retorno: caso de erro

Retorno Usuário ou Senha Inválido

Parâmetro inválido

Não há retorno para esta consulta

Sua consulta não foi realizada, entre em contato com o suporte Cliente não possui permissão para o método

Acesso não permitido para o IP Cliente não possui crédito disponível

Cliente já utilizou todas as consultas do Contrato de Experiência de Uso para esse método Contrato inativo ou fora do período de vigência

Método inválido Produto inválido

Produto em desenvolvimento

2.3.3.2 Exemplo de retorno: caso de erro

<?xml version="1.0" encoding="UTF-8"?>

<consulta>

<

^EBRAT

>

<retorno>Parametro invalido</retorno>

<saldo>0,00</saldo>

<protocolo>981327318291327091236</protocolo>

</

EBRAT

>

</consulta>

2.4 Parâmetros de entrada das consultas 2.4.1 Consulta por Dados do Acidente

Parâmetro Tipo Tamanho Obrigatório Observações

IdUsuario Varchar 255 Sim Informar Login do Usuário

Senha Varchar 255 Sim Informar Senha do Usuário

Placa Varchar 7 Não* Informar Placa para consulta

Chassi Varchar 21 Não* Informar Chassi para consulta

CNPJ/CPF Varchar 11/14 Não* Informar CPF/CNPJ para consulta

Datas Varchar 10 Não Informar Data da ocorrência

Tipo De Veículo Varchar 255 Não Informar se o veículo é o principal ou

(15)

envolvido. Preencher com:

- Principal - Envolvido

*Campos não são obrigatórios, mas ao menos um deles deve ser preenchido.

2.4.2 Consulta por Protocolo

Parâmetro Tipo Tamanho Obrigatório Observações

IdUsuario Varchar 255 Sim Informar Login do Usuário

Senha Varchar 255 Sim Informar Senha do Usuário

Protocolo Varchar 20 Sim Informar Protocolo do Brat

para consulta