CENPROT SP - Central de Protesto do Estado de São Paulo

ATENÇÃO: essa consulta retorna protestos apenas de São Paulo

O que é

A consulta CENPROT SP - Central de Protesto do Estado de São Paulo informa se uma pessoa ou empresa tem relação com algum protesto nos cartórios de São Paulo.

Sobre a requisição:

Método: POST

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

URL Base:

Parâmetros do header

Nome

Tipo

Obrigatório?

Descrição

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

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

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

Status

Significado

negativo

Pessoa ou empresa NÃO está associada a protestos nos cartórios de são paulo.

positivo

Pessoa ou empresa está associada a protestos nos cartórios de são paulo.

Resposta com registro encontrado

{ "status": "negativo", "protocolo": "9999999999", "cpfCnpj": "99.999.999/9999-99", "quantidadeProtestos": 0, "valorProtestado": 0, "protestos": [], "pdf":"JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7..." }