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 objetivo do Renave é registrar a movimentação de entrada e saída de estoque dos veículos dos estabelecimentos, de modo a simplificar a transferência da propriedade do vendedor para o lojista/concessionária.

"O sistema faz com que todo o processo de transferência de titularidade do carro usado seja feito de forma eletrônica. Os registros serão feitos em tempo real e validados pelo Denatran (Departamento Nacional de Trânsito), junto ao Detran (Departamentos de Trânsito), e secretaria de Fazenda.

Na prática, a empresa que vender veículos – seja ela uma concessionária seja uma revenda independente - poderá fazer o registro de entrada e saída do veículo no seu estoque de forma eletrônica e diretamente no órgão de trânsito responsável pelo licenciamento. Com isso, o consumidor que negociar seu veículo usado em uma revenda ou entregá-lo como parte da entrada para adquirir um novo, o simples registro eletrônico comprovará a transferência de domínio deste veículo.

O projeto de lei que criou o Renave prevê que ele substitua o livro de registro, previsto pelo Código de Trânsito Brasileiro, para que possa simplificar a transferência da propriedade do vendedor para o lojista comprador, incorporando este veículo ao estoque do lojista de forma eletrônica."

Nesta integração automática estão previstos o envio das informações referentes a Compra, Venda, Transferência de veículos Usados, bem como consulta aos documentos ATPV, CLRV, CRVRenave-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/Pagina

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

Conceitos 

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 as URLs de homologação e produção no CADA3100os 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.estaleirolinx.serpro.govcom.br/renave-ws/api/

    Homologação: https://hom.auto-renave.estaleirolinx.serpro.govcom.br/renave-ws/api/
    OBS:
    Deve finalizar com '/'
    Image Removed
  • 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 .
    Concessionária deve estar credenciada no DENATRAN e ter o certificado de comunicação instalado :(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.

Painel
  • 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

CRV - Certificado de Registro de Veículo

CRLV - Certificado de Registro e Licenciamento de Veículo

DENATRAN - Departamento Nacional de Trânsito

DETRAN - Departamento de Trânsito



Painel

Opções do Programa

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 Removed

Consultas:

Image Removed

  • 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 Removed

Aba Informações Débito:

Image Removed

Aba Dados do Veiculo:

Image Removed

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

Image Removed

Image Removed

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 Removed

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 Removed

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

Image Removed

Image Removed

Aba Complemento Detalhe:

Image Removed

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

Image RemovedATPV:

"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 Removed

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 Removed

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 Removed

  • CRLV

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

Image Removed

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 Removed

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 Removed

Image Removed

Image Removed

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 Removed

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 Removed

Serão apresentadas opções para as seguintes operações, que estão na ordem que deverão ser invocadas:
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 Removed

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 Removed
    Image Removed

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

    Image Removed

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

    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 Removed

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

    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.

    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 Removed

    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 Removed

    Serão apresentadas opções para as seguintes operações, que estão na ordem que deverão ser invocadas:
    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 Removed

    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 Removed

    Após a informação dos dados, será invocada operação para saída do veículo no estoque do RENAVE.
    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 Removed

    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 Removed
  • 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 Removed

    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.

  • 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 Removed

    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 Removed

    Serão apresentadas opções para as seguintes operações, que estão na ordem que deverão ser invocadas:
    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 Removed

    Após a informação dos dados, será invocada operação para transferência entre filiais do veículo no estoque do RENAVE.
    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 Removed
    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.

    Consultar Termo de Saída do Estoque (Filial Origem)
    Já descrito acima neste documento.
  • 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 Removed

    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 Removed

    Painel
    borderStyledashed
    Painel

    Solução de problemas 

    Descrever as principais dificuldades que podem aparecer para o usuário e dar dicas de como ele pode resolve-las.

    Painel
    borderStyledashed

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

    Verificar 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.
  • Objeto "renave.jar" deve estar no diretório /lib do diretório onde o Sisdia é executado.
  • As URLs de produção e homologação cadastradas no CADA3100, para a Identificação RENAVE_WS
    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

    Image Added


    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

    Image Added


    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

    Image Added


    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

    Image Added

    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 Added

    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

    Image Added

    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

    Image Added

    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

    Image Added


    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.

    Image Added

    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 Added

    Image Added

    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

    Image Added

    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

    Image Added

    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 Added

    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 Added

    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 Added

    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 Added

    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

    Image Added

    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 Added

    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 Added

    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

    Image Added

    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

    Image Added

    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

    Image Added


    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

    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 Added

    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

    Image Added




    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:

    Image Added

    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 Added

    Image Added

    Image Added


    STATUS RETORNADOS PELO WEBSERVICE RENAVE-WS

    Image Added


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

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

     

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

    Image Added

     

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

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