O erro mais caro de um buscador de rede credenciada não é a interface feia nem a busca lenta. É mandar um paciente com dor até um hospital que deixou de atender aquele plano no mês passado. O usuário perde a viagem, o atendimento atrasa e a confiança no sistema acaba ali.
Manter esse tipo de buscador atualizado é um problema de dados antes de ser um problema de código. Abaixo está o processo completo, da coleta à exibição, com os pontos em que os projetos costumam quebrar.
Antes da primeira linha de código: a rede é do produto, não da operadora
Esse é o detalhe que derruba muitos projetos. A mesma operadora vende vários planos, e cada plano, registrado na ANS como um produto, tem a própria rede. Um hospital pode atender o plano mais caro e recusar o mais básico da mesma empresa.
Na modelagem, isso significa que a relação central não é “operadora atende prestador”, e sim “produto atende prestador, em determinado serviço, a partir de determinada data”. Quem modela pela operadora vai mostrar hospitais errados para metade dos usuários.
A consulta pública de rede costuma seguir essa lógica. Uma explicação sobre a consulta de redes credenciadas do ponto de vista do consumidor ajuda a entender o que o usuário espera encontrar.
O processo, etapa por etapa
- Coleta dos arquivos de rede de cada operadora e de bases públicas de referência.
- Normalização de nomes, documentos e endereços.
- Deduplicação de prestadores que aparecem com grafias diferentes.
- Geocodificação dos endereços em coordenadas.
- Carga incremental com histórico de mudanças.
- Validação automática e por amostragem.
- Exposição por uma API com filtros e data de atualização visível.
Coleta: de onde vêm os dados
A fonte primária é a operadora. Algumas entregam arquivos estruturados ou APIs para parceiros, outras só publicam a rede no próprio site. Para operadoras grandes, como a SulAmérica, a rede de atendimento SulAmérica muda com frequência, e a coleta precisa ser periódica, não pontual. Portais de corretoras que reúnem várias operadoras, como o da Amigão Saúde, mostram bem o tamanho do desafio: cada empresa publica a rede num formato próprio.
As bases públicas servem de referência cruzada. O Cadastro Nacional de Estabelecimentos de Saúde disponibiliza a base de estabelecimentos para download, com código CNES, endereço e tipo de unidade. A ANS publica conjuntos no seu portal de dados abertos da ANS, incluindo características dos produtos e relação de prestadores hospitalares por produto.
Normalização e deduplicação
“Hosp. São José”, “Hospital Sao Jose Ltda” e “HOSPITAL SÃO JOSÉ – UNIDADE II” podem ser o mesmo lugar ou três lugares diferentes. Nome não é chave. Use, nesta ordem de confiança: código CNES, CNPJ com filial, e só então nome mais endereço normalizado.
Para profissionais, o identificador é o registro no conselho (CRM, CRO, CRP) com a UF. Um médico atende em três consultórios; cada endereço é uma linha de atendimento, ligada ao mesmo profissional.
Geocodificação
Endereços brasileiros são um teste de paciência: “Rua 3, s/n, Quadra 12”, CEP genérico de cidade pequena, bairro com dois nomes. Algumas boas práticas:
- Guarde a precisão do resultado (número exato, rua, CEP, cidade) junto da coordenada.
- Mantenha um cache por endereço normalizado para não pagar a mesma geocodificação duas vezes.
- Quando a base pública trouxer coordenadas, compare com as suas e marque divergências grandes para revisão.
- Indexe com PostGIS ou estrutura equivalente e faça a busca por raio com índice espacial, não com cálculo em memória.
Carga incremental com histórico
Nunca sobrescreva a rede inteira a cada carga. Compare o arquivo novo com o estado atual e gere eventos: entrou, saiu, mudou endereço, mudou serviço. Cada vínculo produto-prestador ganha valid_from e valid_to.
Esse histórico resolve dois problemas. Permite responder “este hospital atendia meu plano em março?”, útil para disputas de reembolso. E protege contra arquivos quebrados: se a carga nova remove 40% da rede de uma vez, o sistema deve travar e pedir revisão humana, em vez de publicar.
Validação: os sinais de que um dado envelheceu
| Sinal | Como detectar | Ação |
|---|---|---|
| Prestador sumiu do arquivo da operadora | Diff entre cargas | Marcar como “em verificação” antes de remover |
| CNES desativado | Cruzamento com a base pública | Ocultar e alertar a operação |
| Endereço divergente entre fontes | Distância entre coordenadas acima de um limite | Fila de revisão manual |
| Muitos usuários reportando erro | Botão “informação incorreta” na tela | Prioridade de checagem |
| Dado sem confirmação há meses | Campo de última verificação | Rechecagem por amostra |
O botão de feedback do usuário é barato e rende muito. Quem chegou ao hospital e não foi atendido é a melhor fonte de atualização que existe, desde que o relato caia numa fila tratada por alguém.
Para entender o que os pacientes procuram antes de clicar, vale ver como portais de corretoras organizam informações sobre operadoras e redes. A Amigão Saúde, por exemplo, mantém conteúdos explicativos sobre redes credenciadas que mostram a linguagem do usuário final.
A API e a tela: honestidade sobre o que o sistema sabe
Na API, os filtros essenciais são produto, tipo de serviço (pronto-socorro, internação, exames, consulta), especialidade e raio. Pagine os resultados, devolva a data da última verificação de cada item e use cabeçalhos de cache coerentes com a frequência de atualização.
Na tela, três detalhes evitam reclamações:
- Mostrar o nome comercial do plano, e não só o nome da operadora, porque é assim que o usuário reconhece o que contratou.
- Exibir “atualizado em” em cada prestador.
- Incluir um aviso para confirmar o atendimento com a operadora antes de procedimentos eletivos.
Um teste prático: escolha três produtos de operadoras diferentes, como opções Bradesco Saúde e planos NotreDame Intermédica, e compare a lista do seu buscador com a consulta oficial de cada uma. As divergências mostram onde o pipeline está falhando.
Esse cuidado também separa dados de vitrine e dados de operação, tema discutido no texto sobre três camadas de dados que não deveriam se misturar.
Ranking e recomendação: onde o buscador vira produto
Com a base confiável, dá para ir além da lista por distância. Ordenar por tempo de deslocamento real, destacar quem tem horário disponível ou priorizar prestadores com menos relatos de erro melhora muito a experiência. A lógica desses ordenamentos aparece no artigo sobre o algoritmo por trás da recomendação de médicos online.
Cuidado com sinais que parecem objetivos e não são. Número de avaliações favorece prestadores antigos, e “mais próximo” ignora trânsito, estacionamento e horário de funcionamento. Combine dois ou três critérios e deixe o usuário trocar a ordenação.
Só não deixe o ranking esconder a dúvida. Prestador “em verificação” deve aparecer com essa marca, não sumir nem subir para o topo.
Ferramentas de corretoras usam a mesma informação com outro objetivo: ajudar o cliente a escolher o plano pela rede. Na Amigão Saúde, a rede e a cobertura de cada operadora entram na orientação ao consumidor, e a comparação de planos médicos parte justamente dos hospitais que o cliente quer manter por perto.
O próximo passo prático para quem já tem um buscador no ar: rode hoje um diff entre a última carga e a anterior, conte quantos vínculos mudaram e verifique manualmente dez deles. Esse número diz se a sua frequência de atualização está certa.
