• 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 CADA3100as URLs de homologação e produção no CADA3100, para a Identificação RENAVE_WS :
  
  Produção: https://auto-renave.estaleiro.linxserpro.comgov.br/renave-ws/api/
  Homologação: https://auto-hom.renave.estaleiro.linxserpro.comgov.br/renave-ws/api/
  OBS: Deve finalizar com '/'
  
  Image Added
  
  
  
• 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!)..
  
  
• Concessionária deve estar credenciada no DENATRAN e ter o certificado de comunicação instalado :

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.

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:

Image Removed

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:

Image Removed

Image Removed

Image Removed

STATUS RETORNADOS PELO WEBSERVICE RENAVE-WS

Image Removed

ERRO VEÍCULO FATURADO PELA MONTADORA NÃO APARECE 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

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" esta 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" esta 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:

O programa VEIC7950 vai englobar todos os processos de comunicação da concessionária com o RENAVE - DETRAN.

Estes processos estão descritos abaixo.

Image Added

Consultas:

Image Added

• Aptidão:

Consultar aptidão para entrada/saída do estoque → quando algum veículo vai entrar ou sair do estoque da concessionária, deverá ser feita esta consulta, que retorna se o veículo tem algum impedimento, como multas, por exemplo.

"Funciona como uma prévia, indicando se a operação de "solicitação de entrada em estoque" aceitará ou não a entrada em estoque. Embora a invocação desta operação não seja obrigatória, é altamente recomendada como uma boa prática de utilização do Renave. Como os dados no Renavam são constantemente atualizados, recomenda-se a invocação da consulta aptidão logo antes da entrada em estoque."

Neste momento, o veículo ainda não está no estoque da concessionária, deverá ser informado o renavam, placa, numero do CRV e o tipo do CRV:

Image Added

Aba Informações Débito:

Image Added

Aba Dados do Veiculo:

Image Added

Caso seja informado um veículo que não esteja na base do RENAVE, será apresentada mensagem e relatório de erro:

Image Added

Image Added

• Estoque Renave:
  
  

Serão retornados os veículos da concessionária, que já foram enviados para o estoque do RENAVE, através da Solicitação de Entrada (webservice invocado pela opção ‘Entrada em Estoque’, ‘Solicita Entrada Estoque, descrita mais abaixo).

Alguns dos dados retornados serão utilizados em outras consultas e operações do RENAVE, descritas a seguir.

Image Added

Se informar a placa, será retornado o dado do veículo informado, senão, será retornado todo o estoque da concessionária que foi enviado para o RENAVE:

Image Added

Com ENTER ou duplo clique abre a tela de detalhe do veículo no estoque do RENAVE:

Image Added

Image Added

Aba Complemento Detalhe:

Image Added

Informando uma placa que não esteja no estoque RENAVE, será apresentada mensagem e relatório de erro:

Image Added

• ATPV:
  
  

"Possibilita o acesso a dados de ATPV referente a venda de veículo vendido (ou a ser vendido) ao estabelecimento. Ao ter acesso à foto do ATPV físico e às assinaturas digitais envolvidas, os clientes desta operação podem realizar suas próprias verificações de legitimidade do processo, i.e.: verificarem por conta própria se a foto e as assinaturas realmente correspondem ao veículo, estabelecimento e cidadão-vendedor envolvidos na venda do veículo."

O documento de transferência (ATPV) do veículo (PDF) poderá ser obtido a partir de 2 tipos de consulta:

• pelo código de segurança do CRV e documento (CPF/CNPJ) do proprietário OU
• pelo ID do ATPV, retornado na consulta do Estoque RENAVE.

Image Added

Se for informada a placa, será buscado o código de segurança e documento do proprietário armazenados no sistema.

O documento do proprietário será o CPF/CNPJ do proprietário informados na última Avaliação do veículo Seminovo (VEIC0040)

O código de segurança do CRV será o que foi informado na Solicitação de Entrada (opção ‘Entrada em Estoque’, ‘Solicita Entrada Estoque).

OBS:

A operação ATPV está em modificação pelo DETRAN, não está retornando os dados devidos.

Devemos aguardar a alteração para apresentar os dados do ATPV (pdf).

Image Added

• PDF de ATPV:
  
  

"Possibilita o acesso a dados de ATPV referente a venda de veículo vendido (ou a ser vendido) ao estabelecimento. Ao ter acesso à foto do ATPV físico e às assinaturas digitais envolvidas, os clientes desta operação podem realizar suas próprias verificações de legitimidade do processo, i.e.: verificarem por conta própria se a foto e as assinaturas realmente correspondem ao veículo, estabelecimento e cidadão-vendedor envolvidos na venda do veículo."

O documento de transferência (ATPV) do veículo (PDF) poderá ser obtido informando os dados abaixo:

Image Added

• CRLV

Busca o documento CRLV do veículo informado e apresenta na tela (PDF).

Image Added

Ao informar a placa será apresentado o Renavam informado na última Avaliação do veículo Seminovo (VEIC0040).

Caso o veículo não tenha sido avaliado, será apresentada mensagem e o Renavam deverá ser informado na tela.

Image Added

Após a informação da placa e Renavam, será apresentado o CRVL do veículo, desde que ele esteja no estoque do RENAVE para a concessionária:

Image Added

Image Added

Image Added

OBS: Este documento ficará gravado no diretório '/report' do Sisdia.

Caso o CRLV do veículo não seja encontrado, será apresentada mensagem e exibido relatório de erro:

Image Added

Processos de Entrada no Estoque :

Será apresentada tela para informar os dados necessários para os processos de comunicação de entrada do veículo no estoque da concessionária.

Image Added

Serão apresentadas opções para as seguintes operações, que estão na ordem que deverão ser invocadas:

1. Se o veículo estiver apto a entrar no estoque, deverá ser feita Solicitação de entrada no estoque → Neste momento o veiculo deve estar cadastrado no estoque da concessionária e deverão ser enviados dados como o documento de transferência assinado (ATPV), renavam, placa, km hodômetro, documento do proprietário.

   
   Image Added
   
   

   Informar o Tipo de Entrada:

   • Usado -> veículo usado que está entrando na concessionária
   • Próprio -> veículo usado que já entrou no estoque da concessionaria, mas ainda não foi enviado para o estoque do RENAVE.
     
     

   Ao selecionar ‘Usado’, deverá ser informado o diretório e nome do arquivo de imagem (foto em PDF) do Documento de Transferência (ATPV), assinado pelo proprietário do veículo usado.

   Informar também a data de assinatura deste documento e os dados do documento do proprietário.

   Ao selecionar ‘Próprio’ estes dados não serão necessários, pois o veículo já estará em nome da concessionária, e o documento de transferência de propriedade já deverá ter sido enviado ao DETRAN anteriormente.

    

   Ao informar a placa, será verificado se o veículo usado já tem uma Avaliação. Caso não tenha, será apresentada tela para gerar a avaliação: VEIC0040.

   Não será permitido continuar até que tenha sido gerada uma avaliação para o veículo.

   
   
   Image Added
   Image Added

   
   

   Após a informação dos demais dados, será invocada operação para entrada do veículo no estoque do RENAVE.

   Image Added

   Caso ocorra algum erro na comunicação ou erro de negócio o mesmo será retornado no relatório de erro:

2. Após o retorno do DETRAN da entrada no estoque, poderá ser feita a consulta ao Termo de Entrada no Estoque, para certificar que o DETRAN já registrou a entrada do veiculo nas suas bases de dados.

   Para consulta do Termo, deverá ser informado o Identificador do Estoque do Veículo no RENAVE.

    Ele poderá ser preenchido informando a placa/renavam, caso tenha sido gravado com sucesso no retorno da operação ‘Solicita Entrada no Estoque’.

    Ou poderá ser informado, consultando na opção Consultas/Estoque Renave, descrita acima neste documento.

   Após informar o Identificador, será invocada operação para retornar o Termo de Entrada do veículo no estoque do RENAVE (pdf):

   Image Added

   OBS: Este documento ficará gravado no diretório '/report' do Sisdia.

   
   

3. Enviar informações da nota de entrada (chave da nfe), através da operação para Enviar Nota de Entrada.

   Após a solicitação de entrada no estoque e o retorno do Termo de Entrada, deverá ser enviada a nfe de entrada do veículo usado no estoque.

    "Deve ser feito após a entrada em estoque e é condição para a emissão dos novos documentos do veículo".

   Informar os dados para envio da NFe de entrada do veículo usado no estoque do RENAVE.

   Ao informar a placa será apresentado o Renavam informado na última Avaliação do veículo Seminovo e a chave da NFe de Entrada, que é atualizada na tabela de avaliação (cxavalia).

   Após informar todos os dados será invocada a operação de Envio da NFe de Entrada do veículo no estoque da concessionária.

   
   

4. Antes de enviar a nota e antes do DETRAN efetivar a entrada do veiculo no estoque, poderá ser feito o Cancelamento de Entrada em Estoque.

   Informar os dados para o cancelamento da entrada.

   Ao informar a placa será apresentado o Renavam informado na última Avaliação do veículo Seminovo e os dados do CRV do proprietário do veículo.

   Os dados do CRV serão gravados no retorno (com sucesso) da operação ‘Solicita Entrada no Estoque’.
   Image Added

   
   

   Após a informação dos dados, será invocada operação para cancelamento da entrada do veículo no estoque do RENAVE.

Não serão feitas consistências para estas operações. O usuário será responsável por fazer a comunicação e observar o retorno das operações, através das mensagens retornadas.

Será apresentado um histórico das operações com o veículo (opção Consultas/Histórico Operações) , mostrando as operações que foram executadas com sucesso/erro, com a data das mesmas.

Assim o usuário saberá qual próximo processo deverá executar.

Processos de Saída do Estoque :

Será apresentada tela para informar os dados necessários para os processos de comunicação de saída do veículo do estoque da concessionária, quando da venda do usado.

Image Added

Serão apresentadas opções para as seguintes operações, que estão na ordem que deverão ser invocadas:

1. Solicitação de saída do estoque → quando for vender o veiculo usado.

   OBS: a concessionária deverá ter enviado a Nota Fiscal de Entrada anteriormente.

   Informar os dados para solicitar a saída do veículo usado do estoque do RENAVE.

   Ao informar a placa, será verificado se o veículo usado já tem uma Avaliação.

   Caso não tenha, será apresentada mensagem:

   Image Added

   
   

   Deverão ser informados os demais dados:

   • Dados do CRV (em nome da Concessionária): Número e Código de Segurança
   • Dados do comprador do veículo usado: nome, documento e endereço.

   O cliente/endereço deverão estar cadastrados no cadastro de cliente/endereço (CADA0380/CADA0385).

   Poderá ser buscado no cadastro, através da opção CTRL-E ou pela lupa:
   Image Added

   Após a informação dos dados, será invocada operação para saída do veículo no estoque do RENAVE.
   
   

   
   

2. Após o DETRAN confirmar a saída do estoque, poderá ser feita a consulta ao Termo de Saída no Estoque, para certificar que o DETRAN já registrou a saída do veiculo nas suas bases de dados.

   Para consulta do Termo, deverá ser informado o Identificador do Estoque do Veículo no RENAVE.

    

   Ele poderá ser preenchido informando a placa/renavam, caso tenha sido gravado com sucesso no retorno da operação ‘Solicita Entrada no Estoque’.

   Ou poderá ser informado, consultando na opção Consultas/Estoque Renave, descrita acima neste documento.

   Image Added

   
   

   
   

   Após informar o Identificador, será invocada operação para retornar o Termo de Saída do veículo no estoque do RENAVE (pdf):

   Image Added
   
   

3. Enviar informações da nota de Saída (chave da nfe), através da operação para Enviar Nota de Saída.

   Após a solicitação de saída do estoque e o retorno do Termo de Saída, deverá ser enviada a nfe de saída do veículo usado do estoque.

   Só após o envio da nota de saída o Detran vai poder emitir o CRV para o novo comprador do veículo.

   Informar os dados para envio da NFe de saída do veículo usado do estoque do RENAVE.

   Ao informar a placa será apresentado o Renavam informado na última Avaliação do veículo Seminovo e a chave da NFe de saída, que é atualizada na tabela de avaliação (cxavalia).
   Image Added

   Após informar todos os dados será invocada a operação de Envio da NFe de Saída do veículo do estoque da concessionária.

4. Antes de enviar a nota de Saída e antes do DETRAN efetivar a saída do veiculo do estoque, poderá ser feito o Cancelamento de Saída de Estoque.

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

Informar os dados para o cancelamento da saída.

Ao informar a placa será apresentado o Renavam informado na última Avaliação do veículo Seminovo e os dados do CRV do proprietário do veículo.

  Com a informação da placa caso já tenha sido feito a entrada do veículo no estoque será carregado o identificador do veículo no estoque do RENAVE.

Ou poderá ser informado, consultando na opção Consultas/Estoque Renave, descrita acima neste documento.

Image Added

Após a informação dos dados, será invocada operação para cancelar a saída do veículo do estoque do RENAVE.

Não serão feitas consistências para estas operações. O usuário será responsável por fazer a comunicação e observar o retorno das operações, através das mensagens retornadas.

Será apresentado um histórico das operações com o veículo (opção Consultas/Histórico Operações) , mostrando as operações que foram executadas com sucesso/erro, com a data das mesmas.

Assim o usuário saberá qual próximo processo deverá executar.

Processos de Transferência entre Filiais:

Será apresentada tela para informar os dados necessários para os processos de comunicação de transferência de veículo para outra filial.

Image Added

Serão apresentadas opções para as seguintes operações, que estão na ordem que deverão ser invocadas:

1. Solicitar transferência entre filiais (Filial DESTINO)→ se o veículo usado for vendido em outra filial

   Possibilitar que a filial solicite a transferência para seu estoque de um veículo que esteja no estoque de outra filial que compartilhe do mesmo prefixo de CNPJ.

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

   Deverá ser informada a Filial de Origem.

   Poderá ser buscada no cadastro, através da opção CTRL-E ou pela lupa.

   Ao informar a placa será verificado a avaliação de usados, caso já tenha sido feita, será preenchido o renavam e a KM do veículo.

   Se a KM tiver sido alterada após a última avaliação, deverá ser atualizada.

   Image Added

   Após a informação dos dados, será invocada operação para transferência entre filiais do veículo no estoque do RENAVE.

   
   

2. Enviar Nota de Saída (Filial Origem)

   
   

   Após a confirmação que o veículo foi transferido para outra filial (através da consulta do Termo de Saída), o estabelecimento cedendo o veículo deve enviar a nota fiscal de saída.

   Informar os dados para envio da NFe de saída do veículo usado do estoque do RENAVE, da filial Origem.

   Ao informar a placa será apresentado o Renavam informado na última Avaliação do veículo Seminovo.

   Terá que ser informado a chave da nota fiscal Saída por transferência.

   
   Image Added

3. Enviar Nota de Entrada (Filial Destino)

   Após a confirmação que o veículo foi transferido para a filial (através da consulta do Termo de Entrada), o estabelecimento estabelecimento recebendo o veículo deve enviar a nota fiscal de compra.

   Informar os dados para envio da NFe de entrada do veículo usado no estoque do RENAVE, na filial destino.

   Ao informar a placa será apresentado o Renavam informado na última Avaliação do veículo Seminovo.

   Terá que ser informado a chave da nota fiscal Entrada por transferência.

   
   
   

4. Consultar Termo de Saída do Estoque (Filial Origem)

   Já descrito acima neste documento.
   
   
   

5. Consultar Termo de Entrada no Estoque (Filial Destino)

   Já descrito acima neste documento.

Opção Consultas/Histórico de Operações

Apresenta todas as operações realizadas com o veículo – operações de Entrada, Saída e Transferência.

As operações de Consulta não serão gravadas neste histórico.

Através desta consulta poderão ser verificadas todas as operações realizadas para um determinado veículo, observando a data da operação e se houve sucesso ou erro, verificando assim qual a próxima operação deve ser enviada ou mesmo o que deve ser corrigido para enviar novamente com sucesso.

Deverão ser informados os filtros para listar as operações realizadas.

Image Added

Após informar os filtros, serão apresentadas as operações que foram realizadas para o veículo, se com Sucesso ou com Erro, e a mensagem de retorno da operação:

Image Added