Para que serve
Avaliação de risco de crédito da empresa na Boa Vista, com dados do Cadastro Positivo. Traz score e probabilidade de inadimplência, decisão sugerida, limite de crédito e faturamento presumidos, indicadores mensais de pagamento, restrições (pendências, protestos, cheques sem fundo, contumácia, ações, falência e recuperação), quadro societário e administradores, alertas e os dados cadastrais da empresa.
Ideal para
Por que usar
Limite sugerido
Limite de crédito e faturamento presumidos para calibrar a exposição.
Comportamento de pagamento
Indicadores mensais do Cadastro Positivo mostram a tendência, não só a foto.
Prova para auditoria
Comprovante em PDF da consulta, com data e hora, guardado por 90 dias para anexar ao processo de crédito ou de compliance.
Parâmetros
| Parâmetro | Descrição | Regra |
|---|---|---|
cnpj | CNPJCNPJ da empresa, somente dígitos ou formatado. | Obrigatório |
O que você recebe
42 campos no retorno, como o seu sistema recebe.
cnpjCNPJ
Número do CNPJ da empresa ou do estabelecimento.
razaoSocialRazão social
Nome empresarial registrado.
nomeFantasiaNome fantasia
Nome comercial do estabelecimento.
situacaoSituação cadastral
Situação do cadastro no órgão (ex.: Regular, Ativa, Suspensa, Baixada).
dataFundacaoData de abertura
Data de abertura ou de constituição da pessoa jurídica.
naturezaJuridicaNatureza jurídica
Código e descrição da natureza jurídica.
cnaePrimarioAtividade econômica principal
CNAE principal, com código e descrição.
capitalSocialCapital social
Capital social declarado.
portePorte
Porte da empresa na Receita Federal.
faixaFuncionariosFaixa de funcionários
Faixa da quantidade de funcionários da empresa.
opcaoTributariaOpção tributária
Regime tributário declarado (Simples Nacional, Lucro Presumido ou Lucro Real).
inscricaoEstadualInscrição estadual
Número da inscrição estadual do contribuinte do ICMS.
emailDado pessoalE-mail
Endereço eletrônico registrado na fonte.
telefonesDado pessoalTelefones
Telefones ligados ao documento, com DDD.
enderecosDado pessoalEndereços
Endereços ligados ao documento, com logradouro, número, complemento, bairro, cidade, UF e CEP.
decisoesDecisão
Recomendação do birô para a concessão de crédito, com código, descrição e resultado.
score.scoreScore de crédito
Pontuação de crédito do documento; quanto maior, menor o risco. A escala é a do birô que calcula.
score.classificacaoABCClasse de risco
Classe ou faixa de risco do documento.
score.probabilidadeInadimplenciaProbabilidade de inadimplência
Chance estimada de o documento deixar de pagar, como o birô a calcula.
score.textoResumo do resultado
Frase da fonte que resume o resultado da consulta. Texto do birô que explica o score.
indicadoresIndicadores do Cadastro Positivo
Pontuações mensais de crédito obtido, compromissos, pagamentos pontuais e em atraso, eventos da empresa e tempo de relacionamento com fornecedores.
restricoesRestrições
Bloco de restrições de crédito do documento no birô: na pessoa física, o resumo por tipo; na jurídica, pendências, protestos, cheques, contumácia, ações, falências, limite de crédito e faturamento presumido.
restricoes.pendenciasFinanceiras.quantidadeQuantidade de pendências
Quantidade de dívidas negativadas por credores.
restricoes.pendenciasFinanceiras.valorTotalValor total das pendências
Soma das dívidas negativadas ou pendentes encontradas para o documento.
restricoes.pendenciasFinanceiras.ocorrenciasPendências financeiras
Cada dívida negativada por credor, com vencimento, inclusão, credor, valor, contrato e modalidade.
restricoes.protestos.quantidadeTotal de protestos
Quantidade de títulos protestados.
restricoes.protestos.valorTotalValor total protestado
Soma dos valores protestados.
restricoes.protestos.ocorrenciasProtestos
Cada protesto encontrado, com data ou situação, valor e cartório.
restricoes.chequesSemFundoBacen.quantidadeCheques sem fundo
Quantidade de ocorrências de cheque devolvido sem fundo. No cadastro de emitentes de cheques sem fundo do Banco Central.
restricoes.chequesSemFundoVarejo.quantidadeCheques sem fundo
Quantidade de ocorrências de cheque devolvido sem fundo. Informados pelo comércio.
restricoes.contumaciaContumácia
Reincidência em atrasos de pagamento, com quantidade e datas da primeira e da última ocorrência.
restricoes.acoesCiveis.quantidadeTotal de processos
Quantidade de processos encontrados. Ações cíveis.
restricoes.acoesCiveis.valorTotalValor total das ações
Soma dos valores das ações judiciais encontradas.
restricoes.acoesCiveis.ocorrenciasAções judiciais
Cada ação contra o documento, com processo, autor, comarca ou foro, vara, valor e data.
restricoes.falenciaRecuperacaoJudicial.ocorrenciasFalências e recuperações judiciais
Pedidos de falência e de recuperação judicial ligados ao documento, com tipo, data, origem e valor.
restricoes.limiteCreditoLimite de crédito sugerido
Limite de crédito sugerido pelo birô, com valor e texto explicativo.
restricoes.faturamentoPresumidoFaturamento presumido
Faturamento anual estimado da empresa, com faixa, valor presumido e data de referência.
governancas.administradoresDado pessoalAdministradores
Administradores da empresa, com nome, documento, cargo e data de entrada.
governancas.sociosDado pessoalQuadro societário
Sócios e administradores, com qualificação, documento e representante legal.
alertasAlertas
Alertas do birô sobre o documento, com título, tipo e observação.
historicoConsultaConsultas anteriores
Empresas que consultaram o documento no birô recentemente, com data.
dataConsultaData da consulta
Data e hora em que a fonte foi consultada.
Opções da chamada
assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.comprovante=trueGera também o comprovante da consulta em PDF (custo adicional).
Códigos de resposta
200Sucesso — Consulta concluída; o retorno traz os dados da fonte.202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.422Requisição inválida — Parâmetros validados antes de qualquer cobrança.429Limite simultâneo — Até 5 consultas simultâneas por cliente.503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.
Como é cobrado
- Débito por chamada — do saldo pré-pago ou do contrato pós-pago
- Preço exibido na plataforma antes de executar
- Falhas estornadas automaticamente
- Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/boa-vista-risco-positivo-pj?cnpj=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "boa-vista-risco-positivo-pj", "apiNome": "Boa Vista - Risco Positivo Pessoa Jurídica", "fonte": "Boa Vista SCPC · Birô de crédito", "status": "Concluída", "resultado": "Sucesso", "tempoExecucaoMs": 1840, "assincrono": false, "urlComprovante": null }, "retorno": { /* dados da fonte — variam por consulta */ }}Perguntas frequentes sobre Boa Vista - Risco Positivo Pessoa Jurídica
Outras APIs para combinar
Ver catálogo completoSCR — Analítico
Resumo analítico do endividamento no SCR do Banco Central: modalidades, valores e situação das operações de crédito, por CPF ou CNPJ.
SCR — Detalhada
Posição detalhada do SCR do Banco Central por modalidade e vencimento, com opção de mês de competência (MM/aaaa).
Protestos Nacional
Protestos de títulos em cartórios de todo o país, em tempo real, por CPF ou CNPJ.
Comece a integrar
Leve as fontes oficiais do agro para dentro do seu sistema
Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.
- APIs de fontes oficiais, com resposta padronizada
- Pague por chamada — sem mensalidade, falhas estornadas
- API do Dossiê BNIR com lotes de até 1.000 CARs
- Webhooks assinados e comprovante em PDF
- Conformidade LGPD — fontes oficiais, log auditável
Solicite uma Demonstração
Nossa equipe entrará em contato em breve.