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ção | Endpoint |
|---|---|
| Entrada no estoque por compra | POST /renave/nota-fiscal/entrada |
| Saída do estoque por venda | POST /renave/nota-fiscal/saida |
| Entrada de veículo próprio (sem compra) | POST /renave/estoque/entrada-veiculo-proprio |
| Cancelar uma entrada | POST /renave/estoque/cancelamento-entrada |
| Cancelar uma saída | POST /renave/estoque/cancelamento-saida |
| Consultar o resultado | GET /renave/{recibo} |
Como toda operação da v3, o RENAVE é assíncrono: você envia, recebe um recibo e consulta.
-
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": "..." } } -
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. Orecibotambém serve.
Campos
Comuns às três operações de registro
| Campo | Obrigatório | Regra |
|---|---|---|
chaveNFe | sim | 44 dígitos, NF-e modelo 55 da própria empresa |
cpfOperadorResponsavel | sim | CPF de quem opera o registro, 11 dígitos sem pontuação |
veiculo.placa | sim | ABC1234 ou ABC1D23 (Mercosul), sem hífen |
veiculo.numeroCrv | sim | Número do CRV |
veiculo.renavam | sim | Número do Renavam |
Entrada por compra (/renave/nota-fiscal/entrada)
| Campo | Obrigatório | Regra |
|---|---|---|
dataCompra | sim | Data da compra (AAAA-MM-DD). Não pode ser anterior à emissão do último CRV |
valorCompra | sim | Número maior que zero |
emailVendedor | sim | E-mail de quem vendeu o veículo |
veiculo.codigoSegurancaCrv | recomendado | Código de segurança do CRV |
veiculo.tipoCrv | recomendado | AZUL, VERDE, BRANCO ou DIGITAL |
veiculo.dataHoraMedicaoHodometro / veiculo.quilometragemHodometro | recomendado | Leitura do hodômetro; km em número inteiro |
veiculo.documentoProprietarioAtual / veiculo.tipoDocumentoProprietarioAtual | recomendado | CPF/CNPJ do proprietário anterior; tipo CPF ou CNPJ |
Saída por venda (/renave/nota-fiscal/saida)
| Campo | Obrigatório | Regra |
|---|---|---|
dataVenda | sim | Data da venda (AAAA-MM-DD) |
valorVenda | sim | Número maior que zero |
veiculo.codigoSegurancaCrv | recomendado | Código de segurança do CRV |
comprador.nome / comprador.email | sim | Dados do comprador |
comprador.tipoDocumento / comprador.numeroDocumento | recomendado | CPF ou CNPJ, e o número |
comprador.endereco | sim | logradouro, numero, bairro, cep, municipio e uf (2 letras) |
Entrada de veículo próprio (/renave/estoque/entrada-veiculo-proprio)
| Campo | Obrigatório | Regra |
|---|---|---|
dataEntradaEstoque | sim | Data da entrada (AAAA-MM-DD) |
veiculo.codigoSegurancaCrv | sim | Código de segurança do CRV |
veiculo.dataHoraMedicaoHodometro | sim | Data e hora da leitura do hodômetro |
veiculo.quilometragemHodometro | sim | Km em número inteiro |
veiculo.tipoCrv | sim | AZUL, 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
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
status | Significado |
|---|---|
002 | Ainda na fila. Consulte de novo |
003 | Sendo enviado ao SERPRO |
004 | Registrado no RENAVE. Traz id-renave e id-estoque |
010 | Movimento cancelado |
900 | Recusado pelo RENAVE/SERPRO ou pela validação. Motivo em data.mensagem ou data.erro |
999 | Erro interno do SERPRO, falha de comunicação ou resultado indeterminado. Veja Reenvio |
500 | Recibo 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 CRV | dataCompra antes da data do CRV atual do veículo |
| Veículo não está no estoque do estabelecimento | Saída de um veículo sem entrada registrada (ou já baixado) |
| Código de segurança do CRV não confere | codigoSegurancaCrv diferente do último CRV |
| Vendedor deveria ser o proprietário do veículo | documentoProprietarioAtual não é o dono atual |
| Detran do estado não respondeu | Indisponibilidade do Detran da UF da nota. Tente mais tarde |