O que é#

Na consulta Detran GO - Situação do Veículo - você verifica informações e a situação de um veículo com placa registrada no estado de Goiás.

Sobre a requisição#

Método: POST

Endereço: URL Base + /api/maestro/detran-go/veiculos/situacao-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.

Retornos possíveis da requisição#

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#

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

Status 422#

JSON
{
  "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#

JSON
{
    "placa": "ABC1234",
    "renavam": "987654321",
    "chassi": "X1Y2Z3A4B5C6D7E8F",
    "marcaModelo": "MOTOMAK 2000",
    "numeroMotor": "MOT123456789",
    "tipo": "MOTONETA",
    "cor": "VERMELHA",
    "carroceria": "NAO APLICAVEL",
    "anoFabricacao": 2010,
    "anoModelo": 2011,
    "combustivel": "GASOLINA",
    "potencia": "001",
    "cilindradas": "1000",
    "categoria": "PARTICULAR",
    "capacidadePassageiros": 3,
    "especie": "PASSAGEIRO",
    "nacionalidade": "NACIONAL",
    "municipio": "CIDADE A",
    "uf": "GO",
    "dataAquisicao0Km": "01/01/2011",
    "dataAquisicao": "01/01/2012",
    "dataTransferencia": "01/01/2013",
    "situacao": "EM CIRCULACAO",
    "restricoes": "Nada Consta",
    "rouboFurto": "NADA CONSTA",
    "anoUltimoLicenciamento": 2013,
    "anoUltimoLicenciamentoPago": 2013,
    "observacao": "SEM RESERVA DE DOMINIO",
    "crlve": "CRLVe IMPEDIDO, MOTIVO: COMUNICADO DE VENDA ATIVO",
    "debitosVeiculo": [
        {
            "anoReferencia": 2023,
            "ipva": "ISENTO",
            "licenciamento": 150.0,
            "seguroObrigatorio": null,
            "infracoes": null,
            "dataVencimento": "01/01/2024",
            "valorTotal": 150.0
        },
        {
            "anoReferencia": 2022,
            "ipva": "ISENTO",
            "licenciamento": 200.0,
            "seguroObrigatorio": "NAO SE APLICA",
            "infracoes": null,
            "dataVencimento": "01/01/2023",
            "valorTotal": 200.0
        },
        {
            "anoReferencia": 2021,
            "ipva": "DEBITO NA SEFAZ",
            "licenciamento": 200.0,
            "seguroObrigatorio": "NAO SE APLICA",
            "infracoes": null,
            "dataVencimento": "01/01/2022",
            "valorTotal": 200.0
        },
        {
            "anoReferencia": 2020,
            "ipva": "DEBITO NA SEFAZ",
            "licenciamento": 200.0,
            "seguroObrigatorio": "PRESCRITO",
            "infracoes": 300.0,
            "dataVencimento": "01/01/2021",
            "valorTotal": 500.0
        },
        {
            "anoReferencia": 2019,
            "ipva": "DEBITO NA SEFAZ",
            "licenciamento": 200.0,
            "seguroObrigatorio": "PRESCRITO",
            "infracoes": null,
            "dataVencimento": "01/01/2019",
            "valorTotal": 200.0
        },
        {
            "anoReferencia": 2017,
            "ipva": "DEBITO NA SEFAZ",
            "licenciamento": "DIVIDA ATIVA",
            "seguroObrigatorio": "PRESCRITO",
            "infracoes": 200.0,
            "dataVencimento": "01/01/2018",
            "valorTotal": 200.0
        }
    ],
    "debitosInfracoes": {
        "vencidas": [
            {
                "autoInfracao": "R123456789",
                "orgaoAutuador": "GOINFRA - GO",
                "responsavelInfracao": "CONDUTOR",
                "dataVencimento": "01/01/2021",
                "valor": 150.0,
                "valorComDesconto": 120.0,
                "localInfracao": "Rodovia Estadual XYZ",
                "descricaoInfracao": "TRANSITAR VELOC SUPERIOR MAX PERMIT ENTR 20% E 50%",
                "pontos": 3,
                "dataInfracao": "01/12/2012",
                "dataNotificacao": "01/01/2023",
                "horaInfracao": "08:30",
                "grupoInfracao": "MEDIA"
            },
            {
                "autoInfracao": "R987654321",
                "orgaoAutuador": "GOINFRA - GO",
                "responsavelInfracao": "CONDUTOR",
                "dataVencimento": "01/01/2022",
                "valor": 200.0,
                "valorComDesconto": 180.0,
                "localInfracao": "Avenida Principal",
                "descricaoInfracao": "INFRAÇÃO DE TRÂNSITO",
                "pontos": 4,
                "dataInfracao": "01/12/2023",
                "dataNotificacao": "01/01/2024",
                "horaInfracao": "14:00",
                "grupoInfracao": "GRAVE"
            }
        ],
        "naoVencidas": [],
        "sobJudice": [],
        "parcelada": [],
        "notificada": [],
        "sistemaDeNotificacaoEletronica": []
    },
    "outrosDebitos": null,
    "bloqueioAdministrativo": [
        {
            "tipo": "5.19-BLOQ. VEIC. 25 ANOS (FROTA DESATIVADA)",
            "nomeBloqueio": "5.19-BLOQ. VEIC. 25 ANOS (FROTA DESATIVADA)",
            "dataInclusao": "01/01/2023",
            "situacao": "2 - Bloqueado"
        }
    ],
    "bloqueioJudicial": [
        {
            "numeroProcesso": "Processo Judicial - 1234567890",
            "tribunal": "Tribunal de Justiça - Comarca XYZ",
            "comarca": "TJGO",
            "tipo": "3-CIRCULACAO;",
            "dataInclusao": "01/01/2022"
        }
    ],
    "licenciamentoNotificado": [
        {
            "anoReferencia": "2019, 2020",
            "numeroNotificacao": "1234567890",
            "valor": 500.0,
            "situacaoDebito": "LICENCIAMENTO NOTIFICADO",
            "situacaoRecurso": "NÃO EXISTE RECURSO CADASTRADO"
        }
    ],
    "dividaAtiva": [
        {
            "anoReferencia": "2019, 2014, 2015",
            "numeroNotificacao": "2019123456789",
            "valorTotal": 1000.0,
            "situacaoDebito": "DIVIDA ATIVA",
            "statusRecurso": "NÃO EXISTE RECURSO CADASTRADO"
        }
    ],
    "gravame": {
        "numeroGravame": "987654321",
        "dataStatus": "01/01/2020",
        "status": "BAIXADA",
        "agenteFinanceiro": "Instituição Financeira XYZ",
        "cpfCnpjAgenteFinanceiro": "99.999.999/9999-99"
    }
}

A depender da resposta da fonte, alguns campos do registro podem ser retornados como nulos. Exemplos: dataAquisicao e dataAquisicao0Km.

Resposta com erro#

JSON
{
  "status": "erro",
  "mensagem": "Placa e/ou Renavam inválidos ou veículo não registrado no DETRAN-GO. Verifique novamente os dados informados."
}