![](/download/thumbnails/579468339/LogoApp.png?version=1&modificationDate=1609765157277&api=v2)
CONTEÚDO
- Visão Geral
- Exemplo de Utilização
- Requisitos Mínimos
- Configurações - Clientes Pilotos
- Informações Técnicas
- Entrar (Login)
- Sincronismo
- Tabelas utilizadas
- Assuntos Relacionados
01. VISÃO GERAL
Aviso |
---|
title | Ferramenta em Homologação |
---|
|
O TOTVS Gestão de Vendas ainda está em fase de homologação e liberado apenas para clientes pilotos. |
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.
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).
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 |
---|
|
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. |
Âncora |
---|
| EXEMPLOS_DE_USO |
---|
| EXEMPLOS_DE_USO |
---|
|
02. EXEMPLO DE UTILIZAÇÃO
Aqui você pode visualizar um exemplo pratico das principais funcionalidades do TOTVS Gestão de Vendas.
Expandir |
---|
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.
![](/download/attachments/579468339/Gest%C3%A3o%20de%20Vendas%20-%20Indicadores%20de%20Venda.gif?version=1&modificationDate=1609247280937&api=v2)
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).
![](/download/attachments/579468339/Gest%C3%A3o%20de%20Vendas%20-%20Notifica%C3%A7%C3%B5es.gif?version=1&modificationDate=1609248197127&api=v2)
- 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.
![](/download/attachments/579468339/02-%20EXEMPLO%20DE%20UTILIZACAO-PRINCIPAL.gif?version=1&modificationDate=1612559735270&api=v2)
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.
![](/download/attachments/579468339/Meus%20Pedidos.gif?version=1&modificationDate=1610539989000&api=v2)
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
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 |
---|
|
Para o correto funcionamento do TOTVS Gestão de Vendas é necessário aplicar os pacotes de expedição continua dos módulos de Faturamento e Livros Fiscais, além disso será necessário executar o programa SetupTGV este programa tem como finalidade atualizar todas as tabelas utilizadas pelo TOTVS Gestão de Vendas com os campos S_T_A_M_P_ e também alimentar o campo Número Externo (C5_NUMEXT/CJ_NUMEXT) com um identificador único do registro. |
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:
Âncora |
---|
| APPSERVER_REST |
---|
| APPSERVER_REST |
---|
|
- 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 |
---|
|
O TOTVS Gestão de Vendas utiliza a configuração de Appserver REST 2.0. |
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 usuario. Para maiores informações consulte o documento de referenciada da rotina clicando aqui. |
Bloco de código |
---|
firstline | 1 |
---|
title | Exemplo APPSERVER.INI |
---|
linenumbers | true |
---|
collapse | true |
---|
|
[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 |
Âncora |
---|
| DBACCESS_USEROWSTAMP |
---|
| DBACCESS_USEROWSTAMP |
---|
|
- 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 |
---|
firstline | 1 |
---|
title | Exemplo dbaccess.ini |
---|
linenumbers | true |
---|
collapse | true |
---|
|
[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.
![](/download/attachments/579468339/mingle.png?version=1&modificationDate=1609353137697&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)
Card documentos |
---|
Informacao | As funcionalidades mencionadas acima, estarão disponiveis somente a partir do Release da Linha Microsiga Protheus 12.1.33 |
---|
Titulo | IMPORTANTE! |
---|
|
Âncora |
---|
| CONFIG_PILOTO |
---|
| CONFIG_PILOTO |
---|
|
a. CONFIGURAÇÕES - CLIENTES PILOTOS
É Necessário efetuar algumas configurações antes de utilizar o TOTVS Gestão de Vendas, são elas:
- Configurações da Chave UseRowStamp no TOTVS DBAccess conforme descrito anteriormente.
- Será necessário executar programa inicial UPDDISTR para a criação das tabelas A1T, A1S e Inclusão dos campos C5_NUMEXT e CJ_NUMEXT.
- Será necessário executar o programa inicial UPDDISTR para criação do campo A1T_ROTINA.
- Aplicar os pacotes de expedição continua dos módulos Faturamento e Livros Fiscais.
- Executar o programa inicial SetupTGV para atualizar todas as tabelas utilizadas pelo TOTVS Gestão de Vendas com os campos S_T_A_M_P_ e Atualização do campo Número Externo (C5_NUMEXT/CJ_NUMEXT) com um identificador único do registro.
- Habilitar o REST 2.0 no AppServer, conforme descrito anteriormente.
- Solicitar um Alias no TOTVS Mingle.
Aviso |
---|
|
Para o correto funcionamento do TOTVS Gestão de Vendas é necessário aplicar os pacotes de expedição continua dos módulos de Faturamento e Livros Fiscais, além disso será necessário executar o programa SetupTGV este programa tem como finalidade atualizar todas as tabelas utilizadas pelo TOTVS Gestão de Vendas com os campos S_T_A_M_P_ e também alimentar o campo Número Externo (C5_NUMEXT/CJ_NUMEXT) com um identificador único do registro. |
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.
![](/download/attachments/579468339/Login.gif?version=2&modificationDate=1660670303617&api=v2)
![](/download/attachments/579468339/ALTERAR_USUARIO.gif?version=1&modificationDate=1609355680413&api=v2)
- 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.
![](/download/attachments/579468339/Vendedor.gif?version=1&modificationDate=1609355690397&api=v2)
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 operações de inclusão, alteração ou exclusão de pedido, o status do mesmo ficará como Não Sincronizado até efetivamente for realizada a operação no Protheus. Após a confirmação (próxima sincronização) o status irá mudar na interface.
![](/download/attachments/579468339/DSERFAT_19491.gif?version=1&modificationDate=1614021432273&api=v2)
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.
![](/download/attachments/579468339/DSERFAT_19202_2.gif?version=1&modificationDate=1611164530177&api=v2)
Caso o acesso do aplicativo tenha expirado e o TOTVS Mingle não tenha conseguido autenticar novamente de forma automática, aparecerá a mensagem informando que a sessão expirou e o usuário terá que realizar o login novamente. Porém existe a opção de continuar usando o aplicativo em modo offline, assim o usuário poderá realizar suas alterações e as mesmas ficarão pendentes de sincronização até o próximo login ser feito.
![](/download/attachments/579468339/DSERFAT_19201.gif?version=1&modificationDate=1612820292580&api=v2)
Âncora |
---|
| TABELAS_UTILIZADAS |
---|
| TABELAS_UTILIZADAS |
---|
|
05. TABELAS UTILIZADAS
- A1S - Notificações do Vendedor
- A1T - Controle de Integração de Pedidos/Orçamentos
- 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
- SUS - Prospects
- SX5 - Tabelas Genéricas
- SYA - Países
06. 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>
|