O que é#
As certidões de distribuição dos Tribunais Regionais Federais atestam que uma pessoa ou empresa possui ou não alguma ação de natureza criminal.
Os Tribunais Regionais Federais são os tribunais de segunda instância do governo federal e são divididos em 6 regiões. Para cada região é disponibilizada uma consulta diferente no Plexi.
Sobre a requisição#
- Método: POST
- Endereço:
https://api.plexi.com.br/api/maestro/trf3/certidao-distribuicao - 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. |
| nome | string | Não | Nome associado ao documento informado |
| nomeSocial | string | Não | Nome social |
| abrangencia | string | Sim | Abrangência da certidão. A tabela abaixo apresenta os valores possíveis. |
| tipo | string | Sim | Tipo da certidão. A tabela abaixo apresenta os valores possíveis. |
Valores possíveis para o campo "abrangencia":
| Valor | Descrição |
|---|---|
| regional | Regional |
| sjsp | Seção Judiciária de São Paulo |
| sjms | Seção Judiciária de Mato Grosso do Sul |
| trf | Tribunal Regional Federal da 3ª Região |
Valores possíveis para o campo "tipo":
| Valor | Descrição |
|---|---|
| civel | Cível |
| criminal | Criminal |
| eleitoral | Para fins eleitorais (apenas CPF) |
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.
{
"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 nome é obrigatório."
]
}
}Exemplos de retornos do resultado da pesquisa#
Valores possíveis do campo "status"
| Status | Significado |
|---|---|
| positivo | A pessoa ou empresa possui ações na região TRF3 |
| indefinido | Não é possível informar se a pessoa ou empresa possui ações na região TRF3 |
| negativo | Empresa ou pessoa NÃO está associada a ações na região TRF3 |
Indefinido
Não é possível informar se a pessoa ou empresa possui ações na região TRF3. Para ter a certidão para esse caso é preciso fazer a solicitação diretamente pelo site.
{
"status": "indefinido",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}Positivo
{
"status": "positivo",
"numero": "2022/000000000000",
"codigoSeguranca": "0000000000000000",
"nome": "FULANO DA SILVA",
"nomeMae": "SICRANA DE TAL",
"dataNascimento": "01/01/1990",
"cpfCnpj": "999.999.999-99",
"dataHoraEmissao": "01/01/2020 12:00:00",
"processos": [
{
"numero": "9999999-99.2021.4.03.6100",
"classe": "1116 - EXECUÇÃO FISCAL",
"situacao": "ANDAMENTO",
"vara": "6100",
"juizo": "1ª Vara de Execuções Fiscais Federal Exemplo",
"tipoParte": "EXECUTADO"
}
],
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}Negativo
{
"status": "negativo",
"numero": "2022/000000000000",
"codigoSeguranca": "0000000000000000",
"nome": "FULANO DA SILVA",
"nomeMae": "SICRANA DE TAL",
"dataNascimento": "01/01/1990",
"cpfCnpj": "999.999.999-99",
"dataHoraEmissao": "01/01/2020 12:00:00",
"processos": [],
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}
