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: contatos e localização trazem telefones, e-mails, endereços (atual e históricos), outros dados de contato encontrados, além de mapa do endereço e fotos da fachada. Esses dados acompanham todo relatório da GYRA+ — SIMPLES, ESSENCIAL, COMPLETO e COMPLETO+ — ao lado dos dados principais de cada item.
O que é
Enquanto Cadastral responde quem é o CPF ou CNPJ, esta seção responde como encontrar e onde está o tomador. Reúne todos os canais de contato conhecidos e a representação visual do endereço declarado. Responde:- Quais telefones, e-mails e endereços estão associados a este documento?
- Há histórico de endereços anteriores?
- Como é a fachada do endereço declarado? É um ponto comercial real?
- O endereço existe geograficamente (mapa) e parece compatível com a atividade declarada?
Disponibilidade por nível
Diferente de fontes como SCR ou Processos, contatos e localização aparecem em todos os relatórios:| Nível | Contatos principais | Mapa do endereço | Fotos de fachada |
|---|---|---|---|
| SIMPLES | ✅ | ✅ | ✅ |
| ESSENCIAL | ✅ | ✅ | ✅ |
| COMPLETO | ✅ | ✅ | ✅ |
| COMPLETO+ | ✅ | ✅ | ✅ |
De onde vem
- Tipo de fonte: bases públicas, agregadores contratados e serviços de mapa/imagem (Street View e equivalentes).
- Cobertura geográfica: Brasil.
- Natureza do dado: público para endereço oficial de CNPJ; LGPD para dados de contato de pessoa física e histórico.
- Base legal: consentimento de negócio, finalidade de análise de crédito e prevenção a fraude.
Frequência de atualização
| Componente | Atualização |
|---|---|
| Endereço oficial (CNPJ) | sincroniza com RFB em 24-48 h |
| Endereço histórico (PF) | ciclo mensal na base agregada |
| Telefones e e-mails | ciclo mensal |
| Mapa e fotos de fachada | servidos pelo provedor na hora; imagem pode ter meses a anos de idade |
Dados entregues
CNPJ
| Campo | Descrição |
|---|---|
address.street, number, complement | Logradouro oficial |
address.zipCode, city, state | CEP, município, UF |
address.isMatrix | Matriz ou filial |
addressHistory[] | Endereços anteriores registrados |
phones[] | Telefones cadastrados (RFB + agregadores) |
emails[] | E-mails cadastrados (RFB + agregadores) |
otherContacts[] | Outros contatos encontrados em bases públicas/agregadas |
location.map | URL/coordenadas para render do mapa do endereço |
location.facade[] | Imagens de fachada encontradas para o endereço |
CPF
| Campo | Descrição |
|---|---|
address | Endereço atual |
addressHistory[] | Histórico de endereços com datas |
phones[] | Telefones associados |
emails[] | E-mails associados |
otherContacts[] | Outros contatos encontrados |
location.map | URL/coordenadas para o mapa do endereço |
location.facade[] | Imagens de fachada do endereço |
Casos de uso
Validação de cadastro
Cruzar o que o cliente declarou no seu onboarding com os contatos retornados pelo relatório. Divergência exige re-verificação.
Inspeção visual do endereço
Fotos de fachada e mapa ajudam a confirmar se o endereço declarado é um ponto comercial real, residência ou terreno vazio — útil em due diligence e anti-fraude.
Anti-fraude por mudanças
Múltiplas mudanças de endereço ou telefone em janela curta podem indicar fraude em curso.
Contato para cobrança
phones[], emails[] e otherContacts[] alimentam sua plataforma de cobrança em caso de default.Limitações e considerações
- Contatos podem estar desatualizados: telefones e e-mails coletados de bases agregadas nem sempre estão ativos. São leads, não garantia.
- Fachada pode ser antiga: imagens do provedor podem ter meses ou anos. Use como indicação, não como prova atual.
- Endereço declarado vs. operação real: o endereço do cadastro é o informado à RFB. Contabilidades, holdings e e-commerces com galpão remoto podem ter endereço oficial diferente do ponto de operação.
- LGPD em PF: tratamento de dados pessoais exige base legal adequada. Use o relatório apenas para as finalidades contratadas.
Perguntas frequentes
Posso usar telefones retornados para marketing?
Posso usar telefones retornados para marketing?
Depende da sua base legal e consentimento. O relatório é contratado para análise de crédito e prevenção a fraude; uso para marketing ativo requer nova base legal conforme LGPD.
A foto da fachada é tirada na hora da análise?
A foto da fachada é tirada na hora da análise?
Não. É a imagem mais recente disponível no provedor (ex: Street View). Pode estar defasada em meses ou anos.
Endereço do CNPJ bate com a operação real?
Endereço do CNPJ bate com a operação real?
Nem sempre. Muitas empresas declaram endereço de contabilidade ou matriz corporativa diferente do ponto de venda.
E se não houver imagem para o endereço?
E se não houver imagem para o endereço?
Regiões rurais, ruas recém-abertas ou numerações que o provedor não mapeou retornam apenas o mapa sem fachada. O campo volta vazio.
Próximos passos
Cadastral
Identidade oficial do documento.
Financeira
Faturamento e indicadores de capacidade.
Mídia e Reputação
Exposição pública e sinais online.
Criar política
Regras de UF e segmentação.