CENPROT - Central Nacional de Protesto

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.

Veja mais informações em nossa central de ajuda: CENPROT - Central Nacional de Protesto

Sobre a requisição:

Método: POST

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

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

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

{
  "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": "SP",
      "dadosCartorio": [
        {
          "nomeCartorio": "5. TABELIAO DE PROTESTO DE LETRAS E TITULOS",
          "endereco": "RUA DA GLORIA, 168 LIBERDADE, SAO PAULO - SP",
          "bairro": "",
          "cidade": "SAO PAULO",
          "telefone": "11 32423143 ",
          "codIBGE": "3550308",
          "numeroCartorio": "05",
          "qtdTitulos": 1,
          "titulos": [
            {
              "cpfCnpj": "99999999999999",
              "dataProtesto": "12/06/2020",
              "dataVencimento": "",
              "valorProtestado": 9999.99,
              "temAnuencia": false,
              "nomeApresentante": "APRESENTANTE",
              "nomeCedente": "CEDENTE"
            }
          ]
        }
      ]
    }
  ]
}