Árvore de páginas

Versões comparadas

Chave

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

Image Modified

CONTEÚDO

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


Âncora
VISAO_GERAL
VISAO_GERAL

01. VISÃO GERAL

Painel

O TOTVS Gestão de Vendas (TGV) é uma plataforma Web para usuários do Protheus que utilizem o modulo Faturamento (SIGAFAT) para gerenciar as suas vendas.

...

Além disso, a aplicação também possibilita que o usuário trabalhe de modo off-line, permitindo utilizar as principais funcionalidades da aplicação, tais como Incluir um Pedido de Venda ou até consultar um Cliente.

Informações
titleImportante

Algumas funcionalidades não estarão disponíveis caso o usuário opte em trabalhar no modo off-line, tais como a consulta de Títulos a receber e consulta de Inadimplência do cliente.

...

02. EXEMPLO DE UTILIZAÇÃO

Aqui você pode visualizar um exemplo pratico das principais funcionalidades do TOTVS Gestão de Vendas.

...

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.

Image Removed

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.

...

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

Image Removed

  • Para maiores informações acesse o documento de referencia desta rotina clicando aqui.
Aviso
titleImportante

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

Aviso
titleMudança para AWS

Para uma melhor experiência no Portal Gestão de Vendas, estamos atualizando o link de acesso para uma conta Totvs na AWS. Sendo assim, precisamos que passe a acessar até 07/12/23,  pelo link https://gestaodevendasprotheus.totvs-solucoes.com.br Caso estiver acessando de um tablet ou celular, será necessário criar um novo atalho em sua área de trabalho.

Aviso
titleFuncionalidades de cadastros Clientes, Prospect e Contatos estão na versão 1.8.0

As funcionalidades de cadastros de Clientes, Prospects e Contatos estão disponíveis apenas para versão 1.8.0 com atualização da expedição contínua a partir do dia (02/02/2024) (A versão 1.8.0 está disponível apenas para o link https://gestaodevendasprotheus.totvs-solucoes.com.br).

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.

Aviso
titleMudanças na interface

Devido às recentes atualizações na versão da biblioteca de componentes POUI, podem ocorrer variações de cores nos GIFs apresentados em nossas documentações. Essas mudanças não afetam a funcionalidade do sistema.


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
titleUso Offline

Saiba como utilizar o Portal Gestão de Vendas em modo Offline. Para mais informações acesse a página DR - Portal Gestão de Vendas Offline.


Link do Portal de Gestão de Vendas: https://gestaodevendasprotheus.totvs-solucoes.com.br

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


Image Added

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 usuário selecionado.

SIGACFG → Usuários → Senhas → Usuários → Localizar o usuário desejado → Outras Ações → Privilégios


Image Added

Totvs custom tabs box items
defaultno
referenciapasso3

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

Image Added

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.


Image Added


Caso o Vendedor tente acessar a página utilizando a URL no navegador será exibido a tela abaixo:


Image Added


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.


Image Added

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.


Image Added


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.


Image Added


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


Image Added


  • 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 pode Consultar os seus Clientes e visualizar o Status Financeiro e os demais Detalhes do Cliente através das opções Visualizar Detalhes ou Razão Social.


Image Added


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 Prospects

Ao acessar a opção de menu Meus Prospects, o Usuário pode Consultar os seus Prospects e visualizar os demais Detalhes do Prospect através das opções Visualizar Detalhes ou Razão Social.

Image Added



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.


Image Added


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

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:

Image Added

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. 

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:

Aviso
titleLicense Server

Recomendamos a utilização do License Server com data igual ou superior a 14/06/2022.

Totvs custom tabs box
tabs01 - DBAccess, 02 - Appserver, 03 - TOTVS Mingle
idsconfig1,config2,config3
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
titleConfiguração ODBC

Para ambientes que utilizem banco de dados PostgreSQL, recomendamos a configuração do ODBC conforme documento abaixo.

Como criar uma fonte de dados ODBC para uso com PostgreSQL

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

[MSSQL]
environments=environment

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

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 exista no "appserver.ini" ou esteja preenchida com o valor 0 e não exista no RPO a API pgvcheckconfigappserver, não serão validadas as permissões de acesso do usuário.

Caso a Chave Security não exista no "appserver.ini" ou esteja preenchida com o valor 0 e a API pgvcheckconfigappserver exista no RPO, o usuário não conseguirá acessar o Portal Gestão de Vendas conforme o vídeo a seguir.

Image Added

Para maiores informações consulte o documento de referencia sobre a Chave Security 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.

Aviso
titleChave Instances

A chave Instances precisa está configurada de acordo com a quantidade de licenças disponíveis para utilização do REST, consulte a documentação clicando aqui.

Nosso modelo de exemplo está configurado para utilização de no máximo 2 theads e 2 licenças, caso a quantidade de licenças for menor que 2 o PGV pode apresentar um comportamento inesperado ocasionando lentidão no sistema.

Informações
titleImportante

Recomendamos a configuração do REST seguindo o modelo de exemplo abaixo, que deve ser ajustado conforme o contexto de cada ambiente.

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 ; Não utilizar a chave correspondente a TOPSERVER
	dbdatabase=MSSQL ; Não utilizar a chave correspondente a TOPDATABASE
    dbalias=ENVIRONMENT ; Não utilizar a chave correspondente a TOPALIAS
    dbport=7890 ; Não utilizar a chave correspondente a TOPORT
    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 ; Precisa está configurada de acordo com a quantidade de licenças disponíveis para utilização do REST  
    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
defaultno
referenciaconfig3
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


Image Added


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


Image Added


Âncora
TECNICAS
TECNICAS

05. INFORMAÇÕES TÉCNICAS

Painel

Âncora
ENTRAR
ENTRAR

Totvs custom tabs box
tabsEntrar, Carga Inicial, Versão, Sair, Nova Carga de Dados
idsentrar1,entrar2,entrar3,entrar4,entrar5
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.


Image Added


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.


Image Added


Esta carga é efetuada apenas no primeiro acesso ou caso o usuário seja alterado.


Aviso
titleImportante

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


Image Added

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.


Image Added


Totvs custom tabs box items
defaultno
referenciaentrar5

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


Image Added



Âncora
TABELAS_UTILIZADAS
TABELAS_UTILIZADAS

06. TABELAS UTILIZADAS

Painel

Âncora
PARAMETROS_UTILIZADOS
PARAMETROS_UTILIZADOS

07. PARAMETROS UTILIZADOS

Painel


Card documentos
InformacaoO parâmetro MV_GVPLFIN está em fase de homologação e tem previsão para ser disponíbilizado a partir de 01/07/2024 para utilização no PGV.
TituloImportante

Nome

Descrição

Conteúdo (Exemplo)

MV_PAISLOC

Indica a sigla do país onde está sendo utilizado o Sistema. Ex.: BRA = Brasil, ARG = Argentina, USA = Estados Unidos, etc.

BRA

MV_PGVBLQLInclusão de Cliente ou Prospects no Portal Gestão de Vendas com bloqueio de uso. 0-Não bloqueia 1-Blq. Cliente/2-Blq. Prospect/3-Blq. Ambos     0
MV_PGVCSLDHabilitar consulta do saldo do produto em estoque .T.
MV_PGVRISCRisco de crédito padrao ao cadastrar um novo Cliente ou Prospect atravez do Portal Gestão de VendasA
MV_PGVTPOPTipo de Operação padrão utilizado no Portal Gestão de Vendas nas páginas Meus Pedidos e Meus Orçamentos de Vendas
MV_PGVNATNatureza padrão a ser considerada pelo PGV.0001
MV_PGVVERSVersão atual do PGV que está compilada no RPO do Protheus.                                         1.7.0

MV_PGVLFLD

Com este parâmetro, você pode indicar quais informações não quer que sejam selecionadas pelo usuário nos Pedidos de Vendas (SC5) e Orçamentos (SCJ). Você pode bloquear apenas os campos de forma de pagamento (C5_CONDPAG e CJ_CONDPAG) e tabela de preço (C5_TABELA e C5_CONDPAG).

C5_TABELA | CJ_CONDPAG

MV_APICCGC

Preenchimento dos principais campos do cadastro de Clientes / Prospects 

.T.

MV_GVPLFIN

Habilita o botão Planilha Financeira PGV

1 ,1

Âncora
PONTOS_DE_ENTRADA
PONTOS_DE_ENTRADA

08. PONTOS DE ENTRADA

Painel


Informações

Todos os Pontos de Entrada podem ser utilizados para as rotinas ativadas a partir do Portal Gestão de Vendas como Pedidos de Venda, OrçamentosCadastro de Clientes, com exceção dos que fazem ativações de funções de Interface.

Para identificar a origem de um Pedido de Venda e se o mesmo foi gerado a partir do Portal Gestão de Vendas, pode ser analisado o campo de Origem (C5_ORIGEM).


Âncora
RELACIONADOS
RELACIONADOS

09. ASSUNTOS RELACIONADOS

...

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.

Image Removed

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.

...

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.

Image Removed

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.

...

03. REQUISITOS MÍNIMOS 

Aviso

O TOTVS 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 Agosto/2020.

Aviso
titleCompatibilizador

Para o correto funcionamento do TOTVS Gestão de Vendas é necessário a inclusão das Tabelas de Notificações e Controle da Fila de Pedidos de venda e do Numero Externo do Pedido (C5_NUMEXT).

O TOTVS 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:

  • Comunicação REST
    • O TOTVS 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.
Informações
titleREST 2.0

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

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

Para maiores informações consulte o documento de referenciada da rotina clicando aqui.

Bloco de código
firstline1
titleExemplo APPSERVER.INI
linenumberstrue
collapsetrue
[ENVIRONMENT]
	SourcePath=\TOTVS\apo\
	RootPath=\TOTVS\Protheus_data\
	StartPath=\system\
	RpoDb=Top
	RpoLanguage=Portuguese
	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/

[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
  • DBAccess - UseRowStamp
    • Habilitar a chave UseRowStamp.
    • Ao Habilitar a chave UseRowStamp será habilitado a criação da coluna S_T_A_M_P_ nas tabelas do Protheus.
Bloco de código
firstline1
titleExemplo dbaccess.ini
linenumberstrue
collapsetrue
[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1
  • TOTVS Mingle
    • A plataforma TOTVS 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 TOTVS Gestão de Vendas.
    • O Usuário deve receber a chave de acesso por e-mail.

Image Removed

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

Image Removed

Card documentos
InformacaoAs funcionalidades mencionadas acima, estarão disponiveis somente a partir do Release da Linha Microsiga Protheus 12.1.33
TituloIMPORTANTE!

...

04. INFORMAÇÕES TÉCNICAS

...

a. ENTRAR (LOGIN)

  • Para entrar na plataforma, o Vendedor deve informar o mesmo Usuário e Senha utilizados no Protheus e informar o Alias, mencionado na sessão requisitos mínimos.
  • Ao entrar no TOTVS Gestão de Vendas pela primeira vez, a aplicação deverá efetuar a carga inicial. Esta carga é efetuada apenas no primeiro acesso ou caso o usuário seja alterado.

Image Removed

Image Removed

  • Ao efetuar a carga inicial, o usuário é redirecionado para os Indicadores de Venda (Home).
  • Na barra superior é possível visualizar os dados do Vendedor, consultar o status de conexão com a Internet (Online e off-line), consultar as Notificações e Sair da aplicação.

Image Removed

...

b. SINCRONISMO

O TOTVS Gestão de Vendas é uma aplicação que pode trabalhar no modo online e off-line e, para que isso ocorra sem perder nenhuma informação, todos os dados são sincronizados entre a aplicação e o servidor Protheus. Este sincronismo ocorre em segundo plano a cada 60 segundos e garante que os usuários utilizem sempre os dados atualizados, sem sofrer nenhum ônus.

Para que este sincronismo ocorra corretamente é necessário que o campo S_T_A_M_P_ seja criado, conforme informado nos Requisitos Mínimos. Este campo é criado automaticamente nas tabelas do Protheus e tem a finalidade de armazenar a última data e hora que o registro sofreu uma alteração. Através de requisições HTTP/REST o TOTVS Gestão de Vendas consegue atualizar somente os registros que sofreram algum tipo de atualização. 

A opção do menu "Meus Pedidos" possui além do sincronismo do TOTVS Gestão de Vendas, uma fila de registros que é processada por um JOB no Protheus, este JOB pode ser configurado conforme o documento de referencia da rotina.

Ao realizar logout da aplicação, as alterações ou novos pedidos pendentes de sincronização podem ser cancelados e, portanto, não serão enviados ao Protheus.

Image Removed

...

05. TABELAS UTILIZADAS

  • 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
  • SE1 - Contas A Receber
  • SE4 - Condições De Pagamento
  • SU5 - Contatos
  • SX5 - Tabelas Genéricas
  • SYA - Países
  • SZ0 - Notificações
  • SZ1 - Controle Fila Pedidos De Venda

...

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