Documentation Index
Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt
Use this file to discover all available pages before exploring further.
Resumo: a fonte cadastral entrega os dados oficiais de identidade do CPF ou CNPJ: nome ou razão social, situação atual, data de nascimento ou abertura, CNAE, capital social, porte e regime tributário. É a base de qualquer análise e serve para identificar o documento e detectar sinais de alerta cadastrais. Dados de telefone, e-mail, endereço (atual e histórico), mapa e fachada ficam na seção Contatos e Localização e acompanham todo relatório, inclusive o SIMPLES.
O que é
Os dados cadastrais são a identidade oficial do tomador: quem ele é segundo a Receita Federal (para CNPJ) ou base de registros civis (para CPF). Em crédito, a seção cadastral é sempre o ponto de partida: confirma que o documento existe, que está ativo e revela fatos mínimos sobre a empresa ou pessoa. Ela responde perguntas como:- Esta empresa existe e está ativa?
- Há quanto tempo opera?
- Qual o ramo de atividade (CNAE)?
- O CPF tem mais de 18 anos? Está regular?
- Houve mudança recente de endereço ou razão social?
De onde vem
- Tipo de fonte: cadastro oficial.
- Para CNPJ: Receita Federal.
- Para CPF: base de registros civis consolidada.
- Cobertura geográfica: Brasil (nacional).
- Natureza do dado: oficial.
- Base legal: dados públicos (CNPJ) e dados cadastrais sob LGPD (CPF).
Frequência de atualização
| Componente | Atualização |
|---|---|
| Base cadastral da GYRA+ | mensal |
| Base de origem | Receita Federal atualiza diariamente |
| Cache por documento | reaproveitado dentro do mês corrente |
Dados entregues
Campos detalhados em Seção, Informações Básicas.CNPJ (empresa)
| Campo | Descrição | Exemplo |
|---|---|---|
businessName | Razão social | "ACME Ltda" |
tradeName | Nome fantasia | "ACME" |
cnpj | Documento | "43591367000130" |
situation | Situação cadastral | "ATIVA", "BAIXADA", "SUSPENSA", "INAPTA", "NULA" |
situationDate | Data da situação atual | "2020-05-10" |
foundationDate | Data de abertura | "2015-03-22" |
mainCnae | CNAE principal | { "code": "62.01-5-00", "description": "..." } |
secondaryCnaes | CNAEs secundários | [...] |
capital | Capital social | 100000.00 |
taxRegime | Regime tributário | "SIMPLES", "LUCRO_REAL", "LUCRO_PRESUMIDO" |
size | Porte | "ME", "EPP", "DEMAIS" |
CPF (pessoa física)
| Campo | Descrição |
|---|---|
name | Nome completo |
cpf | Documento |
birthDate | Data de nascimento |
motherName | Nome da mãe |
situation | Situação cadastral: REGULAR, SUSPENSA, CANCELADA, TITULAR_FALECIDO, PENDENTE |
age | Idade atual |
gender | Gênero declarado |
Casos de uso
Bloquear situação irregular
Empresa baixada, suspensa, inapta ou nula não deveria tomar crédito.
Regra sugerida:
COMPANY_SITUATION IN ["BAIXADA", "SUSPENSA", "INAPTA", "NULA"] : DENIED.Idade mínima de empresa
Evitar emprestar para empresas recém-abertas sem histórico.
Regra sugerida:
COMPANY_OPENING_TIME < 1 ano : DENIED ou ALERT.CPF irregular
Situação cadastral do CPF diferente de
REGULAR é motivo de bloqueio.CNAE de alto risco
Alguns produtos não atendem certos setores (ex: MEI para crédito empresarial grande). Filtre por
mainCnae.Titular falecido
CPF com situação
TITULAR_FALECIDO indica fraude em curso ou erro cadastral grave.Recência da abertura ou alteração
Mudança recente de razão social ou abertura muito recente pode indicar tentativa de evitar histórico negativo.
Como usar na política
Começar pelos campos de situação
COMPANY_SITUATION e PERSON_SITUATION deveriam ser as primeiras regras de qualquer política: são bloqueios óbvios e baratos de avaliar.Limitações e considerações
- Atualização mensal: a base cadastral é consolidada mensalmente, então alterações recentes (dias) podem ainda não ter refletido. Para estado atual, use Certidões (Cartão CNPJ, situação CPF Receita Federal, etc.).
- Defasagem da Receita: a Receita Federal demora a atualizar certos campos (ex: mudança de regime tributário). Dado pode estar correto mas desatualizado por semanas mesmo na fonte.
- CNPJs muito novos: empresas recém-abertas podem não ter CNAEs secundários ou sócios completamente preenchidos.
- Nome social: CPFs com nome social podem aparecer com nome civil em algumas consultas, reconciliação manual necessária em casos específicos.
Perguntas frequentes
Por que a razão social veio diferente do que cadastrei?
Por que a razão social veio diferente do que cadastrei?
O que é 'INAPTA'?
O que é 'INAPTA'?
Situação em que o CNPJ deixou de cumprir obrigações acessórias (ex: não entregou declarações). Indica empresa com problemas de compliance fiscal, tratar como bloqueio.
CNPJ baixado pode voltar a operar?
CNPJ baixado pode voltar a operar?
Não. Uma vez baixado, o CNPJ é encerrado. Nunca conceder crédito para CNPJ baixado.
Qual nível de relatório inclui cadastral?
Qual nível de relatório inclui cadastral?
Disponível em todos os relatórios, desde o SIMPLES. É a base de qualquer análise.
Próximos passos
Seção detalhada
Todos os campos e JSON de exemplo.
Criar regra de situação
Passo a passo no Toolbox.
Vínculos Societários
QSA, sócios e empresas relacionadas.
Contatos e Localização
Telefones, e-mails, endereços, mapa e fotos de fachada.
Certidões
Situação em tempo real direto na fonte oficial.

