# Como empresas de segurança patrimonial podem validar CPFs de visitantes > Descubra como empresas de segurança patrimonial podem validar CPFs de visitantes via API para controlar acesso e reforçar a segurança de condomínios e empresas. **Publicado:** 02/11/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/como-empresas-de-seguranca-patrimonial-podem-validar-cpfs-de-visitantes --- Empresas de segurança patrimonial podem substituir o registro manual de visitantes por uma consulta à API da CPFHub.io: o visitante informa o CPF, o sistema retorna nome completo e data de nascimento em menos de 1 segundo, e o porteiro confirma a identidade sem necessidade de documentos físicos. O plano gratuito oferece 50 consultas mensais sem cartão de crédito — suficiente para validar a integração em um condomínio ou prédio comercial de menor movimento antes de escalar para o plano Pro. ## Introdução Empresas de segurança patrimonial que gerenciam o acesso a condomínios, prédios comerciais, áreas industriais e eventos precisam identificar visitantes de forma rápida e confiável. O registro de entrada e saída é uma obrigação operacional e, em muitos casos, uma exigência legal ou contratual. Tradicionalmente, o controle de visitantes depende de documentos físicos apresentados na portaria. Esse processo é lento, sujeito a erros e dificulta a rastreabilidade. A validação de CPF via API moderniza esse controle, permitindo que o visitante seja identificado em segundos, com dados verificados e registros digitais para auditoria. --- ## Os desafios do controle de visitantes ### Identificação manual O porteiro solicita um documento, anota o nome e o RG manualmente e entrega um crachá. Esse processo é demorado e propenso a erros de transcrição. ### Dados inconsistentes Visitantes que informam dados incorretos -- por erro ou intenção -- geram registros inúteis para fins de auditoria ou investigação. ### Filas na portaria Em horários de pico, a identificação manual cria filas que prejudicam a experiência do visitante e a operação do local. ### Rastreabilidade Registros manuais dificultam a consulta posterior. Quando é necessário verificar quem visitou o local em determinada data, a busca em cadernos ou planilhas é trabalhosa e imprecisa. --- ## Como a validação de CPF moderniza o controle de acesso ### 1. Identificação rápida O visitante informa apenas o CPF na portaria (por teclado, totem ou aplicativo). O sistema consulta a API e exibe o nome completo, que é confirmado pelo porteiro ou pelo próprio visitante. ### 2. Registro digital Cada entrada e saída é registrada digitalmente com CPF validado, nome, data e horário. Esses registros são facilmente consultáveis e exportáveis para relatórios. ### 3. Pré-cadastro de visitantes O morador ou empresa pode pré-cadastrar visitantes esperados, informando o CPF. Quando o visitante chega, o sistema já possui os dados validados, agilizando a liberação. ### 4. Blocklist CPFs vinculados a ocorrências anteriores podem ser incluídos em uma lista de bloqueio, impedindo o acesso automático e sinalizando o porteiro. --- ## Implementação com cURL e Go Exemplo de consulta via cURL para validar o CPF de um visitante: ```bash curl -X GET https://api.cpfhub.io/cpf/12345678900 \ -H "x-api-key: SUA_CHAVE_DE_API" \ -H "Accept: application/json" \ --max-time 10 ``` Exemplo de integração em Go para um sistema de controle de portaria: ```go package main import ( "encoding/json" "fmt" "io" "net/http" "time" ) type CPFResponse struct { Success bool `json:"success"` Data struct { CPF string `json:"cpf"` Name string `json:"name"` NameUpper string `json:"nameUpper"` Gender string `json:"gender"` BirthDate string `json:"birthDate"` Day int `json:"day"` Month int `json:"month"` Year int `json:"year"` } `json:"data"` } func validarVisitante(cpf string) (*CPFResponse, error) { url := fmt.Sprintf("https://api.cpfhub.io/cpf/%s", cpf) client := &http.Client{Timeout: 10 * time.Second} req, err := http.NewRequest("GET", url, nil) if err != nil { return nil, err } req.Header.Set("x-api-key", "SUA_CHAVE_DE_API") req.Header.Set("Accept", "application/json") resp, err := client.Do(req) if err != nil { return nil, err } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, err } var resultado CPFResponse err = json.Unmarshal(body, &resultado) if err != nil { return nil, err } return &resultado, nil } func main() { resultado, err := validarVisitante("12345678900") if err != nil { fmt.Printf("Erro: %v\n", err) return } if resultado.Success { fmt.Printf("Visitante: %s (CPF: %s)\n", resultado.Data.Name, resultado.Data.CPF) } else { fmt.Println("CPF nao encontrado") } } ``` --- ## Fluxo de controle de acesso com API | Etapa | Descrição | | --- | --- | | 1. Chegada | Visitante informa CPF na portaria | | 2. Consulta | Sistema consulta a API CPFHub.io | | 3. Validação | Nome exibido na tela para confirmação | | 4. Verificação | Sistema checa blocklist e pré-cadastro | | 5. Liberação | Visitante liberado com registro digital | | 6. Saída | Horário de saída registrado automaticamente | --- ## Cenários de aplicação ### Condomínios residenciais Visitantes de moradores são validados pelo CPF, com registro automático de entrada e saída. O morador pode pré-autorizar visitantes pelo aplicativo do condomínio. ### Prédios comerciais Empresas podem gerenciar o acesso de prestadores de serviço, entregadores e visitantes corporativos, mantendo registros auditáveis. ### Áreas industriais Fábricas e centros logísticos que exigem controle rigoroso de acesso podem validar motoristas, fornecedores e técnicos de manutenção. ### Eventos Organizadores de eventos em espaços privados podem validar o CPF dos convidados na entrada, garantindo que apenas pessoas autorizadas acessem o local. --- ## Benefícios operacionais * **Velocidade** -- A validação leva menos de 1 segundo, eliminando filas na portaria. * **Precisão** -- Dados validados automaticamente, sem erros de transcrição. * **Rastreabilidade** -- Registros digitais consultáveis a qualquer momento. * **Integração** -- A API REST se integra com totens, apps e sistemas de portaria existentes. * **Conformidade** -- Registros de acesso atendem exigências de auditoria e seguro patrimonial. --- ## Planos recomendados | Perfil | Plano CPFHub.io | | --- | --- | | Condomínio ou empresa pequena | Gratuito (50 consultas/mês, R$ 0, sem cartão) | | Empresa de segurança com múltiplos contratos | Pro (R$ 149/mês, 1.000 consultas) | | Grande operação com alto volume | Corporativo (volume personalizado, SLA 99,9%) | --- ## Perguntas frequentes ### A API CPFHub.io bloqueia o acesso à portaria se o limite mensal for atingido? Não. A API nunca retorna HTTP 429 nem interrompe consultas ao atingir o limite do plano. Quando o volume mensal é ultrapassado, cada consulta adicional é cobrada a R$0,15 — o que significa que o controle de acesso de visitantes nunca para por falta de quota. Acompanhe o consumo em [app.cpfhub.io/settings/billing](https://app.cpfhub.io/settings/billing). ### Quais dados a API retorna que são úteis para o controle de acesso? A resposta inclui nome completo, nome em caixa alta, gênero e data de nascimento (dia, mês e ano). O nome completo permite confirmar a identidade do visitante sem precisar de um documento físico, e a data de nascimento pode ser usada como segundo fator de verificação em acessos sensíveis. ### Como integrar a validação de CPF em um sistema de portaria já existente? A API REST aceita uma chamada GET simples com o CPF na URL e a API key no header `x-api-key`. O exemplo em Go deste artigo pode ser adaptado para qualquer linguagem. Se o sistema de portaria tiver suporte a webhooks ou integrações externas, a chamada à API pode ser disparada automaticamente ao digitar o CPF no terminal. ### A LGPD impõe restrições ao uso de CPF para controle de acesso de visitantes? Sim. O tratamento de CPF de visitantes deve ter base legal adequada (legítimo interesse ou obrigação contratual), e os dados coletados devem ser usados apenas para a finalidade declarada — controle de acesso. Registros devem ser mantidos pelo tempo necessário e acessados apenas por pessoal autorizado. Consulte as orientações da [ANPD](https://www.gov.br/anpd) sobre tratamento de dados em controle de acesso. ### Leia também - [Como empresas de eventos podem validar CPF na venda de ingressos nominais](https://cpfhub.io/blog/como-empresas-de-eventos-podem-validar-cpf-na-venda-de-ingressos-nominais) - [UX de verificação de CPF em totens de autoatendimento e quiosques](https://cpfhub.io/blog/ux-de-verificacao-de-cpf-em-totens-de-autoatendimento-e-quiosques) - [Como manter registros de auditoria (audit trail) para consultas de CPF](https://cpfhub.io/blog/como-manter-registros-de-auditoria-para-consultas-de-cpf) - [Integrar a API de CPF em uma aplicação Go com Gin ou Echo](https://cpfhub.io/blog/integrar-api-cpf-go-gin-echo) --- ## Conclusão A validação de CPF via API transforma o controle de acesso de visitantes, substituindo processos manuais lentos e imprecisos por identificação digital rápida e rastreável. Empresas de segurança patrimonial que adotam essa tecnologia oferecem um serviço superior aos seus clientes, com registros auditáveis e prevenção a acessos indevidos. A API da CPFHub.io responde em ~900ms e nunca bloqueia por volume — o controle de acesso permanece operacional mesmo em dias de alto fluxo. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e modernize o controle de visitantes da sua operação de segurança patrimonial.