View Source

ATENÇÃO: essa consulta retorna protestos de todos os estados exceto São Paulo

O que é

A consulta CENPROT - Central Nacional de Protesto informa se uma pessoa ou empresa tem relação com algum protesto dos cartórios participantes.

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/cenprot/consulta-protesto

URL Base:

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

{
  "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}

Status 422

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

Valores possíveis do campo “status“

Status	Significado
negativa	Pessoa ou empresa NÃO está associada a protestos nos cartórios participantes.
positiva	Pessoa ou empresa está associada a protestos nos cartórios participantes.

Resposta com registro encontrado

{
  "status": "negativa",
  "pdf":"JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7..."
}

{
  "dataConsulta":"05/08/2020 18:37",
  "cpfCnpj":"99999999999999",
  "qtdTitulos":2,
  "status":"positiva",
  "cartorios":[
    {
      "uf":"RS",
      "dadosCartorio":[
        {
          "nomeCartorio":"1°TABELIONATO DE PROTESTO DE TÍTULOS",
          "endereco":"AVENIDA INDEPENDÊNCIA, 925, 925",
          "bairro":"INDEPENDÊNCIA",
          "cidade":"PORTO ALEGRE",
          "telefone":"5130215600",
          "codIBGE":"4314902",
          "numeroCartorio":"01",
          "qtdTitulos":1,
          "titulos":[
            {
              "cpfCnpj":"99999999999999",
              "dataProtesto":"16/07/2020",
              "dataVencimento":"30/06/2020",
              "valorProtestado":40317.52,
              "temAnuencia":true,
              "nomeApresentante":"APRESENTANTE",
              "nomeCedente":"",
              "nm_chave":"9999999999999999999"
            }
          ]
        }
      ]
    },
    {
      "uf":"MG",
      "dadosCartorio":[
        {
          "nomeCartorio":"1º TABELIONATO DE PROTESTO DE TITULOS - CONTAGEM",
          "endereco":"AVENIDA JOSé FARIA DA ROCHA, 4011 1º ANDAR",
          "bairro":"ELDORADO",
          "cidade":"CONTAGEM",
          "telefone":"3125661100",
          "codIBGE":"3118601",
          "numeroCartorio":"01",
          "qtdTitulos":1,
          "titulos":[
            {
              "cpfCnpj":"99999999999999",
              "dataProtesto":"12/06/2020",
              "dataVencimento":"",
              "valorProtestado":9999.99,
              "temAnuencia":false,
              "nomeApresentante":"APRESENTANTE",
              "nomeCedente":"CEDENTE"
            }
          ]
        }
      ]
    }
  ],
  "pdf":"JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7..."
}