Skip to main content

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

ComponenteAtualização
Base cadastral da GYRA+mensal
Base de origemReceita Federal atualiza diariamente
Cache por documentoreaproveitado dentro do mês corrente
Os dados cadastrais chegam à GYRA+ via dump mensal consolidado, então o dado exibido na análise pode ter até cerca de 30 dias de defasagem em relação à Receita Federal. Para a grande maioria das decisões de crédito isso é suficiente (razão social, CNAE e data de abertura mudam pouco), mas mudanças muito recentes — baixa de CNPJ nos últimos dias, alteração de endereço feita na semana — podem ainda não ter refletido.
Precisa de dado em tempo real? Use as Certidões: elas consultam a fonte oficial na hora (Receita Federal, PGFN, Junta Comercial, etc.) e trazem a situação atualizada em segundos. Recomendadas quando a decisão depende de estado regulatório de hoje, como emissão de certidão negativa, ou quando o próprio fluxo operacional exige prova atual.

Dados entregues

Campos detalhados em Seção, Informações Básicas.

CNPJ (empresa)

CampoDescriçãoExemplo
businessNameRazão social"ACME Ltda"
tradeNameNome fantasia"ACME"
cnpjDocumento"43591367000130"
situationSituação cadastral"ATIVA", "BAIXADA", "SUSPENSA", "INAPTA", "NULA"
situationDateData da situação atual"2020-05-10"
foundationDateData de abertura"2015-03-22"
mainCnaeCNAE principal{ "code": "62.01-5-00", "description": "..." }
secondaryCnaesCNAEs secundários[...]
capitalCapital social100000.00
taxRegimeRegime tributário"SIMPLES", "LUCRO_REAL", "LUCRO_PRESUMIDO"
sizePorte"ME", "EPP", "DEMAIS"
Endereço, telefones, e-mails e demais dados de localização estão descritos em Contatos e Localização.

CPF (pessoa física)

CampoDescrição
nameNome completo
cpfDocumento
birthDateData de nascimento
motherNameNome da mãe
situationSituação cadastral: REGULAR, SUSPENSA, CANCELADA, TITULAR_FALECIDO, PENDENTE
ageIdade atual
genderGê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

1

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.
2

Adicionar regras de idade

COMPANY_OPENING_TIME e PERSON_AGE são segundo filtro fundamental.
3

Camada opcional de segmentação

Filtros por CNAE, porte, regime tributário para alinhar ao produto que você oferece.
Exemplo:
{
  "field": "company.situation",
  "operator": "CONTAINS",
  "value": "INAPTA,BAIXADA,SUSPENSA,NULA",
  "status": "DENIED"
}

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

A fonte entrega o nome oficial na Receita. Se você cadastrou o nome fantasia, tradeName provavelmente bate, mas businessName é o registro formal.
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.
Não. Uma vez baixado, o CNPJ é encerrado. Nunca conceder crédito para CNPJ baixado.
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.