Vehicle Identification Number

(1)

Vehicle Identification Number VIN

Manual do Produto Versão 2.5

Janeiro/2018

(2)

Índice

1. INFORMAÇÕES GERAIS SOBRE O PRODUTO ... 3

1.1 NOME ... 3

1.2 OBJETIVO ... 3

1.3 CONTEXTO ... 3

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 Chassi ... 5

2.1.2.2 Consulta por Placa ... 6

2.1.3 Exemplos: ... 6

2.1.3.1 Exemplo de consultas realizadas com sucesso ... 6

2.1.3.1.1 Consulta por Chassi; Consulta por Placa ... 6

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

2.1.3.2.1 Parâmetro Inválido ... 8

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

2.1.4.1 Retornos específicos deste produto ... 8

2.1.4.2 Retornos gerais ... 8

2.2 ACESSO WEBSERVICE ... 9

2.2.1 Protocolo de Comunicação ... 9

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

2.3 PARÂMETROS DE ENTRADA DAS CONSULTAS ... 9

2.3.1 Consulta por Chassi ... 9

2.3.2 Consulta por Placa ... 10

2.4 INFORMAÇÕES SOBRE O RETORNO DAS CONSULTAS ... 10

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

2.4.1.1 Estrutura dos Dados ... 10

2.4.2 Exemplos de retorno: caso de sucesso ... 11

2.4.2.1 Exemplo A ... 11

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

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

2.4.3.2 Exemplo de retorno: caso de erro ... 15

(3)

1. Informações gerais sobre o produto

1.1 Nome

Vehicle Identification Number – VIN • Sistema de Decodificação de Chassis

1.2 Objetivo

Decodificar o número do Chassi com intuito de obter informações relacionadas ao veículo e se o mesmo sofreu recall.

1.3 Contexto

A numeração de chassi moderna é chamada de VIN (Vehicle Identification Number). O padrão VIN é um código, podendo ser decodificado.

O sistema de decodificação de chassi do veículo automotor “traduz” os dados contidos na numeração do chassi, apresentando as informações relacionadas às suas características fabris, tais como montadora, marca, modelo, ano de fabricação/modelo, entre outros. Fornece também informações relacionadas à tabela FIPE (código e valor de mercado), imagens da gravação do número do chassi no veículo (no motor, no câmbio ou em outro local) e indica se o veículo está cadastrado na base de dados de Recall.

Benefícios:

√

Obtenção e validação de informações de veículos

√

Identificação de veículos com recall no momento da aceitação do veículo, reduzindo risco de sinistros.

A numeração do chassi é formada por 17 caracteres (a partir de 1981/FIAT, 1983/VW, 1984/FORD e GM) e é dividido em 3 seções:

VIN

WMI VDS VIS

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

(4)

1. WMI (Word Manufacturers Identification): é reservada à identificação do fabricante e seu país de origem.

2. VDS (Vehicle Description Section): fornece informações a respeito das características gerais do veículo, tais como carroceria, n° de portas, versão, motor, etc.

3. VIS (Vehicle Indentification Section): fornece os caracteres que efetivamente distinguem um veículo do outro.

1.4 Endereço do arquivo WSDL

http://vin.cnseg.org.br/consultavin/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.

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.

(5)

2. Informações detalhadas do serviço

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

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

2.1.2 Telas

2.1.2.1 Consulta por Chassi

(6)

2.1.2.2 Consulta por Placa

2.1.3 Exemplos:

2.1.3.1 Exemplo de consultas realizadas com sucesso

2.1.3.1.1

Consulta por Chassi; Consulta por Placa

(7)

(8)

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

Chassi não encontrado

Indica que o chassi informado no parâmetro enviado foi consultado na base de dados, porém não foi localizado, seja devido ao código informado ser inválido, ou devido a realmente não estar cadastrado.

É necessário preencher todos os campos do chassi Indica que o chassi informado no parâmetro enviado contém menos de 17 dígitos, que é o tamanho esperado.

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

(9)

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 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 Chassi consultaChassi

Consulta por Placa consultaPlaca

2.3 Parâmetros de entrada das consultas 2.3.1 Consulta por Chassi

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

Chassi Varchar 21 Sim Informar Chassi para consulta

(10)

2.3.2 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

Placa Varchar 7 Sim Informar Placa para consulta

2.4 Informações sobre o retorno das consultas

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

2.4.1 Parâmetros de retorno: caso de sucesso

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

2.4.1.1 Estrutura dos Dados

Nome do Campo Descrição do Campo

VIN Parte do chassi informado, utilizado na decodificação.

URL_IMAGENS Endereço web disponibilizado com imagens do chassi decodificado DESCRITIVOS

Cd_Descritivo Parte do chassi informado que definiu a informação

Ds_Combinacao Título da parte do item decodificado relacionado à característica de fabricação do veículo. Ex. região geográfica, montadora, modelo, tipo de carroceria, versão, entre outros.

Ds_Descritivo Conteúdo descritivo relativo ao item relacionado à característica de fabricação do veículo. Ex. América do Sul, General Motors, Meriva, Meriva Expression, Monovolume 4P, entre outros.

Nr_Descritivo Código interno do item.

Vl_Inicio Posição inicial da sequência do chassi que define a informação

St_OK Validação do Dígito ou conjunto de dígitos dentro da decodificação. Possíveis retornos:

- True - False

ADICIONAIS

Ds_Tipo_Informacao_Adicional Título da informação adicional do veículo Ds_Informacao Conteúdo descritivo relativo ao item adicional.

Nr_Ordem Ordem de exibição da informação adicional FIPES

Cd_Fipe Código de referência do veículo de acordo com a Fundação Instituto de Pesquisas Econômicas

Dt_Ano_Modelo Ano do modelo do veículo

Id_Combustivel Identificação do tipo de combustível Ds_Combustivel Descrição do combustível do veículo

(11)

Ds_Marca Marca do veículo

Ds_Modelo Modelo do veículo

Vl_Veiculo Valor de mercado do veículo segundo Tabela FIPE RECALLS

Ds_Convocacao Texto da convocação do Recall

Ds_Fonte_Informacao Referência de onde foi coletada a informação do Recall

Ds_Marca Marca do veículo na qual foi identificado problema a ser revisado.

Ds_Modelo Modelo do veículo na qual foi identificado problema a ser revisado.

Ds_Produto Descrição dos veículos envolvidos Cd_Vin_Final Código final do chassi convocado Cd_Vin_Inicial Código inicial do chassi convocado Dt_Ano_Final Ano final de produção do veículo Dt_Ano_Inicial Ano inicial de produção do veículo Cd_Vin_Final Código final do chassi convocado Id_Recall Identificação interna do recall

RECALLS/Sistemas

Ds_Informacao Informação sobre a categoria Sistemas dos veículos nos quais foram identificados problemas a serem revisados.

RECALLS/Componentes

Ds_Informacao Informação sobre a categoria Componentes dos veículos nos quais foram identificados problemas a serem revisados.

RECALLS/Riscos

Ds_Informacao Informação sobre a categoria Riscos identificados a serem revisados RECALLS/Ações

Ds_Informacao Informação sobre a categoria Ações a serem efetuadas para solucionar os problemas identificados

Identificação da Consulta Protocolo Número de protocolo da consulta

Saldo Saldo (só deve ser considerado para contratos Pré-pago)

2.4.2 Exemplos de retorno: caso de sucesso

Exemplos de XML de retorno para consultas realizadas com sucesso.

2.4.2.1 Exemplo A

O exemplo de retorno A se aplica aos métodos:

 Consulta por Chassi

 Consulta por Placa

<VIN>

<VIN>1C4BJWAG1CL</VIN>

(12)

<Cd_Descritivo>1</Cd_Descritivo>

<Ds_Combinacao>REGIÃO GEOGRÁFICA</Ds_Combinacao>

<Ds_Descritivo>AMÉRICA DO NORTE</Ds_Descritivo>

<Nr_Descritivo>8560</Nr_Descritivo>

<St_Ok>True</St_Ok>

<Vl_Inicio>1</Vl_Inicio>

</DESCRITIVO>

<Cd_Descritivo>C</Cd_Descritivo>

<Ds_Combinacao>PAÍS DE ORIGEM</Ds_Combinacao>

<Ds_Descritivo>ESTADOS UNIDOS</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Ds_Combinacao>MONTADORA</Ds_Combinacao>

<Ds_Descritivo>JEEP</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Cd_Descritivo>B</Cd_Descritivo>

<Ds_Combinacao>PESO BRUTO TOTAL</Ds_Combinacao>

<Ds_Descritivo>2.200 A 2.800 KG</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Cd_Descritivo>J</Cd_Descritivo>

<Ds_Combinacao>MODELO</Ds_Combinacao>

<Ds_Descritivo>WRANGLER</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Cd_Descritivo>W</Cd_Descritivo>

<Ds_Combinacao>VERSÃO</Ds_Combinacao>

<Ds_Descritivo>SPORT</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Cd_Descritivo>A</Cd_Descritivo>

<Ds_Combinacao>TIPO DE CARROCERIA</Ds_Combinacao>

<Ds_Descritivo>UTILITARIO ESPORTIVO</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Cd_Descritivo>G</Cd_Descritivo>

<Ds_Combinacao>POTÊNCIA DO MOTOR</Ds_Combinacao>

<Ds_Descritivo>3.6 V6</Ds_Descritivo>

<St_Ok>True</St_Ok>

(13)

</DESCRITIVO>

<Ds_Combinacao>DÍGITO VERIFICADOR</Ds_Combinacao>

<Ds_Descritivo>1</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Cd_Descritivo>C</Cd_Descritivo>

<Ds_Combinacao>ANO MODELO</Ds_Combinacao>

<Ds_Descritivo>2012</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

<Cd_Descritivo>L</Cd_Descritivo>

<Ds_Combinacao>LOCAL DE FABRICAÇÃO</Ds_Combinacao>

<Ds_Descritivo>TOLEDO</Ds_Descritivo>

<St_Ok>True</St_Ok>

</DESCRITIVO>

</DESCRITIVOS>

<FIPES>

<FIPE>

<Cd_Fipe>017029-1</Cd_Fipe>

<Ds_Combustivel>Gasolina</Ds_Combustivel>

<Ds_Marca>VEÍCULOS - JEEP</Ds_Marca>

<Ds_Modelo>WRANGLER SPORT 3.6 V6 284CV 2P</Ds_Modelo>

<Dt_Ano_Modelo>2012</Dt_Ano_Modelo>

<Id_Combustivel>3</Id_Combustivel>

<Vl_Veiculo>119111,00</Vl_Veiculo>

</FIPE>

<FIPE>

<Cd_Fipe>017030-5</Cd_Fipe>

<Ds_Combustivel>Gasolina</Ds_Combustivel>

<Ds_Marca>VEÍCULOS - JEEP</Ds_Marca>

<Ds_Modelo>WRANGLER UNLIMITED SPORT 3.6 V6 284CV 4P</Ds_Modelo>

<Dt_Ano_Modelo>2012</Dt_Ano_Modelo>

<Id_Combustivel>3</Id_Combustivel>

<Vl_Veiculo>124076,00</Vl_Veiculo>

</FIPE>

</FIPES>

<Cd_Vin_Final>1C4BJWDGXDL626000</Cd_Vin_Final>

<Cd_Vin_Inicial>1C4BJWAG0CL115000</Cd_Vin_Inicial>

<Ds_Ano_Final>2012</Ds_Ano_Final>

<Ds_Ano_Inicial>2012</Ds_Ano_Inicial>

<Ds_Convocacao>A Secretaria Nacional do Consumidor (Senacon) do Ministério da Justiça informa que a CHRYSLER GROUP DO BRASIL COMÉRCIO DE VEÍCULOS LTDA. protocolou Campanha de Chamamento para substituição do tubo do fluido da direção hidráulica e para inspeção do tubo de arrefecimento do óleo dos veículos Jeep Wrangler, ano/modelo 2012/2013. De acordo com a empresa, a Campanha, com início em 17 de dezembro de 2013, abrange 448 (quatrocentos e quarenta e oito) veículos, com numeração de chassi de 1C4BJWAGOCL115000 a 1C4BJWDGXDL626000. Quanto aos riscos à saúde e à segurança, a empresa destacou que há possibilidade de atrito entre o tubo de arrefecimento do óleo da transmissão e o tubo de retorno do fluido da direção hidráulica, provocando vazamento do

(14)

óleo da transmissão, que poderá ser danificada, causando falha no seu funcionamento e aumentando, assim, o risco de colisão.

</Ds_Convocacao>

<Ds_Fonte_Informacao>Ministério da Justiça</Ds_Fonte_Informacao>

<Ds_Marca>Jeep</Ds_Marca>

<Ds_Modelo>Wrangler</Ds_Modelo>

<Ds_Produto>Wrangler</Ds_Produto>

<Dt_Comunicacao>17/12/2013</Dt_Comunicacao>

<Id_Recall>2505</Id_Recall>

<Ds_Informacao>Sistema de arrefecimento</Ds_Informacao>

<Ds_Informacao>Sistema de direção</Ds_Informacao>

</Sistemas>

<Ds_Informacao>TUBO DO FLUIDO DA DIREÇÃO HIDRAULICA</Ds_Informacao>

<Ds_Informacao>TUBULAÇÃO DE ÓLEO</Ds_Informacao>

</Componentes>

<Ds_Informacao>Danos a dirigibilidade do condutor</Ds_Informacao>

</Riscos>

<Acoes>

<Ds_Informacao>Substituição</Ds_Informacao>

</Acoes>

</RECALL>

</RECALLS>

<URL_IMAGENS>http://app.trendconsulting.com.br/VIN/Charts/</URL_IMAGENS>

</CONSULTA>

</VIN>

2.4.3 Informações de retorno: caso de erro

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

2.4.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 Chassi não encontrado

(15)

2.4.3.2 Exemplo de retorno: caso de erro

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

<VIN>

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

</VIN>

</consulta>