CONTEÚDO
- Visão Geral
- Exemplo de Utilização
- Requisitos Mínimos
- Configurações
- DBAccess
- Configurações iniciais (SETUPTGV)
- Appserver
- TOTVS Mingle
- Informações Técnicas
- Entrar (Login)
- Carga Inicial
- Validação de Versão
- Sair
- Tabelas utilizadas
- Pontos de Entrada
- Assuntos Relacionados
- O que há de novo
01. VISÃO GERAL
Painel |
---|
Aviso |
---|
| O Portal Gestão de Vendas está disponível a partir do release 12.1.33. |
Aviso |
---|
| O Portal Gestão de Vendas não está disponível para o Mercado Internacional. |
Aviso |
---|
| Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico. |
O Portal Gestão de Vendas (PGV) é uma plataforma Web para usuários do TOTVS Backoffice Linha Protheus que utilizem o modulo Faturamento (SIGAFAT) para gerenciar as suas vendas. Com ele, o vendedor pode consultar os seus Indicadores de Venda, seus Clientes (Incluindo status financeiro, risco de crédito, títulos em aberto e percentual de inadimplência no Protheus), receber Notificações sobre os seus Pedidos de Vendas e Gerenciar os seus Pedidos de vendas (Alterar, incluir, excluir e Visualizar).
Informações |
---|
| O uso do Portal Gestão de Vendas em modo Offline está em validação e testes por clientes pilotos. Para mais informações acesse a página DR - Portal Gestão de Vendas Offline. |
Link do Portal de Gestão de Vendas: https://bopgestaodevendas.com/ |
Âncora |
---|
| EXEMPLOS_DE_USO |
---|
| EXEMPLOS_DE_USO |
---|
|
02. EXEMPLO DE UTILIZAÇÃO
Painel |
---|
Aqui você pode visualizar um exemplo pratico das principais funcionalidades do Portal Gestão de Vendas.
Expandir |
---|
Expandir |
---|
| No Portal Gestão de Vendas, é possível configurar privilégios para um usuário. Esses privilégios servem para dizer ao sistema à quais opções de menu do PGV o usuário terá acesso. Eles podem ser configurados utilizando as opções da rotina TGVA004, conforme instruções abaixo: Informações |
---|
| Os privilégios são carregados para o portal após o login do vendedor. Caso o privilégio seja alterado, a alteração será refletida no PGV apenas a partir do próximo login do vendedor. |
Informações |
---|
| Não é possível restringir o acesso as ações (Incluir, Alterar e Excluir) do Portal Gestão de Vendas. |
Totvs custom tabs box |
---|
tabs | Cadastro do Privilégio, Cadastro de Usuários, Adicionando o privilégio, Acessando o Portal |
---|
ids | passo1,passo2,passo3,passo4 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Para configurar, basta acessar o menu Privilégios, localizado no modulo Configurador (SIGACFG) → Usuários → Senhas → Privilégios → Incluir: - Em Regras por transação/rotina, preencha o campo Transação/Rotina com o código da rotina TGVA004.
- Em Funcionalidades das transações/rotina selecione se o usuário (Vendedor) terá acesso Permitido ou Negado aos itens do menu do Portal Gestão de Vendas.
Neste exemplo, será negado acesso a página de Minhas Notificações. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Acesse o cadastro de usuários do modulo Configurador (SIGACFG) e adicione o privilégio ao usuario selecionado. SIGACFG → Usuários → Senhas → Usuários → Localizar o usuário desejado → Outras Ações → Privilégios
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Em Restrições de acesso selecione a regra cadastrada anteriormente (Passo 1).
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Ao acessar o portal Gestão de vendas o Vendedor não terá acesso a página e também ao menu, neste exemplo o Vendedor não possui acesso a página Minhas Notificações.
Caso o Vendedor tente acessar a página utilizando a URL no navegador será exibido a tela abaixo:
Informações |
---|
| As permissões de acessos são carregadas somente ao acessar o Portal Gestão de Vendas. |
Informações |
---|
Caso o usuário já esteja utilizando o portal Gestão de vendas, será necessário efetuar um login novamente para receber as atualizações dos privilégios. |
|
|
Informações |
---|
| Para maiores informações sobre os privilégios, clique aqui. |
|
Expandir |
---|
| O portal Gestão de vendas permite trocar a filial utilizada após Ao realizar o Login, o sistema possui um Toolbar (barra de ferramentas) na parte superior. Nele temos as informações de conexão com a internet (1° ícone), notificações recebidas (2° ícone) e vendedor logado (3° ícone).
Totvs custom tabs box |
---|
tabs | Passo 1, Passo 2 |
---|
ids | trocaFilial1,trocaFilial2 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | trocaFilial1 |
---|
| Na barra de ferramentas, clique no botão com o ícone de usuário. A barra de ferramentas esta localizada na parte superior da página. Em seguida acesse a opção de menu Trocar de Filial.
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | trocaFilial2 |
---|
| Ao acessar o menu Trocar de Filial será apresentado um janela onde o Vendedor poderá selecionar a Empresa e Filial desejada.
Ao clicar no botão Confirmar o Vendedor será redirecionado para a página de Carga de Dados do Portal Gestão de vendas.
Informações |
---|
São listadas somente Empresas e Filiais que o Vendedor possui acesso no TOTVS BackOffice Protheus®. |
|
|
Aviso |
---|
| Para que seja possível a troca de filial, o usuário do vendedor logado deve ter vínculo de vendedor na filial de destino também. |
|
Expandir |
---|
title | Indicadores de Vendas |
---|
| Ao acessar a Página Inicial (Home) o Usuário pode visualizar os seus Indicadores de Vendas, podendo filtrar pelos períodos: Anual ou Mensal.
Informações |
---|
title | Filtro de Indicadores |
---|
| - Ao selecionar a opção Anual o Vendedor pode informar um período de até dez anos.
- Ao selecionar a opção Mensal o Vendedor pode informar um período de até doze meses.
|
- Para maiores informações acesse o documento de referencia desta rotina clicando aqui.
|
Expandir |
---|
| Ao acessar a opção de menu Minhas Notificações, o Usuário pode Consultar todas as suas Notificações, tendo como opção visualizar no formato de Tabela (Padrão Desktop) ou Card (Padrão Mobile).
- Para maiores informações acesse o documento de referencia desta rotina clicando aqui.
|
Expandir |
---|
| Ao acessar a opção de menu Meus Clientes, o Usuário Consultar os seus Clientes, podendo visualizar o Status Financeiro e os demais Detalhes do Cliente através da opção Visualizar Detalhes.
Aviso |
---|
Algumas funcionalidades estarão disponíveis apenas se o Usuário estiver Online. |
- Para maiores informações acesse o documento de referencia desta rotina clicando aqui.
|
Expandir |
---|
| Ao acessar a opção de menu Meus Pedidos, o Usuário pode Consultar todos os seus Pedidos de Vendas e também Incluir um Novo Pedido.
Informações |
---|
| Ao acessar a opção Visualizar Detalhes o Usuário além de Visualizar o Resumo do Pedido de Venda, poderá acessar as opções Alterar e Excluir. |
- Para maiores informações acesse o documento de referencia desta rotina clicando aqui.
|
Expandir |
---|
| Ao acessar a opção de menu Meus Orçamentos, o usuário pode consultar todos os seus Orçamentos de Venda e/ou incluir um Novo Orçamento:
Clicando em 'Visualizar Detalhes', é possível visualizar as informações do orçamento e também Gerar PDF, Alterar e/ou Excluir o orçamento. - Para maiores informações acesse o documento de referencia desta rotina clicando aqui.
|
|
|
03. REQUISITOS MÍNIMOS
Painel |
---|
Aviso |
---|
O Portal Gestão de Vendas necessita do Microsiga Protheus® Release 12.1.33 ou Superior e arquivos binários com data de expedição igual ou superior a Outubro/2021. |
Aviso |
---|
O Portal Gestão de Vendas necessita do último pacote da Expedição Contínua do Faturamento, para manter sua versão atualizada. |
Informações |
---|
| O Portal Gestão de Vendas utiliza a configuração de Appserver REST 2.0. |
Informações |
---|
| Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico. |
|
Âncora |
---|
| CONFIG_PILOTO |
---|
| CONFIG_PILOTO |
---|
|
04. CONFIGURAÇÕES
Painel |
---|
O Portal Gestão de Vendas é uma plataforma de web integrada com o modulo Faturamento (SIGAFAT) do Microsiga Protheus®, para efetuar esta integração é necessário que o seu ambiente esteja configurado corretamente com o pré-requisitos listados abaixo: Aviso |
---|
| Recomendamos a utilização do License Server com data igual ou superior a 14/06/2022. |
Totvs custom tabs box |
---|
tabs | 01 - DBAccess, 02 - Appserver, 03 - TOTVS Mingle |
---|
ids | config1,config2,config3 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | config1 |
---|
| Para sincronizar os dados as APIs do Portal Gestão de Vendas utilizam o campo S_T_A_M_P_ como parâmetro de busca, sendo necessária a inclusão da chave UseRowStamp no TOTVS DBAccess.
Bloco de código |
---|
firstline | 1 |
---|
title | Exemplo dbaccess.ini |
---|
linenumbers | true |
---|
| [General]
Port=7890
[MSSQL]
environments=environment
[MSSQL/environment]
UseRowStamp=1
memoinquery=1 |
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | config2 |
---|
| Comunicação REST - O Portal Gestão de Vendas efetua comunicação com o servidor Protheus através de requisições HTTP. Para que essa comunicação ocorra será necessário efetuar algumas configurações no servidor APPServer.
- Para maiores informações sobre REST consulte o documento de referenciada da rotina.
Aviso |
---|
| Caso a Chave Security não seja informado no "appserver.ini" ou seja informado com o valor 0, não serão validados as permissões de acesso do usuário. Para maiores informações consulte o documento de referenciada da rotina clicando aqui. |
Aviso |
---|
| Caso a chave PrepareIn esteja apontando para empresas específicas, na funcionalidade de Troca de Filial, os usuários terão acesso apenas às empresas informadas nesta chave. Caso não seja necessário este tipo de restrição, mantê-la como "All". Para maiores informações, consulte a documentação clicando aqui. |
Informações |
---|
| Recomendamos a configuração do REST seguindo o exemplo abaixo |
Bloco de código |
---|
title | exemplo appserver.ini |
---|
| [ENVIRONMENT]
SourcePath=\TOTVS\apo\
RootPath=\TOTVS\Protheus_data\
StartPath=\system\
RpoDb=Top
RpoLanguage=multi
RegionalLanguage=BRA
RpoVersion=120
dbserver=localhost
dbdatabase=MSSQL
dbalias=ENVIRONMENT
dbport=7890
TOPMemoMega=30
[Drivers]
Active=TCP
MultiProtocolPort=1
multiprotocolportsecure=0
Secure=SSL
[HTTPJOB]
ENVIRONMENT=ENVIRONMENT
MAIN=HTTP_START
[HTTPREST]
BUGS=0
HSM=0
MaxQueue=10
Port=8282
SECURITY=1
SSL2=0
SSL3=0
State=0
TLS1=0
URIs=HTTPURI
Verbose=0
[HTTPURI]
AllowOrigin=*
CORSEnable=0
Instances=1,2
OnConnect=REST_CONNECT
OnExit=REST_EXIT
OnStart=REST_START
PrepareIn=All
URL=/rest/
Stateless=1
[HTTPV11]
ADVPL=0
Enable=1
Sockets=HTTPREST
TimeOut=120
[HTTPSERVER]
Enable=0
Servers=HTTP_REST
[HTTP_REST]
hostname=localhost
port=9995
locations=HTTP_ROOT
[HTTP_ROOT]
Path=/rest/
RootPath=root/web
ThreadPool=THREAD_POOL
[THREAD_POOL]
Environment=ENVIRONMENT
MinFreeThreads=1
MinThreads=1
MaxThreads=10
[OnStart]
JOBS=HTTPJOB
REFRESHRATE=120 |
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | config3 |
---|
| Informações |
---|
| Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico. |
- A plataforma Portal Gestão de Venda é armazenada em uma nuvem TOTVS. Para que a aplicação possa se comunicar com o servidor Protheus é necessário efetuar a configuração do TOTVS Mingle, que executa o papel de um gateway entre a aplicação é o servidor Protheus. Além disso, ao configurar o TOTVS Mingle, a aplicação passa a utilizar os dados de Autenticação padrão do Protheus.
- Para configurar o TOTVS Mingle, o servidor Appserver deve possuir um IP publico.
- O Administrador do sistema deve solicitar um Alias, através da pagina TOTVS MINGLE e informar o app Portal Gestão de Vendas.
- O Usuário deve receber a chave de acesso por e-mail.
Informações |
---|
| Deve ser informado ao menos uma empresa e filial no cadastro do Mingle |
- O Alias recebido deve ser o mesmo utilizado para acessar a plataforma e deve ser inserido junto com os dados do Login do usuário.
|
|
|
Painel |
---|
Totvs custom tabs box |
---|
tabs | Entrar, Carga Inicial, Versão, Sair, Nova Carga de Dados |
---|
ids | entrar1,entrar2,entrar3,entrar4,entrar5 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | entrar1 |
---|
| Para acessar o Portal Gestão de Vendas o Vendedor deve informar o mesmo Usuário e Senha utilizado no TOTVS Backoffice (Linha Protheus), além de informar o Alias utilizado pela empresa.
Para maiores informações sobre o Alias acesse a sessão requisitos mínimos. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | entrar2 |
---|
| Após clicar no botão Entrar o Vendedor será redirecionado para a página de Carga Inicial de dados, está página carrega algumas configurações utilizadas pelo Portal Gestão de Vendas.
Esta carga é efetuada apenas no primeiro acesso ou caso o usuário seja alterado.
Aviso |
---|
| Dependendo da quantidade de registros disponibilizados nas tabelas de Tabela de Preço e Condição de Pagamento (DA0, DA1 e SE4) pode levar no máximo 30 segundos para ser disponibilizada a página home, porém as opções Meus Pedidos, Meus Orçamentos e Meus Clientes serão disponibilizadas quando o sincronismo estiver concluído. |
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | entrar3 |
---|
| Ao realizar o login no Portal de Gestão de Vendas, é executada uma verificação para avaliar se a versão do servidor Protheus é a mesma que consta no Portal do Usuário. Caso o Vendedor ( usuário ) receba a mensagem abaixo, significa que o deve ser atualizado o Repositório ( RPO ) aplicando o último pacote da expedição continua que consta AQUI. O usuário ficará impossibilitado de realizar o login até que o repositório seja atualizado com sua versão mais recente.
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | entrar4 |
---|
| Na barra de ferramentas, clique no botão com o ícone de usuário. A barra de ferramentas esta localizada na parte superior da página. Em seguida acesse a opção de menu Sair.
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | entrar5 |
---|
| Na barra de ferramentas, clique no botão com o ícone de conexão de dados. A barra de ferramentas esta localizada na parte superior da página. Em seguida acesse a opção de menu Realizar carga de dados. Irá aparecer um modal perguntando se Deseja realizar a carga de dados, clique em Confirmar. Isso fará com que o Portal Gestão de Vendas faça uma nova carga de dados com o servidor trazendo os novos registros que foram atualizados.
|
|
|
Âncora |
---|
| TABELAS_UTILIZADAS |
---|
| TABELAS_UTILIZADAS |
---|
|
06. TABELAS UTILIZADAS
Âncora |
---|
| PONTOS_DE_ENTRADA |
---|
| PONTOS_DE_ENTRADA |
---|
|
07. PONTOS DE ENTRADA
08. ASSUNTOS RELACIONADOS
HTML |
---|
<!-- esconder o menu -->
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style>
|