...
01. VISÃO GERAL
Painel |
---|
Aviso |
---|
|
|
O Portal O Protheus Gestão de Compras
está disponível a partir do release 12.1.33. Aviso |
---|
|
O Portal Gestão de Compras 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 Compras (PGC) é uma plataforma Web para usuários do TOTVS Backoffice Linha Protheus que utilizem o modulo Compras (SIGACOM) para gerenciar as suas compras.
Com ele, o comprador 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) auxilia no gerenciamento, controle e tomada de decisão referente a área de Compras da sua empresa.
A ferramenta permite adotar melhores estratégias para escolha de fornecedores, gerenciamento de SC´s e cotações. A partir de cards e telas minimalista projetadas para facilitar o uso e modernizar o processo de cotação.
A análise de informações e estatísticas permite aos gestores tomadas de decisões mais assertivas a partir da análise de dados, fazendo com que sua empresa consiga sempre os melhores fornecedores para maximizar os lucros e manter a qualidade e prazos das SC´s.
Link do Portal de Gestão de Vendas: https://bopgestaodevendas.com/
...
Painel |
---|
Aqui você pode visualizar um exemplo pratico das principais funcionalidades do Portal Gestão de Compras. Expandir |
---|
Expandir |
---|
| 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)direita. Ao clicar na terceira opçãono ícone de perfil, ela irá abrir uma janelinha com duas opções: Image RemovedImage Added Ao clicar na opção de 'Trocar de Filial', será aberta uma janela informando a filial atual do vendedor e com dois campos para serem preenchidos: um campo para indicar o Grupo de Empresas e outro campo para indicar a filial (as filiais serão retornadas de acordo com o Grupo de Empresa que foi selecionado). Ao Ao selecionar a filial desejada, basta apenas clicar no botão de 'Confirmar' e a troca de filial será realizada. Ao selecionar uma filial deve se levar em conta a permissão de acesso do usuário. Image AddedImage Removed 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 acesso a filial escolhida também. |
|
Expandir |
---|
title | Indicadores de VendasTela Inicial |
---|
| 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 |
---|
| title | Filtro de Indicadores |
---|
| uma breve previa do que cada item do menu faz. A pagina ainda está em construção então aguarde novidades. A tela atualmente conta com um campo com o nome do usuário logado, e um link direto para acessar a rotina desejada.
Image Added 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 |
---|
title | Minhas NotificaçõesNecessidade de compra |
---|
| Ao acessar a opção de menu Minhas Notificações Necessidade de compra, o Usuário pode Consultar todas as suas Notificaçõessolicitações de compras já criadas, tendo como opção visualizar no formato de Tabela (Padrão Desktop) ou Card (Padrão Mobile).3(Três) separações padrões sendo elas em aberto, parcialmente atendidas e atendidas.
Image AddedImage Removed
Para maiores informações acesse o documento de referencia desta rotina clicando aqui. |
Expandir |
---|
title | Meus ClientesNecessidade de compra - Filtros |
---|
| 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 Filtras as SC´s , podendo utilizar diversos tipos de filtros começando pelo Filtro por Data, o filtro por data funciona com intervalo então e preciso inserir duas datas para verificar as SC´s que tem a data da necessidade naquele intervalo selecionado.
Image Added
O segundo filtro padrão e para selecionar por um código de produto especifico, ao fazer a seleção e possível inserir o código do produto inteiro ou apenas parte dele. Image Added Image Added
A ultima opção de filtro e mais completa e mais personalizada o filtro avançado possibilita inúmeras possibilidades de personalizações para encontrar uma ou mais solicitações.
Image Added Note que o filtro avançado funciona de forma unitária (Apenas um campo) ou de forma personalizada juntando vários campos para uma busca mais refinada.
- Para maiores informações acesse o documento de referencia desta rotina clicando aqui.
|
Expandir |
---|
title | Meus Pedidos | Necessidade de compra - Pré seleção |
---|
| A função de pré seleção permite fazer uma seleção de SC´s e marca-la para continuar buscando antes de iniciar uma cotação.
Image Added
Aviso |
---|
Algumas funcionalidades estarão disponíveis apenas se o Usuário estiver Online |
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 |
---|
| 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
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 |
---|
| 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 |
---|
| O Portal Gestão de Vendas Compras 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
...
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:
...
tabs | 01 - DBAccess, 02 - Configuração Inicial, 03 - Appserver, 04 - TOTVS Mingle |
---|
ids | passo1,passo2,passo3,passo4 |
---|
...
...
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 |
---|
|
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 |
---|
firstline | 1 |
---|
title | Exemplo dbaccess.ini |
---|
linenumbers | true |
---|
|
[General]
Port=7890
[MSSQL]
environments=environment
[MSSQL/environment]
UseRowStamp=1 |
...
default | no |
---|
referencia | passo2 |
---|
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:
...
title | Expandir origem para visualizar exemplo de execução através do Smartclient |
---|
...
tabs | Passo 01, Passo 02, Passo 03, Passo 04 |
---|
ids | p1,p2,p3,p4 |
---|
Aviso |
---|
title | Acesso 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 |
---|
title | Porta multiprotocolo |
---|
|
Desabilitar temporariamente as configurações utilizadas pela Porta multiprotocolo. |
...
- Abrir o smartclient
- Preencha o campo Programa inicial com o valor SETUPTGV
- Clique em Ok para confirmar ação.
...
Totvs custom tabs box items |
---|
|
- Selecione as Empresa(s) e Filial(is) que serão utilizadas no Portal Gestão de Vendas.
- Clique em confirmar
Image Removed |
...
- 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. |
Image Removed
Totvs custom tabs box items |
---|
|
- 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.
Image Removed |
...
title | Expandir 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 |
---|
language | c# |
---|
theme | Eclipse |
---|
title | MySetupTGV |
---|
linenumbers | true |
---|
|
#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 |
...
default | no |
---|
referencia | passo3 |
---|
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. |
Bloco de código |
---|
title | exemplo appserver.ini |
---|
|
[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 |
...
default | no |
---|
referencia | passo4 |
---|
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 |
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
...
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 Portal 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 o Login e iniciar a carga inicial, o usuário é redirecionado para os Indicadores de Venda (Home).
- Na barra superior é possível visualizar os dados do Vendedor, consultar as Notificações e Sair da aplicação.
Image Removed
...
b. VALIDAÇÃO DE VERSÃO (LOGIN)
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 Removed
...
05. TABELAS UTILIZADAS
Painel |
A1S - Notificações do VendedorA1T - Controle de Integração de PedidosA1V - Schemas do Gestão de vendas |
A1W - Campos do SchemaAC8 - Relação de Contatos X EntidadeAGB - Telefones X EntidadesDA0 - Tabela de PreçosDA1 - Itens da Tabela de PreçosSA1 - ClientesSA3 - VendedoresSA4 - TransportadorasSB1 - Descrição Genérica do ProdutoSB2 - Saldos Físico e FinanceiroSC5 - Pedidos de VendaSC6 - Itens dos Pedidos de VendaSC9 - Pedidos LiberadosSD2 - Itens de Venda da NF SE1 - Contas a ReceberSE4 - Condições de PagamentoSF2 - Cabeçalho das NF de Saída SU5 - ContatosSX5 - Tabelas GenéricasSYA - Países |
06. ASSUNTOS RELACIONADOS
...