Orientações e respostas da equipe da Direct Data

💡 A API Protestos - SP permite consultar a existência de protestos registrados exclusivamente no estado de São Paulo, fornecendo detalhes sobre os registros e os cartórios envolvidos.

Introdução

A API Protestos - SP realiza consultas detalhadas sobre protestos de pessoas físicas e jurídicas registrados no Instituto de Estudos de Protesto de Títulos do Brasil (IEPTB) do estado de São Paulo. Ideal para análises de crédito e validações cadastrais.

---

URL Base

A API está hospedada no seguinte endereço:

https://api.directd.com.br

---

Endpoint

Consulta de Protestos em São Paulo

GET /api/ProtestosSP

Descrição: Endpoint para consultar protestos registrados no estado de São Paulo.

Nota: É possível gerar um comprovante em PDF mediante configuração adicional.

---

Autenticação

Para acessar esta API, é necessário fornecer um token de autenticação.

Regras de Autenticação:

1. O token deve ser enviado como parâmetro na URL da requisição.
2. O token é obrigatório para realizar consultas.

---

Campos da API

Dados Gerais

• Documento Consultado: CPF ou CNPJ consultado.
• Data da Consulta: Data em que a consulta foi realizada.
• Flag Protestos: Indica se há protestos registrados.
• Número Total de Protestos: Total de protestos registrados para o documento consultado.
• Número Total de Protestos no Estado: Total de protestos registrados no estado de São Paulo.

Protestos

• Estado: Unidade Federativa (sempre SP).
• Pesquisa Efetuada Em: Data de realização da pesquisa.
• Pesquisa Retroativa Até: Data limite da pesquisa retroativa.

Detalhes do Cartório

• Nome: Nome do cartório responsável pelo protesto.
• Cidade: Cidade onde o cartório está localizado.
• Endereço: Endereço do cartório.
• Telefone: Telefone de contato do cartório.
• Código do Cartório: Código identificador do cartório.
• Código da Cidade: Código identificador da cidade.
• Data de Atualização: Data da última atualização do registro no cartório.
• Número de Protestos: Número de protestos registrados no cartório.

Detalhes do Protesto

• Data do Protesto: Data em que o protesto foi registrado.
• Valor Protestado: Valor associado ao protesto.

---

Parâmetros

---

Exemplos de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/ProtestosSP?CPF=12345678909&TOKEN=seu_token_aqui&GERARCOMPROVANTE=Habilitar'

---

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "Protestos - SP",
    "consultaUid": "protestosSP-123456",
    "usuario": "João Silva",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 150
  },
  "retorno": {
    "constamProtestos": true,
    "documentoConsultado": "123.456.789-09",
    "dataConsulta": "2024-12-09",
    "protestos": [
      {
        "estado": "SP",
        "pesquisaEfetuadaEm": "2024-12-08",
        "pesquisaRetroativaAte": "2024-01-01",
        "cartoriosProtesto": [
          {
            "cidade": "São Paulo",
            "nome": "Cartório Central",
            "endereco": "Rua Central, 123",
            "observacao": "Registro atualizado",
            "telefone": "(11) 98765-4321",
            "codigoCartorio": "12345",
            "codigoCidade": "3550308",
            "dataAtualizacao": "2024-12-07",
            "numProtestos": 2,
            "protesto": [
              {
                "dataProtesto": "2024-11-01",
                "valorProtestado": "5000.00"
              },
              {
                "dataProtesto": "2024-10-15",
                "valorProtestado": "3000.00"
              }
            ]
          }
        ],
        "totalNumProtestosUf": 10
      }
    ],
    "totalNumProtestos": 10,
    "observacoes": "Consulta realizada com sucesso."
  }
}

---

Erros Comuns

---

Notas Importantes

• Apenas um CPF ou CNPJ pode ser informado por requisição.
• O comprovante em PDF é opcional e gera um custo adicional.
• Certifique-se de que seu saldo na plataforma seja suficiente para a consulta.