Titular e tenant ID
Cada usuário do portal vê apenas os registros que são dele. Quem decide isso são dois valores que precisam ser iguais:
- o tenant ID do usuário do portal, definido em Usuários do portal;
- o ID do titular de cada registro: o valor do campo que a entidade marca como titular — por exemplo, o CPF/CNPJ do cliente numa fatura.
O portal mostra ao usuário os registros cujo ID do titular é igual ao tenant ID dele. Um usuário sem tenant ID não vê nenhum registro.
Vários usuários, o mesmo titular
Vários usuários podem ter o mesmo tenant ID — os sócios de uma empresa, a equipe financeira, o contador. Cada um tem o próprio login, e todos veem os mesmos registros.
Como os valores são comparados
Na entidade, você escolhe como comparar:
| Comparação | Quando usar | Exemplo |
|---|---|---|
| Tenant ID (texto exato) | O titular é um código do seu sistema | RESP-2027013 |
| Tenant ID como CPF/CNPJ (só os dígitos) | O titular é um documento | 123.456.789-09 e 12345678909 são o mesmo titular |
Na comparação por CPF/CNPJ, quando o valor é um CPF (11 dígitos) ou um CNPJ (14 dígitos), só os dígitos contam, dos dois lados: uma máscara no sistema de origem ou no cadastro do usuário não impede o acesso. Um valor que não é CPF nem CNPJ é comparado como texto exato. Nas duas comparações, espaços no começo e no fim são ignorados, e um titular vazio não pertence a ninguém.
Exemplo
Na Aurora Energia, a entidade Fatura usa o campo CPF/CNPJ do titular com a comparação por CPF/CNPJ. Uma usuária com tenant ID 367.909.817-05 vê, no portal, só as faturas daquele CPF — e um colega cadastrado com o mesmo tenant ID vê as mesmas faturas.
O caminho completo, do sistema de origem até a tela do usuário, está em Do dado ao portal.