Fazenda SP - Débitos vinculados ao veículo

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

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

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.
secretName	string	Sim	Identificador do certificado a ser utilizado para autenticação.

Retornos possíveis da requisição

Status	Significado	Descrição	Informações retornadas

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.

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

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

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