Pessoas

Clientes, fornecedores, funcionários e motoboys — um cadastro só, com papéis que se acumulam.

É uma única tela pra tudo: a mesma pessoa pode ser Cliente e Funcionário ao mesmo tempo, por exemplo. Os 4 cards do hub (Clientes, Fornecedores, Funcionários, MotoBoy) abrem essa mesma tela, só mudando o filtro inicial de papel.

Para quem: Cadastro · Gerente · Financeiro Precisa do módulo: Cadastros — sempre disponível (permissão "cadastro.ver")

Fluxos do dia a dia

1 Cadastrar um cliente novo #

1 No Hub de Pessoas, clique em Clientes (ou abra Pessoas e filtre por Cliente).
2 Clique em "+ Nova Pessoa" — o formulário já abre com o papel Cliente marcado.
3 Preencha Nome, documento, telefone e endereço.
4 Se for Pessoa Jurídica, use a lupa ao lado do documento pra preencher razão social, endereço e telefone sozinho (CNPJ no Brasil, RUC no Paraguai).
5 Se for Brasil, digite o CEP e use a lupa pra preencher endereço via ViaCEP.
6 Se quiser, informe Limite de crédito, Limite por período e Observações de crédito.
7 Clique em Cadastrar.

i O documento (quando informado) precisa passar na validação de CPF/CNPJ (Brasil) ou ter o tamanho certo de Cédula/RUC (Paraguai), e não pode repetir o de outra pessoa da mesma empresa — se repetir, aparece um link "Ver cadastro existente" em vez de deixar duplicar.

2 Cadastrar um fornecedor #

1 Hub → Fornecedores (ou filtro Fornecedor).
2 "+ Nova Pessoa" já vem com o papel Fornecedor marcado.
3 Preencha os mesmos campos comuns (não existe campo específico de fornecedor).
4 Cadastrar.

i Depois de salvo, use as abas Histórico de Vendas (na verdade mostra as compras feitas a esse fornecedor) e Contas a Pagar pra lançar e baixar títulos.

3 Cadastrar um funcionário #

1 Hub → Funcionários (ou filtro Funcionário).
2 "+ Nova Pessoa" com o papel Funcionário marcado.
3 Preencha os campos comuns.
4 Escolha o Cargo/Perfil (lista os perfis de acesso já cadastrados em Config → Perfis), Data de Admissão e Salário base.
5 Se ele vai receber comissão, escolha o tipo (Por Venda ou Por Recebimento) e o percentual.
6 Cadastrar.

i Essa tela não cria o login/PIN de acesso do funcionário, mesmo pedindo o Cargo/Perfil. Pra ele conseguir logar no PDV ou usar PIN de garçom, o acesso precisa ser criado à parte em Config → Usuários, vinculando ao mesmo cadastro de pessoa.

4 Cadastrar um motoboy #

1 Hub → MotoBoy.
2 "+ Nova Pessoa" com o papel MotoBoy marcado.
3 Preencha só os campos comuns — não tem veículo nem zona de entrega pra cadastrar.
4 Cadastrar.

i O papel MotoBoy só aparece pra escolher se a empresa tiver o módulo Delivery ativo, ou o Delivery integrado do Gourmet ligado (Config → Módulos).

5 Editar, ativar/desativar ou excluir uma pessoa #

1 Editar: botão Editar na linha, ou duplo clique nela.
2 Excluir: botão Inativar na linha (só aparece pra cadastro ativo e que não seja de sistema) — confirme no aviso.

i A exclusão só é de verdade quando a pessoa nunca teve nenhum vínculo (venda, compra, título, crédito, pré-venda, orçamento, condicional, devolução, delivery ou login). Tendo qualquer um desses, o sistema apenas inativa e mantém o histórico. Não existe botão dedicado de "reativar" — é preciso editar o cadastro.

6 Registrar um aporte de crédito adiantado (cliente) #

1 Edite o cliente e abra a aba Crédito Adiantado.
2 Clique em "+ Registrar Aporte".
3 Informe o valor.
4 Se o dinheiro acabou de ser recebido no balcão, marque "Recebido agora em dinheiro/cartão, num caixa aberto" e escolha o caixa — isso lança um suprimento naquele caixa.
5 Confirme — o saldo do cliente já atualiza na hora.

i Sem marcar a opção do caixa, o aporte é tratado como recebido "por fora" (ex.: transferência) e não entra na conferência de fechamento de caixa nenhuma — mesmo que o dinheiro tenha sido recebido no balcão, é preciso marcar a opção certa. O saldo é debitado sozinho a cada venda paga com "Crédito do Cliente".

Telas e janelas — referência

Campos comuns a qualquer pessoa

Dados Cadastrais

CamposPaís (BR/PY), Tipo (Pessoa Física/Jurídica), Papéis (pode marcar mais de um), Nome, documento (CPF/RG, CNPJ/Insc. Estadual, Cédula ou RUC conforme país/tipo), telefones (vários, com um marcado como principal), e-mail, endereço completo, observações.

Ao confirmarUma pessoa não pode ficar sem nenhum papel marcado. Ao criar, o País já vem preenchido igual ao da empresa, pra evitar cadastro no país errado.

Cliente

Campos e abas do Cliente

CamposLimite de crédito, Limite por período (Semanal/Quinzenal/Mensal), Observações de crédito.

Ao confirmarDepois de salvo, ganha as abas Histórico de Compras, Contas a Receber (lançar/baixar títulos) e Crédito Adiantado (extrato + "Registrar Aporte").

⚠A tela também guarda um campo "inadimplente" no cliente, mas hoje nenhuma parte do sistema marca ele como verdadeiro — na prática, esse campo não reflete nada ainda.

Fornecedor

Campos e abas do Fornecedor

CamposNenhum campo específico — usa só os campos comuns.

Ao confirmarDepois de salvo, ganha as abas Histórico de Vendas (mostra as compras feitas a ele) e Contas a Pagar (lançar/baixar títulos).

Funcionário

Campos e abas do Funcionário

CamposCargo/Perfil (o mesmo perfil de acesso usado em permissões), Data de Admissão, Salário base, Tipo de Comissão (Nenhuma/Por Venda/Por Recebimento) + percentual.

Ao confirmarDepois de salvo, ganha a aba Prestação de Contas (extrato de vale, desconto, comissão e fechamento — só leitura aqui).

⚠O lançamento de vale/adiantamento/fechamento mensal é feito em Financeiro → Funcionários, não nesta tela. E o login/PIN de acesso do funcionário também é criado à parte, em Config → Usuários.

MotoBoy

Campos e abas do MotoBoy

CamposNenhum campo específico (sem veículo ou zona de entrega) — usa só os campos comuns.

Ao confirmarDepois de salvo, ganha a aba Estatísticas, que mostra o total de entregas concluídas por ele.

⚠O papel MotoBoy só fica disponível pra escolher se o módulo Delivery (ou o Delivery do Gourmet) estiver ativo em Config → Módulos.

Permissões e acesso

Como funciona aqui

CamposNão tem senha de supervisor nem PIN nesta tela — o controle é todo por permissão de perfil (Config → Perfis).

cadastro.ver

CamposNecessária pra ver a lista e o detalhe completo de qualquer pessoa.

cadastro.criar

CamposNecessária pra criar Fornecedor, Funcionário ou MotoBoy. Pra criar só um Cliente, quem tem venda.criar (ex.: caixa, garçom) também pode, sem precisar de cadastro.criar — pensado pro cadastro rápido durante uma venda.

cadastro.editar

CamposNecessária pra editar qualquer pessoa.

cadastro.excluir

CamposNecessária pra inativar/excluir.

Mais detalhes

Um cadastro, papéis que se acumulam

A mesma pessoa pode ser Cliente e Funcionário ao mesmo tempo. Os 4 cards do hub (Clientes, Fornecedores, Funcionários, MotoBoy) abrem a mesma tela — só mudam o filtro de papel. Marque quantos papéis fizerem sentido no mesmo cadastro; não duplique a pessoa.

O país do cliente e a Regra Turista (Paraguai)

Se a empresa é cadastrada no Paraguai e o cliente tem país diferente (ex.: brasileiro), o PDV aplica a Regra Turista (desconto de IVA) — e o único campo que importa pra isso é o País do cliente, que já é padrão no cadastro. Não há nada extra pra marcar aqui. Se a empresa exige senha de supervisor, o PDV pede no momento de identificar o cliente (F10).

Aba Funcionário

A % de comissão do vendedor fica aqui (Cadastros → Pessoas → aba Funcionário). O cálculo é por recebimento — à vista sai na hora, a prazo só quando a parcela é paga. O relatório está em Relatórios → Financeiro → Comissões.
O login do sistema dessa pessoa não se cria aqui — é em Configurações → Usuários, onde você vincula o usuário a um Funcionário já cadastrado.

Documento e preenchimento automático

Pessoa Jurídica: a lupa ao lado do documento busca razão social, endereço e telefone (CNPJ no Brasil, RUC no Paraguai).
Endereço no Brasil: digite o CEP e use a lupa (ViaCEP).

Ligações com outros módulos

Financeiro — Crediário e Contas a Receber usam o cliente daqui; Comissões usam o funcionário.
PDV — F10 identifica o cliente na venda; F3, o vendedor.

Atualizado em 2026-09-10