O que é

Na consulta Fazenda SP - Débitos vinculados ao veículo - você verifica se um veículo com placa registrada no estado São Paulo possui algum débito ou restrição.

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/fazenda-sp/debitos-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.

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 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
{
    "renavam": "99999999999",
    "placa": "ABC1D23",
    "proprietario": "EMPRESA LTDA",
    "cpfCnpjProprietario": "***.999.999-**",
    "debitos": [
        {
            "tipoServico": 13,
            "descricaoServico": "Licenciamento",
            "descricao": "LICENCIAMENTO 2024",
            "valor": 189.30,
            "dataVencimento": "2024-07-31"
        },
        {
            "tipoServico": 9,
            "descricaoServico": "Transferencia",
            "descricao": "TRANSFERENCIA DE VEICULO",
            "valor": 275.48,
            "dataVencimento": "2024-09-15"
        }
    ],
    "multas": [
        {
            "numeroAit": "9A9999999",
            "dataInfracao": "2024-03-15T00:00:00",
            "dataVencimento": "2024-05-20",
            "descricaoInfracao": "Estacionar em desacordo com a regulamentacao.",
            "municipio": "Sao Paulo",
            "numeroGuia": "999999999",
            "orgaoAutuador": "MUNICIPAL",
            "valor": 233.16
        }
    ],
    "pdf": "JVBERi0xLjQKMSAwIG9iago8PA..."
}

Resposta com erro

JSON
{
    "status": "erro",
    "mensagem": "RENAVAM/PLACA NAO ENCONTRADOS"
}