Portal PDV

A seguir, cada seção da tela de Portal PDV é detalhada, incluindo colunas, campos, botões de ação e suas regras de preenchimento, bem como possíveis impactos em outros módulos do sistema (como Vendas e Financeiro).

1) Acesso ao cadastro do Portal PDV

Para acessar a tela de configuração do Portal PDV no BomControle:

• No menu superior, selecione Vendas e passe o cursor em Avançado.

• Clique na opção Portal PDV.

• A tela de Portal PDV será exibida, apresentando as seções de configuração e uma lista (grid) dos usuários convidados para utilizar o PDV (caso já existam convites cadastrados), além da configuração de tabela de preço para o portal.

Figura 1 – Tela de Configurações do Portal PDV 

2) Seção – Configurações Portal PDV

A primeira seção da tela é Configurações Portal PDV, onde são definidas as opções gerais de convite e comunicação do portal. A figura a seguir destaca essa área, com cada item numerado para referência:

Figura 2 – Seção Configurações Portal PDV 

2.1 Campos e opções (Configurações Portal PDV)

Legenda: ✅ Campo obrigatório · ⚠️ Campo opcional

Template do e-mail de convite/acesso ao portal (botão Editar Template) ⚠️
- Função: Abre uma janela/modal para editar o conteúdo do e-mail enviado aos usuários convidados do Portal PDV. Ao clicar em Editar Template, você pode personalizar o assunto e o corpo do e-mail de convite. É possível incluir variáveis automáticas fornecidas pelo sistema, como por exemplo o nome do usuário ({{NOME_USUARIO}}), o nome da empresa ({{NOME_EMPRESA}}), o logo do portal ({{LOGO_CONFIG_PORTAL}}) e o botão de cadastro/ativação ({{BOTAO_CADASTRAR}}).

- Regras de preenchimento: Não se trata de um campo tradicional, mas sim de um editor de texto enriquecido. Preencha Assunto do e-mail (por exemplo: "Convite para acessar Portal PDV") e edite o Corpo do e-mail com a mensagem que será enviada aos convidados. É obrigatório preencher tanto o assunto quanto o corpo antes de salvar. Utilize uma linguagem clara, informe brevemente o propósito do portal e inclua instruções para o primeiro acesso (o sistema já disponibiliza um link de ativação através da variável do botão).

- Impacto: O template definido aqui será usado em todos os convites enviados pelo sistema para novos usuários do Portal PDV. Personalizá-lo permite adequar a comunicação ao tom da empresa, orientando melhor os convidados sobre como acessar o portal. Observações: Caso não seja personalizado, o BomControle usará um conteúdo padrão de convite. Recomenda-se revisar e, se necessário, ajustar periodicamente este template para mantê-lo atualizado com informações de contato ou mensagens importantes.

(Observação: Nesta seção o acesso dos convidados é realizado através do link enviado por e-mail, ou pelo endereço padrão do Portal PDV informado pela BomControle.)

3) Seção – Convidar usuários para acessar o portal

A seção Convidar usuários para acessar o portal é onde você gerencia os convites e acessos dos usuários que poderão utilizar o Portal PDV. Nessa área, é possível filtrar e listar os usuários convidados, além de convidar um novo usuário através de um formulário próprio. A figura abaixo destaca os filtros de busca e a lista de usuários, com itens numerados para referência:

Figura 3 – Seção Convidar Usuários (filtros de pesquisa e grid de convites)

3.1 Filtros de pesquisa de usuários

Acima da tabela de usuários convidados, há opções de filtro para facilitar a localização de convites:

• Filtro de Empresas: Permite filtrar os usuários por empresa interna. Em ambientes com multi-empresa (várias empresas/unidades dentro do BomControle), selecione uma ou mais empresas para exibir apenas os convites vinculados a elas. ✅ Obrigatório selecionar ao menos uma empresa: por padrão, se o usuário logado possui acesso a apenas uma empresa, ela já vem selecionada automaticamente (e neste caso o campo pode ficar fixo, sem opção de alteração). Se houver múltiplas empresas disponíveis, o campo permite múltipla seleção. Alterar este filtro marca a listagem como pendente de atualização.

• Campo de busca livre (Pesquisar): Caixa de texto para digitar parte do nome ou e-mail do usuário convidado. ⚠️ Opcional – se preenchido, o sistema filtrará dinamicamente a lista para corresponder ao texto inserido (com pequena espera após a digitação para atualizar). Deixe em branco para não aplicar filtragem por texto. Este campo é útil para localizar rapidamente um usuário específico pelo nome ou endereço de e-mail.

• Botão Aplicar filtros (): Após ajustar os filtros desejados (empresa e/ou texto de pesquisa), clique em Aplicar para atualizar a lista conforme os critérios. Este botão ficará habilitado somente quando há alterações nos filtros a serem aplicadas.

• Botão Recarregar (): Recarrega a listagem de usuários convidados. Serve para atualizar os dados exibidos, por exemplo, após realizar convites ou alterações. Fica desabilitado enquanto existirem filtros não aplicados (nesse caso, use Aplicar primeiro), e habilita-se quando não há mudanças pendentes nos filtros.

• Botão Limpar filtros (): Restaura todos os filtros aos valores padrão. Isso significa definir a seleção de Empresas de volta à empresa atual (ou todas acessíveis) e limpar o texto de Pesquisar. Após limpar, a lista volta a exibir todos os usuários convidados. Este botão permanece desabilitado caso nenhum filtro tenha sido alterado (ou seja, já está mostrando a lista completa padrão).

3.2 Colunas da grid de usuários convidados

A tabela abaixo dos filtros lista os usuários convidados para o Portal PDV, mostrando informações de convite e status. As colunas exibidas são:

• EMPRESA: A empresa interna do BomControle à qual o usuário convidado está vinculado. É representada por um ícone contendo as iniciais da empresa, com uma cor de fundo específica. Ao passar o mouse sobre o ícone, aparece um tooltip com o nome completo da empresa e seu CNPJ/CPF. Observação: Essa coluna é especialmente útil em ambientes com múltiplas empresas; caso sua operação envolva apenas uma empresa, todos os usuários listados pertencerão a ela (e a coluna servirá apenas como identificação visual).

• NOME: O nome do usuário convidado (geralmente o nome da pessoa que utilizará o PDV). Se o nome for muito longo, o sistema o abrevia na exibição; você pode visualizar o nome completo passando o mouse sobre ele (aparece uma dica de tela com o nome completo). É importante cadastrar um nome que identifique claramente o usuário (por exemplo, “João Silva” ou “Caixa Loja Centro”).

• E-MAIL: O endereço de e-mail do usuário convidado, que também serve como login de acesso ao Portal PDV. Este é o e-mail para o qual o convite foi (ou será) enviado. Certifique-se de usar um e-mail válido e que a pessoa tenha acesso, pois será necessário para ativar a conta e futuramente para entrar no portal.

• VERIFICADO: Indica se o usuário já verificou/ativou o acesso ao portal. Quando o usuário conclui o primeiro acesso definindo sua senha (através do link do convite), sua conta é marcada como verificada. Nesse caso, a coluna exibirá a data em que a verificação ocorreu. Caso apareça “Não verificado”, significa que o convidado ainda não aceitou o convite ou não finalizou o cadastro de acesso. Esse status ajuda a controlar quem já está apto a utilizar o portal.

• ÚLTIMO ENVIO: Mostra a data do último envio de convite para aquele usuário. Toda vez que um convite é enviado ou re-enviado para o e-mail (ação de reenvio manual, explicada adiante), esta data é atualizada. Assim, é possível saber quando foi a última tentativa de convidar aquele usuário. Se o usuário nunca recebeu um convite (por exemplo, registro criado mas convite não enviado), essa data pode estar em branco ou não preenchida. Normalmente, porém, ao criar um novo convite o sistema já faz um envio imediato, registrando aqui.

• AÇÕES: Coluna contendo os botões de ação disponíveis para cada usuário convidado. As ações possíveis são:

• Histórico (ícone ): abre uma janela/modal com o histórico de convites do usuário selecionado. Nele constam registros de quando os convites foram enviados, e possivelmente se foram visualizados ou não (quando essa informação está disponível), além de outras ocorrências relacionadas. Essa funcionalidade é útil para auditoria ou para confirmar, por exemplo, se o usuário recebeu o e-mail de convite.

• Reenviar convite (ícone de envelope ): envia novamente o e-mail de convite para o usuário. Utilize esta opção caso o usuário não tenha recebido o convite inicial ou não o encontre na caixa de entrada (verifique se o e-mail está correto antes de reenviar). Ao clicar em Reenviar convite, o sistema dispara um novo e-mail para o mesmo endereço cadastrado e atualiza a coluna "Último envio" com a data do reenvio. Dica: sempre confirme com o convidado se o e-mail está correto e peça para checar a pasta de spam antes de reenvios múltiplos.

• Editar (ícone de lápis ): reabre o modal de convite preenchido com os dados do usuário selecionado, permitindo editar informações como o nome ou reatribuir a empresa (casos raros). Importante: o e-mail de login não pode ser alterado após o cadastro inicial – este campo ficará bloqueado na edição, pois é a chave de identificação do usuário. Você pode usar a edição para corrigir o nome ou, se necessário, mudar a empresa associada (por exemplo, se o usuário passou a operar em outra unidade). Após ajustar os dados no formulário, clique em Salvar para gravar as alterações. Não há reenvio automático de e-mail ao editar – a menos que você deseje reenviar manualmente depois.

• Bloquear/Desbloquear (ícone ): alterna o status de acesso do usuário convidado. Se o usuário atualmente não está bloqueado, o botão exibirá um cadeado aberto; ao clicar, você bloqueará o acesso dele ao portal imediatamente (ele não conseguirá mais logar, embora seu cadastro permaneça na lista). 

Se o usuário já está bloqueado, o botão mostrará um cadeado fechado; clicando, você desbloqueia o usuário, restaurando seu acesso. O tooltip (dica de tela) do botão indica a ação disponível no momento (“Bloquear” ou “Desbloquear”). Utilize o bloqueio, por exemplo, em casos de segurança ou quando um operador deixar de precisar acessar o PDV temporariamente, sem removê-lo completamente do cadastro. Ao bloquear ou desbloquear, o sistema exibirá uma notificação de sucesso e atualizará o status na listagem.

• Paginação: Caso haja muitos usuários convidados cadastrados, a tabela exibirá controles de paginação no rodapé (logo abaixo das linhas). Você pode navegar entre as páginas de resultados usando os botões Anterior e Próximo. Por padrão, são exibidos 5 registros por página nessa listagem. A paginação ajuda a manter a interface leve e organizada quando o volume de convites é grande.

3.3 Convidando um novo usuário (Cadastro de convite)

Para adicionar um novo usuário ao Portal PDV, clique no botão Convidar Novo. Será aberta uma janela/modal de convite, onde você deverá preencher os dados do novo usuário convidado. A figura abaixo ilustra o formulário de convite:

Figura 4 – Formulário "Convidar Usuário PDV" 

Preencha os campos do formulário conforme a seguir:

• Nome: Informe o nome completo ou identificável do usuário que está sendo convidado. ✅ Obrigatório. Pode ter até 100 caracteres. Use apenas letras e, se necessário, espaços ou caracteres comuns de pontuação (evite caracteres especiais ou números, a não ser que façam parte do nome, como "Filial 2"). O nome cadastrado será utilizado para exibição na lista de usuários e também poderá ser inserido automaticamente no e-mail de convite (saudação), portanto deve ser escrito corretamente.

Impacto: O nome serve apenas para identificação interna e pessoal; não influencia outros módulos, mas um nome claro ajuda a administração a gerenciar os acessos (evite duplicidade de nomes para não confundir usuários com nomes iguais).

• E-mail: Digite o endereço de e-mail do usuário. ✅ Obrigatório. Deve estar em um formato válido (ex.: usuario@empresa.com). Esse e-mail será o login de acesso do convidado no Portal PDV e o destino para onde o sistema envia automaticamente o convite. Regras adicionais: O BomControle não permite e-mails em duplicidade no contexto de usuários convidados ativos da mesma empresa. 

Portanto, não utilize um e-mail já cadastrado para outro usuário do Portal PDV na mesma empresa, para evitar conflito – o sistema exibirá erro caso tente convidar alguém com um e-mail duplicado. (Se for necessário dar acesso a um mesmo e-mail em duas empresas diferentes, o BomControle tratará isso vinculando o mesmo usuário a ambas as empresas. Entretanto, na prática recomenda-se convidar um e-mail apenas uma vez e, se a pessoa precisa atuar em mais de uma empresa, avaliar a criação de acessos separados ou gerenciar a vinculação via suporte técnico.) Após salvar o convite, este campo não poderá ser editado posteriormente, pois é o identificador único do usuário.

• Empresa: Selecione a qual empresa interna do BomControle o usuário estará vinculado. ✅ Obrigatório. Em ambientes multi-empresa, escolha a empresa onde o usuário irá operar o PDV. Em ambientes com apenas uma empresa, ela já virá selecionada por padrão e o campo poderá vir travado (não editável), pois não há outras opções. Impacto: A empresa define o contexto de dados que o usuário poderá acessar no Portal PDV (estoque, preços, vendas daquela empresa). 

Um usuário convidado está sempre associado exatamente a uma empresa; caso precise acessar outra, é necessário outro convite ou mudar a empresa via edição. Note que, ao fazer login no Portal PDV, se o usuário tiver vínculos com mais de uma empresa, ele poderá escolher com qual empresa deseja operar no momento (mas isso só ocorre se houver convites ativos em múltiplas empresas com o mesmo e-mail).

Após preencher todos os campos, clique em Salvar para concluir o convite. O sistema validará os dados e, estando tudo correto, criará o usuário convidado. Imediatamente, um e-mail de convite será enviado para o endereço fornecido, contendo um link para o usuário definir sua senha de acesso e ativar a conta. Você verá então o novo convite listado na grid de usuários, com status "Não verificado" inicialmente. O convidado deve acessar o e-mail e seguir as instruções para começar a usar o Portal PDV. Somente após ele completar o primeiro login é que aparecerá a data de verificação na coluna respectiva.

Observações importantes ao convidar usuários:
- Verifique duas vezes o e-mail digitado antes de salvar. Se houver erro de digitação, o usuário não receberá o convite. Caso perceba o erro depois, você pode Editar o convite para corrigir o nome ou empresa, mas não poderá ajustar o e-mail – será necessário excluir o convite incorreto e cadastrar novamente com o e-mail correto, se for o caso.
- O convite por e-mail normalmente é enviado quase instantaneamente após salvar (pode levar alguns minutos para chegar). Oriente o convidado a verificar caixa de entrada e spam. Se necessário, utilize a função Reenviar convite da lista.
- Um usuário convidado do Portal PDV é diferente dos usuários internos do BomControle (colaboradores com acesso completo ao ERP). Esses convidados têm acesso restrito somente ao módulo PDV via portal web específico. Eles não consomem licenças de usuário internas, porém normalmente só conseguem realizar operações limitadas no ambiente PDV (como registrar vendas).
- Atualmente, o Portal PDV é voltado para operações de venda presencial/rápida. Portanto, convide apenas pessoas que atuarão como atendentes, caixas de loja ou representantes autorizados a realizar vendas em nome da sua empresa. Todos os registros de vendas efetuados no portal ficarão associados a esses usuários e à empresa configurada.

4) Seção – Tabela de Preço (Configuração do PDV)

A terceira seção da tela de Portal PDV é Tabela de Preço. Aqui, configura-se qual tabela de preços de Produtos será utilizada no Portal PDV para cada empresa. Em outras palavras, você define a lista de preços que os usuários do PDV verão e aplicarão ao vender os produtos no portal. A figura abaixo ilustra essa seção, com cada elemento numerado:

Figura 5 – Seção Tabela de Preço do Portal PDV

4.1 Campos e regras de preenchimento (Tabela de Preço por Empresa)

Nesta tabela, cada linha corresponde a uma Empresa vinculada à sua conta BomControle (listando as empresas nas quais o módulo PDV está disponível). As colunas exibidas são:

• EMPRESA: Identificação da empresa (similar à coluna já descrita na seção de usuários convidados), mostrando o ícone/sigla e permitindo ver o nome e CNPJ completo em um tooltip. Cada empresa do grupo é listada em uma linha separada.

• CNPJ: O documento (CNPJ/CPF) da empresa listada, formatado para melhor leitura. Serve para confirmar a identidade da empresa em ambientes com nomes semelhantes ou grupos empresariais.

• NOME: O nome completo da empresa. É o mesmo nome cadastrado para a empresa no BomControle.

• TABELA DE PREÇO PRODUTO: Este é o campo configurável da seção – um seletor (dropdown) que permite escolher qual Tabela de Preço do tipo Produto será atribuída ao Portal PDV daquela empresa. ✅ Obrigatório escolher uma tabela para cada empresa que utilizará o PDV. Clique no campo Selecione da linha desejada para ver a lista de tabelas de preço disponíveis. 

Apenas tabelas do Tipo Produto são listadas (tabelas de serviço não se aplicam aqui, pois o PDV lida somente com vendas de mercadorias/produtos). Selecione a tabela que contenha os preços que deverão ser praticados no PDV para essa empresa. Por exemplo, se a empresa "Loja Matriz" tiver uma tabela de preços especial para balcão, escolha essa tabela. Caso use a tabela padrão de vendas, selecione-a.

Regras de preenchimento: É obrigatório que cada empresa tenha uma tabela selecionada – caso contrário, os usuários do PDV dessa empresa não terão preços carregados para os produtos, impossibilitando as vendas pelo portal. O sistema não permite deixar "Selecione" em branco; se estiver sem valor, isso indicará que a configuração está pendente e deve ser feita. Ao escolher uma tabela no dropdown, a alteração é salva automaticamente no sistema para aquela empresa (não há um botão "Salvar" geral; cada mudança no seletor já dispara o salvamento imediato). Depois de selecionar, a linha é atualizada e o sistema mostrará uma notificação de "Tabela de preço atualizada com sucesso". Se você trocar a tabela posteriormente, o efeito é imediato para os próximos acessos e operações no portal.

Impacto em outros módulos: A definição da tabela de preço aqui afeta diretamente as vendas realizadas no Portal PDV. Ou seja, quando um usuário do PDV dessa empresa adicionar produtos em um pedido de venda no portal, os preços aplicados serão os da tabela escolhida. Isso garante consistência de preços entre o ERP e o PDV. Observações: Essa configuração não altera a tabela de preço padrão da empresa em outros contextos (por exemplo, pedidos internos ou orçamentos feitos dentro do BomControle – esses podem ter configuração própria no menu Vendas > Configurações). Ela se aplica unicamente ao contexto do Portal PDV. Portanto, é possível usar uma tabela de preço específica para PDV (por exemplo, uma tabela de varejo com preços de balcão) e manter outra tabela como padrão para outros canais de venda, se desejado.

Se sua conta possui várias empresas e você utiliza o Portal PDV em todas, repita a seleção para cada linha. Caso alguma empresa da lista não utilize o PDV, ainda assim é necessário atribuir uma tabela (você pode escolher a tabela padrão ou uma tabela genérica) – dessa forma a configuração do portal fica completa. Empresas recém-adicionadas ao BomControle também aparecerão nessa lista; lembre-se de configurar a tabela de preço delas caso passem a usar o PDV.

Dica: Mantenha as tabelas de preço atualizadas com os valores corretos dos produtos. O Portal PDV refletirá exatamente os preços cadastrados na tabela selecionada. Qualquer alteração de preço (promoções, reajustes) deve ser feita no cadastro da própria tabela de preço em Vendas > Cadastros > Tabela de Preço. Uma vez alterada e vigente, a mudança se propagará para o PDV automaticamente através da seleção configurada aqui.

Concluindo: Após realizar as configurações nas três seções acima – verificar o template de e-mail de convite, gerenciar os usuários convidados e definir as tabelas de preço – o Portal PDV estará pronto para uso. Os operadores convidados poderão acessar o portal (utilizando o link fornecido e suas credenciais cadastradas) e terão à disposição um ambiente de ponto de venda integrado: eles conseguirão registrar vendas de produtos conforme a tabela de preço definida, selecionar ou cadastrar clientes no ato da venda, e emitir documentos fiscais de venda ao consumidor, conforme a configuração da sua empresa no BomControle.

Lembre-se de que, assim como outros módulos, manter a configuração do Portal PDV atualizada é fundamental. Sempre que ingressar um novo funcionário ou parceiro que precisará usar o PDV, utilize a funcionalidade Convidar Novo para prover acesso a ele. Da mesma forma, remova ou bloqueie usuários que não devem mais acessar.

Conclusão

O Portal PDV foi concebido para dar autonomia e segurança no controle de pontos de venda externos. Com ele, sua empresa pode expandir operações de balcão/loja de forma organizada, garantindo que preços e vendas do PDV reflitam corretamente nas áreas de Vendas e Financeiro do BomControle. Aproveite essa ferramenta para otimizar suas vendas presenciais com o poder do seu ERP!