1

TOTVS PROTHEUS FRONTLOJA

O T Totvs Protheus Front Loja um mdulo complementar do Controle de Lojas Microsiga
Protheus, que permite a realizao de um atendimento rpido e ininterrupto de frente
de loja, voltado a clientes com um grande volume de vendas, como por exemplo:
supermercados, drogarias, lojas de convenincias e grandes magazines, e utilizando
dispositivos como leitor de cdigo de barras, impressora fiscal, leitor de CMC7, gaveteiro
e impressora de cheques.
Com uma interface mais rpida, simples e direta, o Totvs Protheus Front Loja vem de encontro
ao dinamismo que estas lojas necessitam. O objetivo principal do Mdulo Totvs Protheus Front
Loja permitir um atendimento rpido e ininterrupto aos clientes, e simples e eficiente aos
operadores de caixa.
O seu conceito de caixa Non-Stop garante que seja possvel trabalhar sem interrupes. Caso
haja queda do servidor de Retaguarda, esta queda no afetar o atendimento, pois o Mdulo
Totvs Protheus Front Loja possui sua prpria base de dados trabalhando independente da
conexo com o servidor. Se houver queda da rede eltrica ou algum outro motivo, que venha a
reinicializar a estao no meio de uma venda, a recuperao dos dados e a retomada da venda
ao ponto em que havia parado transparente. Para sua utilizao necessrio que o servidor
de Retaguarda contenha no mnimo uma licena do Mdulo Controle de Lojas e as Estaes, o
Mdulo Totvs Protheus Front Loja.
Dentre as principais funes podemos destacar:

Atendimento
Abertura e fechamento do caixa
Desconto por item e/ou total da venda
Pagamentos em dinheiro, cheque, carto, etc.
Excluir item
Cancelar cupom
Alterar cliente
Sangria
Troco
Leitura X
Reduo Z
Permisso de Acesso por Usurio

Identificando as Estaes
Pelo fato de o Totvs Protheus Front Loja trabalhar independentemente de um servidor, faz-se
necessrio montar uma estao que tenha a capacidade de enviar as vendas para um
centralizador de informaes. Com esta viso teremos dois tipos de mquinas, o Check-Out, o
qual ser o responsvel pelas vendas, e o Servidor de Retaguarda, o qual ser o centralizador
destas informaes.
O Check-Out
O check-out uma estao que deve ter as mesmas caractersticas do servidor, uma vez que
ele no acessa diretamente a base de dados do Servidor. O dicionrio de dados deve ter as
mesmas caractersticas do dicionrio de dados do Servidor. Portanto, caso seja feita alguma
alterao no dicionrio de dados do Servidor, a mesma deve ser replicada para todos os chekouts. Cada check-out deve ser identificado por um nmero que servir tanto para a
identificao no Cadastro de Estaes no Servidor, quanto para Carga das Estaes (rotina
responsvel por atualizar a base de dados no check-out).
Para que o check-out possa enviar as vendas ao Servidor, deve-se iniciar um servio na
inicializao do Server do check-out, a qual chamamos de StartJob. O Job APFrontLoja o
responsvel por fazer a conexo do Server do check-out com o Server do Servidor. Uma vez
que o check-out esteja conectado ao Servidor, este servio ir verificar se existe vendas
pendentes a serem enviados ao Servidor, ao mesmo tempo que verifica se existe alguma Carga
a ser baixada.
necessrio adotar como padro nas implantaes, que o check-out 1 utilize as caractersticas
da Estao identificada como 001 no Cadastro de Estaes, e no servio de envio de vendas e
recepo de Carga, e assim por diante nos outros check-outs.
O Servidor de Retaguarda
O Servidor de Retaguarda uma estao que ser responsvel por receber e processar os
pacotes enviados pelo check-out. Devemos iniciar os trabalhos com o FrontLoja, com a
premissa de que o Controle de Lojas esteja devidamente instalado e configurado nesta
mquina.
Uma vez que os pacotes tenham sido recebidos pelo Servidor, os mesmos devem ser
processados para que se possa haver a integrao das vendas com o ERP da Microsiga. Para
isso deve ser iniciado um Job no Server do Servidor. Este servio pode ser inicializado por uma
interveno do usurio ou por uma StartJob.
Podemos carregar este servio utilizando as funes LJGRVSTART (ERP On-Line) e LJGRVEND
(ERP Off-Line) diretamente do Menu ou caso queiramos automatizar, podemos carregar este
servio em uma StartJob, como no exemplo abaixo:
[OnStart]
Jobs=Integracao ERP
[Integracao ERP]
Main=LJGRVBATCH
Environment=<cAmbiente>
nParms=2
Parm1=<cEmpresa>
Parm2=<cFilial>

O Que So Pacotes?
Um pacote caracterizado pela base de dados geradora do Controle de Lojas, ou seja, os
arquivos SL1, SL2 e SL4. Estes arquivos contm todas as informaes necessrias para a
integrao com o ERP da Microsiga. Com estes arquivos possvel gerar as notas de sada,
atualizar o estoque, gerar as informaes financeiras, atualizar o saldo dos clientes, enfim,
todos os processos disparados quando se realiza uma venda pelo Controle de Lojas. Um outro
arquivo que tambm pode integrar este pacote o SE5, que guarda os movimentos de Sangria
e Entrada de Troco.
A conexo entre o check-out e o Servidor, unilateral, isto , somente o check-out se conecta
ao Servidor, verificando se tem Carga a ser baixada ou enviando os pacotes.
Uma vez que o check-out tem o simples objetivo de atender o cliente ou seja, vender, no
necessrio que uma sobrecarga de informaes trafegue pela rede, diminundo assim a sua
performance. Foi com esta concepo que foi desenhado o arquivo SBI Produtos x Preos,
que nada mais que uma simplificao dos arquivos SB1 e SB0.
Configurao dos Operadores de Caixa
Os Operadores de Caixa utilizados pelo FrontLoja devem ser configurados exclusivamente no
Servidor, para que todas as estaes recebam estas configuraes. Em virtude da segurana,
todos os check-outs devem somente acessar a aplicao FrontLoja. Para isto habilite a opo
Acionamento Automtico da Tela de Vendas no FrontLoja.
Para usufruir da grande capacidade de segurana oferecida pelo FrontLoja, convm configurar
rotinas especficas a certas pessoas. Delegaremos neste caso um Supervisor, que ter
permisso a todas as rotinas e os Caixas que necessitaram da autorizao deste Supervisor
para acessar rotinas como Abertura e Fechamento do Caixa, Descontos, e Cancelamentos do
Cupom.
Configurao das Estaes
Algums detalhes importantes na configurao das estaes devem ser analizados para se evitar
problemas futuros.
No FrontLoja temos que utilizar configuraes especficas para cada check-out, pois como
vimos, estas configuraes esto diretamente ligadas com o check-out. Quando trabalhamos
com um grande nmero de check-outs, certamente iremos deparar com diferenas nas
configuraes.
Devemos prestar bastante ateno em configurar corretamente a pasta Back Office FrontLoja,
pois as informaes que esto na seo Conexo com o servidor so as necessrias para
conexo. Os valores devem ser os mesmos para todos os check-outs. Neste ponto devemos
nos atentar para o no preenchimento da seo Ambiente Local, pois as informaes aqui
configuradas sero gravadas no MP8SRV.INI em questo, o que no caso do Servidor, no deve
ocorrer. Esta seo ser vista mais adiante, e somente dever ser configurada no check-out.

Carga Nas Estaes

Como o vimos anteriormente, o FrontLoja no trabalha acessando diretamente a base de dados
do Servidor. Por este motivo, o FrontLoja trabalha com o conceito de Carga. De modo geral,
preparar uma Carga gerar arquivos com as ltimas alteraes, comparando a ltima Carga
gerada com o arquivo atual, e disponibiliz-los para que os check-outs possam se autoatualizar assim que esta Carga estiver liberada, e o check-out no esteja em modo de venda.
Os arquivos que fazem parte da Carga so os seguintes:
-

SA1 Cadastro de Clientes - compartilhado

SA3 Cadastro de Vendedores - compartilhado
SA6 Cadastro de Bancos - compartilhado
SAE Cadastro de Administradores de Cartes d Crdito - compartilhado
SAF Cadastro de Fatores Para Financiamento - compartilhado
SBI Produtos x Preos - compartilhado
SE4 Condies de Pagamento - compartilhado
SED Cadastro de Naturezas - compartilhado
SF4 Tipos de Entrada e Sada - compartilhado
SF7 Grupo de Tributao
SFC Amarrao TES x Impostos (Especfico outro pas)
SLF Perfil/Acessos do Caixa SLG Cadastro de Estaes - compartilhado
SLK Cadastro de Cdigos de Barra - compartilhado

Caso seja necessrio adicionar mais algum arquivo a esta lista, existe o Ponto de Entrada
FRTCARGA, que recebe um array com estes arquivos. O seu retorno deve ser este mesmo array
adicionado dos arquivos a fazer parte da Carga. Atente-se ao fato que que este Ponto de
Entrada tambm deve estar no RPO do check-out.
Arquivos Adicionados na Carga
-

SFM TES Inteligente

SZ2 Vendedores x Tabelas
DA0 Tabela de Preos
DA1 Itens da Tabela de Preos

Devemos nos atentar para os seguintes parmetros antes de comearmos a implantar o

FrontLoja.
MV_DIRCFRT Este parmetro indica o diretrio onde sero gerados e acessados os arquivos
de Carga. Como default, o padro \DATA\CARGA\, bastando apenas criar este diretrio para
que possa ser gerada uma Carga.
MV_NUMESTA Este parmetro indica o nmero exato de check-outs que estaro acessando
o Servidor. muito importante este parmetro estar corretamente configurado, pois a Carga
trabalha diretamente ligada a este parmetro.
Caso o Servidor rode em uma base de dados diferente do check-out, como por exemplo
TOP e CodeBase, atente-se ao fato de que os dois RPOs devem conter os mesmos
RDMakes e estarem com as mesmas atualizaes.

Roteiro de Implantao
Aps serem configurados todos os parmetros para o funcionamento do FrontLoja, no Servidor,
deve-se realizar os seguintes procedimentos para a sua instalao.
Inicialmente deve-se copiar os seguintes diretrios do Servidor para o check-out:
\PROTHEUS8\SYSTEM
\PROTHEUS8\BIN;
\PROTHEUS8\APO.
Crie o diretrio especificado como diretrio de dados no SX2. Por exemplo, no SX padro crie o
diretrio \DATA\. (As tabelas sero criadas e preenchidas automaticamente pelo FrontLoja)
Certifique-se de que o item Server, na seo TCP do arquivo de configurao MP8RMT.INI
esteja corretamente configurado. Deve ser utilizado a chave LocalHost ou o prprio nome da
mquina.
Lembre-se que cada check-out dever ter obrigatoriamente um Server. E que cada check-out
dever ter um nmero de estao prprio.
Na pasta Iniciar do Windows, coloque um atalho para o MP8SRVWIN.EXE e para o
MP8RMT.EXE, como no exemplo abaixo, pois o check-out dever inicializar e iniciar diretamente
o FrontLoja.
MP8SRVWIN.EXE CONSOLE
MP8RMT.EXE P=SIGAFRT E=<Ambiente>
Estao>

A=

-A=<Nmero

da

Neste momento o check-out j pode inicializar o Protheus. Inicialize o MP8SRVWIN.EXE e inicie

uma seo do FrontLoja.
No FrontLoja, entre no menu Miscelneas, selecione a Configurao da Estao, e inclua a
estao para a qual este check-out foi configurado para trabalhar. Quando for executada uma
Carga, estas informaes sero substitudas pelas configuraes do Servidor. Portanto, v
direto pasta Back Office Totvs Protheus Front Loja, preencha todas as informaes da
janela Conexo com o Servidor com os mesmos dados preenchidos no Servidor de
Retaguarda, e na janela Ambiente Local, preencha todas as informaes para executar um
aplicativo, como ambiente de trabalho, empresa e filial. Ao confirmar esta informaes, ser
gravado no arquivo de configurao MP8SRV.INI, a configurao necessria para a conexo
com o Servidor de Retaguarda seo criada segue este padro:
[OnStart]
Jobs=APFrontLoja
[APFrontLoja]
Main=FRTA020
Environment=<cAmbiente>
nParms=3
Parm1=<cEmpresa>
Parm2=<cFilial>
Parm3=<cEstacao>

Saia do FrontLoja, finalize o Server do Protheus e reinicie-o. Este procedimento necessrio

pois este Job iniciado na inicializao do Server. Na inicializao o check-out ir iniciar o
servio APFrontLoja de conexo com o Servidor. Todos os arquivos necessrios para o
funcionamento do FrontLoja, descritos na seo de Carga das Estaes, sero atualizados neste
momento.
Realizando uma Venda
O processo de venda no FrontLoja definido em dois momentos distintos. Um momento antes
de ser iniciado o processo de finalizao da venda e outro durante este processo.
Para o primeiro momento, as teclas definidas so as seguintes:
Teclas
[F4]
[F5]
[F6]
[F7]
[F8]
[F9]
[F10]
[F11]
[F12]
[ESC]

Funo
Abrir Caixa
Fechar Caixa
Conceder desconto p/ o item de venda
Alterar a quantidade
Cancelar item
Apresentar sub-total do valor de venda
Alterar cliente
Alterar Vendedor
Tecla de funes
Sair do Sistema

Para se executar qualquer procedimento no FrontLoja, deve-se Abrir o Caixa. Caso o usurio
no tenha permisso para efetuar a operao, ser sempre solicitada a senha de permisso de
um superior.
possvel sair do sistema entre uma venda e outra. Para isso pressione [ESC]. Quando
retornar ao sistema novamente deve ser utilizado o caixa que estava aberto
anteriormente. Caso seja necessrio utilizar outro caixa, feche o caixa anterior e abra
um novo caixa.
O atendimento permite alterar o cliente nas operaes de venda. Para isso, antes de iniciar a
venda, pressione a tecla [F10]. Somente possvel alterar o cliente antes de se iniciar a venda.
O sistema assume automaticamente o cliente informado pelo parmetro MV_CLIPAD.
A partir deste momento, as movimentaes de vendas podem ser executadas. Para agilizar a
venda, o sistema j considera o campo "Quantidade" com 1. Se for necessrio registrar uma
quantidade maior, pressione [F7] e informe-a. Caso esteja sendo utilizada o leitor de cdigo de
barras, faa a leitura do cdigo do produto. Se os produtos no puderem serem lidos pelo
leitor, ou o check-out no o possu-lo, basta apenas digitar o cdigo e teclar [ENTER].
Nas operaes de venda possvel conceder descontos para os itens. Para isso antes de
informar o cdigo do item, pressione a tecla [F6]. Caso o usurio no tenha permisso para
efetuar a operao, ser sempre solicitado a senha de permisso de um superior.
O Atendimento permite que os itens informados sejam excludos. Para isso na tela de Venda,
pressione a tecla [F8]. S ser possvel cancelar o ltimo item impresso. Caso o usurio no
tenha permisso para efetuar a operao, ser sempre solicitado a senha de permisso de um
superior. O item excludo apresenta a notao de Cancelado na rea do ticket.

Aps ter registrado todos os produtos da venda, iniciado o processo de finalizao da venda
onde so definidos os pagamentos. Para isso pressione a tecla [F9]. No quadro abaixo so
apresentadas as teclas de atalho utilizadas na finalizao da venda:
Teclas
[F6]
[F9]
[F12]
[ESC]

Funo
Desconto para o total da venda
Finalizar a venda
Tecla de funes
Sair do Sistema

As formas de pagamento no FrontLoja podem ser definidas pelas teclas CTRL+A at CTRL+Z.
Caso no tenha sido cadastrada nenhuma Administradora Financeira (SAE), as formas de
pagamento padro sero:
CTRL + A
CTRL + B

Pagamento em Dinheiro
Pagamento em Cheque

As Administradoras Financeiras cadastradas sero adicionadas a prxima tecla disponvel (CTRL

+ C).
Para conceder desconto no total da venda, pressione a tecla [F6]. Para finalizar a venda
pressione [F9]. Neste ponto, o procedimento para o recebimento apresentar as mesmas telas
usadas no Controle de Lojas. O sistema encerra o processo e libera a estao para iniciar nova
venda.
Para realizar o Fechamento do Caixa, pressione a tecla [F5] (voltamos as teclas do primeiro
momento da tela de venda). Caso o usurio no tenha permisso para efetuar a operao, ser
sempre solicitada a senha de permisso de um superior.
Antes de encerrar o caixa, deve ser executada a sangria, transferindo os valores do caixa do
check-out para o caixa geral da empresa, identificado atravs do parmetro MV_CXLOJA.
Desta forma, possvel controlar o fluxo de numerrios tanto dos caixas como do caixa geral
da loja.
Cancelando um Cupom Fiscal
No FrontLoja possvel cancelar o cupom fiscal durante o processamento da venda, ou logo
aps a sua finalizao. Caso a venda, j tenha sido encerrada, possvel cancelar somente o
ltimo cupom impresso. Para isso, pressione a tecla [F12] e digite o cdigo 03 (Cancelar
Cupom). Caso o usurio no tenha permisso para efetuar a operao, ser sempre solicitada a
senha de permisso de um superior.
Apesar de permitir cancelar o ltimo cupom, atentamos para a possibilidade de
cancelarmos o cupom durante a sua realizao, pois uma vez o cupom finalizado, o
mesmo j ser enviado ao Servidor, o que gerar um trabalho extra ao Servidor para
que o mesmo cancele este cupom, o que pode ser evitado cancelando-o antes de sua
finalizao.

Realizando uma Sangria

Refere-se a sangria toda operao de retirada de valores do caixa, seja em dinheiro para
pagamento de pequenas despesas, cheques para depsito, vales para cobrana ou outros.
A sangria deve ser efetuada sempre do check-out para o Caixa Geral, e o troco deve ser do
Caixa Geral para o check-out. Para realizar uma sangria, pressione a tecla [F12] e digite o
cdigo "05"(Sangria). Caso o usurio no tenha permisso para efetuar a operao ser
sempre solicitada a senha de permisso de um superior.
Realizando uma Entrada de Troco
Entrada de Troco toda operao de colocao de valores sob a responsabilidade do Operador
de Caixa, como por exemplo, de moedas e notas de menor valor no incio do movimento para
que o caixa possa ter troco para devolver ao cliente. Para isso pressione [F12] e digite o cdigo
"06" (Entrada de Troco). Caso o usurio no tenha permisso para efetuar a operao, ser
sempre solicitada a senha de permisso de um superior.
Realizando uma Leitura X
A Leitura X gera um relatrio das vendas do dia na impressora fiscal. As vendas podem
continuar sendo registradas, normalmente, aps a leitura. obrigatrio, legalmente, efetuar a
Leitura X antes de terminar o papel na impressora fiscal e logo aps a troca. Para efetuar uma
Leitura X pressione a tecla [F12] e digite o cdigo 04-Leitura X.
Realizando uma Reduo Z
A Reduo Z gera um relatrio de fechamento do dia na impressora fiscal e a partir deste
momento, no podero ser efetuadas mais vendas neste dia. Lembre-se de ter realizado o
Fechamento do Caixa. Para efetuar uma Reduo Z pressione a tecla [F12] e digite o cdigo
02-Fechar ECF (Reduo Z). Caso o usurio no tenha permisso para efetuar a operao,
ser sempre solicitada a senha de permisso de um superior.

PERSONALIZAES TOTVS PROTHEUS FRONT LOJA

A pedido do cliente, foi customizado a opo de escolha do segundo cliente no momento da
venda, condio de pagamento e seleo de campanha para formao do preo de venda,
todas acionadas pela tecla de funo F12, as mesmas dever ser escolhidas antes da digitao
do cdigo do produto, momento que o ECF registra o item no cupom.

10

TELA DE ESCOLHA DO SEGUNDO CLIENTE

11

TELA DE ESCOLHA DA CONDIO DE PAGAMENTO

12

TELA DA ESCOLHA DA CAMPANHA

Reviso: 03/10/2005
Fbio L. Pereira