Detran SC - Consulta Completa do Veículo

O que é#

Na consulta Detran SC - Consulta Completa do Veículo você obtém o dossiê consolidado de um veículo registrado no estado de Santa Catarina, incluindo dados cadastrais, situação, débitos (IPVA e licenciamento), histórico de multas, multas a pagar, recursos de infração, processos e IPVA em dívida ativa, além do extrato em PDF. Requer autenticação via certificado digital Gov.br (e-CPF/e-CNPJ).

Sobre a requisição#

Método: POST

Endereço: https://api.plexi.com.br/api/maestro/detran-sc/veiculos/consulta-completa-veiculo

URL Base: https://api.plexi.com.br/

Parâmetros do header#

Nome	Tipo	Obrigatório?	Descrição
Authorization	String	Sim	Chave de API gerada no cadastro no Plexi, prefixada com `Bearer`
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
placa	string	Sim	Placa do veículo a ser pesquisado.
renavam	string	Sim	Renavam do veículo a ser pesquisado.
certificate	string	Sim	Identificador do certificado a ser utilizado para autenticação.

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 quando você faz a requisição#

Status 201

A consulta recebida com sucesso e será processada. Com o ID retornado você pode consultar se já houve resposta.

JSON

{
  "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}

Status 422

Significa que ocorreu um erro de validação dos dados enviados.

JSON

{
  "message": "The given data was invalid.",
  "errors": {
    "cpf": [
      "O campo cpf é obrigatório."
    ],
    "nome": [
      "O campo nome é obrigatório."
    ]
  }
}

Resultados da pesquisa (retornados no callback ou fazendo requisição à API de respostas)#

Resposta com registro encontrado

JSON

{
  "placa": "ABC1234",
  "renavam": "99999999999",
  "lugares": "5",
  "tipo": "Automovel",
  "cor": "Branca",
  "combustivel": "Alcool-Gasol",
  "carroceria": "Nao Aplicavel",
  "categoria": "Particular",
  "anoFabricacao": "2015",
  "anoModelo": "2016",
  "dataAquisicao": "01/01/2020",
  "municipioEmplacamento": "CIDADE EXEMPLO",
  "situacao": "Em circulação",
  "marca": "MARCA EXEMPLO",
  "modelo": "MODELO EXEMPLO",
  "proprietarioAtual": "FULANO DE TAL",
  "proprietarioAnterior": "BELTRANO DE TAL",
  "restricaoVenda": "Sem gravame",
  "restricoes": "",
  "licenciado": "2023 CRLV Digital",
  "origemDados": "Cadastro",
  "principalCondutor": "",
  "especie": "Passageiro",
  "historicoMultas": [
    {
      "numeroAuto": "E00000000",
      "situacao": "Penalidade notificada",
      "descricao": "TRANSITAR EM VEL SUPERIOR À MÁXIMA PERMITIDA EM ATÉ 20%",
      "data": "01/01/2020",
      "hora": "12:09",
      "localComplemento": "BR-101 KM 000.000 - CIDADE EXEMPLO/SC ",
      "valor": 85.13
    }
  ],
  "multasPagar": [],
  "debitos": [
    {
      "classe": "Licenciamento Anual 2024",
      "numeroDetranNET": "00000000",
      "vencimento": "30/12/2024",
      "valorAtual": 149.37,
      "exercicio": 2024
    }
  ],
  "recursoInfracao": [
    {
      "processo": "Indicação Condutor 00000/2020 Em 01/01/2020 requerido pelo Proprietário",
      "numeroAuto": "CIDADE-000000-0000000000-0000-0",
      "detalhamentoInfracao": "TRANSITAR EM VEL SUPERIOR À MÁXIMA PERMITIDA EM ATÉ 20%",
      "resultadoProcesso": ""
    }
  ],
  "processos": [],
  "ipvaDividaAtiva": [],
  "valorTotalDebitos": 149.37,
  "valorTotalMultasPagar": 0,
  "valorTotalHistoricoMultas": 85.13,
  "ultimoProcesso": {
    "processo": "000000/2019",
    "inicioEm": "01/01/2020 10:42",
    "finalEm": "01/01/2020 09:58",
    "interessado": "999.999.999-99",
    "situacao": "Encerrado",
    "servicos": [
      {
        "nome": "Transferência de Propriedade",
        "data": "01/01/2020",
        "hora": "10:42"
      },
      {
        "nome": "Geração de guia de pagamento",
        "data": "01/01/2020",
        "hora": "10:42"
      },
      {
        "nome": "Auditoria",
        "data": "01/01/2020",
        "hora": "09:58"
      },
      {
        "nome": "Emissão CRV(1ª via)",
        "data": "01/01/2020",
        "hora": "12:28"
      }
    ]
  },
  "pdf": "<pdf em base64>"
}

Resposta com erro

JSON

{"status": "erro", "mensagem": "Veículo não encontrado"}

JSON

{"status": "erro", "mensagem": "O veículo consultado está protegido. Entre em contato com o proprietário do veículo."}