Pessoas
Pessoas (/people) são os clientes, fornecedores e contatos cadastrados no espaço de trabalho. Um mesmo cadastro pode acumular papéis — cliente, fornecedor, os dois ou nenhum — sem virar registro duplicado.
A listagem
Colunas: foto, Nome, Papel, Documento, E-mail e Telefone — mais Cadastrado em, que só aparece na visão consolidada. O papel vira selo: Cliente, Fornecedor, os dois, ou o texto Sem papel.
Acima da tabela, a busca (por nome ou documento) e o filtro Papel: Todas, Clientes, Fornecedores e Sem papel. Cada linha tem duas ações — Editar e Excluir. O botão de criação é "Nova pessoa".
O formulário
Quatro abas: Identificação, Contato, Endereço e Dados bancários.
Identificação
| Campo | Observações |
|---|---|
| Nome | Obrigatório |
| Apelido | Opcional |
| Razão social | "Para PJ — razão social oficial" |
| Cadastrar em | Obrigatório — a empresa onde a pessoa é cadastrada |
| Papel | Os checkboxes Cliente e Fornecedor. Nenhum dos dois é válido |
| Natureza | Detectar automaticamente (padrão), Pessoa física ou Pessoa jurídica |
| CPF / CNPJ | O rótulo e a máscara seguem a Natureza — CPF por padrão, CNPJ quando pessoa jurídica |
| Data de nascimento | Opcional |
A Natureza não precisa ser escolhida. No padrão, o sistema deduz pelo documento que você digitar.
Contato
E-mails e Telefones, ambos em lista — dá para adicionar quantos precisar.
Só o e-mail tem rótulo. Cada e-mail aceita um rótulo livre (financeiro, comercial…). Telefone não tem esse campo. E "e-mail principal" não é um conceito do sistema — nenhum e-mail é eleito o principal.
Endereço e Dados bancários
Duas abas próprias. Dados bancários cobre banco, agência e conta (com dígitos), chave PIX e tipo da chave.
Papéis
| Combinação | Uso típico |
|---|---|
| Cliente | Quem paga à empresa |
| Fornecedor | Quem recebe da empresa |
| Cliente + Fornecedor | Parceiro que compra e vende |
| Nenhum dos dois | Contato sem relação financeira ativa |
O papel decide onde a pessoa aparece: o campo Cliente das contas a receber busca só quem é cliente; o Fornecedor das contas a pagar, só quem é fornecedor.
Busca e criação automática
Ao digitar um nome nos formulários de contas a pagar ou receber, o sistema busca os cadastros existentes e, não achando, oferece cadastrar pelo nome — a pessoa é criada junto no salvamento. A importação CSV faz o mesmo.
Foto de perfil
O sistema busca a foto em duas fontes, nesta ordem:
- Gravatar — pelo e-mail cadastrado. É a fonte primária.
- WhatsApp — pelo telefone, e só se a integração estiver configurada para a empresa. É o fallback, usado quando o Gravatar não devolve nada.
Nenhuma foto aparece sozinha. A busca não roda em segundo plano nem ao salvar a pessoa: é uma ferramenta manual, em Manutenção → Buscar fotos. Cada execução percorre apenas pessoas ainda sem foto, no teto de 100 por vez, e espera 30 dias antes de tentar de novo quem falhou. A foto encontrada é guardada no cadastro — não é buscada de novo a cada visita.
A foto aparece na listagem e no topo do detalhe da pessoa.
Exclusão
Um único bloqueio: regra de classificação apontando para a pessoa. Enquanto existir uma, a exclusão falha — a regra ficaria classificando contra alguém invisível, e não há para quem repontar. Edite ou remova a regra antes.
Contas a pagar, a receber e lançamentos não bloqueiam. O diálogo mostra o que está vinculado, mas deixa excluir.
A exclusão não pode ser desfeita — e isso é intencional. A pessoa sai das telas mas o histórico financeiro dela permanece intacto, apontando para o cadastro apagado. Não há "restaurar": ao apagar, o CPF/CNPJ é liberado, e nada impede que outro cadastro passe a usá-lo. Por isso a volta não é oferecida — ela poderia colidir com quem ocupou o lugar.