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 - Configuração Inicial, 03 - Appserver, 04 - TOTVS Mingle |
---|
ids | config1,config2,config3,config4 |
---|
| 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 |
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | config2 |
---|
| 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 |
---|
title | Expandir origem para visualizar exemplo de execução através do Smartclient |
---|
| Totvs custom tabs box |
---|
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. |
Totvs custom tabs box items |
---|
| - Abrir o smartclient
- Preencha o campo Programa inicial com o valor SETUPTGV
- Clique em Ok para confirmar ação.
![](/download/attachments/579468339/Parametros_iniciais.png?version=1&modificationDate=1643993096313&api=v2) |
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
![](/download/attachments/579468339/Selecao_de_filiais.gif?version=1&modificationDate=1643993665873&api=v2)
|
Totvs custom tabs box items |
---|
| - 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. |
![](/download/attachments/579468339/definindo_parametros.gif?version=1&modificationDate=1643994194103&api=v2)
|
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.
![](/download/attachments/579468339/conclus%C3%A3o.png?version=1&modificationDate=1643994552640&api=v2)
|
|
|
Expandir |
---|
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.
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 |
|
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | config3 |
---|
| 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 | config4 |
---|
| 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 |
![](/download/attachments/579468339/cadastro_mingle.png?version=1&modificationDate=1635340822220&api=v2)
- 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.
![](/download/attachments/579468339/login.png?version=1&modificationDate=1609353468777&api=v2)
|
|
|