Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


CONTEÚDO

  1. Visão Geral
  2. Exemplo de Utilização
  3. Requisitos Mínimos
  4. Configurações
    1. DBAccess
    2. Configurações iniciais (SETUPTGV)
    3. Appserver
    4. TOTVS Mingle
  5. Informações Técnicas
    1. Entrar (Login)
    2. Carga Inicial
    3. Validação de Versão
    4. Sair
  6. Tabelas utilizadas
  7. Pontos de Entrada
  8. Assuntos Relacionados
  9. O que há de novo


Âncora
VISAO_GERAL
VISAO_GERAL

01. VISÃO GERAL

Painel
Aviso
titleImportante

O Portal Gestão de Vendas está disponível a partir do release 12.1.33.

Aviso
titleImportante

O Portal Gestão de Vendas não está disponível para o Mercado Internacional.

Aviso
titleMingle

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).


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
titlePrivilégios

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
titleImportante!

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.

Totvs custom tabs box
tabsCadastro do Privilégio, Cadastro de Usuários, Adicionando o privilégio, Acessando o Portal
idspasso1,passo2,passo3,passo4
Totvs custom tabs box items
defaultyes
referenciapasso1

Para configurar, basta acessar o menu Privilégios, localizado no modulo Configurador (SIGACFG) → Usuários → Senhas → Privilégios → Incluir:

  1. Em Regras por transação/rotina, preencha o campo Transação/Rotina com o código da rotina TGVA004.
  2. 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
defaultno
referenciapasso2

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
defaultno
referenciapasso3

Em Restrições de acesso selecione a regra cadastrada anteriormente (Passo 1).

Totvs custom tabs box items
defaultno
referenciapasso4

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
titleImportante

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
titlePrivilégios

Para maiores informações sobre os privilégios, clique aqui.

Expandir
titleTroca de Filial

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
tabsPasso 1, Passo 2
idstrocaFilial1,trocaFilial2
Totvs custom tabs box items
defaultyes
referenciatrocaFilial1

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
defaultno
referenciatrocaFilial2

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
titleRestrição de Acesso

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
titleIndicadores 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
titleFiltro 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
titleMinhas Notificações

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
titleMeus Clientes

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
titleMeus Pedidos

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
titleDetalhes

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
titleMeus Orçamentos
Aviso
titleImportante!

A funcionalidade está em homologação por clientes pilotos.


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.

Âncora
REQUISITOS
REQUISITOS

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. 

Aviso
titleClientes

Para o correto funcionamento do Portal Gestão de Vendas é necessário executar o programa SetupTGV. Este programa tem como finalidade atualizar todas as tabelas utilizadas pelo Portal Gestão de Vendas com os campos S_T_A_M_P_ e também alimentar as tabelas A1V (schemas) e A1W (campos dos schemas).

Informações
titleREST 2.0

O Portal Gestão de Vendas utiliza a configuração de Appserver REST 2.0.

Informações
titleAlias TOTVS Mingle

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:


Totvs custom tabs box
tabs01 - DBAccess, 02 - Configuração Inicial, 03 - Appserver, 04 - TOTVS Mingle
idsconfig1,config2,config3,config4
Totvs custom tabs box items
defaultyes
referenciaconfig1

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.

Aviso
titleS_T_A_M_P_

O campo S_T_A_M_P_ será criado somente nas tabelas utilizadas pelo Portal Gestão de Vendas após a execução do programa inicial SETUPTGV (Verificar Passo 02)

Bloco de código
firstline1
titleExemplo dbaccess.ini
linenumberstrue
[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1
Totvs custom tabs box items
defaultno
referenciaconfig2

Após executar a configuração do TOTVS DBAccess, conforme informado no Passo 01, será necessário efetuar a carga inicial das tabelas de Schemas (A1V) e campos dos schemas (A1W), também será necessário efetuar a inclusão do campo S_T_A_M_P_ nas tabelas utilizadas no portal Gestão de Vendas, para pode efetuar este procedimento foi criado um facilitador (SETUPTGV) que deve ser executado por um Administrador do sistema em modo exclusivo.


É possível efetuar estas configurações de duas formas, onde o usuário pode executar diretamente no SmartClient o programa inicial SETUPTGV ou através de uma função de usuário (user function), conforme exemplos abaixo:


Expandir
titleExpandir origem para visualizar exemplo de execução através do Smartclient
Totvs custom tabs box
tabsPasso 01, Passo 02, Passo 03, Passo 04
idsp1,p2,p3,p4
Aviso
titleAcesso exclusivo ao sistema

Antes de executar o passo a passo abaixo, certifique-se que não exista usuários ou job conectados ao sistema, caso contrario pode ocorrer falhas nos procedimentos.

Aviso
titlePorta multiprotocolo

Desabilitar temporariamente as configurações utilizadas pela Porta multiprotocolo.

Totvs custom tabs box items
defaultyes
referenciap1
  • Abrir o smartclient
  • Preencha o campo Programa inicial com o valor SETUPTGV
  • Clique em Ok para confirmar ação.


Totvs custom tabs box items
defaultno
referenciap2
  • Selecione as Empresa(s) e Filial(is) que serão utilizadas no Portal Gestão de Vendas.
  • Clique em confirmar

Totvs custom tabs box items
defaultno
referenciap3
  • Acesse a Parâmetros (botão Param.) e selecione as opções Atualizar tabelas com campo S_T_A_M_P_ e Carga Inicial de Schemas e clique em confirmar.
  • Novamente na tela inicial, clique em Ok para iniciar processamento.
  • Será apresentado uma tela onde deve ser informando os dados de um usuário com privilégios de Administrador.
  • Após validação do acesso do usuário será iniciado o processamento.


Informações

Este procedimento pode levar alguns minutos para ser concluído.

Informações

Caso as tabelas de Schemas do Gestão de Vendas (A1V) e Campos do Schema (A1W) contenham registros, será apresentada uma pergunta para o usuário selecionar se deseja atualizar os registros ou não.


Totvs custom tabs box items
defaultno
referenciap4
  • Ao finalizar o processamento, deve ser apresentado uma mensagem de Log conforme exemplo abaixo.
  • As tabelas utilizadas no Portal Gestão de Vendas devem apresentar o campo S_T_A_M_P_ ao concluir este procedimento (Para as Tabelas Genéricas (SX5) não será criado o campo).
  • As tabelas de Schemas do Gestão de Vendas (A1V) e Campos do Schema (A1W), devem conter registros.

Expandir
titleExpandir origem para visualizar exemplo de execução através de um função de usuário

Esta opção permite que o usuário execute o SETUPTGV, em segundo plano.


Informações

Caso já existam registros nas tabelas Schemas do Gestão de Vendas (A1V) e Campos do Schema (A1W), os dados serão atualizados.

Bloco de código
languagec#
themeEclipse
titleMySetupTGV
linenumberstrue
#include "totvs.ch"

user function MyStpTGV()
	local aCompanies := {}
	// aAdd( aCompanies, { "CODIGO DA EMPRESA - T1", "NOME EMPRESA" , "codigo da filial", "descrição da filial" } )
	aAdd( aCompanies, { "T1", "NOME EMPRESA" , "D MG 01 ", "descrição da filial" } )
	ProcSetupTGV(.f., aCompanies, .t., .t.)
    aSize(aCompanies, 0)
return nil
Totvs custom tabs box items
defaultno
referenciaconfig3

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
titleChave de Segurança

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
titleChave PrepareIn

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
titleImportante

Recomendamos a configuração do REST seguindo o exemplo abaixo

Bloco de código
titleexemplo 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
	Stateless=1

[HTTPURI]
	AllowOrigin=*
	CORSEnable=0
	Instances=1,2
	OnConnect=REST_CONNECT
	OnExit=REST_EXIT
	OnStart=REST_START
	PrepareIn=All
	URL=/rest/

[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
defaultno
referenciaconfig4
Informações
titleAlias TOTVS Mingle

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
titleEmpresa/Filial

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.



Âncora
TECNICAS
TECNICAS

05. INFORMAÇÕES TÉCNICAS

Painel

Âncora
ENTRAR
ENTRAR

Totvs custom tabs box
tabsEntrar, Carga Inicial, Versão, Sair
idsentrar1,entrar2,entrar3,entrar4
Totvs custom tabs box items
defaultyes
referenciaentrar1

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
defaultno
referenciaentrar2

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.

Totvs custom tabs box items
defaultno
referenciaentrar3

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
defaultno
referenciaentrar4

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.




Âncora
TABELAS_UTILIZADAS
TABELAS_UTILIZADAS

06. TABELAS UTILIZADAS

Painel
  • A1S - Notificações do Vendedor
  • A1TControle de Integração de Pedidos
  • A1VSchemas do Gestão de vendas
  • A1W - Campos do Schema
  • AC8 - Relação de Contatos X Entidade
  • AGB - Telefones X Entidades
  • DA0 - Tabela de Preços
  • DA1 - Itens da Tabela de Preços
  • SA1 - Clientes
  • SA3 - Vendedores
  • SA4 - Transportadoras
  • SB1 - Descrição Genérica do Produto
  • SB2 - Saldos Físico e Financeiro
  • SC5 - Pedidos de Venda
  • SC6 - Itens dos Pedidos de Venda
  • SC9 - Pedidos Liberados
  • SD2 - Itens de Venda da NF  
  • SE1 - Contas a Receber
  • SE4 - Condições de Pagamento
  • SF2 - Cabeçalho das NF de Saída  
  • SU5 - Contatos
  • SX5 - Tabelas Genéricas
  • SYA - Países
  • SCJ - Orçamentos
  • SCK - Itens de Orçamento

Âncora
PONTOS_DE_ENTRADA
PONTOS_DE_ENTRADA

07. PONTOS DE ENTRADA

Painel


Âncora
RELACIONADOS
RELACIONADOS

08. ASSUNTOS RELACIONADOS

Painel
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>