O que é#
Consulta de certidão negativa de procedimentos extrajudiciais no Ministério Público Federal (MPF), a partir de um CPF ou CNPJ.
Sobre a requisição#
- Método: POST
- Endereço: https://api.plexi.com.br/api/maestro/mpf/certidao-negativa
- 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 |
|---|---|---|---|
| cpfCnpj | string | Sim | CPF ou CNPJ a ser pesquisado, com ou sem máscara. Exemplos: 99999999999 ou 999.999.999-99 |
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."
]
}
}Exemplos de retornos do resultado da pesquisa#
Valores possíveis do campo "status"
| Status | Significado |
|---|---|
| negativo | NÃO foram encontrados procedimentos extrajudiciais ao documento pesquisado |
| positivo | Foram encontrados procedimentos extrajudiciais relacionados ao documento pesquisado |
| erro | Erro ao buscar informações, seja por documento ou outro dado incorreto |
Respostas com registro encontrado
JSON
{
"status": "positivo",
"cpfCnpj": "99999999999999",
"dataAtualizacao": "01/01/2020 12:00",
"dataEmissao": "01/01/2020 12:00",
"etiquetasLocalizacoes": [],
"nome": "FULANO DE TAL",
"seloDigitalSeguranca": "00000000000000000000000000000000",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}JSON
{
"status": "negativo",
"cpfCnpj": "99999999999999",
"dataAtualizacao": "01/01/2020 12:00",
"dataEmissao": "01/01/2020 12:00",
"etiquetasLocalizacoes": [
{
"etiqueta": "1.00.000.000000/2020-00",
"localizacao": "PR-UF/GABPR0-XXXX - FULANO DE TAL"
},
{
"etiqueta": "1.00.000.000000/2020-01",
"localizacao": "PR-UF/GABPR0-XXXX - FULANO DE TAL"
}
],
"nome": "EMPRESA EXEMPLO LTDA",
"seloDigitalSeguranca": "00000000000000000000000000000000",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}Resposta com erro
JSON
{
"status": "erro",
"mensagem": "Pessoa jurídica não localizada com o CNPJ informado!",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}JSON
{
"status": "erro",
"mensagem": "Pessoa física não localizada com o CPF informado!",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}
