Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


VEIC7960 - Integração RENAVE-WS Veículos Zero KM

Sumário

Índice
maxLevel1


Painel


VERSÃO DO PROGRAMA: 10.10




Painel

Assunto

Painel
borderStyledashed

Implementado módulo para integração automática (via API) do Sisdia FX com o módulo RENAVE-WS do DETRAN com veículos zero KM.

O Renave-WS visa a registrar o movimento de compra e venda de veículos que sejam mantidos em estoque por estabelecimentos, conforme determinação do artigo 330 do Código de Trânsito Brasileiro.

Para um determinado veículo, o estado de estoque representa que esse veículo está em posse de um determinado estabelecimento, sendo que esse estabelecimento possui o propósito de comercializar esse veículo.

O objetivo do Renave é registrar a movimentação de entrada e saída de estoque dos veículos dos estabelecimentos. Não compete ao Renave garantir a lisura do processo de compra e venda.

Contudo, para que o vendedor que vendeu seu veículo a um estabelecimento possa posteriormente alegar com assertividade sobre o fato, o Renave possibilita o upload da assinatura digital do ATPV. O vendedor tem ainda a possibilidade de registrar a comunicação de venda no cartório.

Mas como os itens descritos acima são opcionais, o Renave, que garante a autenticidade do estabelecimento com quem se comunica, presume a boa fé nas informações fornecidas pelo estabelecimento. A presunção de boa-fé nas relações com os usuários dos serviços públicos é uma diretriz traçada por por decreto federal com  com vistas à desburocratização.

De qualquer forma, o processo se encerra com o atendimento físico no guichê do Detran de Jurisdição, que nesse momento constatará a assinatura física de ambos: comprador e vendedor.

Nesta integração automática estão previstos o envio das informações referentes à Compra, Venda, Transferência entre estabelecimentos, Rejeição e Devolução de veículos Novos (Zero KM), bem como consulta ao documento ATPV.

Manual do Renave : https://hom.renave.estaleiro.serpro.gov.br/renave-ws/manual/

Página do Renave no SERPRO: https://www.loja.serpro.gov.br/renave.




Painel

Abrangência 

Painel
borderStyledashed

Programa destinado a todos os clientes do segmento Automotivo do produto Sisdia FX/LinxMaq, que tenham feito o credenciamento no DENATRAN para esta integração.



Painel

Requisitos 

Painel
borderStyledashed
  • Ter certificado digital A1 pfx para matriz e filiais.
  • Ter realizado o cadastramento no CREDENCIA.
  • SisdiaFX versão v10.10 atualizada com todos HotFix disponíveis.
  • Cadastrar os ambientes de "P"-Produção e "T"-Treino para as instâncias utilizadas no ('CADA3200').
  • Cadastrar as URLs de homologação e produção no ('CADA3100'), para a Identificação RENAVE_WS:
    Produção: https://auto-renave.linx.com.br/api/

    Homologação: https://auto-renave.linx.com.br/api/
    OBS:
    Deve finalizar com '/'
  • Diretório '/report' com permissão de gravação, para gravação dos 'pdf's' retornados pelos serviços RENAVE.
  • Versão JAVA : 1.7.0_80 ou superior - verificar manual "Java - guia de atualização do Java 7"
  • Shell "cmd_renave.sh" deve estar no diretório /shell do diretório onde o Sisdia é executado (Importante:Dar permissão de acesso!).
  • Objeto "renave.jar" deve estar no diretório /lib do diretório onde o Sisdia é executado (Importante:Dar permissão de acesso!).
  • Copiar o arquivo do certificado '.pfx' para o diretório /usr/local/tomcat/certificados. (Importante:Dar permissão de acesso!).

O Renave WS exige autenticação SSL (https). Por conta disso, os clientes devem utilizar certificados digitais de máquina para conseguir realizar as requisições.

Cada cliente (estabelecimento) deve ter seu certificado previamente cadastrado no banco de dados do Credencia Denatran.

Para participar, os estabelecimentos comerciais precisam se cadastrar no sistema CREDENCIA, plataforma de credenciamento do DENATRAN. As empresas que desenvolvem soluções de integração para o mercado, podem participar sem problemas, mas sempre a partir do cadastro de seus clientes no CREDENCIA. Seguem os links de Homologação e Produção.

    CREDENCIA Homologação: https://homologacao-credencia.estaleiro.serpro.gov.br/credencia-web/#/login
    CREDENCIA Produção:    https://credencia.estaleiro.serpro.gov.br/credencia-web/#/login

Após a etapa do cadastro, outro pré-requisito é informar (também por meio do CREDENCIA) a chave pública de certificado digital (A1 ou A3), padrão ICP-Brasil, em Nome/CNPJ do estabelecimento comercial.

O certificado será a chave utilizada para comunicação segura com o RENAVE.

Não há uso de login/senha.

Página do Renave no SERPRO: https://www.loja.serpro.gov.br/renave.

  • Após a obtenção do certificado junto à CREDENCIA, então deverá possuir os parâmetros (caminho do certificado e senha) na tabela caparam, e este caminho do certificado deve estar com permissão de leitura para efetivar a comunicação segura com web service do RENAVE.



Painel

Conceitos 

Painel
borderStyledashed

RENAVE - Registro Nacional de Veículos em Estoque

ATPV - Autorização para Transferência de Propriedade do Veículo

DENATRAN - Departamento Nacional de Trânsito

DETRAN - Departamento de Trânsito



Painel

Opções do Programa

Painel
borderStyledashed

Solução de problemas

Painel
Para funcionamento em seu primeiro acesso, devemos escolher qual ambiente será usado para envio dos dados ao RENAVE no programa ('CADA3200'). Existem dois ambientes, o de homologação para testes, e o de produção. Num primeiro momento, para validar a aplicação e a integração, você deve assinalar a opção de "T-Treino" (homologação). A partir do momento que estiver concluído a fase de homologação, você altera o ambiente para "P-Produção" (OFICIAL).

CADA3200


Devemos também parametrizar as URLs do RENAVE de Produção (oficial) e Homologação (treino) no programa ('CADA3100') escolher qual ambiente será usado para envio dos dados ao RENAVE. Existem dois ambientes, o de homologação(homologação) para testes, e o de produção(OFICIAL).

CADA3100


Também é necessário cadastrar o nome/caminho do certificado RENAVE e sua respectiva senha no Sisdia FX, para isso a partir do programa ('CADA0220') basta entrar na opção Altera, selecionar a filial desejada e confirmar, após a confirmação é exibida a mensagem: "Deseja cadastrar certificado RENAVE?", respondendo Sim será direcionado ao programa ('CADA1220') para realizar o cadastramento.

CADA1220 -> CADA0220


Já no programa ('CADA1220') parametrizar o diretório/nome do certificado RENAVE e sua senha de Produção (oficial) e Homologação (treino), confirmando ao final.

ATENÇÃO: O campo Diretório/Nome suporta 75 caracteres, caso seja necessário renomeie o nome do arquivo do certificado nesse diretório do Sisdia FX.

CADA1220

VEIC7960

O menu principal exibe as abas que dão acesso a toda comunicação com o RENAVE Zero KM.

Observação Importante: Em todas as operações de comunicação com o RENAVE-WS, é exigido o CPF do Operador responsável por cada operação, o Sisdia FX sempre envia o CPF do usuário logado no Sistema.

VEIC7960 -> Menu Principal

Image RemovedImage Added

CONSULTAR

Consultar

Nessa sub aba vamos encontrar três sub abas a Pendente que é onde podemos consultar todos os veículos que a montadora liberou para a concessionária, Estoque que temos todos os veículos que já se encontram no estoque da Renave e o ATPV onde é possível gerar um PDF do ATPV.

VEIC7960 -> Consultar

PENDENTE

Pendente

Nessa sub aba podemos ver todos os veículos que a montadora liberou para a concessionária (pré cadastro da Montadora) e que estão aptos a dar entrada no Renave. Caso o chassi não seja informado, serão retornados todos os veículos pendentes para o estabelecimento solicitante.

"Possibilitar que o estabelecimento consulte os veículos zero kms pendentes."

VEIC7960 -> Consultar -> Pendente

ESTOQUE

Estoque

Nessa sub aba podemos ver todos os veículos que já deram entrada na Renave e seus respectivos 'estados'(status conforme tabela Renave). Caso não seja informado o chassi ou Estado do Estoque serão retornados todos os veículos em estoque para o estabelecimento solicitante.

"Possibilitar que o estabelecimento consulte os veículos zero km em estoque."

VEIC7960 -> Consultar -> Estoque


Os Estados de estoque de um veículo possíveis para o estoque Zero Km são:

Confirmado: Veiculo deu entrada no Estoque Renave da concessionária.

Finalizado: Veículo deu saída no Estoque Renave da concessionária.

Os estados: Solicitado e Transferido estão previstos no Renave, mas sem uso no momento.


ATPV

atpv

Nessa aba é possível gerar o PDF do ATPV - Autorização de Transferência de Propriedade de Veículo para consulta ou impressão.

"Possibilita o acesso ao PDF do ATPVe de um veículo.


O ATPV (Autorização para Transferência de Propriedade do Veículo) é o documento utilizado nas transações de compra/venda de veículos. Quando o veículo não possuir um CRV em papel moeda, a transferência deve ser feita com o uso do ATPVe, um documento digital gerado pelo Renavam a partir de uma intenção de venda, que é cadastrada pelo Detran ou gerada pelo Renave, contendo dados do comprador e da venda do veículo. Esta operação trata do acesso ao PDF desse ATPVe.


O ATPVe está também diretamente disponível para o cidadão via app Carteira Digital de Trânsito (CDT)."

VEIC7960 -> Consultar -> ATPV

Image Modified

Image Modified

ENTRADA

Entrada

Nessa sub aba realizamos a entrada do veículo na Renave, também é possível cancelar essa entrada, devolver o veículo para a Montadora,  rejeitar o veículo pendente (pré cadastro da Montadora) ou cancelar uma rejeição de veículo anteriormente realizada.

VEIC7960 -> Entrada

ENTRAR

EntrAR ESTOQUE

Nessa aba realizamos a entrada do veículo na Renave, para fazer isso é necessário que o veículo esteja cadastrado como pendente (pré cadastro da Montadora). depois basta informar o chassi, chave Nfe, KM e data de medição do Hodômetro, data de entrada em estoque e o valor da compra.

"Possibilitar que o estabelecimento realize a entrada de um veículo zero km em estoque.

Após o sucesso da operação, o veículo estará em estoque."



Fluxo de estoque zero km: ('Clique Aqui')


VEIC7960 -> Entrada -> Entrar Estoque

CANCELAR ENTRADA

Nessa aba realizamos o cancelamento da entrada do veículo na Renave, para fazer isso é necessário que o veículo esteja no estoque Renave. Basta então informar o chassi e a data do cancelamento (o identificador do estoque é buscado automaticamente).

"Possibilitar que o estabelecimento cancele a entrada de estoque de um veículo zero km.


Após o sucesso da operação, o veículo sairá de estoque e estará novamente disponível para entrar em estoque."

VEIC7960 -> Entrada -> Cancelar Entrada

Image Modified

DEVOLVER VEÍCULO

Nessa aba realizamos a devolução do veículo para a Montadora, para fazer isso é necessário que o veículo esteja no estoque Renave. Basta então informar o chassi, chave NFe e a data da devolução (o identificador do estoque é buscado automaticamente).

"Possibilitar que o estabelecimento devolva um veículo zero km para a montadora.


Após o sucesso da operação, o veículo sairá de estoque."

VEIC7960 -> Entrada -> Devolver Veículo

Image Modified

REJEITAR PENDENTE

rejeitar pendente

Nessa aba realizamos a rejeição do veículo (pré cadastro da Montadora), para fazer isso é necessário que o veículo esteja no Pendente Renave. Basta então informar o chassi.

"Possibilitar que o estabelecimento rejeite um veículo zero km pendente de entrada em estoque.


Após o sucesso da operação, o veículo não constará como pendente de entrada em estoque."

VEIC7960 -> Entrada -> Rejeitar Pendente

Image Modified

CANCELAR REJEIÇÃO

Cancelar rejeição

Nessa aba realizamos o cancelamento da rejeição do veículo (pré cadastro da Montadora), para fazer isso é necessário que o veículo tenha sido rejeitado anteriormente. Basta então informar o chassi.

"Possibilitar que o estabelecimento cancele uma rejeição de veículo zero km.


Após o sucesso da operação, o veículo estará novamente disponível para entrar em estoque."

VEIC7960 -> Entrada -> Cancelar Rejeição

Image Modified

SAÍDA

Saída

Nessa aba nos encontraremos as sub abas onde informamos a saída do veículo da concessionária ou cancelamos essa saída.

VEIC7960 -> Saída


SAIR

SaIR ESTOQUE

Nessa aba é onde informamos a saída do veículo da concessionária As informações relativas ao cliente são buscadas no cadastro do Sisdia, em caso de necessidade de alteração dos dados do cliente, essa alteração pode ser realizada no programa de cadastro de clientes e repetida a operação no Renave, ou diretamente nos campos da tela, nesse último caso não será salva no cadastro do Sisdia.

"Possibilitar que o estabelecimento realize a saída de um veículo zero km de estoque. Na sequência, o estabelecimento pode obter o ATPVe utilizando a operação "Consultar PDF do ATPV do veículo". O ATPVe (Autorização para Transferência de Propriedade do Veículo Digital) é o documento normalmente utilizado nas transações de compra/venda de veículos."

VEIC7960 -> Saída -> Sair Estoque

Image Modified

CANCELAR SAÍDA

Nessa aba é onde informamos o cancelamento da saída do veículo da concessionária, após o cancelamento o veículo retornará então para o estoque Renave. Basta informar o chassi (o identificador do estoque será buscado automaticamente).

"Possibilitar que o estabelecimento realize o cancelamento da saída de um veículo zero km de estoque.


Após o sucesso da operação, o Renave gerará um novo estoque no estado de "Confirmado" com as mesmas informações do estoque que originou a saída que está cancelada.


O intuito dessa operação é ser invocada em casos de exceção, quando a saída de estoque tiver sido indevidamente invocada."

VEIC7960 -> Saída -> Cancelar Saída

Image Modified

TRANSFERÊNCIA

Transferência

Nessa aba nos encontraremos as sub abas para consultar autorização, autorizar transferência e realizar a transferência entre estabelecimentos.

"Possibilitar que o estabelecimento realize a transferência de estoque de um veículo zero km que esteja em outro estabelecimento. Para que essa operação seja realizada, é necessário que o estabelecimento de origem tenha autorizado a transferência do veículo.

Após o sucesso da operação, o veículo sairá do estoque do estabelecimento de origem e entrará no estoque do estabelecimento solicitante."


Fluxo de transferência de estoque entre estabelecimentos: ('clique aqui')


VEIC7960 -> Transferência

AUTORIZAR TRANSFERÊNCIA

Autorizar Transferência

Nessa aba podemos autorizar a saída de um veículo, aqui informamos o chassi e o CNPJ do estabelecimento destino. O identificador de estoque é preenchido automaticamente.

"Possibilitar que o estabelecimento autorize a transferência de um veículo que esteja em seu estoque para outro estabelecimento.


Após o sucesso da operação, uma Autorização ficará registrada e permitirá que o estabelecimento de destino do estoque realize a transferência de estoque. O veículo continua no estoque do estabelecimento que autorizou a transferência de estoque."

VEIC7960 -> Transferência -> Autorizar Transferência

CONSULTAR

Consultar

Nessa aba podemos consultar a situação de todas as autorizações. A tela tem opção de pesquisar as autorizações por chassi ou estado da Autorização.

"Possibilitar que o estabelecimento consulte autorizações de transferência nas quais ele está relacionado."

VEIC7960 -> Transferência -> Consultar


O Estab.Autoriz. é o Estabelecimento Autorizador, a origem da transferência.

O Estab.Destino é o Estabelecimento que irá receber a transferência, é o destino.

O CPF Auto. é o CPF do usuário que autorizou a transferência.

A Data na qual a Autorização de Transferência foi criada.

O Estado da autorização de transferência possui os valores:

  • Criada: A autorização de transferência foi criada pelo estabelecimento Origem.
  • Consumida: A autorização de transferência foi consumida (utilizada) pelo estabelecimento Destino.
  • Cancelada: A autorização de transferência foi cancelada pelo estabelecimento Origem.

O Id.Est é o Identificador do Estoque, um número de controle criado e mantido pelo Renave.

O Id.Auto é o Identificador da Autorização, um número de controle criado e mantido pelo Renave.

TRANSFERIR

TransferIR

Nessa aba podemos autorizar a saída de um veículo, aqui informamos o chassi e clicamos em pesquisar, após isso informamos a Chave NFe, Data de Transferência, KM, Data de Medição do Hodômetro e o Valor da Compra.

"Possibilitar que o estabelecimento solicite a transferência de estoque de um veículo que esteja em outro estabelecimento. Para que essa operação seja realizada, é necessário que o estabelecimento de origem tenha autorizado a transferência do veículo.

Após o sucesso da operação, o veículo sairá do estoque do estabelecimento de origem e entrará no estoque do estabelecimento solicitante no estado de Solicitado. Na sequência, os estabelecimentos envolvidos podem obter o ATPVe utilizando a operação "Consultar PDF do ATPV do veículo". O ATPVe (Autorização para Transferência de Propriedade do Veículo Digital) é o documento normalmente utilizado nas transações de compra/venda de veículos. Já o estabelecimento solicitante pode obter o Termo de Entrada em Estoque utilizando a operação "Consultar Termo de Entrada em Estoque"."

VEIC7960 -> Transferência -> Transferir

Image Modified

CANCELAR

cancelar

Nessa aba podemos cancelar a autorização de transferência, aqui basta informamos o chassi (O identificador de autorização é obtido automaticamente).

"Possibilitar que o estabelecimento cancele a autorização de transferência de um veículo que não tenha sido utilizada. Após o sucesso da operação, a Autorização ficará cancelada e sem efeitos no Renave."

VEIC7960 -> Transferência -> Cancelar

Painel


Venda Direta

Nessa sub aba podemos ver todos os veículos que já deram entrada na Renave através da venda direta.


"Possibilitar que o estabelecimento consulte os veículos zero km que são vendidos pelo fabricante diretamente ao cliente."

VEIC7960 -> Venda Direta

Image Added

Image Added

Quando o grid carrega e dependendo da escolha de pesquisa do combox "Estado" o concessionário poderá clicar nos botões de "Entrega", "Cancelamento", "ATPV" ou "Detalhe Consulta".

O concessionário pode pesquisar por chassi, basta digita-lo.

Ou seja, se pesquisar os veículos "PENDENTES", a opção será a "Entrega", então, posicionar na linha deseja do grid e clicar no botão "Entrega".




Painel

Solução de problemas

Painel
borderStyledashed

ERROS E MENSAGENS DE ALERTAS RETORNADOS PELO WEBSERVICE RENAVE-WS

Para todas as operações do programa VEIC7960, há um tratamento padrão para as mensagens de erros e alertas retornados durante a operação com o RENAVE-WS.

Caso a integração ocorra com Sucesso, será apresentado a mensagem:

Caso alguma mensagem de alerta ou erro ocorra, será apresentada a mensagem abaixo e ao selecionar "Sim", será exibido o relatório com a mensagem de alerta ou erro:

STATUS


status RETORNADOS PELO WEBSERVICE RENAVE-WS


ERRO VEÍCULO FATURADO PELA MONTADORA NÃO APARECE

NA CONSULTA  DE ESTOQUE 

Na consulta  de estoque  PENDENTES

Caso a montadora fature um veículo, e o mesmo não apareça na consulta "Pendentes", isso pode significar que a Montadora não registrou o chassi do veículo na base BIN. Nesse caso entrar em contato com a Montadora e se necessário com o suporte Renave SERPRO através do Telefone: 0800728 2324 ou pela página: https://www.serpro.gov.br/menu/suporte/css

RASTREABILIDADE DE ERROS WEBSERVICE


rastreabilidade de erros webservice

Caso ocorra algum erro na comunicação do web service, conferir :

A versão do Java Instalada, ver manual "Java - guia de atualização do Java 7"

No shell ambiente_sisdia.sh, que encontra-se dentro do diretório shell, (Exemplo /ext/sisdia/shell), verificar se a versão do Java está jre1.7.0_80 ou superior, na linha

"export JAVA_HOME=/usr/java/jre1.7.0_80"

Verificar os pre-requisitos:

  • Verificar se o Shell "cmd_renave.sh" está no diretório /shell do diretório onde o Sisdia é executado (Importante: Verificar a permissão de acesso a esse arquivo, permissão total!);
  • Verificar se o objeto "renave.jar" está no diretório /lib do diretório onde o Sisdia é executado (Importante: Verificar a permissão de acesso a esse arquivo, permissão total!);
  • Verificar se as  URLs de produção e homologação estão cadastradas no ('CADA3100'), para a identificação RENAVE_WS;
  • Verificar se os ambientes de P-Produção ou T-Treino estão cadastrados para a instância no ('CADA3200');
  • Verificar se o arquivo do certificado '.pfx' está no diretório /usr/local/tomcat/certificados. (Importante: Verificar a permissão de acesso a esse arquivo, permissão total!);
  • Verificar se os parâmetros (caminho do certificado e senha) se estão cadastrados na tabela caparam, e este caminho do certificado esteja com permissão de leitura.

Verificando mensagens de retorno da integração RENAVE_WS:

  • Após a execução de um serviço (integração), caso ocorram erros ou mensagens de alerta importantes, os mesmos serão registrados e apresentados na tela padrão de relatórios do Sisdia FX.
  • Erro "Unauthorized" na comunicação com o RENAVE:
    Durante a homologação existiram casos de clientes onde o firewall do cliente bloqueava as comunicações do RENAVE, verificar com o TI.
    Durante a homologação existiram casos de clientes onde o cadastro não estava completo no CREDENCIA, o que bloqueava as comunicação do RENAVE.

Verificando os Logs:

  • No log do Sisdia FX buscar por "INICIO Integracao" e "FIM Integracao" verificando a versão dos serviços e toda a comunicação com o RENAVE_WS.
  • Na pasta \report do Sisdia FX buscar os arquivos mais recentes de envio e retorno da comunicação avaliando o seu conteúdo. O nome do arquivo é composto pelo "NomeServiço" + "_ret" (retorno) + "_env" (envio) + data e hora da execução do serviço.
    Ex.:  "ConsultaEstoqueZero_ret20220118175248" e "ConsultaEstoqueZero_env20220118175248"
VERIFICANDO SE O CERTIFICADO DO CLIENTE ESTÁ VÁLIDO


verificando se o certificado do cliente está válido

Para verificar se o certificado de produção do cliente está válido para operar no ambiente de produção do RENAVE (cadastramento no CREDENCIA-RENAVE).
Oriente por favor o cliente para esse teste:

1-Entrar no Swagger (com o certificado de produção do cliente) através do link:

https://hom.renave.estaleiro.serpro.gov.br/renave-ws/swagger-ui.html?urls.primaryName=Estabelecimento

2-No box superior direito escolher: Select a spec "Estabelecimento"

Image Removed

 Image Added


3-Encontra na página a operação:"Estoque de Veículos zero km'

Estoques de veículos zero km 


4-Clique na API: "GET /api/veiculos-zero-km-pendentes-entrada-estoque" 

Image Added

Image Removed

 


5-Clique no botão: 'Try it out'

Image Removed

 

Image Added


6-Clique na barra 'EXECUTE' (não precisa informar nenhum parâmetro)

Image Removed

 

Image Added


7-O resultado da operação é exibida no quadro (fundo preto) abaixo, CODE 200 ou 201 Ok... outro erro significa problemas com o certificado do cliente, que deve ser visto junto ao pessoal do RENAVE - SERPRO.

Image Removed

 

Image Added


Se a resposta (Server Response) da tela acima for 200 ou 201 está Ok (sem problemas no certificado), para qualquer outro erro retornado o cliente deve entrar em contato com o suporte do RENAVE (cadastramento CREDENCIA-RENAVE), para verificar o que está ocorrendo e somente depois retomar as tentativas no SisdiaFX.



Expandir
titleOutras soluções...

Resultados da pesquisa
spacekeyDMS
maxLimit50
queryFAQ
typepage




Documentação de versões anteriores deste programa

Expandir
titleVersões anteriores

Não há informações disponíveis.