O que é#
Na consulta TCU - Relação de Inidôneos é possível verificar se uma pessoa é inidônea para licitação de acordo com o Tribunal de Contas da União.
Sobre a requisição#
Método: POST
Endereço: https://api.plexi.com.br/api/maestro/tcu/relacao-inidoneos
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 |
|---|---|---|---|
| cpfCnpj | string | Sim | CPF ou CNPJ a ser pesquisado, com ou sem máscara. Exemplos: 99999999999 ou 999.999.999-99 |
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": {
"cpfCnpj": [
"CPF ou CNPJ inválido"
]
}
}Resultados da pesquisa ( retornados no callback ou fazendo requisição à API de respostas )#
Valores possíveis do campo "status"
| Status | Significado |
|---|---|
| positivo | Documento está presente na listagem de pessoas inidôneas do TCU. |
| negativo | Não consta o documento na listagem de pessoas inidôneas do TCU. |
Resposta com documento encontrado
JSON
{
"status": "positivo",
"nomeResponsavel": "EMPRESA EXEMPLO LTDA",
"cpfCnpj": "99.999.999/9999-99",
"uf": "RJ",
"processo": "000.111/2021-1",
"deliberacao": "AC-999999/2021-PL",
"transitoJulgado": "01/01/2020",
"dataFinal": "01/01/2020",
"dataAcordao": "01/01/2020",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}Resposta com documento não encontrado
JSON
{
"status": "negativo",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}
