Pular para o conteúdo

RENAVE — estoque de veículos

O RENAVE (Registro Nacional de Veículos em Estoque) é o registro, no SERPRO, de cada veículo que entra ou sai do estoque de uma revenda. A API do FazNota envia esses registros vinculados à NF-e da operação, devolve o resultado do SERPRO e permite cancelar.

Contrato completo e consulta por recibo desde a versão 3.14.0.

Pré-requisitos

  • Certificado digital A1 da empresa no FazNota.
  • E-mail principal no cadastro da empresa, que vai ao SERPRO como e-mail do estabelecimento.
  • Empresa credenciada no RENAVE junto ao Detran do estado.
  • NF-e modelo 55 da operação, emitida pela própria empresa: a chave tem de ser do CNPJ dela.

Operações

OperaçãoEndpoint
Entrada no estoque por compraPOST /renave/nota-fiscal/entrada
Saída do estoque por vendaPOST /renave/nota-fiscal/saida
Entrada de veículo próprio (sem compra)POST /renave/estoque/entrada-veiculo-proprio
Cancelar uma entradaPOST /renave/estoque/cancelamento-entrada
Cancelar uma saídaPOST /renave/estoque/cancelamento-saida
Consultar o resultadoGET /renave/{recibo}

Como toda operação da v3, o RENAVE é assíncrono: você envia, recebe um recibo e consulta.

  1. Registrar a entrada de um veículo comprado

    Terminal window
    curl -X POST $BASE/renave/nota-fiscal/entrada \
    -H "Authorization: Token $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
    "chaveNFe": "35261012345678000190550010000012341000012345",
    "cpfOperadorResponsavel": "12345678901",
    "dataCompra": "2026-10-20",
    "valorCompra": 45000.00,
    "emailVendedor": "[email protected]",
    "veiculo": {
    "placa": "ABC1D23",
    "numeroCrv": "123456789012",
    "renavam": "01234567890",
    "codigoSegurancaCrv": "12345678901",
    "tipoCrv": "DIGITAL",
    "dataHoraMedicaoHodometro": "2026-10-20T10:00:00",
    "quilometragemHodometro": 52000,
    "documentoProprietarioAtual": "98765432100",
    "tipoDocumentoProprietarioAtual": "CPF"
    }
    }'

    Resposta: { "status": "001", "descricao": "Evento RENAVE registrado com sucesso.", "data": { "recibo": "..." } }

  2. Consultar o resultado

    Terminal window
    curl $BASE/renave/{recibo} -H "Authorization: Token $TOKEN"

    Quando o SERPRO aceita:

    {
    "status": "004",
    "descricao": "Evento registrado no RENAVE.",
    "data": {
    "processo": "nota_fiscal_entrada",
    "id-renave": "123",
    "evento": "COMPRA",
    "chaveNFe": "35261012345678000190550010000012341000012345",
    "placa": "ABC1D23",
    "id-estoque": "987654",
    "status-integracao": "ENVIADA_COM_SUCESSO",
    "tentativas": 1,
    "data-envio": "2026-10-20 10:05:12",
    "data-resposta": "2026-10-20 10:05:14",
    "cancelado": false
    }
    }

    Guarde o id-renave: ele identifica o registro no cancelamento. O recibo também serve.

Campos

Comuns às três operações de registro

CampoObrigatórioRegra
chaveNFesim44 dígitos, NF-e modelo 55 da própria empresa
cpfOperadorResponsavelsimCPF de quem opera o registro, 11 dígitos sem pontuação
veiculo.placasimABC1234 ou ABC1D23 (Mercosul), sem hífen
veiculo.numeroCrvsimNúmero do CRV
veiculo.renavamsimNúmero do Renavam

Entrada por compra (/renave/nota-fiscal/entrada)

CampoObrigatórioRegra
dataComprasimData da compra (AAAA-MM-DD). Não pode ser anterior à emissão do último CRV
valorComprasimNúmero maior que zero
emailVendedorsimE-mail de quem vendeu o veículo
veiculo.codigoSegurancaCrvrecomendadoCódigo de segurança do CRV
veiculo.tipoCrvrecomendadoAZUL, VERDE, BRANCO ou DIGITAL
veiculo.dataHoraMedicaoHodometro / veiculo.quilometragemHodometrorecomendadoLeitura do hodômetro; km em número inteiro
veiculo.documentoProprietarioAtual / veiculo.tipoDocumentoProprietarioAtualrecomendadoCPF/CNPJ do proprietário anterior; tipo CPF ou CNPJ

Saída por venda (/renave/nota-fiscal/saida)

CampoObrigatórioRegra
dataVendasimData da venda (AAAA-MM-DD)
valorVendasimNúmero maior que zero
veiculo.codigoSegurancaCrvrecomendadoCódigo de segurança do CRV
comprador.nome / comprador.emailsimDados do comprador
comprador.tipoDocumento / comprador.numeroDocumentorecomendadoCPF ou CNPJ, e o número
comprador.enderecosimlogradouro, numero, bairro, cep, municipio e uf (2 letras)

Entrada de veículo próprio (/renave/estoque/entrada-veiculo-proprio)

CampoObrigatórioRegra
dataEntradaEstoquesimData da entrada (AAAA-MM-DD)
veiculo.codigoSegurancaCrvsimCódigo de segurança do CRV
veiculo.dataHoraMedicaoHodometrosimData e hora da leitura do hodômetro
veiculo.quilometragemHodometrosimKm em número inteiro
veiculo.tipoCrvsimAZUL, VERDE, BRANCO ou DIGITAL

A chaveNFe identifica o movimento no FazNota, mas não é enviada ao SERPRO. Nesta operação basta que tenha 44 caracteres.

Cancelar

Terminal window
curl -X POST $BASE/renave/estoque/cancelamento-entrada \
-H "Authorization: Token $TOKEN" -H "Content-Type: application/json" \
-d '{ "id-renave": "123" }'

Use cancelamento-entrada para entrada por compra ou de veículo próprio, e cancelamento-saida para venda. Informe o id-renave ou o recibo do registro. Os dados do veículo saem do próprio registro. Só é possível cancelar um registro que o SERPRO aceitou e que ainda não foi cancelado. A consulta do recibo do cancelamento responde status: "010".

Status da consulta

statusSignificado
002Ainda na fila. Consulte de novo
003Sendo enviado ao SERPRO
004Registrado no RENAVE. Traz id-renave e id-estoque
010Movimento cancelado
900Recusado pelo RENAVE/SERPRO ou pela validação. Motivo em data.mensagem ou data.erro
999Erro interno do SERPRO, falha de comunicação ou resultado indeterminado. Veja Reenvio
500Recibo inexistente

Reenvio

O mesmo pedido (mesma chaveNFe e mesma operação) é idempotente:

  • enquanto está na fila ou depois de registrado com sucesso, reenviar devolve o recibo original;
  • depois de uma recusa (900), corrija o que o motivo indicar e envie de novo. Reenviar o mesmo conteúdo não vai passar;
  • depois de um erro técnico (999), reenvie o mesmo pedido.

Nos dois casos o reenvio é aceito. O FazNota reaproveita o mesmo registro e conta mais uma tentativa, em vez de criar outro.

Recusado na hora (status: "400")

O pedido nem entra na fila, e o motivo vem na descricao e em data.erro, quando falta um campo obrigatório ou ele está fora da regra (chave, CPF do operador, placa, valores, comprador), ou quando a empresa não tem certificado A1 ou e-mail principal cadastrado. No cancelamento, também quando o registro não é desta empresa, não foi aceito pelo SERPRO, já foi cancelado ou é de outro tipo (cancelar a saída de uma entrada, por exemplo).

Recusas comuns do SERPRO (status: "900")

Mensagem (resumo)Causa provável
Data da compra anterior à emissão do último CRVdataCompra antes da data do CRV atual do veículo
Veículo não está no estoque do estabelecimentoSaída de um veículo sem entrada registrada (ou já baixado)
Código de segurança do CRV não conferecodigoSegurancaCrv diferente do último CRV
Vendedor deveria ser o proprietário do veículodocumentoProprietarioAtual não é o dono atual
Detran do estado não respondeuIndisponibilidade do Detran da UF da nota. Tente mais tarde