Assunto
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 decreto federal 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.
Abrangência
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.
Requisitos
- 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!).
- O shell "cmd_renave.sh" e o objeto "renave.jar" são obtidos no link Liberação Sisdia (diasystem.com.br).
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.
Conceitos
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
Opções do Programa
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
VEIC7960
O menu principal exibe as abas que dão acesso a toda comunicação com o RENAVE Zero KM.
VEIC7960 -> Menu Principal
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
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
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
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
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 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."
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
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
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
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
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 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
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
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."
VEIC7960 -> Transferência
Autorizar Transferência
Nessa 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
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
TransferIR
Nessa aba podemos autorizar a saída de um veículo, aqui informamos o chassi e clicamos em pesquisar, após isso definimos o CNPJ do estabelecimento destino. Após definir o CNPJ, basta clicar em autorizar.
"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
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
Solução de problemas
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 RETORNADOS PELO WEBSERVICE RENAVE-WS
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:
- Shell "cmd_renave.sh" deve estar no diretório /shell do diretório onde o Sisdia é executado (Importante:Dar permissão de acesso a esse arquivo!).;
- Objeto "renave.jar" deve estar no diretório /lib do diretório onde o Sisdia é executado (Importante:Dar permissão de acesso a esse arquivo!).;
- As URLs de produção e homologação cadastradas no CADA3100, para a identificação RENAVE_WS;
- Os ambientes de P-Produção ou T-Treino cadastrados para a instância no CADA3200;
- 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"