Ícone Procob Crédito Bureau

Ícone Procob Contratar

O Credit Bureau é um relatório completo sobre consumidores, com dados cadastrais, de comportamento em negócios e de relacionamento com o mercado. Seu objetivo é subsidiar a análise do risco de crédito com consumidores, proporcionando mais rapidez e segurança aos negócios.

O que é? Melhor consulta de informações sobre Pessoas Físicas, junto a maior e mais consultada Base de Dados do Brasil: Serasa Experian. Para acessar o produto, basta informar o CPF do consumidor.
A quem se destina? Destinado a empresas que necessitam conhecer melhor seus clientes, subsidiar suas decisões de crédito e combater fraudes com dados cadastrais, registros de consultas e anotações de inadimplência.
Formas de acesso Consulta Online (usuário/senha);
Web Services – API (SOAP / HTTPS);
Traz quais informações? Síntese cadastral – regularidade na Receita Federal;
Registro de consultas efetuadas;
Últimas consultas efetuadas;
Informações cadastrais;
Pendências Financeiras (PEFIN/REFIN);
Protesto Nacional;
Ações Judiciais;
Participações em Insucesso Empresarial;
Mais Anotações;

Campos Obrigatórios

  • =
  • Parâmetros

  • =
  • =
  • =
  • =
  • =
  • Pelo menos um campo deve ser preenchido!

    Resposta Linha Padrão

    URL Requisitada:

    Campos Obrigatórios

    Nome Tipo Formato Descrição Obrigatório?
    documento String /(^\d{11}$)/ CPF a ser pesquisado SIM

    Parâmetros

    Nome Tipo Formato Descrição Obrigatório?
    indiceRelacionamentoMercado String /(SIM)/ Feature Indice de Relacionamento com o Mercado [SIM] NAO
    alertaIdentidade String /(SIM)/ Feature Alerta Identidade [SIM] NAO
    rendaPro String /(SIM)/ Feature Renda Pro [SIM] NAO
    comprometimentoMensalEstimado String /(SIM)/ Feature Comprometimento Mensal Estimado [SIM] NAO
    capacidadeMensalPagamento String /(SIM)/ Feature Capacidade Mensal de Pagamento [SIM] NAO

    Ícone Procob Autenticação

    Todas as chamadas a API devem ser autenticadas, o formato escolhido é a autenticação basic através do header Basic Authorization. Nesse header é enviado o email concatenado por dois pontos (:) mais a senha, tudo junto sem espaços. Esse conteúdo é convertido para uma chave usando algoritmos de base 64, ficando como o exemplo abaixo:

    Authorization: Basic UUAN5678e9WsdDdsSaD54854=

    É possível gerar o valor a ser enviado no cabeçalho através do comando unix abaixo:

    echo -n conta:Senha | base64

    É possível fazer esse procedimento através do site base64Encode gratuitamente.

    Para realizar os testes aqui no Sandbox basta preencher o usuário e senha no formulário no topo superior direito da página.

    Ícone Procob Request

    Separamos alguns exemplos de requisição em diversas linguagens de programação que retorna somente se a comunicação foi bem sucedida.

    var client = new RestClient("https://api.procob.com/consultas/teste");
    var request = new RestRequest(Method.GET);
    request.AddHeader("authorization", "Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp");
    IRestResponse response = client.Execute(request);
    
    package main
    
    	import (
    		"fmt"
    		"net/http"
    		"io/ioutil"
    	)
    
    	func main() {
    
    		url := "https://api.procob.com/consultas/teste"
    
    		req, _ := http.NewRequest("GET", url, nil)
    
    		req.Header.Add("authorization", "Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp")
    
    		res, _ := http.DefaultClient.Do(req)
    
    		defer res.Body.Close()
    		body, _ := ioutil.ReadAll(res.Body)
    
    		fmt.Println(res)
    		fmt.Println(string(body))
    
    	}
    
    package javaapplication1;
    
    import java.io.BufferedReader;
    import java.io.IOException;
    import java.io.InputStreamReader;
    import java.net.HttpURLConnection;
    import java.net.MalformedURLException;
    import java.net.URL;
    
    /**
     *
     * @author anderson
     */
    public class JavaApplication1 {
    
        public static final String HOST = "https://api.procob.com";
        
        /**
         * @param args the command line arguments
         */
        public static void main(String[] args) throws MalformedURLException, IOException {
            
            String path = "/consultas/teste";
            
            URL obj = new URL(HOST + path);
            
            HttpURLConnection con = (HttpURLConnection) obj.openConnection();
            
            con.setRequestMethod("GET");
            con.setRequestProperty("Authorization", "Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp");
            
            BufferedReader in = new BufferedReader(
    		        new InputStreamReader(con.getInputStream()));
    		String inputLine;
    		StringBuilder response = new StringBuilder();
    
    		while ((inputLine = in.readLine()) != null) {
    			response.append(inputLine);
    		}
    		in.close();
    
    		System.out.println(response.toString());
        }
    }
    
    var http = require("https");
    
    var options = {
      "method": "GET",
      "hostname": "api.procob.com",
      "port": 443,
      "path": "/consultas/teste",
      "headers": {
        "authorization": "Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp",
      }
    };
    
    var req = http.request(options, function (res) {
      var chunks = [];
    
      res.on("data", function (chunk) {
        chunks.push(chunk);
      });
    
      res.on("end", function () {
        var body = Buffer.concat(chunks);
        console.log(body.toString());
      });
    });
    
    req.end();
    
    #import <Foundation/Foundation.h>
    
    NSDictionary *headers = @{ @"authorization": @"Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp"};
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.procob.com/consultas/teste"]
                                                           cachePolicy:NSURLRequestUseProtocolCachePolicy
                                                       timeoutInterval:10.0];
    [request setHTTPMethod:@"GET"];
    [request setAllHTTPHeaderFields:headers];
    
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                                                    if (error) {
                                                        NSLog(@"%@", error);
                                                    } else {
                                                        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
                                                        NSLog(@"%@", httpResponse);
                                                    }
                                                }];
    [dataTask resume];
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.procob.com/consultas/teste",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 30,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "GET",
      CURLOPT_HTTPHEADER => array(
        "authorization: Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp"
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    curl_close($curl);
    
    if ($err) {
      echo "cURL Error #:" . $err;
    } else {
      echo $response;
    }
    
    import http.client
    
    conn = http.client.HTTPConnection("api.procob.com")
    
    headers = {
        'authorization': "Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp"
        }
    
    conn.request("GET", "/consultas/teste", headers=headers)
    
    res = conn.getresponse()
    data = res.read()
    
    print(data.decode("utf-8"))
    
    require 'uri'
    require 'net/http'
    
    url = URI("https://api.procob.com/consultas/teste")
    
    http = Net::HTTP.new(url.host, url.port)
    
    request = Net::HTTP::Get.new(url)
    request["authorization"] = 'Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp'
    
    response = http.request(request)
    puts response.read_body
    
    import Foundation
    
    let headers = [
      "authorization": "Basic c2FuZGJveEBwcm9jb2IuY29tOlRlc3RlQXBp"
    ]
    
    var request = NSMutableURLRequest(URL: NSURL(string: "https://api.procob.com/consultas/teste")!,
                                            cachePolicy: .UseProtocolCachePolicy,
                                        timeoutInterval: 10.0)
    request.HTTPMethod = "GET"
    request.allHTTPHeaderFields = headers
    
    let session = NSURLSession.sharedSession()
    let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
      if (error != nil) {
        println(error)
      } else {
        let httpResponse = response as? NSHTTPURLResponse
        println(httpResponse)
      }
    })
    
    dataTask.resume()
    

    Ícone Procob Retorno

    Caso o retorno seja de sucesso, você irá receber um JSON como o exibido abaixo:

    {
        "code": "000",
        "message": "Consulta de testes com dados fictícios",
        "date": "2019-08-20",
        "hour": "13:03:28",
        "revision": "1222",
        "saldo": "3.83",
        "server": "99",
        "content": {
            "advertencias": {
                "pefin": 9,
                "protesto": 9,
                "acoes_judiciais": 9,
                "participacao_falencias": 9,
                "contumacia": 9,
                "falencia_concordata": 9,
                "dividas_vencidas": 9,
                "ccf": 9
            },
            "confirmei": {
                "existe_informacao": "SIM",
                "conteudo": {
                    "grafia": "FULANO DA SILVA",
                    "cpf": "99999999999",
                    "rg": "999999999999999",
                    "data_nascimento": "99/99/9999",
                    "codigo_cidade": "CTA",
                    "titular": "S",
                    "link_n": "999999999",
                    "situacao_antiga": "Regular",
                    "data_atual": "99/99/9999",
                    "indice_erro": "",
                    "excluir_grafia": "",
                    "nova_situacao": "Regular",
                    "data_atualizacao": "99/99/9999",
                    "nome_mae": "MARIA DA SILVA",
                    "sexo": "M",
                    "tipo_documento": "9",
                    "numero_documento": "999999999999999",
                    "orgao_emissor": "",
                    "data_emissao": "99/99/9999",
                    "uf_emissor": "",
                    "estado_civil": "",
                    "numero_dependentes": "99",
                    "escolaridade": "",
                    "cidade_nascimento": "",
                    "uf_nascimento": "",
                    "cpf_conjuge": "99999999999",
                    "ddd_residencial": "999",
                    "fone_residencial": "999999999",
                    "ddd_comercial": "999",
                    "fone_comercial": "999999999",
                    "ramal": "9999",
                    "fone_celular": "999999999",
                    "ddd_celular": "999",
                    "endereco": "R WALDEMIRO SILVEIRA 999  KTN 9",
                    "logradouro": "R WALDEMIRO SILVEIRA",
                    "numero": "",
                    "complemento": "999  KTN 9",
                    "bairro": "CENTRO",
                    "cidade": "CTA",
                    "uf": "PR",
                    "cep": "99999999",
                    "data_inicio_residencia": "99/9999",
                    "ocupacao": "",
                    "renda": "",
                    "ct_serie": "",
                    "ct_numero": "",
                    "percentual_participacao": "",
                    "nome_empresa": "",
                    "data_admissao": "",
                    "tipo_moeda": "",
                    "profissao": "",
                    "cargo": ""
                }
            },
            "registro_consultas": {
                "existe_informacao": "SIM",
                "conteudo": {
                    "resumo": {
                        "qtde_total": "999",
                        "data_atual": "99/9999",
                        "qtde_consultas_credito_mes_atual": [
                            "999",
                            "999",
                            "999",
                            "999"
                        ],
                        "qtde_total_consultas_cheque": "999",
                        "qtde_total_consultas_cheque_mes_atual": [
                            "999",
                            "999",
                            "999",
                            "999"
                        ],
                        "data_ultima_consulta": "99/99/9999",
                        "data_ultima_atualizacao_empresa": "99/99/9999"
                    },
                    "detalhe": [
                        {
                            "data_consulta": "99/99/9999",
                            "segmento": "TESTE LTDA",
                            "modalidade": "",
                            "tipo_moeda": "",
                            "valor": "9"
                        }
                    ]
                }
            },
            "participacao_societaria": {
                "existe_informacao": "SIM",
                "conteudo": [
                    {
                        "nome_empresa": "TESTE",
                        "cnpj": "99999999999999",
                        "percentual_participacao": "80",
                        "estado": "PR",
                        "situacao": "SITUACAO DO CNPJ EM 03/11/2016: ATIVA",
                        "data_inicio_participacao": "01/2004",
                        "data_ultima_atualizacao": "04/2016"
                    }
                ]
            },
            "contumacia": {
                "existe_informacao": "SIM",
                "quantidade": 99999,
                "conteudo": [
                    {
                        "data_ocorrencia": "13/05/2016",
                        "origem": "TESTE",
                        "agencia": "9999",
                        "conta_corrente": "99999999",
                        "cheque_inicial": "999999",
                        "cheque_final": "999999",
                        "motivo_sustacao": "TESTE",
                        "qtde_ocorrencias": "99999"
                    }
                ]
            },
            "pendencias_financeiras": {
                "existe_informacao": "SIM",
                "quantidade": 9,
                "conteudo": {
                    "resumo": [
                        {
                            "qtde_total": "99999",
                            "descricao": "REFIN",
                            "data_primeira_ocorrencia": "9999",
                            "data_ultima_ocorrencia": "9999",
                            "tipo_moeda": "R$",
                            "valor_ultima_ocorrencia": "999,99",
                            "empresa_ultima_ocorrencia": "FINANCEIRA LTDA",
                            "filial": "SPO",
                            "tipo_pefin": "REFIN",
                            "valor_total_ocorrencias": "999,99"
                        }
                    ],
                    "detalhe": [
                        {
                            "tipo_pefin": "REFIN",
                            "modalidade": "CREDITO E FI",
                            "ultima_ocorrencia": "999999999",
                            "data_ocorrencia": "99/99/9999",
                            "sigla_modalidade_credito": "FI",
                            "principal": "N",
                            "tipo_moeda": "R$",
                            "valor": "999,99",
                            "contrato": "999999999999999",
                            "empresa_origem": "FINANCEIRA LTDA",
                            "filial": "SPO",
                            "qtde_ocorrencias": "99999",
                            "cod_banco": "9999",
                            "sub_judice": "",
                            "uf": "SP"
                        }
                    ]
                }
            },
            "ccf": {
                "existe_informacao": "SIM",
                "quantidade": 1,
                "conteudo": {
                    "resumo": {
                        "qtde_total": "00001",
                        "descricao": "TESTE",
                        "data_primeira_ocorrencia": "01/2016",
                        "data_ultima_ocorrencia": "01/2016",
                        "tipo_moeda": "R$",
                        "valor_ultima_ocorrencia": "4.246,00",
                        "origem": "TESTE",
                        "filial": "9999"
                    },
                    "detalhe": [
                        {
                            "data_ocorrencia": "01/01/2016",
                            "numero_cheque": "999999",
                            "alinea": "99",
                            "qtde_cheques_devolvidos": "9999",
                            "tipo_moeda": "R$",
                            "valor": "9.999,99",
                            "banco": "TESTE",
                            "agencia": "9999",
                            "cidade": "TESTE",
                            "uf": "PR",
                            "qtde_ocorrencias": "00003",
                            "tipo_conta": "0",
                            "conta": "999999999"
                        }
                    ]
                }
            },
            "protesto": {
                "existe_informacao": "SIM",
                "quantidade": 3,
                "conteudo": {
                    "resumo": {
                        "qtde_total": "00003",
                        "descricao": "PROTESTOS",
                        "data_primeira_ocorrencia": "01/2011",
                        "data_ultima_ocorrencia": "01/2011",
                        "tipo_moeda": "R$",
                        "valor": "4.500,00",
                        "cidade": "SPO",
                        "uf": "SP",
                        "valor_total_ocorrencias": "10.223,00"
                    },
                    "detalhe": [
                        {
                            "data_ocorrencia": "30/05/2011",
                            "tipo_moeda": "R$",
                            "valor": "4.500,00",
                            "cartorio": "0002",
                            "cidade": "SPO",
                            "uf": "SP",
                            "qtde_ocorrencias": "00003",
                            "subjudice": false,
                            "data_carta_anuencia": "00/00/0000"
                        }
                    ]
                }
            },
            "acoes_judiciais": {
                "existe_informacao": "SIM",
                "quantidade": 1,
                "conteudo": {
                    "resumo": {
                        "qtde_total": "0001",
                        "descricao": "Teste",
                        "data_primeira_ocorrencia": "01/2016",
                        "data_ultima_ocorrencia": "02/2016",
                        "tipo_moeda": "R$",
                        "valor": "999,99",
                        "natureza": "NAO INFORMADA",
                        "uf": "PR",
                        "valor_total": "000000001"
                    },
                    "detalhe": [
                        {
                            "data_ocorrencia": "01/01/2016",
                            "natureza": "NAO INFORMADA",
                            "principal": "S",
                            "tipo_moeda": "R$",
                            "valor": "99,99",
                            "distribuidor_acao": "9999",
                            "vara": "9999",
                            "cidade": "TESTE",
                            "uf": "PR",
                            "qtde_ocorrencias": "0001",
                            "subjudice": "S"
                        }
                    ]
                }
            },
            "participacao_falencias": {
                "existe_informacao": "SIM",
                "quantidade": 1,
                "conteudo": {
                    "resumo": {
                        "qtde_total": "0001",
                        "descricao": "TESTE",
                        "data_primeira_ocorrencia": "01/2016",
                        "data_ultima_ocorrencia": "02/2016",
                        "empresa": "TESTE"
                    },
                    "detalhe": [
                        {
                            "data_ocorrencia": "01/01/2016",
                            "tipo_ocorrencia": "TESTE",
                            "cnpj": "99999999999999",
                            "empresa": "TESTE",
                            "total_ocorrencias": "00001",
                            "cod_qualificacao": "GER",
                            "vara": "0001"
                        }
                    ]
                }
            },
            "dividas_vencidas": {
                "existe_informacao": "SIM",
                "quantidade": 1,
                "conteudo": {
                    "resumo": {
                        "qtde_total": "0001",
                        "descricao": "TESTE",
                        "data_primeira_ocorrencia": "01/2016",
                        "data_ultima_ocorrencia": "02/2016",
                        "tipo_moeda": "R$",
                        "valor_ultima_ocorrencia": "4.246,00",
                        "origem": "TESTE",
                        "local": "ABCD",
                        "valor_total": "10.223,00"
                    },
                    "detalhe": [
                        {
                            "data_ocorrencia": "01/01/2016",
                            "modalidade": "TESTE",
                            "tipo_moeda": "R$",
                            "valor": "99,99",
                            "nome_titulo": "TESTE",
                            "origem": "TESTE",
                            "local": "ABCD",
                            "qtde_ocorrencias": "99999"
                        }
                    ]
                }
            },
            "indice_relacionamento_mercado": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "setores": [
                        {
                            "faixa": "A3",
                            "calculado": "S",
                            "mensagem": "ALTO RELACIONAMENTO COM O MERCADO COM TENDENCIA DE ALTA",
                            "setor": "01"
                        },
                        {
                            "faixa": "A1",
                            "calculado": "S",
                            "mensagem": "ALTO RELACIONAMENTO COM O MERCADO COM TENDENCIA DE BAIXA",
                            "setor": "02"
                        },
                        {
                            "faixa": "A3",
                            "calculado": "S",
                            "mensagem": "ALTO RELACIONAMENTO COM O MERCADO COM TENDENCIA DE ALTA",
                            "setor": "03"
                        },
                        {
                            "faixa": "A3",
                            "calculado": "S",
                            "mensagem": "ALTO RELACIONAMENTO COM O MERCADO COM TENDENCIA DE ALTA",
                            "setor": "99"
                        }
                    ]
                }
            },
            "score_serasa": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "score": "999",
                    "percentual": "9,99",
                    "mensagem": "A chance do consumidor pagar seus compromissos financeiros nos próximos 12 meses é de 9,99"
                }
            },
            "alerta_identidade": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "resumo": "NAO FOI DETECTADA A NECESSIDADE DE VERIFICAR DOCUMENTOS ADICIONAIS  DE IDENTIFICACAO.",
                    "detalhe": "PARA  REALIZAR  UMA TRANSACAO COMERCIAL MAIS SEGURA,  O   ALERTA  DE  IDENTIDADE  E  UMA  FERRAMENTA QUE PODE AUXILIAR O CONTRATANTE AO INDICAR  A  NECESSIDADE   OU  NAO  DE  VERIFICACAO  DE DOCUMENTOS ADICIONAIS DE IDENTIFICACAO DO CONSUMIDOR,  TAIS  COMO DOCUMENTOS PESSOAIS COM FOTO, COMPROVANTE  DE ENDERECO/TELEFONE E/OU REFERENCIAS PESSOAIS. "
                }
            },
            "renda_pro": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "renda": "9.999,99"
                }
            },
            "capacidade_mensal_pagamento": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "valor": "99,99"
                }
            },
            "comprometimento_mensal_estimado": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "percentual": 99.9
                }
            },
            "recuperacao_credito": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "faixa": "1",
                    "mensagem": "BAIXISSIMO"
                }
            },
            "indicador_pontualidade_pagamento": {
                "existe_informacao": "SIM",
                "manutencao": "NAO",
                "conteudo": {
                    "pontuacao": 41,
                    "faixa": "26% a 50%",
                    "mensagem": "Consumidor realiza o pagamento de 26% a 50% dos seus compromissos financeiros até a data do vencimento."
                }
            }
        }
    }

    A resposta da API se da sempre em um bloco contendo o código da resposta, a mensagem, a data e hora da consulta e o conteúdo da consulta efetuada, caso ele exista.

    Segue abaixo a lista de retornos disponíveis:

    Código Mensagem
    000 Pesquisa feita com sucesso
    001 Nao encontramos registros para a pesquisa
    002 Seus creditos são inferiores ao valor da consulta
    003 Tipo de documento invalido para está consulta
    004 Sem informacoes disponiveis
    005 É necessario passar parametros via GET
    006 O fornecedor desta consulta se encontra em manutencao, favor tentar daqui alguns minutos
    007 Produto se encontra em manutencao, favor tentar daqui alguns minutos
    008 Usuário ou senha invalidos
    009 Operacao realizada com sucesso
    010 Usuario não cadastrado
    011 Usuario não cadastrado via rede social especificada
    012 Data de nascimento obrigatório para o documento informado
    900 Ocorreu um erro de execucao, favor contatar o suporte Procob
    999 Mensagem generica usada para diversos retornos na API