Vehicle Identification Number VIN Manual do Produto Versão 2.5 Janeiro/2018
Í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 2.1.4.2 Retornos específicos deste produto... 8 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 2.4.3.2 Parâmetros de retorno: caso de erro... 14 Exemplo de retorno: caso de erro... 15
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 3
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. 4
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 5
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 6
7
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 Chassi não encontrado Retorno É necessário preencher todos os campos do chassi Descrição 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. 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 Usuário ou Senha Inválido Parâmetro inválido Não há retorno para esta consulta Descrição Indica que o usuário e/ou a senha informada são inválidos Indica que um ou mais campos estão nulos ou inválidos Indica que não foi encontrado nenhum registro para os campos informados 8
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 Indica que ocorreu um erro inesperado e é preciso entre em contato com o suporte Indica que o usuário não tem permissão para realizar a consulta Indica que a consulta foi realizada a partir de um IP não cadastrado para a empresa do usuário Indica que a consulta não pode ser realizada, pois não há crédito suficiente Indica que o contrato da empresa é de Experiência de Uso e a quantidade máxima de consultas permitidas já foi atingida. Indica que a empresa não possui nenhum contrato ativo e/ou vigente para o produto. Indica que esta consulta não está disponível. Indica que esta consulta não está disponível. 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. Consulta por Chassi Consulta por Placa Descrição da Consulta consultachassi consultaplaca Nome da Operação 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 9
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 VIN Nome do Campo URL_IMAGENS Cd_Descritivo Ds_Combinacao Ds_Descritivo Nr_Descritivo Vl_Inicio St_OK Descrição do Campo Parte do chassi informado, utilizado na decodificação. Endereço web disponibilizado com imagens do chassi decodificado DESCRITIVOS Parte do chassi informado que definiu a informação 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. 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. Código interno do item. Posição inicial da sequência do chassi que define a informação 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 Nr_Ordem Cd_Fipe Dt_Ano_Modelo Id_Combustivel Ds_Combustivel Conteúdo descritivo relativo ao item adicional. Ordem de exibição da informação adicional FIPES Código de referência do veículo de acordo com a Fundação Instituto de Pesquisas Econômicas Ano do modelo do veículo Identificação do tipo de combustível Descrição do combustível do veículo 10
Ds_Marca Ds_Modelo Vl_Veiculo Ds_Convocacao Ds_Fonte_Informacao Ds_Marca Ds_Modelo Ds_Produto Cd_Vin_Final Cd_Vin_Inicial Dt_Ano_Final Dt_Ano_Inicial Cd_Vin_Final Id_Recall Ds_Informacao Ds_Informacao Ds_Informacao Ds_Informacao Protocolo Saldo Marca do veículo Modelo do veículo Valor de mercado do veículo segundo Tabela FIPE RECALLS Texto da convocação do Recall Referência de onde foi coletada a informação do Recall Marca do veículo na qual foi identificado problema a ser revisado. Modelo do veículo na qual foi identificado problema a ser revisado. Descrição dos veículos envolvidos Código final do chassi convocado Código inicial do chassi convocado Ano final de produção do veículo Ano inicial de produção do veículo Código final do chassi convocado Identificação interna do recall RECALLS/Sistemas Informação sobre a categoria Sistemas dos veículos nos quais foram identificados problemas a serem revisados. RECALLS/Componentes Informação sobre a categoria Componentes dos veículos nos quais foram identificados problemas a serem revisados. RECALLS/Riscos Informação sobre a categoria Riscos identificados a serem revisados RECALLS/Ações Informação sobre a categoria Ações a serem efetuadas para solucionar os problemas identificados Identificação da Consulta Número de protocolo da consulta 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> <CONSULTA> <VIN>1C4BJWAG1CL</VIN> <DESCRITIVOS> 11
<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> <Vl_Inicio>1</Vl_Inicio> <Cd_Descritivo>C</Cd_Descritivo> <Ds_Combinacao>PAÍS DE ORIGEM</Ds_Combinacao> <Ds_Descritivo>ESTADOS UNIDOS</Ds_Descritivo> <Nr_Descritivo>12524</Nr_Descritivo> <Vl_Inicio>2</Vl_Inicio> <Cd_Descritivo>4</Cd_Descritivo> <Ds_Combinacao>MONTADORA</Ds_Combinacao> <Ds_Descritivo>JEEP</Ds_Descritivo> <Nr_Descritivo>8562</Nr_Descritivo> <Vl_Inicio>3</Vl_Inicio> <Cd_Descritivo>B</Cd_Descritivo> <Ds_Combinacao>PESO BRUTO TOTAL</Ds_Combinacao> <Ds_Descritivo>2.200 A 2.800 KG</Ds_Descritivo> <Nr_Descritivo>8737</Nr_Descritivo> <Vl_Inicio>4</Vl_Inicio> <Cd_Descritivo>J</Cd_Descritivo> <Ds_Combinacao>MODELO</Ds_Combinacao> <Ds_Descritivo>WRANGLER</Ds_Descritivo> <Nr_Descritivo>12986</Nr_Descritivo> <Vl_Inicio>5</Vl_Inicio> <Cd_Descritivo>W</Cd_Descritivo> <Ds_Combinacao>VERSÃO</Ds_Combinacao> <Ds_Descritivo>SPORT</Ds_Descritivo> <Nr_Descritivo>12987</Nr_Descritivo> <Vl_Inicio>6</Vl_Inicio> <Cd_Descritivo>A</Cd_Descritivo> <Ds_Combinacao>TIPO DE CARROCERIA</Ds_Combinacao> <Ds_Descritivo>UTILITARIO ESPORTIVO</Ds_Descritivo> <Nr_Descritivo>12528</Nr_Descritivo> <Vl_Inicio>7</Vl_Inicio> <Cd_Descritivo>G</Cd_Descritivo> <Ds_Combinacao>POTÊNCIA DO MOTOR</Ds_Combinacao> <Ds_Descritivo>3.6 V6</Ds_Descritivo> <Nr_Descritivo>10161</Nr_Descritivo> <Vl_Inicio>8</Vl_Inicio> 12
<Cd_Descritivo>1</Cd_Descritivo> <Ds_Combinacao>DÍGITO VERIFICADOR</Ds_Combinacao> <Ds_Descritivo>1</Ds_Descritivo> <Nr_Descritivo>8597</Nr_Descritivo> <Vl_Inicio>9</Vl_Inicio> <Cd_Descritivo>C</Cd_Descritivo> <Ds_Combinacao>ANO MODELO</Ds_Combinacao> <Ds_Descritivo>2012</Ds_Descritivo> <Nr_Descritivo>8596</Nr_Descritivo> <Vl_Inicio>10</Vl_Inicio> <Cd_Descritivo>L</Cd_Descritivo> <Ds_Combinacao>LOCAL DE FABRICAÇÃO</Ds_Combinacao> <Ds_Descritivo>TOLEDO</Ds_Descritivo> <Nr_Descritivo>8568</Nr_Descritivo> <Vl_Inicio>11</Vl_Inicio> </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> <RECALLS> <RECALL> <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 13
</VIN> ó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> <Sistemas> <Ds_Informacao>Sistema de arrefecimento</ds_informacao> <Ds_Informacao>Sistema de direção</ds_informacao> </Sistemas> <Componentes> <Ds_Informacao>TUBO DO FLUIDO DA DIREÇÃO HIDRAULICA</Ds_Informacao> <Ds_Informacao>TUBULAÇÃO DE ÓLEO</Ds_Informacao> </Componentes> <Riscos> <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> <saldo>0,00</saldo> <protocolo>20150129171857000001</protocolo> </CONSULTA> 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 14
2.4.3.2 Exemplo de retorno: caso de erro <?xml version="1.0" encoding="utf-8"?> <consulta> <VIN> <retorno>parâmetro inválido</retorno> <saldo>0,00</saldo> <protocolo>20140724155545000014</protocolo> </VIN> </consulta> 15