# APIs de CPF para gestão condominial: validação de moradores e síndicos > Saiba como APIs de CPF podem ser utilizadas na gestão condominial para validar moradores, síndicos e prestadores de serviço de forma automatizada. **Publicado:** 21/05/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/apis-de-cpf-para-gestao-condominial-validacao-de-moradores --- Para gestão condominial, integre a API de CPF nos momentos de cadastro de novos moradores (proprietários e inquilinos), eleição de síndicos e cadastro de prestadores de serviço. A chamada GET `https://api.cpfhub.io/cpf/{cpf}` com o header `x-api-key` retorna nome e data de nascimento, permitindo confirmar que o CPF pertence à pessoa que está se cadastrando — em menos de 1 segundo e a custo inferior ao de qualquer verificação documental manual. ## Introdução A gestão condominial no Brasil passa por uma transformação digital significativa. Aplicativos de gestão, portarias remotas, sistemas de reservas e plataformas de comunicação entre moradores estão substituindo processos manuais e burocráticos. No centro de toda essa digitalização está a necessidade de identificar e validar as pessoas que interagem com o condomínio: moradores, proprietários, inquilinos, síndicos, conselheiros e prestadores de serviço. O CPF é o identificador natural para essa finalidade. Ele é utilizado no registro de propriedade do imóvel, na elaboração de contratos de locação, no cadastro de moradores junto à administradora e na emissão de boletos de condomínio. No entanto, a validação desse CPF -- confirmar que o número é real, que os dados conferem e que a pessoa é quem diz ser -- frequentemente é negligenciada ou feita manualmente. --- ## Cenários de uso no dia a dia condominial ### Cadastro de novos moradores Quando um novo morador se muda para o condomínio -- seja proprietário ou inquilino -- seus dados precisam ser cadastrados no sistema de gestão. A validação do CPF nesse momento garante que os dados informados são reais e consistentes. ### Eleição e cadastro de síndicos A eleição do síndico é um dos atos mais importantes da gestão condominial. Validar o CPF do candidato a síndico confirma sua identidade e permite verificar se os dados estão corretos para fins de representação legal do condomínio. ### Cadastro de prestadores de serviço Eletricistas, encanadores, jardineiros e outros prestadores que acessam regularmente o condomínio podem ter seus CPFs validados para fins de controle de acesso e emissão de documentos fiscais (RPA). ### Portaria remota e controle de acesso Sistemas de portaria remota podem utilizar a validação de CPF para confirmar a identidade de visitantes e prestadores antes de liberar o acesso ao condomínio. ### Emissão de boletos e cobranças A emissão de boletos de condomínio exige CPF válido do condômino. Validar previamente evita rejeições no sistema bancário. --- ## Integrando a API de CPF ao sistema de gestão ### Consulta básica via cURL A integração com a API da CPFHub.io é simples e pode ser realizada por qualquer sistema que suporte requisições HTTP: ```bash curl -X GET https://api.cpfhub.io/cpf/12345678900 \ -H "x-api-key: SUA_CHAVE_DE_API" \ -H "Accept: application/json" ``` ```json { "success": true, "data": { "cpf": "12345678900", "name": "Ricardo Souza Barros", "nameUpper": "RICARDO SOUZA BARROS", "gender": "M", "birthDate": "05/12/1978", "day": 5, "month": 12, "year": 1978 } } ``` ### Implementação para cadastro de moradores ```python import requests class GestaoCondominial: """ Módulo de validação de CPF para sistemas de gestão condominial. """ def __init__(self, api_key: str): self.api_key = api_key self.base_url = 'https://api.cpfhub.io/cpf' def cadastrar_morador(self, cpf: str, nome: str, unidade: str, tipo: str = 'proprietario') -> dict: """ Valida CPF e cadastra novo morador no sistema. Parâmetros: - cpf: Número do CPF - nome: Nome informado pelo morador - unidade: Número da unidade (ex: '101', 'Bloco A - 203') - tipo: 'proprietario' ou 'inquilino' """ cpf_limpo = ''.join(filter(str.isdigit, cpf)) if len(cpf_limpo) != 11: return {'cadastrado': False, 'motivo': 'CPF com formato inválido'} # Consultar API url = f'{self.base_url}/{cpf_limpo}' headers = { 'x-api-key': self.api_key, 'Accept': 'application/json' } try: response = requests.get(url, headers=headers, timeout=10) data = response.json() except Exception as e: return {'cadastrado': False, 'motivo': f'Erro na consulta: {str(e)}'} if not data.get('success'): return {'cadastrado': False, 'motivo': 'CPF não localizado na base'} # Verificar consistência do nome nome_api = data['data']['nameUpper'] nome_informado = nome.upper().strip() if nome_informado not in nome_api and nome_api not in nome_informado: primeiro_nome_informado = nome_informado.split()[0] primeiro_nome_api = nome_api.split()[0] if primeiro_nome_informado != primeiro_nome_api: return { 'cadastrado': False, 'motivo': 'Nome informado diverge do CPF', 'nome_cpf': data['data']['name'], 'nome_informado': nome } return { 'cadastrado': True, 'morador': { 'cpf': cpf_limpo, 'nome': data['data']['name'], 'genero': data['data']['gender'], 'nascimento': data['data']['birthDate'], 'unidade': unidade, 'tipo': tipo } } def validar_sindico(self, cpf: str, nome: str) -> dict: """ Valida CPF do candidato a síndico. """ resultado = self.cadastrar_morador(cpf, nome, unidade='N/A', tipo='sindico') if resultado.get('cadastrado'): # Verificar idade mínima (18 anos) dados = resultado['morador'] from datetime import datetime nascimento = datetime.strptime(dados['nascimento'], '%d/%m/%Y') hoje = datetime.now() idade = hoje.year - nascimento.year if (hoje.month, hoje.day) < (nascimento.month, nascimento.day): idade -= 1 resultado['morador']['idade'] = idade resultado['morador']['apto_sindico'] = idade >= 18 return resultado def validar_prestador(self, cpf: str, nome: str, servico: str) -> dict: """ Valida CPF de prestador de serviço para controle de acesso e RPA. """ resultado = self.cadastrar_morador(cpf, nome, unidade='Prestador', tipo='prestador') if resultado.get('cadastrado'): resultado['prestador'] = { 'cpf': resultado['morador']['cpf'], 'nome': resultado['morador']['nome'], 'servico': servico, 'dados_para_rpa': { 'nome_completo': resultado['morador']['nome'], 'cpf': resultado['morador']['cpf'], 'nascimento': resultado['morador']['nascimento'] } } return resultado # Exemplo de uso gestao = GestaoCondominial(api_key='SUA_CHAVE_DE_API') # Cadastrar morador morador = gestao.cadastrar_morador( cpf='12345678900', nome='Ricardo Souza Barros', unidade='Bloco A - 302', tipo='proprietario' ) print('Morador:', morador) # Validar síndico sindico = gestao.validar_sindico( cpf='12345678900', nome='Ricardo Souza Barros' ) print('Síndico:', sindico) ``` --- ## Benefícios para a administração condominial ### Redução de erros cadastrais A validação automática de CPF elimina erros de digitação, nomes incompletos e CPFs inválidos que causam problemas na emissão de boletos e na comunicação oficial com os condôminos. ### Prevenção de fraudes Casos de pessoas que se apresentam como moradores ou proprietários sem de fato serem podem ser identificados pela divergência entre o nome informado e o nome vinculado ao CPF. ### Agilidade no cadastro O processo de cadastro de novos moradores, que pode levar dias quando depende de verificação manual de documentos, pode ser concluído em segundos com validação via API. ### Conformidade com a LGPD A utilização de uma API em conformidade com a LGPD, como a da [**CPFHub.io**](https://www.cpfhub.io/), garante que o condomínio cumpre o princípio da necessidade: os dados são processados apenas para a finalidade declarada (verificação de identidade do morador) e o provedor opera como operador de dados conforme previsto em lei. --- ## Tipos de condomínio e volumes de validação | Tipo de condomínio | Unidades | Validações estimadas/ano | Plano recomendado | | --- | --- | --- | --- | | Residencial pequeno | Até 30 | 20-50 | Gratuito (R$ 0) | | Residencial médio | 30-200 | 50-300 | Gratuito ou Pro | | Residencial grande | 200-1.000 | 300-1.000 | Pro (R$ 149/mês) | | Comercial | Variável | 100-500 | Pro | | Administradora (múltiplos condomínios) | 1.000+ | 1.000+ | Corporativo | Para administradoras que gerenciam múltiplos condomínios, o plano Corporativo da CPFHub.io oferece volume personalizado, SLA de 99,9% e suporte prioritário. --- ## Integração com portaria remota Sistemas de portaria remota podem utilizar a API de CPF para validar visitantes e prestadores no momento do acesso: 1. O visitante informa seu CPF no terminal da portaria ou pelo interfone. 2. O sistema consulta a API para obter o nome do titular. 3. O operador remoto confirma o nome com o visitante. 4. Se os dados conferem, o acesso é liberado e registrado. Esse fluxo adiciona uma camada de segurança sem impactar significativamente o tempo de acesso, já que a API responde em aproximadamente 900ms. --- ## Boas práticas para condomínios * **Informar os moradores** -- Comunique previamente que os dados de CPF serão verificados no cadastro, explicando a finalidade e o amparo legal. * **Armazenar com segurança** -- Os dados de CPF dos condôminos devem ser armazenados de forma segura, com acesso restrito apenas a pessoas autorizadas. * **Atualizar periodicamente** -- Reconsulte os CPFs dos moradores periodicamente para manter os dados atualizados, especialmente após mudanças de propriedade ou troca de inquilinos. * **Manter registros** -- Mantenha registros das validações realizadas para fins de auditoria e resolução de disputas. * **Política de privacidade** -- O condomínio deve ter uma política de privacidade que informe como os dados pessoais dos moradores são coletados, utilizados e protegidos. --- ## Perguntas frequentes ### Um condomínio pode exigir validação de CPF de todos os moradores e prestadores? Sim, desde que a finalidade seja clara e proporcional (identificação, controle de acesso, emissão de documentos fiscais) e os moradores sejam informados sobre o tratamento. O Código Civil autoriza o condomínio a exigir identificação de quem acessa o prédio, e a LGPD permite o tratamento com base no legítimo interesse de segurança patrimonial. ### Como integrar validação de CPF a sistemas de gestão condominial existentes como Superlógica ou Apto? A maioria das plataformas de gestão condominial suporta webhooks ou integrações via API. Configure um webhook que dispara a chamada GET para `https://api.cpfhub.io/cpf/{cpf}` no momento do cadastro de um novo morador. Se a plataforma não suportar webhooks, use o Zapier ou Make para criar o fluxo automatizado sem código. ### Com 50 consultas gratuitas por mês, o plano grátis é suficiente para um condomínio? Para condomínios pequenos (até 30 unidades), o plano gratuito cobre o volume anual de cadastros novos (mudanças de proprietário, novos inquilinos, troca de síndico) com folga. Condomínios maiores com portaria remota ativa — que valida visitantes e prestadores diariamente — precisam do plano Pro (1.000 consultas/mês por R$149) ou Corporativo. ### A validação de CPF de prestadores de serviço é exigida para emissão de RPA? Sim. Para emitir RPA (Recibo de Pagamento a Autônomo), o CPF do prestador deve constar no documento e estar correto. A validação via API antes da emissão garante que o CPF está ativo e que os dados do prestador são consistentes, evitando rejeições fiscais e facilitando a comprovação de pagamentos para fins de IRPF. ### Leia também - [APIs de CPF para plataformas de aluguel de imóveis: como validar inquilinos](https://cpfhub.io/blog/apis-cpf-plataformas-aluguel-imoveis-como-validar-inquilinos) - [APIs de CPF grátis para imobiliárias: como agilizar contratos?](https://cpfhub.io/blog/apis-de-cpf-gratis-para-imobiliarias-como-agilizar-contratos) - [KYC no Brasil: quais setores são obrigados a validar CPF por lei](https://cpfhub.io/blog/kyc-no-brasil-quais-setores-sao-obrigados-a-validar-cpf-por-lei) - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) --- ## Conclusão A validação de CPF via API é uma ferramenta valiosa para a gestão condominial moderna. Ela automatiza o cadastro de moradores, fortalece o controle de acesso, viabiliza a emissão correta de boletos e documentos fiscais, e adiciona uma camada de segurança a todo o ecossistema do condomínio. Para condomínios pequenos, o plano gratuito com 50 consultas mensais é mais do que suficiente. Administradoras que gerenciam múltiplos condomínios encontram no plano Pro ou Corporativo o volume e o suporte necessários para operações em escala. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e comece a validar CPFs de moradores, síndicos e prestadores no mesmo dia.