Balança com impressão Automática da Comanda (P-zei)
Saiba como configurar e utilizar o "P-zei", o sistema da tryideas de pesagem e impressão automática do ticket da comanda.
Instalação
O aplicativo da balança de pesagem automática, utiliza o recurso LocalDB do SQL Server como banco de dados, onde são armazenadas todas as informações.
Pré requisitos: Windows 10
Instalação do LocalDB
O instalador do SQL LocalDB está no FTP, basta baixar e executar a instalação do arquivo.
Após finalizada a instalação do SQL, siga os passos abaixo.
Configuração da Instância do SQL
No Prompt de Comando, os seguintes comandos estão disponíveis para auxiliar na analise de possíveis problemas.
A instância do SQL LocalDB é iniciada automaticamente ao abrir a aplicação da pesagem automática, não significando que se o serviço estiver paralisado, a mesma não irá funcionar.
Abra o Prompt de comando, e insira o seguinte comando, para visualizar as instâncias existentes.
Após isso, verifique se a instância foi iniciada.
Se o resultado for igual a imagem abaixo, a instância já foi criada, caso contrário, precisamos criá-la.
Para criar a instância, insira o seguinte comando.
Comandos adicionais:
- Listar as instâncias do SQL:
SqlLocalDB info
- Verificar os detalhes da instância:
SqlLocalDB info "nomeInstancia"
- Criar uma nova instância:
SqlLocalDB create "nomeInstancia"
- Remover uma instância existente:
SqlLocalDB delete "nomeInstancia"
- Iniciar a execução de uma instância:
SqlLocalDB start "nomeInstancia"
- Parar a execução de uma instância:
SqlLocalDB stop "nomeInstancia"
Instalação do .net 5.0 runtime
Realize o download do instalador no seguinte link, e execute o aplicativo para realizar a instalação.
Extraindo os arquivos
Crie uma nova pasta no "Disco C", nomeada "tryideas". Descompacte dentro desta pasta, o arquivo que irá realizar o download por este endereço.
A estrutura da pasta e arquivos deverá ficar no seguinte formato: C:\tryideas\Pzei\
Arquivos do Banco de Dados
Se os arquivos do Banco de Dados não estiverem dentro da pasta que foi extraída no passo acima, realize o download pelo link.
Configuração da Conexão com o Banco de Dados
Dentro da pasta da aplicação, existe o arquivo DBConfig.txt, que possui a string de conexão com o arquivo do Banco de Dados. Verifique se o caminho está correto com a localização do arquivo .mdf.
Exemplo: AttachDbFilename=C:\tryideas\Pzei\dbTryideas_balancaAuto.mdf
Desativar as atualizações automáticas do Windows.
Tags para Configuração do Ticket
numero | Número da Comanda |
numeroCodigoBarras | Número da Comanda com 3 caracteres, acrescido de zeros a esquerda |
dataHora | Data e Hora |
peso | Peso registrado (Caso utilizado os botões da tela, este campo não terá valor) |
quantidade | Quantidade para o caso de Refeição Livre |
dscQuantidade | Quantidade acrescido do caractere "X". Ex: 1X, 2X, etc |
preco | Preço unitário |
total | Preço total |
dscBuffetLivre | Descrição da opção registrada. Ex: BUFFET KG, BUFFET LIVRE, ou a descrição dos "Extras" |
nomeEmpresa | Razão Social da Empresa, definida nas Configurações do Pzei |
cnpjEmpresa | CNPJ da Empresa, definido nas Configurações do Pzei |
codigoBarrasProduto |
Código de Barras no formato EAN13, no padrão 2000100012345 |
Configuração de leiaute na Impressão Direta
Para a impressão direta, as tags devem ser utilizadas em MAIÚSCULO, entre o sinal de % (porcento), exemplo %NUMERO% para inserir o número da comanda.
- Modelo padrão, com os produtos:
</zera>
</ce><n>%NOMEEMPRESA%</n>
</linha_simples>
<a><e><n>Comanda: %NUMERO%</n></e></a>
Data: %DATAHORA%
</ae>PREÇO: %PRECO% - %DSCBUFFETLIVRE%
PESO: %PESO%
</reset>
</ad><a><e><n>R$ %TOTAL%</n></e></a>
</linha_simples>
</ce>
ÁGUA ( ) ( ) ( ) ( )
ÁGUA C/ SABOR ( ) ( ) ( ) ( )
CERV LATA ( ) ( ) ( ) ( )
CERV LONG NECK ( ) ( ) ( ) ( )
CERV GARRAFA ( ) ( ) ( ) ( )
REFRI 290 ML ( ) ( ) ( ) ( )
REFRI LATA ( ) ( ) ( ) ( )
REFRI 600 ML ( ) ( ) ( ) ( )
REFRI 1 LT ( ) ( ) ( ) ( )
REFRI 2 LT ( ) ( ) ( ) ( )
SUCO COPO ( ) ( ) ( ) ( )
SUCO LATA ( ) ( ) ( ) ( )
SUCO JARRA PEQ ( ) ( ) ( ) ( )
SUCO JARRA GRA ( ) ( ) ( ) ( )
( ) ( ) ( ) ( )
( ) ( ) ( ) ( )
</ad>TOTAL A PAGAR: R$ | |
</linha_simples>
</ce>Bom apetite!!!
</linha_simples>
</ce><i>www.tryideas.com.br</i>
</corte>
- Modelo com o Código de barras do Número da Comanda:
</zera>
</ce><e><n>%NOMEEMPRESA%</n></e>
</linha_simples>
<a><e><n>Comanda: %NUMERO%</n></e></a>
Data: %DATAHORA%
PREÇO: %PRECO% - %DSCBUFFETLIVRE%
PESO: %PESO%
</reset>
</ad><a><e><n>R$ %TOTAL%</n></e></a>
</linha_simples>
</ce>
<code128>%NUMEROCODIGOBARRAS%</code128>
</linha_simples>
</ce>Bom apetite!!!
</linha_simples>
</ce><i>www.tryideas.com.br</i>
</corte>
- Modelo com o Código de barras do Produto:
</zera>
</ce><e><n>%NOMEEMPRESA%</n></e>
</linha_simples>
<e><n>Comanda: %NUMERO%</n></e>
Data: %DATAHORA%
PREÇO: %PRECO% - %DSCBUFFETLIVRE%
PESO: %PESO%
</cr>
</ad>
<a><e><n>R$ %TOTAL%</n></e></a>
</linha_simples>
</ce>
<code128>%CODIGOBARRASPRODUTO%</code128>
%CODIGOBARRASPRODUTO%
</linha_simples>
</ce><i>www.tryideas.com.br</i>
</corte>
Guia de uso
Neste manual, iremos descrever como realizar as configurações e detalhar o funcionamento da balança automática, com a impressão do ticket.
Execute o atalho do programa que estará na área de trabalho, e a tela inicial será exibida (conforme imagem abaixo), onde existem algumas opções, que iremos detalhar abaixo.
1. Configurações
Nesta opção, estão as configurações ou parâmetros necessários para o correto funcionamento da aplicação.
Empresa
CNPJ - Informe o CNPJ da empresa, para o caso de precisar utilizar em algum ticket (esta informação também será utilizada para monitorar os recursos e o funcionamento da aplicação, facilitando detectarmos problemas que possam ocorrer).
Balança
Modelo - Selecione o modelo da sua balança, dentre as opções disponíveis no menu;
Porta - Selecione a Porta de comunicação, em que a impressora está conectada;
*Para conferir esta informação, acesse o Gerenciador de Dispositivos, e na opção "Portas" verifique a porta de comunicação.
Velocidade - Selecione a velocidade conforme a configuração definida na Balança (é possível acessar a programação da balança para alterar/visualizar esta informação se necessário. Por padrão geralmente é utilizado 4800 ou 9600, dependendo da fabricante).
Preço
Nesta aba iremos configurar os valores de cada opção, bem como podemos definir algumas opções "Extras", caso possua esta necessida.
Observe que as configurações estão separadas por grupos, onde cada linha identifica uma opção diferente.
Refeição por KG
- Valor KG - Informe o Preço por KG cobrado nas refeições.
- Desabilitar Livre Automático - Ao realizar a pesagem da refeição, caso o valor seja superior ao Preço Livre, o P-zei irá considerar como uma refeição livre automaticamente. Caso queira desabilitar esta opção, e sempre considerar o Preço por KG, selecione esta opção.
- Configuração por Dia da Semana - Nesta opção, podemos definir valores diferentes para cada dia da semana, conforme os valores praticados por seu estabelecimento. (Se o valor é o mesmo todos os dias, não é necessário realizar esta configuração).
- Código ERP - Informe o Código do Produto por KG do seu ERP, para gerar um Código de Barras no padrão EAN13, que conterá o Código do Produto e o Valor Total. Desta forma será possível bipar o código de barras no sistema ERP, para a inclusão do item na tela de venda de forma automatizada.
Refeição Livre (Buffet livre)
- Descrição - Informe a descrição desejada para esta opção, que será exibida no Ticket e na tela de Pesagem, caso habilitada.
- Valor Livre - Informe o Preço da refeição livre, quando possuir esta opção no estabelecimento.
- Exibir - Esta opção quando selecionada, irá exibir um botão na tela de pesagem automática, sendo possível o cliente clicar sobre o botão para a impressão do Ticket sem a necessidade de pesagem do prato. Para os casos em que não queira que a opção seja exibida, desmarque esta opção.
- Código ERP - Informe o Código do Produto Buffet Livre do seu ERP, para gerar um Código de Barras no padrão EAN13, que conterá o Código do Produto e o Valor Total. Desta forma será possível bipar o código de barras no sistema ERP, para a inclusão do item na tela de venda de forma automatizada.
Botões Extras
É possível configurar "botões extras", para opções diversas que possuir, como por exemplo, Marmita Pequena, Média e Grande, ou então, uma opção de "Rodízio" em algum dia da semana.
- Descrição - Informe uma descrição que seja compreensível ao usuário, a mesma também será exibida no Ticket. (Limitada a 15 caracteres).
- Valor - Defina o valor desta opção "Extra".
- Pesar - Identifica se o item é pesável, ou unitário. Selecione a opção caso o item deva ser pesado.
- Exibir - Esta opção define se o item será exibido ou não na tela de pesagem automática.
- Código ERP - Informe o Código do Produto Extra do seu ERP, para gerar um Código de Barras no padrão EAN13, que conterá o Código do Produto e o Valor Total. Desta forma será possível bipar o código de barras no sistema ERP, para a inclusão do item na tela de venda de forma automatizada.
Os Botões Extras são considerados apenas na primeira pesagem, após serem selecionados, ou seja, após o registro do peso, automaticamente será retomado o modo de pesagem de Refeição por KG.
Os botões apenas serão exibidos, caso possuam uma Descrição, um Valor (geral ou personalizado para o dia), e que estejam com a opção "Exibir" habilitada.
Como configurar um valor diferenciado em dias específicos?
Vamos lá, supondo que durante a semana o valor praticado para o "buffet livre" seja R$ 38,00 por exemplo, como podemos configurar um valor diferente para o sábado e domingo?
Certo! Observe na imagem acima, que definimos o "Valor Geral" que será considerado todos os dias, exceto, os específicos que iremos configurar logo abaixo.
Veja que inserimos 2 configurações, uma para o Sábado e outra para o Domingo, desta forma o P-zei saberá que de Segunda a Sexta deverá considerar o valor de R$ 38,00, no Sábado o valor R$ 42,00 e no Domingo R$ 45,00.
Como exibir uma opção "Extra" apenas em um dia específico da semana?
Digamos que no Domingo, o estabelecimento possua a opção de Refeição em KG e também um Rodízio. Neste caso, não queremos que o Rodízio esteja visível na tela de pesagem para os demais dias da semana.
Em uma das opções de "Botão Extra", informe a descrição desejada, e não defina nenhum Valor, apenas selecione a opção "Exibir".
Após isso, clique na opção "Configurar", correspondente a opção extra que iremos utilizar. Observe na animação abaixo, que selecionamos o dia da semana desejado, inserimos o Valor, e incluímos a configuração. Após isso, clique na opção Salvar.
É possível ajustar os valores diretamente na lista (grid), ou então, remover alguma configuração caso não deseje mais.
Não é possível a alteração de dias da semana para configurações já inseridas, neste caso remova a configuração e insira novamente.
É realizado uma validação que não permite incluir o mesmo dia da semana em configurações diferentes, nestas situações um aviso será exibido na tela.
Impressora
Selecione o método de Impressão: Spooler ou Direta.
Spooler
Esta opção irá utilizar o spooler do windows para realizar a impressão das Comandas, onde é enviado o arquivo da comanda que o layout especificado, que poderá ser customizado conforme necessário.
No modo Spooler, selecione a impressora que irá realizar a impressão dos Ticket's e Relatórios.
Atenção: O relatório de Vendas sempre será impresso pelo Spooler, se for utilizar este relatório, sempre defina a impressora, mesmo que for utilizar a configuração "Direta" para a impressão das comandas.
Direto
Já na opção direta, a impressão será enviada diretamente para a porta da impressora, sendo uma alternativa mais rápida para realizar as impressões.
Observação: Neste modo, algumas configurações adicionais são necessárias para a sua utilização.
Antes de realizar qualquer impressão, seja do ticket ou das tags, faça primeiro a configuração através da opção "Configurar Impressão Direta".
No campo "Modelo Ticket", deverá ser realizado a configuração do layout do ticket da comanda a ser impresso. Um layout padrão já está configurado, utilize-o como base e realize os ajustes necessários conforme desejar.
Para esta configuração, "tags" poderão ser usadas, para por exemplo, centralizar um texto, deixa-lo em negrito, incluir uma linha, entre várias outras opções (clique no botão Imprimir Tags para realizar a impressão das opções).
1 - Configurar Impressão direta
Ao clicar sobre esta opção, uma nova tela será aberta, onde iremos selecionar o Modelo da impressora que já deverá estar conectada e configurada, e a sua Porta de conexão. (Caso tenha dúvida em qual porta está conectada, abra o Gerenciador de Dispositivos do Windows).
Após isso na aba Geral, confira se as informações estão definidas conforme a imagem abaixo, e ajuste os campos necessários.
Após definir e conferir todos os campos, clique na opção Salvar alterações.
2 - Imprimir Ticket
Esta opção permite realizar a impressão do Ticket para visualizar o layout configurado no campo Modelo Ticket, auxiliando na sua configuração.
3 - Imprimir Tags
Esta opção irá imprimir um relatórios das tags disponíveis para a configuração do "Modelo Ticket".
Integração tryERP
Algumas configurações no tryERP devem ser realizadas antes de iniciar a configuração da integração no P-zei.
Ainda na tela de Configurações Globais, localize no menu lateral a opção Pré Venda > Configurações da Pré-Venda. Defina a Operação e o Parceiro padrão, e clique em Gravar para salvar as alterações.
A próxima configuração será definir o código do Produto Kg, Livre e os Extras, caso utilize algum. Caso ainda não possua os produtos cadastrados, realize o cadastro e depois selecione cada um em seu respectivo campo, no menu lateral Pré-Venda > Configurações do P-zei, e salve as configurações clicando em Gravar.
Pronto! O sistema tryerp está configurado e apto a receber as comandas enviadas pelo P-zei.
Configurações da Integração no P-zei
Habilitar Integração - Defina nesta opção se a integração estará Habilitada ou Desabilitada.
Instância Servidor - Informe o nome da instância de conexão ao SQL Server (Exemplo: NOME-DO-PC\SQLEXPRESS).
Nome Banco de Dados - Informe o nome do Banco de Dados (Exemplo em instalação local: TryNFeOnline).
Usuário - Para conexões remotas, será necessário realizar a configuração de acesso por usuário (Exemplo: sa).
Senha - Informe a senha do usuário informado acima.
Realize sempre o teste de conexão, pela opção disponível na tela, afim de garantir que as informações da configuração estão corretos.
Serão realizadas 3 (TRÊS) tentativas de sincronização, com intervalo de 1 (UM) minuto entre uma tentativa e outra, levando em consideração uma possível queda de conexão de internet, reinicialização do computador onde o tryERP está configurado, entre outros.
Caso alguma comanda não seja enviada nestas tentativas, consulte as vendas e solicite o reenvio manualmente.
Gerais
Abrir a tela de pesagem ao iniciar o aplicativo - Selecione esta opção quando desejar que a tela de auto-atendimento, ou seja, onde é realizado o monitoramento das pesagens, seja aberta automaticamente ao abrir o Pzei. Desta forma, após abrir o aplicativo, o mesmo já estará pronto para iniciar as pesagens sem a necessidade de interferência de algum operador.
Abrir a tela para definir a Quantidade de 'Refeições Livres' desejada - Selecione esta opção quando desejar que uma opção para informar a Quantidade seja exibida, desta forma é possível incluir na mesma comanda mais de um Produto.
Minimizar a aplicação durante a pesagem - Selecione esta opção quando não possuir um monitor dedicado para a pesagem, onde a aplicação deverá ficar minimizada enquanto estiver sendo executada.
Habilitar gravação de Log - Esta opção permite iniciar a gravação de logs que irá registrar tudo o que ocorre enquanto a aplicação está sendo executada. Opção útil para análise da tryideas, em caso de problemas que possam estar ocorrendo.
Número Inicial Comanda - Defina neste campo o número inicial da Comanda no dia. O número da comanda é reiniciado automaticamente a cada dia, iniciando pelo número configurado neste campo, 1 por padrão.
Caso utilize o P-zei em mais de um computador, o Número Inicial deverá ser configurado, para não existirem comandas duplicadas com a mesma numeração. Atenção a esta informação quando utilizado integração, e possuir mais de uma balança, para evitar a duplicidade de comandas e gerar confusão no fechamento das mesmas.
Caminho copiar Logs - Este campo permite definir um caminho personalizado para salvar os logs, caso habilitado o parâmetro.
Intervalo para leitura do peso (em milisegundos) - Configure o tempo de intervalo entre as pesagens. Obs: Definir um tempo maior, irá deixar o processo mais lento.
Após definir todas as configurações, clique sobre a opção "Salvar alterações", para aplicar as informações definidas.
2. Fechar
Esta opção fecha a aplicação.
3. Fechar e Desligar
Esta opção irá fechar a aplicação, e enviar um comando para que o computador seja desligado automaticamente.
4. Pesagem Automática
Esta tela é a responsável por monitorar a balança, e registrar os pesos, sempre que um prato for colocado sobre a balança. Basta colocar o prato, e aguardar a impressão do ticket. Após isso, basta retirar o prato, e o próximo da fila já poderá realizar a sua pesagem.
A mesma sempre deverá estar aberta para que o peso seja lido, e o ticket impresso.
A tara do prato, deverá ser definida na balança, antes de iniciar o atendimento.
Para sair desta tela e voltar a tela inicial, clique sobre o link www.tryideas.com.br no topo da tela.
5. Consultar Vendas
Esta opção irá abrir uma tela, que permite realizar a consulta das Comandas, com possibilidade de aplicar um filtro por período.
Nesta tela é possível observar os detalhes das informações da sincronização por exemplo, caso tenha ocorrido algum erro, e tentar realizar o reenvio após a correção de alguma configuração.
6. Relatório Vendas
Ao clicar sobre esta opção, será impresso um relatório com os totalizadores do dia, exibindo a quantidade de Vendas, Peso e Valor para conferência diária.
Resolução de Problemas
Neste documento estão descritos alguns dos problemas que podem ocorrer no aplicativo P-zei, bem como a resolução de cada um.
Caso tenha algum problema, verifique o erro apresentado e localize-o na lista abaixo. Veja a solução recomendada, e siga os passos.
Se não localizar o problema enfrentado nas opções abaixo, entre em contato com o suporte e solicite auxilio.
Porta COM não encontrada
Esta mensagem indica que a porta de comunicação com a balança está configurada incorretamente, ou então, que o cabo USB não está conectado ao computador.
Solução: Verifique se o cabo está conectado corretamente ao computador. Tente desconectar e conectar novamente, caso o problema persista.
Communication error 5: Acesso negado
Este erro pode ser ocasionado quando a porta de comunicação já está em uso.
Solução: Verifique se existe mais de uma instância da aplicação aberta, ou seja, verifique se o aplicativo de auto atendimento não está aberto mais de uma vez.
Windows 11
No Windows 11 após a primeira pesagem, não é mais retornado o peso. A princípio é algum problema ao abrir/fechar a porta de comunicação.
Solução: Instalar o seguinte driver: Driver USB CH340 - Windows 11.
(Realizado o download pelo link.)
O aplicativo não pode ser iniciado. Contate o fornecedor do aplicativo.
Aparentemente este problema ocorre devido a arquivos da aplicação que foram corrompidos, e causa erro ao iniciar.
Solução: Desinstalar o aplicativo e instalar novamente. A desinstalação é realizada pelo Painel de Controle > Desinstalar um programa. Localize o Pzei, clique em desinstalar.
Se o processo de remoção não funcionar, será necessário remover a pasta dos arquivos manualmente. Para isso abra o Executar do windows (win + R) e digite %UserProfile%\AppData\Local\Apps\2.0. Apague todas as pastas, e após isso tente realizar a desinstalação novamente. O próximo passo será reinstalar o aplicativo novamente (instalação do Pzei).
Ao abrir a tela de Auto Atendimento, a porta de comunicação com a Balança é ativada, e irá iniciar o monitoramento da balança, realizando a leitura do peso até que identifique um peso sobre ela.
Caso o cabo que faz a ligação do computador com a balança seja removido, um dos erros listados acima será exibido.
Será necessário Fechar a tela de Auto Atendimento, e reabri-la novamente, para que a comunicação com a balança seja ativada.
Ativação de Logs
Existem alguns tipos de log que podem ser ativados para auxiliar na analise de problemas ocorridos no pzei.
Log Pzei
Este log registra a Data e Hora da:
- Abertura e fechamento do aplicativo pzei;
- Abertura e fechamento da tela de pesagem;
- Histórico dos Pesos lidos.
-> Para habilitar este log, no aplicativo Pzei, acesse a tela de Configurações, e na aba Gerais selecione a opção Habilitar gravação de Log. Após isso clique em Salvar alterações.
Os arquivos serão salvos no caminho: C:\Users\NomeUsuario\AppData\Local\tryideas\pzei\LogACBR_data.log
Log ACBR Balança
Log do ACBR com o histórico dos pesos lidos.
-> Para habilitar este log, no aplicativo Pzei, acesse a tela de Configurações, e na aba Gerais selecione a opção Habilitar gravação de Log. Após isso clique em Salvar alterações.
Os arquivos serão salvos no caminho: C:\Users\NomeUsuario\AppData\Local\tryideas\pzei
Log ACBR
Log genérico do ACBR, que poderá registrar erros ou problemas diversos.
-> Para habilitar o log, localize o arquivo ACBrLib.ini na pasta onde o Pzei está sendo executado. Na propriedade LogNivel, informe o valor 4, para gerar o log mais completo.
Os arquivos serão salvos na propria pasta, caso não defina um caminho na propriedade LogPath.
Balança Prix 3 Fit
Para acessar as configurações da balança, teclar no botão "modo", digitar a senha 2011, clicar em "modo" novamente.
Após isso, clique na tecla "entra" até chegar nas configurações abaixo.
C14: Prt2
C15: Velocidade: 9600
C16: L
Para alterar alguma configuração, tecle no botão "Liga/Desliga", e após finalizar, clique em "entra" até sair do modo de programação.
Balança Urano
A balança Urano com cabo adaptador serial TTL/USB (RJ45 - USB) necessita de instalação de driver no PC para comunicação. Segue o link para download: Driver Balança Urano