O que é
Na consulta Detran SP - Meu Veículo - DRV você pesquisa por dados dos seus veículos na área autenticada do Detran SP.
Veja mais informações em nossa central de ajuda: Detran SP - Meu Veículo - DRV
Sobre a requisição:
Método: POST
Endereço: URL Base + /api/maestro/detran-sp-drv
URL Base:
Parâmetros do header
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
Authorization | String | Sim | Chave de API gerada no cadastro no Plexi, prefixada com |
Callback | String | Não | URL para onde o resultado da requisição será enviado via HTTP POST. |
Parâmetros do body
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
renavam | string | Sim | Renavam do veículo a ser consultado (deve pertencer ao cpfCnpj informado) |
cpfCnpj | string | Sim | CPF ou CNPJ para login no site do Detran/SP. |
senha | string | Sim | Senha para login no site do Detran/SP. |
Estrutura da resposta
Status | Significado | Descrição | Informações retornadas |
---|---|---|---|
201 | Created | Solicitação criada | Campo requestId, com o ID da requisição criada. |
422 | Unprocessable Entity | A solicitação contém erro | Em quais campos houve erro. |
Exemplos de retornos
Status 201
A consulta recebida com sucesso e será processada. Com o ID retornado você pode consultar se já houve resposta.
{ "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42" }
Status 422
Significa que ocorreu um erro de validação dos dados enviados.
{ "message": "The given data was invalid.", "errors": { "cpf": [ "O campo cpf é obrigatório." ], "nome": [ "O campo name é obrigatório." ] } }
Resultados da pesquisa ( retornados no callback ou fazendo requisição à API de respostas )
Resposta com registro encontrado
{ "placa": "ABC1234", "renavam": "12345678901", "marca": "VOLVO\/VM 270 8X4R", "categoria": "PARTICULAR", "anoFabricacao": "2011", "anoModelo": "2011", "cor": "BRANCA", "combustivel": "DIESEL", "tipo": "CAMINHAO", "ipva": "NADA CONSTA", "detran": "NADA CONSTA", "der": 195.23, "dersa": "NADA CONSTA", "cetesb": "NADA CONSTA", "municipaisRenainf": 952.39, "policiaRodoviariaFederal": "NADA CONSTA", "restricoes": { "bloqueioFurtoRoubo": "NADA CONSTA", "administrativa": "NADA CONSTA", "tributaria": "NADA CONSTA", "judiciaria": "NADA CONSTA", "financeira": "BANCO ITAU BBA SA", "veiculoGuinchado": "NADA CONSTA" }, "inspecaoGnv": "NADA CONSTA", "licenciamento": { "ultimoLicenciamento": "2020", "statusLicenciamento": "em dia (prazo para licenciamento vencerá no próximo ano)." }, "licenciamentoDigital": { "acessoPermitido": "Sim", "motivo": "" }, "vistorias": [], "multasMensagem": "", "multas": [ { "orgao": "Munícipio Conveniado", "aiip": "ABC", "infracao": "Multa, por nao identificacao do condutor infrator, imposta a", "dataHora": "01\/01\/2020 00:00", "local": "AVENIDA NOVE DE JULHO (CENTRO\/", "municipio": "SAO PAULO", "valor": 529.63 }, { "orgao": "Munícipio Conveniado", "aiip": "ABC", "infracao": "Multa, por nao identificacao do condutor infrator, imposta a", "dataHora": "01\/01\/2020 00:00", "local": "AV SANTOS DUMONT (C\/B), A MENO", "municipio": "SAO PAULO", "valor": 660.23 } ], "pdf": "{PDF EM BASE64}" }
Resposta com erro
{ "status": "erro", "mensagem": "Senha inválida para o usuário informado." }
{ "status": "erro", "mensagem": "Usuário não cadastrado no Portal Detran." }
{ "status": "erro", "mensagem": "Detran não retornou informações para o renavam e cpfCnpj informados" }
{ "status": "erro", "mensagem": "Senha inválida para o usuário informado." }