# Limite de Crédito — PJ

> Relatório de crédito de pessoa jurídica da Boa Vista/Equifax a partir do CNPJ, com recomendação de limite de crédito, score de risco, situação cadastral, natureza jurídica, indicadores de pagamento e restrições. Também detalha o quadro societário, informando cada sócio com o respectivo PERCENTUAL DE PARTICIPAÇÃO, além das participações desses sócios/administradores em outras empresas.

- **Consulta:** `boa-vista-limite-pj`
- **Categoria:** Crédito & Score
- **Preço:** R$ 29,05 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/boa-vista-limite-pj`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/credito-e-score/boa-vista-limite-pj

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Entrega a análise de crédito positiva de pessoa jurídica da Boa Vista/Equifax, orientada à recomendação de limite de crédito. A partir do CNPJ, retorna a identificação cadastral da empresa (razão social, nome fantasia, situação, data de fundação, natureza jurídica, CNAEs, capital social, endereço), o score de risco em 12 meses com probabilidade de inadimplência, a decisão de negociação, o limite de crédito sugerido, o faturamento presumido e as restrições (pendências, protestos, cheques sem fundo, ações cíveis, falências/recuperações). Além disso, descreve a **governança e o quadro societário**, listando cada sócio com o seu **percentual de participação** no capital, e mapeia as participações desses sócios/administradores em outras empresas (também com o percentual em cada uma). É voltada à definição de limite, política de crédito e avaliação de risco de fornecedores/clientes PJ.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/boa-vista-limite-pj?cnpj=SEU_CNPJ"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/boa-vista-limite-pj",
    params={"cnpj": "SEU_CNPJ"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/boa-vista-limite-pj");

url.search = new URLSearchParams({
  "cnpj": "SEU_CNPJ"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cnpj` | CNPJ | sim | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> ### Identificação da empresa
> - `cnpj`, `razaoSocial`, `razaoSocialAnterior`, `nomeFantasia`.
> - `situacao`, `dataSituacao`, `dataFundacao`, `dataEncerramento`: situação e datas.
> - `naturezaJuridica`, `porte`, `tipoSociedade`, `opcaoTributaria`, `capitalSocial`.
> - `ramoAtividadePrimario`, `ramoAtividadeSecundario`, `cnaePrimario`, `cnaeSecundario`.
> - `inscricaoEstadual`, `inscricaoEstadualUf`, `nire`, `nireUf`, `quantidadeFiliais`, `faixaFuncionarios`.
> - `telefones[]`, `enderecos[]`.
>
> ### Decisão, score e limite
> - `decisoes`: recomendação de negociação (código, descrição e layout).
> - `score`: score de risco 12 meses, classificação numérica/ABC, probabilidade de inadimplência e texto interpretativo.
> - `restricoes.limiteCredito`: limite de crédito recomendado (`valor`, `descricao`, `texto`).
> - `restricoes.faturamentoPresumido`: faturamento anual presumido e faixa.
> - `indicadores`: crédito obtido, compromissos, pontualidade e histórico de pagamento.
>
> ### Restrições
> - `restricoes.pendenciasFinanceiras`, `protestos`, `chequesSemFundoBacen`, `chequesSemFundoVarejo`, `contumacia`, `acoesCiveis`, `falenciaRecuperacaoJudicial`: quantidades, valores e ocorrências de cada tipo.
> - `alertas[]`: alertas informativos (ex.: ramos de atividade adicionais).
>
> ### Quadro societário e participações
> - `governancas.quantidadeSocios`, `governancas.quantidadeAdministradores`.
> - `governancas.socios[]`: cada sócio com `nome`, `documento`, `tipoDocumento`, `situacaoDocumento` e, principalmente, **`percentualParticipacao`** (percentual do sócio no capital da empresa).
> - `participacoes.participacoesSocioAdmOutrasEmpresas[]`: para cada sócio/administrador, a lista de outras empresas em que participa, cada uma com `razaoSocial`, `cnpj`, `situacaoCnpj`, indicadores de débito/fraude e o campo **`participacao`** (percentual do sócio naquela empresa).
> - `historicoConsulta`: consultas anteriores realizadas ao CNPJ.

### Exemplo de resposta

```json
{
  "cnpj": "string",
  "nire": "string",
  "email": null,
  "porte": null,
  "score": {
    "risco": "string",
    "score": "string",
    "texto": "string",
    "layout": "string",
    "execucao": null,
    "tipoScore": "string",
    "descrPlano": "string",
    "descrScore": "string",
    "informante": "string",
    "modeloScore": null,
    "classificacaoABC": "string",
    "classificacaoNumero": "string",
    "probabilidadeInadimplencia": "string"
  },
  "nireUf": "string",
  "alertas": [
    {
      "tipo": "string",
      "titulo": "string",
      "observacao": "string"
    }
  ],
  "decisoes": {
    "layout": "string",
    "descricao": "string",
    "codigoSituacao": "string"
  },
  "situacao": "string",
  "enderecos": [
    {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "cidade": "string",
      "numero": "string",
      "logradouro": "string",
      "complemento": null
    }
  ],
  "telefones": [],
  "restricoes": {
    "protestos": {
      "dataMaior": null,
      "dataUltimo": null,
      "quantidade": "string",
      "valorMaior": null,
      "valorTotal": null,
      "ocorrencias": [],
      "valorUltimo": null,
      "dataPrimeiro": null,
      "valorPrimeiro": null,
      "ultimoProtesto": null
    },
    "contumacia": {
      "quantidade": "string",
      "dataUltimaOcorrencia": null,
      "dataPrimeiraOcorrencia": null
    },
    "acoesCiveis": {
      "dataMaior": null,
      "dataMenor": null,
      "dataUltimo": null,
      "quantidade": "string",
      "valorMaior": null,
      "valorMenor": null,
      "valorTotal": null,
      "ocorrencias": null,
      "valorUltimo": null,
      "dataPrimeira": null,
      "valorPrimeiro": null
    },
    "limiteCredito": {
      "texto": "string",
      "valor": "string",
      "descricao": "string"
    },
    "chequesSemFundoBacen": {
      "documento": "string",
      "quantidade": "string",
      "tipoPessoa": "string",
      "correntista": "string"
    },
    "faturamentoPresumido": {
      "faixa": "string",
      "dataReferencia": null,
      "valorPresumido": null,
      "faturamentoAnual": "string",
      "dadosCadastroPositivo": null
    },
    "chequesSemFundoVarejo": {
      "documento": "string",
      "quantidade": "string",
      "tipoPessoa": "string",
      "correntista": "string"
    },
    "pendenciasFinanceiras": {
      "dataMaior": null,
      "provedores": [
        "string"
      ],
      "quantidade": "string",
      "valorMaior": null,
      "valorTotal": null,
      "ocorrencias": [],
      "dataPrimeiro": null,
      "periodoFinal": null,
      "totalCredores": null,
      "valorPrimeiro": null,
      "periodoInicial": null,
      "ultimoVencimento": null
    },
    "falenciaRecuperacaoJudicial": {
      "quantidade": "string",
      "ocorrencias": null,
      "periodoFinal": null,
      "periodoInicial": null
    }
  },
  "governancas": {
    "socios": [
      {
        "nome": "string",
        "documento": "string",
        "restricoes": [
          {
            "tipo": "string",
            "valor": "string",
            "ultima": "string",
            "quantidade": "string"
          }
        ],
        "tipoDocumento": "string",
        "situacaoDocumento": "string",
        "percentualParticipacao": "string"
      }
    ],
    "administradores": null,
    "quantidadeSocios": "string",
    "quantidadeAdministradores": "string"
  },
  "indicadores": {
    "compromissos": null,
    "creditoObtido": null,
    "pagamentoPontual": null,
    "pagamentoAtrasado": {
      "ocorrencias": []
    },
    "eventosPessoaJuridica": null,
    "periodoRelacionamentoFornecedores": null
  },
  "razaoSocial": "string",
  "cnaePrimario": "string",
  "dataFundacao": "string",
  "dataSituacao": "string",
  "nomeFantasia": null,
  "capitalSocial": "string",
  "participacoes": {
    "quantidadeParticipacoesSocioAdm": "string",
    "participacoesEmpresasConsultadas": null,
    "quantidadeParticipacoesConsultada": "string",
    "participacoesSocioAdmOutrasEmpresas": [
      {
        "cpfCnpj": "string",
        "empresas": [
          {
            "cnpj": "string",
            "razaoSocial": "string",
            "participacao": "string",
            "situacaoCnpj": "string",
            "indicadorDebito": "string",
            "indicadorFraude": "string"
          }
        ],
        "nomeSocio": "string",
        "tipoDocumento": "string"
      }
    ]
  },
  "tipoSociedade": null,
  "cidadesFiliais": null,
  "cnaeSecundario": "string",
  "opcaoTributaria": null,
  "dataEncerramento": null,
  "naturezaJuridica": "string",
  "situacaoSintegra": null,
  "faixaFuncionarios": null,
  "historicoConsulta": {
    "detalhes": [
      {
        "cnpj": "string",
        "data": "string",
        "razaoSocial": "string"
      }
    ],
    "dataFinal": "string",
    "dataInicial": "string",
    "quantidadeOcorrencias": "string"
  },
  "inscricaoEstadual": null,
  "quantidadeFiliais": "string",
  "inscricaoEstadualUf": "string",
  "razaoSocialAnterior": null,
  "dataConsultaSintegra": null,
  "dataSituacaoSintegra": null,
  "ramoAtividadePrimario": "string",
  "ramoAtividadeSecundario": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ pesquisado."
    },
    "nire": {
      "type": [
        "string",
        "null"
      ],
      "description": "NIRE (registro na junta comercial)."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "E-mail da empresa."
    },
    "porte": {
      "type": [
        "string",
        "null"
      ],
      "description": "Porte da empresa."
    },
    "score": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "risco": {
          "type": [
            "string",
            "null"
          ],
          "description": "Faixa de risco."
        },
        "score": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor do score."
        },
        "texto": {
          "type": [
            "string",
            "null"
          ],
          "description": "Texto interpretativo do score."
        },
        "layout": {
          "type": [
            "string",
            "null"
          ],
          "description": "Layout/modelo do score."
        },
        "execucao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Indicador de execução."
        },
        "tipoScore": {
          "type": [
            "string",
            "null"
          ],
          "description": "Tipo do score."
        },
        "descrPlano": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição do plano."
        },
        "descrScore": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição do score."
        },
        "informante": {
          "type": [
            "string",
            "null"
          ],
          "description": "Base informante."
        },
        "modeloScore": {
          "type": [
            "string",
            "null"
          ],
          "description": "Modelo de score."
        },
        "classificacaoABC": {
          "type": [
            "string",
            "null"
          ],
          "description": "Classificação em letras."
        },
        "classificacaoNumero": {
          "type": [
            "string",
            "null"
          ],
          "description": "Classificação numérica."
        },
        "probabilidadeInadimplencia": {
          "type": [
            "string",
            "null"
          ],
          "description": "Probabilidade de inadimplência (%)."
        }
      },
      "description": "Score de risco de crédito em 12 meses."
    },
    "nireUf": {
      "type": [
        "string",
        "null"
      ],
      "description": "UF do NIRE."
    },
    "alertas": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "tipo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo do alerta (ex.: INFORMACAO)."
          },
          "titulo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Título do alerta."
          },
          "observacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Detalhe do alerta."
          }
        }
      },
      "description": "Alertas informativos."
    },
    "decisoes": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "layout": {
          "type": [
            "string",
            "null"
          ],
          "description": "Layout da decisão."
        },
        "descricao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição da recomendação de negociação."
        },
        "codigoSituacao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Código da situação de decisão."
        }
      },
      "description": "Recomendação de decisão de negociação."
    },
    "situacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral (ex.: ATIVO)."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "UF."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "CEP."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro."
          },
          "cidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logradouro."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento."
          }
        }
      },
      "description": "Endereços da empresa."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "ddd": {
            "type": [
              "string",
              "null"
            ],
            "description": "DDD."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número."
          },
          "telefoneComDDD": {
            "type": [
              "string",
              "null"
            ],
            "description": "Telefone com DDD."
          }
        }
      },
      "description": "Telefones da empresa."
    },
    "restricoes": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "protestos": {
          "type": [
            "object",
            "null"
          ],
          "description": "Protestos: quantidade, valores, datas e ocorrências."
        },
        "contumacia": {
          "type": [
            "object",
            "null"
          ],
          "description": "Contumácia (reincidência) de ocorrências."
        },
        "acoesCiveis": {
          "type": [
            "object",
            "null"
          ],
          "description": "Ações cíveis."
        },
        "limiteCredito": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "texto": {
              "type": [
                "string",
                "null"
              ],
              "description": "Texto explicativo do limite."
            },
            "valor": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor do limite de crédito recomendado."
            },
            "descricao": {
              "type": [
                "string",
                "null"
              ],
              "description": "Descrição do limite recomendado."
            }
          },
          "description": "Limite de crédito recomendado para a empresa."
        },
        "chequesSemFundoBacen": {
          "type": [
            "object",
            "null"
          ],
          "description": "Cheques sem fundo no Bacen."
        },
        "faturamentoPresumido": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "faixa": {
              "type": [
                "string",
                "null"
              ],
              "description": "Faixa de faturamento."
            },
            "dataReferencia": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data de referência."
            },
            "valorPresumido": {
              "type": [
                "string",
                "null"
              ],
              "description": "Valor presumido."
            },
            "faturamentoAnual": {
              "type": [
                "string",
                "null"
              ],
              "description": "Faturamento anual presumido."
            },
            "dadosCadastroPositivo": {
              "type": [
                "string",
                "null"
              ],
              "description": "Dados do cadastro positivo."
            }
          },
          "description": "Faturamento presumido da empresa."
        },
        "chequesSemFundoVarejo": {
          "type": [
            "object",
            "null"
          ],
          "description": "Cheques sem fundo no varejo."
        },
        "pendenciasFinanceiras": {
          "type": [
            "object",
            "null"
          ],
          "description": "Pendências financeiras: quantidade, valores, período e ocorrências."
        },
        "falenciaRecuperacaoJudicial": {
          "type": [
            "object",
            "null"
          ],
          "description": "Falências e recuperações judiciais."
        }
      },
      "description": "Restrições, limite de crédito e faturamento presumido."
    },
    "governancas": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "socios": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "nome": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nome do sócio."
              },
              "documento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Documento (CPF/CNPJ) do sócio."
              },
              "restricoes": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object",
                  "properties": {
                    "tipo": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Tipo da restrição (PENDENCIAS, CCF, PROTESTOS, ACOES JUDICIAIS, FALENCIAS RECUPERACAO JUDICIAL, CONSULTAS)."
                    },
                    "valor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Valor total da restrição, formatado em reais."
                    },
                    "ultima": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Data da ocorrência mais recente do tipo."
                    },
                    "quantidade": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Quantidade de ocorrências do tipo."
                    }
                  }
                },
                "description": "Restrições associadas ao sócio, uma entrada por tipo."
              },
              "tipoDocumento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tipo do documento (CPF/CNPJ)."
              },
              "situacaoDocumento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Situação do documento do sócio."
              },
              "percentualParticipacao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Percentual de participação do sócio no capital da empresa (ex.: \"080,00\")."
              }
            }
          },
          "description": "Quadro societário, com o percentual de participação de cada sócio."
        },
        "administradores": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object"
          },
          "description": "Lista de administradores."
        },
        "quantidadeSocios": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de sócios."
        },
        "quantidadeAdministradores": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de administradores."
        }
      },
      "description": "Governança e quadro societário da empresa."
    },
    "indicadores": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "compromissos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Compromissos assumidos."
        },
        "creditoObtido": {
          "type": [
            "string",
            "null"
          ],
          "description": "Crédito obtido."
        },
        "pagamentoPontual": {
          "type": [
            "string",
            "null"
          ],
          "description": "Indicador de pagamento pontual."
        },
        "pagamentoAtrasado": {
          "type": [
            "object",
            "null"
          ],
          "description": "Ocorrências de pagamento atrasado."
        },
        "eventosPessoaJuridica": {
          "type": [
            "string",
            "null"
          ],
          "description": "Eventos da pessoa jurídica."
        },
        "periodoRelacionamentoFornecedores": {
          "type": [
            "string",
            "null"
          ],
          "description": "Período de relacionamento com fornecedores."
        }
      },
      "description": "Indicadores de comportamento de pagamento."
    },
    "razaoSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social da empresa."
    },
    "cnaePrimario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código CNAE primário."
    },
    "dataFundacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de fundação/abertura."
    },
    "dataSituacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da situação cadastral."
    },
    "nomeFantasia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome fantasia."
    },
    "capitalSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Capital social."
    },
    "participacoes": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "quantidadeParticipacoesSocioAdm": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de sócios/administradores com participações mapeadas."
        },
        "participacoesEmpresasConsultadas": {
          "type": [
            "string",
            "null"
          ],
          "description": "Participações das empresas consultadas."
        },
        "quantidadeParticipacoesConsultada": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de participações consultadas."
        },
        "participacoesSocioAdmOutrasEmpresas": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "cpfCnpj": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "CPF/CNPJ do sócio."
              },
              "empresas": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object",
                  "properties": {
                    "cnpj": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "CNPJ da outra empresa."
                    },
                    "razaoSocial": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Razão social da outra empresa."
                    },
                    "participacao": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Percentual de participação do sócio nessa empresa (ex.: \"025,00\")."
                    },
                    "situacaoCnpj": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Situação cadastral da outra empresa."
                    },
                    "indicadorDebito": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Indicador de débito."
                    },
                    "indicadorFraude": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Indicador de fraude."
                    }
                  }
                },
                "description": "Outras empresas em que o sócio participa, com o respectivo percentual."
              },
              "nomeSocio": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nome do sócio/administrador."
              },
              "tipoDocumento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tipo do documento."
              }
            }
          },
          "description": "Participações dos sócios/administradores em outras empresas."
        }
      },
      "description": "Participações societárias dos sócios/administradores em outras empresas."
    },
    "tipoSociedade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tipo de sociedade."
    },
    "cidadesFiliais": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cidades das filiais."
    },
    "cnaeSecundario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código CNAE secundário."
    },
    "opcaoTributaria": {
      "type": [
        "string",
        "null"
      ],
      "description": "Opção tributária (ex.: Simples, Lucro Real)."
    },
    "dataEncerramento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de encerramento, se houver."
    },
    "naturezaJuridica": {
      "type": [
        "string",
        "null"
      ],
      "description": "Natureza jurídica (código e descrição)."
    },
    "situacaoSintegra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação no Sintegra."
    },
    "faixaFuncionarios": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa de número de funcionários."
    },
    "historicoConsulta": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "detalhes": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object"
          },
          "description": "Detalhes das consultas anteriores."
        },
        "dataFinal": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data final do histórico."
        },
        "dataInicial": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data inicial do histórico."
        },
        "quantidadeOcorrencias": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de consultas anteriores."
        }
      },
      "description": "Histórico de consultas ao CNPJ."
    },
    "inscricaoEstadual": {
      "type": [
        "string",
        "null"
      ],
      "description": "Inscrição estadual."
    },
    "quantidadeFiliais": {
      "type": [
        "string",
        "null"
      ],
      "description": "Quantidade de filiais."
    },
    "inscricaoEstadualUf": {
      "type": [
        "string",
        "null"
      ],
      "description": "UF da inscrição estadual."
    },
    "razaoSocialAnterior": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social anterior, se houve alteração."
    },
    "dataConsultaSintegra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da consulta ao Sintegra."
    },
    "dataSituacaoSintegra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da situação no Sintegra."
    },
    "ramoAtividadePrimario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição do ramo de atividade primário."
    },
    "ramoAtividadeSecundario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição do ramo de atividade secundário."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Fonte: Boa Vista SCPC / Equifax (base do cadastro positivo, identificada como "BASE III").
> - O limite de crédito só é informado quando a negociação é recomendada; em decisão neutra ou não recomendada, o `valor` retorna "R$ 0,00" com texto explicativo.
> - Percentuais de participação vêm como texto, muitas vezes com zeros à esquerda e vírgula decimal (ex.: "080,00"); interprete como valor percentual.
> - Quantidades vêm como string numérica; blocos sem registro trazem quantidade "0" e listas vazias ou nulas.
> - A cobrança ocorre pela consulta realizada, independentemente de haver ou não restrições no resultado.
> - A disponibilidade depende do serviço da Boa Vista; em manutenção, a consulta pode retornar indisponível.

---

Página em HTML: https://fontedata.com/docs/credito-e-score/boa-vista-limite-pj
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp