RENAVAM - BIN FABRIL. Manual do Produto Versão 2.5

(1)

RENAVAM - BIN FABRIL

Manual do Produto

Versão 2.5

(2)

Índice

1. INFORMAÇÕES GERAIS SOBRE O SERVIÇO ... 4

1.1 CONTEXTO ... 4

1.2 OBJETIVO ... 4

1.3 NOME ... 4

1.4 ENDEREÇO DO ARQUIVO WSDL ... 4

1.5 REQUISITOS E ORIENTAÇÕES PARA O ACESSO ... 4

2. INFORMAÇÕES DETALHADAS DO SERVIÇO ... 5

2.1 ACESSO VIA BROWSER ... 5

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

2.1.2 Telas ... 5

2.1.2.1 Consulta por Placa ... 6

2.1.2.2 Consulta por Chassi ... 6

2.1.2.3 Consulta por Motor... 7

2.1.2.4 Consulta por Caixa de Câmbio ... 7

2.1.2.5 Consulta por Proprietário ... 8

2.1.2.6 Consulta por Renavam ... 8

2.1.2.7 Consulta Chassi e Proprietário ... 9

2.1.2.8 Consulta por Chassi e Proprietário Detalhamento ... 9

2.1.2.9 Consulta Placa e Proprietário ... 10

2.1.3 Exemplos ... 10

2.1.3.1 Exemplo de consultas realizadas com sucesso ... 10

2.1.3.1.1 Consulta por Placa ... 10

2.1.3.1.2 Consulta por Chassi com mais de 1 ocorrência... 12

2.1.3.1.3 Consulta por Motor com mais de 1 ocorrência ... 12

2.1.3.1.4 Consulta por Caixa de Câmbio com mais de uma ocorrência ... 13

2.1.3.1.5 Consulta por Chassi com apenas 1 ocorrência, Consulta por Motor com apenas 1 ocorrência, Consulta por Caixa de Câmbio com apenas 1 ocorrência e Consulta por Renavam com apenas 1 ocorrência ... 13

2.1.3.1.6 Consulta por Proprietário com menos de 4 ocorrências ... 16

2.1.3.1.7 Consulta por Proprietário com mais de 4 ocorrências ... 16

2.1.3.1.8 Consulta por Renavam com mais de 1 ocorrência ... 16

2.1.3.1.9 Consulta por Chassi e Proprietário ... 17

2.1.3.1.10 Consulta por Chassi e Proprietário Detalhado ... 17

2.1.3.1.11 Consulta por Placa e Proprietário ... 17

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

2.1.3.2.1 Parâmetro Inválido ... 17

2.1.4 Possíveis retornos com erro na consulta ... 18

2.1.4.1 Retornos Específicos ... 18

2.1.4.2 Retornos Gerais ... 18

2.2 ACESSO WEBSERVICE ... 19

2.2.1 Nome das consultas do serviço ... 19

2.3 INFORMAÇÕES SOBRE O RETORNO DAS CONSULTAS ... 20

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

2.3.1.1 Estrutura dos Dados ... 20

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

2.3.2.1 Consulta por Placa, Consulta por Chassi Detalhamento, Consulta por Chassi com apenas 1 ocorrência, Consulta por Motor Detalhamento, Consulta por Motor com apenas 1 ocorrência, Consulta por Caixa de Câmbio Detalhamento, Consulta por Caixa de Câmbio com apenas 1 ocorrência, Consulta por Renavam Detalhamento e Consulta por Renavam com apenas 1 ocorrência 27 2.3.2.2 Consulta por Chassi com mais de 1 ocorrência ... 28

2.3.2.3 Consulta por Motor com mais de 1 ocorrência ... 29

2.3.2.4 Consulta por Caixa de Câmbio com mais de 1 ocorrência ... 30

2.3.2.5 Consulta por Proprietário com menos de 4 ocorrências ... 30

2.3.2.6 Consulta por Proprietário com mais de 4 ocorrências ... 31

2.3.2.7 Consulta por Renavam com mais de 1 ocorrência ... 32

2.3.2.8 Consulta por Chassi e Proprietário com mais de 1 ocorrência ... 33

2.3.2.9 Consulta por Chassi e Proprietário Detalhamento, Consulta por Chassi e Proprietário com apenas 1 ocorrência e Consulta por Placa e Proprietário ... 33

(3)

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

2.3.3.1 Exemplo de retorno: caso de erro ... 35

2.3.4 Possíveis retornos na consulta: ... 35

2.4 PARÂMETROS DE ENTRADA DAS CONSULTAS ... 36

2.4.1 Consulta por Placa ... 36

2.4.2 Consulta por Chassi ... 36

2.4.3 Consulta por Chassi Detalhamento ... 36

2.4.4 Consulta por Motor... 36

2.4.5 Consulta por Motor Detalhamento ... 37

2.4.6 Consulta por Caixa de Câmbio ... 37

2.4.7 Consulta por Caixa de Câmbio Detalhamento ... 37

2.4.8 Consulta por Proprietário ... 37

2.4.9 Consulta por Proprietário Detalhamento ... 38

2.4.10 Consulta por Renavam ... 38

2.4.11 Consulta por Renavam Detalhamento ... 38

2.4.12 Consulta por Chassi e Proprietário ... 38

2.4.13 Consulta por Chassi e Proprietário Detalhamento ... 38

2.4.14 Consulta por Placa e Proprietário ... 39

2.5 CONSULTA EM LOTE ... 39

2.5.1 Contexto ... 39

2.5.2 Objetivo ... 39

2.5.3 Consulta em Lote ... 39

2.5.4 Considerações gerais sobre parâmetros de entrada e/ou saída ... 40

2.5.5 Arquivo(s) de entrada ... 40

2.5.6 Arquivo(s) de saída ... 42

(4)

1. Informações gerais sobre o serviço

1.1 Contexto

Sistema que possibilita consulta à base de dados do DENATRAN sobre as características técnicas e construtivas de todos os veículos do Brasil, de fabricação nacional ou importados.

1.2 Objetivo

O sistema permite consultas tais como: Chassi, placa, UF, CNPJ ou CPF do Proprietário, RENAVAM, Município de licenciamento, marca/modelo, tipo de veículo, espécie de veículo, combustível, quantidade de passageiros, nº do motor, ano de fabricação, ano do modelo, nº da caixa de câmbio, potência do motor, cor, procedência (nacional ou importado) e eventuais restrições, como por exemplo, se existe alguma restrição judicial, aviso de roubo e furto.

1.3 Nome

RENAVAM BIN FABRIL – Registro Nacional de Veículos Automotores – Base Integrada Nacional Fabril

1.4 Endereço do arquivo WSDL

 Homologação: https://binfabril-hmlg.cnseg.org.br/consultarenavam/service.asmx?wsdl

 Produção: https://binfabril.cnseg.org.br/consultarenavam/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.

(5)

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: https://centraldeservicos-hmlg.cnseg.org.br/

 Produção: https://centraldeservicos.cnseg.org.br/

2.1.2 Telas

(6)

2.1.2.1 Consulta por Placa

2.1.2.2 Consulta por Chassi

(7)

2.1.2.3 Consulta por Motor

2.1.2.4 Consulta por Caixa de Câmbio

(8)

2.1.2.5 Consulta por Proprietário

2.1.2.6 Consulta por Renavam

(9)

2.1.2.7 Consulta Chassi e Proprietário

2.1.2.8 Consulta por Chassi e Proprietário Detalhamento

(10)

2.1.2.9 Consulta Placa e Proprietário

2.1.3 Exemplos

2.1.3.1 Exemplo de consultas realizadas com sucesso

2.1.3.1.1 Consulta por Placa

(11)

(12)

2.1.3.1.2 Consulta por Chassi com mais de 1 ocorrência Nesse caso, o resultado da consulta é apresentado em 2 passos.

1º Passo: Listagem com todas as ocorrências resumidas.

2º Passo: Ao clicar sobre o chassi do veículo, outra consulta é realizada a partir dos dados resumidos para detalhar a informação do registro que foi clicado, conforme imagem presente na seção 2.1.3.1.5.

2.1.3.1.3 Consulta por Motor com mais de 1 ocorrência Nesse caso, o resultado da consulta é apresentado em 2 passos.

1º Passo: Listagem com todas as ocorrências resumidas.

(13)

2º Passo: Ao clicar sobre o número do motor do veículo, outra consulta é realizada a partir dos dados resumidos para detalhar a informação do registro que foi clicado, conforme imagem presente na seção 2.1.3.1.5.

2.1.3.1.4 Consulta por Caixa de Câmbio com mais de uma ocorrência Nesse caso, o resultado da consulta é apresentado em 2 passos.

1º Passo: Listagem com todas as ocorrências resumidas.

2º Passo: Ao clicar sobre o número da caixa de câmbio do veículo, outra consulta é realizada a partir dos dados resumidos para detalhar a informação do registro que foi clicado, conforme imagem presente na seção 2.1.3.1.5.

2.1.3.1.5 Consulta por Chassi com apenas 1 ocorrência, Consulta por Motor com apenas 1

ocorrência, Consulta por Caixa de Câmbio com apenas 1 ocorrência e Consulta por Renavam

com apenas 1 ocorrência

(14)

(15)

(16)

2.1.3.1.6 Consulta por Proprietário com menos de 4 ocorrências

2.1.3.1.7 Consulta por Proprietário com mais de 4 ocorrências Nesse caso, o resultado da consulta é apresentado em 2 passos.

1º Passo: Listagem com todas ocorrências.

2º Passo: Ao clicar sobre o número do documento do proprietário do veículo, a ocorrência é detalhada, conforme imagem presente na seção 2.1.3.1.6.

2.1.3.1.8 Consulta por Renavam com mais de 1 ocorrência Nesse caso, o resultado da consulta é apresentado em 2 passos.

1º Passo: Listagem com todas ocorrências.

(17)

2º Passo: Ao clicar sobre o número RENAVAM do veículo, a ocorrência é detalhada, conforme imagem presente na seção 2.1.3.1.5.

2.1.3.1.9 Consulta por Chassi e Proprietário [Não há XSL para formatar a tela desse método]

2.1.3.1.10 Consulta por Chassi e Proprietário Detalhado [Não há XSL para formatar a tela desse método]

2.1.3.1.11 Consulta por Placa e Proprietário [Não há XSL para formatar a tela desse método]

2.1.3.2 Exemplo de retorno com erro na consulta

2.1.3.2.1 Parâmetro Inválido

(18)

2.1.4 Possíveis retornos com erro na consulta 2.1.4.1 Retornos Específicos

Retorno Descrição

Transação efetuada Indica que a consulta foi realizada com sucesso Campo <nome do campo> fora da especificação de

tamanhos Campo com quantidade de caracteres inválida

Erro na aplicação Indica que ocorreu um erro ao realizar a consulta Nenhum registro encontrado Indica que não foi encontrado nenhum resultado para

os dados informados Existem mais registros do que o previsto para essa

consulta Indica que foram encontrados mais registros que o

esperado para os dados informados Veículo não cadastrado e com ocorrência de

roubo/furto Indica que o veículo não foi cadastrado e possui

ocorrência de roubo/furto

Veículo não cadastrado e com sinalização de alarme Indica que o veículo não foi cadastrado e possui sinalização de alarme

Veículo cadastrado e com sinalização de alarme Indica que o veículo está cadastrado e possui sinalização de alarme

Veículo cadastrado e com ocorrência de roubo/furto Indica que o veículo está cadastrado e possui ocorrência de roubo/furto

Número do documento de identificação do

proprietário inválido Indica que o número informado do documento de identificação do proprietário é inválido

Chassi inválido Indica que o chassi informado é inválido

Código do Renavam inválido Indica que o código do renavam informado é inválido UF Jurisdição inválida Indica que a UF de jurisdição informada é inválida

Placa inválida Indica que a placa informada é inválida

Não foi possível conexão com a UF de origem Indica que não foi possível realizar a conexão com a UF de origem

Código órgão de Segurança Invalido Indica que o código de segurança informado é inválido

UF Boletim ocorrência invalido Indica que a UF do boletim de ocorrência informada é inválida

Número do boletim de ocorrência invalido Indica que o número do boletim de ocorrência informado é inválido

Ano boletim ocorrência invalido Indica que o ano do boletim de ocorrência informado é inválido

Categoria da ocorrência invalido Indica que a categoria da ocorrência informado é inválido

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

(19)

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

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á crédito 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.

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 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 Placa ConsultaSerpro902

Consulta por Chassi ConsultaSerpro901

Consulta por Chassi Detalhamento ConsultaSerpro901Env2

Consulta por Motor ConsultaSerpro903

Consulta por Motor Detalhamento ConsultaSerpro903Env2

Consulta por Caixa de Câmbio ConsultaSerpro904

Consulta por Caixa de Câmbio Detalhamento ConsultaSerpro904Env2

Consulta por Proprietário ConsultaSerpro910

Consulta por Proprietário Detalhamento ConsultaSerpro910Env2

Consulta por Renavam ConsultaSerpro913

Consulta por Renavam Detalhamento ConsultaSerpro913Env2

Consulta Chassi e Proprietário ConsultaSerpro943

Consulta por Chassi e Proprietário Detalhamento ConsultaSerpro943Env2

Consulta Placa e Proprietário ConsultaSerpro944

(20)

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 BDRF realizadas com sucesso.

2.3.1.1 Estrutura dos Dados

Nome do Campo Tipo Tamanho Descrição do Campo

codmetodo Char 10 Código do método utilizado na consulta

nomemetodo Char 50 Nome do método utilizado na consulta

codret Char 3 Código do retorno

Mensagem Char 50 Mensagem de retorno, podendo ser:

001 - Nenhum registro encontrado

003 - Existem mais registros do que o previsto para essa consulta

017 - Veículo não cadastrado e com ocorrência de roubo/furto

018 - Veículo não cadastrado e com sinalização de alarme

019 - Veiculo cadastrado e com sinalização de alarme 048 - Veículo cadastrado e com ocorrência de roubo/furto

054 - Número do documento de identificação do proprietário inválido

055 - Chassi inválido

065 - Código do Renavam inválido 075 - UF Jurisdição inválida 076 - Placa inválida

077 - Chassi invalido

085 - Não foi possível conexão com a UF de origem 087 - Código órgão de Segurança Invalido

088 - UF Boletim ocorrência invalido

089 - Número do boletim de ocorrência invalido 090 - Ano boletim ocorrência invalido

096 - Categoria da ocorrência invalido

ufJurisdicao Char 2 UF onde o veículo foi emplacado

chassi Char 21 Chassi do veículo

placa Char 7 Placa do veículo

placaunica Char 7 Placa do veículo

renavam Char 9 RENAVAM do veículo

codrenavam Char 9 RENAVAM do veículo

situacao Char 10 Situação atual do veículo

(21)

tipodoccprop Char 1 Tipo do documento do proprietário do veículo Identpropri Char 14 Identificação do proprietário do veículo

qtdeocorrencias Char 2 É apresentado apenas nas consultas que podemos retornar mais de 1 veículo

codqtdocorrencias Char 2 É apresentado apenas nas consultas que podemos retornar mais de 1 veículo

qtdocorrencias Char 2 É apresentado apenas nas consultas que podemos retornar mais de 1 veículo

codmunicipio Char 4 Código do município de emplacamento do veículo

nomecidade Char 2 Nome do município de emplacamento do veiculo

tiporemarcacao Char 1 Informa se o veículo possui chassi remarcado 1 – REGRAVADO

2 - NORMAL

tipomontagem Char 13 Tipo de montagem

codtipoveiculo Char 2 Código do tipo do veículo

nometipoveiculo Char 100 Nome do tipo do veículo, podendo ser:

1 - Bicicleta 2 - Ciclomotor 3 - Motoneta 4 - Motocicleta 5 - Triciclo 6 - Automovel 7 - Microonibus 8 - Onibus 9 - Bonde 10 - Reboque 11 - Semi reboque 12 - Charrete 13 - Camioneta 14 - Caminhao 15 - Carroca 16 - Carro de mao 17 - Caminhao trator 18 - Trator de rodas 19 - Trator de esteiras 20 - Trator misto 21 - Quadriciclo 22 - Chassi plataforma 23 - Caminhonete 24 - Side car 25 - Utilitario

codmodelo Char 6 Código da marca/modelo do veículo

marcamodelo Char 50 Descrição da marca/modelo do veículo

codespecie Char 1 Código da espécie do veículo

nomeespecie Char 50 Descrição da espécie do veículo, podendo ser

(22)

2 - CARGA 3 - MISTO

4 - CORRIDA 5 - TRACAO 6 - ESPECIAL 7 - COLECAO 8 – NULL

tipocarroceria Char 3 Código do tipo da carroceria do veículo codcarroceria Char 3 Código do tipo da carroceria do veículo

nomecarroceria Char 50 Descrição do tipo de carroceria do veículo, podendo ser:

0 - NAO INFORMADO 101 - AMBULANCIA 102 - BASCULANTE 103 - BLINDADA 104 - BOMBEIRO 105 - BUGGY 106 - CABINE DUPLA 107 - CARROCERIA ABERTA 108 - CARROCERIA FECHADA 109 - CHASSI PORTA CONTEINER 110 - CONVERSIVEL 111 - FUNERAL 112 - FURGAO 113 - JIPE

114 - KIT MOTOCICLETA/TRICICLO 115 - LIMUSINE

116 - MECANISMO OPERACIONAL 117 - MOTOR CASA

118 - PRANCHA

119 - SIDE CAR/INTERCAMBIAVEL 120 - SILO

121 - TANQUE 122 - TRAILER 123 - TRANSPORTE MILITAR 124 - TRANSPORTE DE PRESOS 125 - TRANSPORTE RECREATIVO 126 - TRANSPORTE TRABALHADORES 127 - PR.P.CONTEINER CONV.P/C.ABERTA 128 - PRANCHA PORTA CONTEINER 129 - CABINE ESTENDIDA 130 - TRIO ELETRICO 131 - DOLLY 132 - INTERCAMBI_VEL 133 - ROLLON ROLLOFF 134 - ABERTA/CABINE DUPLA 135 - ABERTA/CABINE ESTENDIDA 136 - ABERTA/CABINE SUPLEMENTAR

(23)

137 - FECHADA/CABINE DUPLA 138 - FECHADA/CABINE ESTENDIDA 139 - FECHADA/CABINE SUPLEMENTAR 140 - ABERTA/INTERCAMBIAVEL 141 - CABINE DUPLA/INACABADA 142 - MECANISMO OPERACIONAL/CAB/DUPL 143 - TRANSPORTE TORAS/MADEIRA BRUTA 144 - INACABADA/CABINE ESTENDIDA 145 - ABERTA/MECANISMO OPERACIONAL 146 - FECHADA/MECANISMO OPERACIONAL 147 - TANQUE/MECANISMO OPERACIONAL 148 - PRANCHA/MECANISMO OPERACIONAL 149 - ABERTA/MEC OPERACIONAL/C DUPLA 150 - ABERTA/MEC OPERACIONAL/C ESTEN 151 - ABERTA/MEC OPERACIONAL/C SUPL 152 - FECHADA/MEC OPERACIONAL/C DUPL 153 - FECHADA/MEC OPERACIONAL/C EST 154 - FECHADA/MEC OPERACIONAL/C SUP 155 - TANQUE/CABINE DUPLA 156 - TANQUE/CABINE ESTENDIDA 157 - TANQUE/CABINE SUPLEMENTAR 158 - TANQUE/MEC OPERACIONAL/C DUPLA 159 - TANQUE/MEC OPERACIONAL/C EST 160 - TANQUE/MEC OPERACIONAL/C SUPL 161 - ROLLON ROLLOFF/CABINE DUPLA 162 - ROLLON ROLLOFF/C ESTENDIDA 163 - ROLLON ROLLOFF/C SUPLEMENTAR 164 - BASCULANTE/CABINE DUPLA 165 - BASCULANTE/CABINE ESTENDIDA 166 - BASCULANTE/CABINE SUPLEMENTAR 167 - PRANCHA/CABINE DUPLA 168 - PRANCHA/CABINE ESTENDIDA 169 - PRANCHA/CABINE SUPL 170 - PRANCHA/MEC OPERAC/C DUPLA 171 - PRANCHA/MEC OPERAC/C ESTENDIDA 172 - PRANCHA/MEC OPERAC/C SUPLEMENT 173 - ABERTA/INTERCAMBIAVEL/CAB DUPL 174 - ABERTA/INTERCAMBIAVEL/CAB EST 175 - ABERTA/INTERCAMBIAVEL/CAB SUP 176 - ABERTA/CABINE TRIPLA 177 - FECHADA/CABINE TRIPLA 178 - COM_RCIO 179 - TRANSP GRANITO 180 - SILO/BASCULANTE

181 - BASCULANTE/MEC OPERACIONAL 182 - CHASSI CTEINER/CAB ESTENDIDA 183 - MEC OPERAC/C ESTENDIDA

(24)

186 - PRANCHA CONTEINER/C ESTENDIDA 187 - TRANSP DE TORAS/C ESTENDIDA 188 - SILO/BASCULANTE/C ESTENDIDA 999 - N_O APLICAVEL

codcor Char 2 Código da cor do veículo

nomecor Char 100 Descrição da cor do veículo, podendo ser:

0 - NAO INFORMADO 1 - AMARELA

2 - AZUL 3 - BEGE 4 - BRANCA 5 - CINZA 6 - DOURADA 7 - GRENA 8 - LARANJA 9 - MARROM 10 - PRATA 11 - PRETA 12 - ROSA 13 - ROXA 14 - VERDE 15 - VERMELHA 16 - FANTASIA

99 - NAO INFORMADO

anomodelo Char 4 Ano do modelo do veículo

anofabricacao Char 4 Ano de fabricação do veículo

anofabricao Char 4 Ano de fabricação do veículo

potencia Char 3 Potência do veículo, em cv.

cilindradas Char 4 Cilindrada do motor do veículo, em cm³

codcombustivel Char 2 Código do tipo de combustível utilizado pelo veículo nomecombustivel Char 50 Descrição do tipo de combustível utilizado pelo veículo,

podendo ser:

0 - NAO INFORMADO 1 - ALCOOL

2 - GASOLINA 3 - DIESEL 4 - GASOGENIO 5 - GAS METANO

6 - ELETRICO/FONTE INTERNA 7 - ELETRICO/FONTE EXTERNA

8 - GASOL/GAS NATURAL COMBUSTIVEL 9 - ALCOOL/GAS NATURAL COMBUSTIVEL 10 - DIESEL/GAS NATURAL COMBUSTIVEL 11 - VIDE/CAMPO/OBSERVACAO

12 - ALCOOL/GAS NATURAL VEICULAR 13 - GASOLINA/GAS NATURAL VEICULAR 14 - DIESEL/GAS NATURAL VEICULAR 15 - GAS NATURAL VEICULAR

(25)

16 - ALCOOL/GASOLINA

17 - GASOLINA/ALCOOL/GAS NATURAL 18 - GASOLINA/ELETRICO

nummotor Char 21 Número do motor do veículo

cmtveiculo Char 5 Capacidade máxima de tração do veículo, em Kg.

pbtveiculo Char 5 Peso bruto total do veículo, em Kg

capacidadecarga Char 5 Capacidade de carga do veículo, em Kg.

procedencia Char 11 Procedência do veículo

caixacambio Char 21 Número da caixa de câmbio do veículo

cxcambio Char 21 Número da caixa de câmbio do veículo

tipodocprop Char 1 Tipo do documento de identificação do proprietário identpropri Char 14 Número do documento de identificação do proprietário numidentprop Char 14 Número do documento de identificação do proprietário codidentprop Char 14 Número do documento de identificação do proprietário numcarroceria Char 21 Número da carroceria informado pelo fabricante

cappassageiro Char 3 Quantidade máxima de possíveis passageiros no veículo codrestricao1 Char 2 Código de restrição junto aos órgãos competentes nomerestricao1 Char 50 Descrição da restrição junto aos órgãos competentes,

podendo ser:

00 - SEM RESTRICAO 01 - ARRENDAMENTO 02 - RESERVA DE DOMINIO 03 - ALIENACAO FIDUCIARIA 04 - RESTRICAO JUDICIAL 05 - REST. ADMINISTRATIVA 06 - REST. P/ ROUBO/FURTO 07 - REST. BEN.TRIBUTARIO 08 - BAIXA ALIE P/ORD JUD 09 - PENHOR DE VEICULO

codrestricao2 Char 2 Código de restrição junto aos órgãos competentes nomerestricao2 Char 50 Descrição da restrição junto aos órgãos competentes,

podendo ser:

(26)

01 - ARRENDAMENTO 02 - RESERVA DE DOMINIO 03 - ALIENACAO FIDUCIARIA 04 - RESTRICAO JUDICIAL 05 - REST. ADMINISTRATIVA 06 - REST. P/ ROUBO/FURTO 07 - REST. BEN.TRIBUTARIO 08 - BAIXA ALIE P/ORD JUD 09 - PENHOR DE VEICULO

podendo ser:

numeroeixo Char 2 Quantidade de eixos do veículo

numeixotraseiro Char 21 Número do eixo traseiro informado pelo fabricante numeixoauxiliar Char 21 Número do eixo auxiliar informado pelo fabricante tipodocimportador Char 1 Tipo do documento do importador do veículo identimportador Char 14 Número do documento do importador do veículo codorgaosrf Char 7 Código do órgão da Secretaria de Receita federal (SRF)

que liberou a importação do veículo estrangeiro.

numeroreda Char 5 Número de despacho aduaneiro que permitiu a

importação de um veículo sob regime especial.

numerodi Char 10 Número da declaração de importação de um veículo.

dataregistrodi Char 8 Data de registro da declaração de importação de um veículo

docfaturado Char 1 Tipo do documento de quem realizou o faturamento do veículo

identfaturado Char 14 Identificação do quem realizou o faturamento do veículo

ufdestfaturado Char 2 UF onde foi realizado o faturamento do veículo datalimiteresttrib Char 8 Data limite para restituição dos tributos

dataultimaatualiza Char 8 Data de última atualização das informações do veículo tipoopimportacao Char 2 Tipo da operação de importação do veículo

numprocimportacao Char 15 Número do processo de importação do veículo datatransfpais Char 8 Data de Transferência para o país

codpaistrans Char 5 Código do país para o qual o veículo está sendo transferido.

(27)

indicadormultaRENAINF Char 1 indicadorcomunicavenda Char 1

indicadorpendemissao Char 1

indicadorrestRENAJUD Char 1

indicadorocorrerecall1 Char 2 indicadorocorrerecall2 Char 2 indicadorocorrerecall3 Char 2 indicadorocorrerecall4 Char 2

codigocatveicMRE Char 2

tipodocpropriMRE Char 1

numerodocpropriMRE Char 14

dataultimaatualizaMRE Char 8

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.

2.3.2.1 Consulta por Placa, Consulta por Chassi Detalhamento, Consulta por Chassi com apenas 1 ocorrência, Consulta por Motor Detalhamento, Consulta por Motor com apenas 1 ocorrência, Consulta por Caixa de Câmbio Detalhamento, Consulta por Caixa de Câmbio com apenas 1 ocorrência, Consulta por Renavam Detalhamento e Consulta por Renavam com apenas 1 ocorrência

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

<nomemetodo>Consulta por Placa</nomemetodo>

<mensagem>Transação efetuada</mensagem>

<situacao>CIRCULACAO</situacao>

<nomecidade>RIO DE JANEIRO</nomecidade>

<tipomontagem>COMPLETA</tipomontagem>

<nometipoveiculo>NAO INFORMADO</nometipoveiculo>

<nomeespecie>PASSAGEIRO</nomeespecie>

<nomecarroceria>N_O APLICAVEL</nomecarroceria>

(28)

<nomecombustivel>ALCOOL/GASOLINA</nomecombustivel>

<procedencia>NACIONAL</procedencia>

<nomerestricao1>ALIENACAO FIDUCIARIA</nomerestricao1>

<nomerestricao2>SEM RESTRICAO</nomerestricao2>

</registro>

</consulta>

2.3.2.2 Consulta por Chassi com mais de 1 ocorrência

(29)

<nomemetodo>Consulta por Chassi</nomemetodo>

</registro>

<nomemetodo>Consulta por Chassi</nomemetodo>

</registro>

</consulta>

2.3.2.3 Consulta por Motor com mais de 1 ocorrência

<nomemetodo>Consulta por Motor</nomemetodo>

</registro>

<nomemetodo>Consulta por Motor</nomemetodo>

(30)

</registro>

</consulta>

2.3.2.4 Consulta por Caixa de Câmbio com mais de 1 ocorrência

<nomemetodo>Consulta por Caixa de Câmbio</nomemetodo>

</registro>

<nomemetodo>Consulta por Caixa de Câmbio</nomemetodo>

</registro>

</consulta>

2.3.2.5 Consulta por Proprietário com menos de 4 ocorrências

<nomemetodo>Consulta por Proprietário</nomemetodo>

(31)

</registro>

</consulta>

2.3.2.6 Consulta por Proprietário com mais de 4 ocorrências

<marcamodelo>GM/CORSA HATCH MAXX</marcamodelo>

<nomecor>PRETA</nomecor>

</registro>

</registro>

(32)

</registro>

</registro>

</registro>

</consulta>

2.3.2.7 Consulta por Renavam com mais de 1 ocorrência

<nomemetodo>Consulta por Renavam</nomemetodo>

(33)

</registro>

<nomemetodo>Consulta por Renavam</nomemetodo>

</registro>

</consulta>

2.3.2.8 Consulta por Chassi e Proprietário com mais de 1 ocorrência

<nomemetodo>Consulta por Chassi e CPF/CNPJ</nomemetodo>

</registro>

</consulta>

2.3.2.9 Consulta por Chassi e Proprietário Detalhamento, Consulta por Chassi e Proprietário com apenas 1 ocorrência e Consulta por Placa e Proprietário

<nomemetodo>Consulta por Chassi e CPF/CNPJ</nomemetodo>

(34)

<nomecidade>RIO DE JANEIRO</nomecidade>

<tipomontagem>COMPLETA</tipomontagem>

<nometipoveiculo>NAO INFORMADO</nometipoveiculo>

<nomeespecie>PASSAGEIRO</nomeespecie>

<nomecarroceria>N_O APLICAVEL</nomecarroceria>

<nomecor>NAO INFORMADO</nomecor>

<nomecombustivel>ALCOOL/GASOLINA</nomecombustivel>

<procedencia>NACIONAL</procedencia>

<nomerestricao1>ALIENACAO FIDUCIARIA</nomerestricao1>

(35)

</registro>

</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 Exemplo de retorno: caso de erro

<nomemetodo>Consulta por Placa</nomemetodo>

<mensagem>Parâmetro inválido </mensagem>

</registro>

</consulta>

2.3.4 Possíveis retornos na consulta:

Código Retorno Retorno

000 Transação efetuada com sucesso 001 Nenhum registro encontrado

003 Existem mais registros do que o previsto para essa consulta 017 Veículo não cadastrado e com ocorrência de roubo/furto 018 Veículo não cadastrado e com sinalização de alarme 019 Veículo cadastrado e com sinalização de alarme 048 Veículo cadastrado e com ocorrência de roubo/furto

054 Número do documento de identificação do proprietário inválido 065 Código do Renavam inválido

075 UF Jurisdição inválida

076 Placa inválida

077 Chassi inválido

085 Não foi possível conexão com a UF de origem 087 Código órgão de Segurança Invalido

088 UF Boletim ocorrência invalido

089 Número do boletim de ocorrência invalido 090 Ano boletim ocorrência invalido

096 Categoria da ocorrência invalido ERR Acesso não permitido para o IP

ERR Campo <nome do campo> fora da especificação de tamanhos

(36)

ERR Cliente não possui crédito disponível

ERR Cliente não possui permissão para o método ERR Contrato inativo ou fora do período de vigência

ERR Erro na aplicação

ERR Método inválido

ERR Não há retorno para esta consulta

ERR Parâmetro inválido

ERR Produto em desenvolvimento

ERR Produto inválido

ERR Sua consulta não foi realizada, entre em contato com o suporte ERR Usuário ou Senha Inválido

2.4 Parâmetros de entrada das consultas

2.4.1 Consulta por Placa

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

IdPlaca Varchar 7 Sim Placa para consulta

2.4.2 Consulta por Chassi

IdChassi Varchar 21 Sim Chassi para consulta

2.4.3 Consulta por Chassi Detalhamento

IdUfJurisdicao Varchar 2 Sim UF para consulta

IdMarcaModelo Varchar 25 Sim Marca/Modelo para consulta

IdAnoFabricacao Varchar 4 Sim Ano de Fabricação para consulta

IdRenavam Varchar 11 Sim Renavam para consulta

2.4.4 Consulta por Motor

(37)

Senha Varchar 255 Sim Informar Senha do Usuário

IdMotor Varchar 21 Sim Motor para consulta

2.4.5 Consulta por Motor Detalhamento

idNumMotor Varchar 21 Sim Motor para consulta

idCodMarcaModelo Varchar 25 Sim Marca/Modelo para consulta

2.4.6 Consulta por Caixa de Câmbio

IdCxCambio Varchar 21 Sim Caixa de Câmbio para consulta

2.4.7 Consulta por Caixa de Câmbio Detalhamento

IdCxCambio Varchar 21 Sim Caixa de Câmbio para consulta

2.4.8 Consulta por Proprietário

IdProprietario Varchar 14 Sim Proprietário para consulta

(38)

2.4.9 Consulta por Proprietário Detalhamento

2.4.10 Consulta por Renavam

2.4.11 Consulta por Renavam Detalhamento

2.4.12 Consulta por Chassi e Proprietário

2.4.13 Consulta por Chassi e Proprietário Detalhamento

(39)

IdMarcaModelo Varchar 25 Sim Marca/Modelo para consulta

IdDocProprietario Varchar 14 Sim Proprietário para consulta

2.4.14 Consulta por Placa e Proprietário

2.5 Consulta em Lote

2.5.1 Contexto

A Consulta em Lote armazena em arquivo único o resultado obtido de um montante de consultas feitas ao Portal de Serviços e Soluções.

2.5.2 Objetivo

Disponibilizar resultado de consultas sequenciais feitas ao Portal de Serviços e Soluções em arquivo consolidado.

2.5.3 Consulta em Lote

O Módulo pode ser acessado seguindo os seguintes passos:

 Efetuar Log In no Portal de Serviços e Soluções

 Acessar a opção de menu superior “Lote”

 Acessar a opção de menu lateral “Consulta em lote”

Caso o objetivo seja consultar o resultado de um Lote, seguir os seguintes passos:

 Efetuar Log In no Portal de Serviços e Soluções (Caso ainda não esteja logado).

 Acessar a opção de menu superior “Lote”

 Acessar a opção de menu lateral “Pesquisar em lote”

(40)

2.5.4 Considerações gerais sobre parâmetros de entrada e/ou saída Restrições:

 O Arquivo de entrada não pode ter mais do que 100.000 Linhas.

 O Arquivo de entrada deve ter o formato CSV ou TXT

 O Arquivo de entrada deve ter apenas um parâmetro por linha (salvo quando a consulta exige mais parâmetros de entrada. Neste caso, os parâmetros devem ser separados por “;” “Ponto e Vírgula”).

2.5.5 Arquivo(s) de entrada

Todo arquivo de entrada deve ter por padrão, apenas um parâmetro por linha.

Ex.:

Nome do arquivo → xxxxxxxxxx.txt ou yyyyyyyyyyy.csv

KYT6013 KQL1309 LJB5663

Em caso de utilizar os dois parâmetros:

KYT6013;9BFZF55P8B8139022 LJB5663; 9BGTB11NNNC146085

Após a última linha do arquivo, tanto no Excel quanto no .TXT, não pode conter ENTER, senão,

será considerada como uma nova linha e o sistema sinalizará como inconsistência na

quantidade de linhas informadas.

(41)

No produto RENAVAM BIN FABRIL, as consultas podem ser por placa (como mostrado no exemplo) ou por chassi.

Verificar se a informação de número de linhas está correta, selecionar a opção “de acordo” e enviar.

Após processado poderá ser realizado o download do arquivo final.

(42)

Selecionar o link indicado pela seta, onde consta o protocolo do arquivo enviado.

Realizar o download do arquivo no local indicado pela seta.

2.5.6 Arquivo(s) de saída

Os arquivos de retorno terão o formato XML. Desta forma, o usuário tem liberdade para trabalhar com o mesmo em várias ferramentas. Excel, Notepad, dentre outros.

Para isto, salve o arquivo final e ao abrir execute os seguintes passos:

1º passo:

(43)

(Obs. Pode ser utilizada qualquer ferramenta de extração de arquivos WinZip, WinRar etc.)

2º passo:

(44)