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. Cada papel vira um selo — Cliente, Fornecedor, Gerente de conta, Time — ou aparece o texto Sem papel.
Acima da tabela, a busca (por nome ou documento) e o filtro Papel: Todas, Clientes, Fornecedores, Gerentes, Time 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, Fornecedor, Gerente de conta e Time. Deixar todos desmarcados é 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 |
| Gerente de conta | Gerente do banco que atende uma conta da empresa — veja Gerentes |
| Time | Gente da própria empresa: sócios, equipe do financeiro — veja Acessos |
| Nenhum | 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.
Para quem é ou foi gerente, o detalhe da pessoa mostra Contas que atende, com o período de cada uma; para quem tem acesso a contas, Acessos a contas, com o nível de cada uma.
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.
Transferências e a Segurança
A aba Beneficiários da Segurança decide para quais favorecidos as transferências (Pix e TED) podem ser enviadas ao banco. A regra olha o CPF/CNPJ, não o cadastro:
- Uma regra por documento. A mesma pessoa cadastrada em várias empresas aparece uma vez só em Segurança, e liberar, bloquear ou limitar vale para todos os cadastros com aquele CPF/CNPJ — com os limites diário e mensal somados entre as empresas.
- Cadastrar não é bloqueado. No modo Bloquear todos e liberar alguns, uma pessoa nova pode ser cadastrada e usada em títulos normalmente; só o envio das transferências para ela fica barrado ("Favorecido não liberado") até que alguém peça a liberação do documento e a Kobana aprove. No modo Liberar todos e bloquear alguns, ela entra liberada.
- Boleto, tributo e concessionária não passam por essa regra — para eles o dinheiro vai para quem o código de barras indica, e o controle fica em Tipos de operações.
- Excluir ou juntar cadastros não muda a regra. Um documento bloqueado continua bloqueado mesmo sem cadastro ativo (aparece em Segurança como "Sem cadastro ativo"), e um liberado continua liberado.
Exclusão
Um único bloqueio: regra automática 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.