beneficiaries.read
Lista e visualiza beneficiários e seus status de acesso.
Rota /portal & /beneficiaries
Portal do Beneficiário.
O portal permite que os beneficiários finais (vidas) tenham acesso a uma área logada premium para gerenciar sua carteirinha, visualizar detalhes do plano e receber comunicações institucionais.
beneficiaries.manage
Cria, edita, convida, bloqueia e gerencia beneficiários.
engagement.publish
Cria e publica comunicados ou campanhas de engajamento no portal.
Recursos do portal
Visão do Beneficiário
Carteirinha Digital
Visualização frente e verso da carteirinha do plano de saúde, com download em PDF e compartilhamento nativo.
Estrutura Familiar
Vinculação entre titular (HOLDER) e dependentes (DEPENDENT) compartilhando o mesmo contrato e plano.
Consulta de Plano
Exibição do plano contratado, número da apólice, carências e vigência operacional.
Engajamento & Campanhas
Visualização de comunicados institucionais com marcação de leitura e notificações enviadas pela operadora/corretora.
Ciclo de vida de acesso
Fluxo de status do usuário
Convite Enviado
Um convite seguro é gerado e enviado por e-mail. O status do beneficiário muda para INVITED.
Cadastro Ativo
Quando o beneficiário aceita o convite e define sua senha, o status passa para ACTIVE.
Acesso Bloqueado
Operadores podem suspender o acesso do beneficiário a qualquer momento, mudando o status para BLOCKED.
Auditoria de Acesso (AccessAuditLog)
Todas as ações críticas realizadas pelo beneficiário no portal (como primeiro acesso, visualização de carteirinha e downloads) são registradas no banco para auditoria de segurança da informação (LGPD).
Dados cadastrais
Campos Chave do Beneficiário
| Campo | API DB | Descrição e Regra de Negócio |
|---|---|---|
| Nome Completo | name | Obrigatorio. Nome exibido na carteirinha digital. |
| Opcional no cadastro, mas obrigatorio para habilitar o convite ao portal. | ||
| Tipo de Beneficiário | type | HOLDER (Titular) ou DEPENDENT (Dependente). |
| Titular Vinculado | dependentOfId | Obrigatório para dependentes; define qual beneficiário é o titular. |
| Status de Acesso | accessStatus | PENDING (sem convite), INVITED, ACTIVE ou BLOCKED. |
Checklist Operacional
Antes de liberar o acesso
O e-mail do beneficiário foi cadastrado corretamente antes de enviar o convite.
Para dependentes, a vinculação com o titular correto foi realizada no formulário.
O contrato do beneficiário está ativo na plataforma.
Todos os convites em lote (bulk invite) foram revisados na listagem de importação.
Auditorias de acessos e logins foram validadas no painel de controle.