Pular para o conteúdo

Para quem tem loja

O app do computador (iLarika Negócios)

  • App iLarika Negócios (Windows)
  • PainelConfiguraçõesEste computador
  • Painelfoto da pessoa (menu "Este computador")

O app do computador abre o painel como um programa: maximizado, sem barra de menu, e imprime as comandas sozinho. Aqui está onde fica cada coisa.

Antes de começar

Instale o app pela página de downloads (Configurações › Aplicativos). Ele já vem apontando para o servidor da iLarika (app.ilarika.com.br): é só abrir e entrar com o seu e-mail e senha.

Passo a passo

  1. Abra o iLarika Negócios. Ele abre maximizado, já na tela de entrar.
  2. Para usar a tela cheia, aperte F11. Para sair, aperte F11 de novo ou Esc. Se houver uma janelinha aberta no painel, o primeiro Esc fecha a janelinha e o segundo sai da tela cheia.
  3. Clique na sua foto (no topo à direita ou no pé da lateral) para abrir o menu Este computador: tela cheia, recarregar, limpar cache, trocar servidor, atualizações e sair do aplicativo.
  4. Em Configurações › Este computador ficam as mesmas opções, a versão instalada e a lista de atalhos.

Atalhos de teclado

Teclas O que faz
F11 Tela cheia
Esc Sai da tela cheia
F5 ou Ctrl+R Recarrega o painel
Ctrl+Shift+R Limpa o cache e recarrega
Ctrl+Shift+S Trocar servidor
Ctrl+Q Sair do aplicativo

Atualizações

O app procura versão nova sozinho. Quando acha:

  1. Baixa em segundo plano. Um aviso pequeno no canto da tela mostra a porcentagem; dá para continuar trabalhando normalmente.
  2. Pronto o download, o aviso mostra Instalar agora. O app fecha, instala e abre de novo sozinho em poucos segundos.
  3. Se você não clicar, ela instala sozinha quando o balcão ficar parado (veja abaixo) ou quando o app for fechado, o que vier primeiro.

Para procurar na hora: Configurações › Este computador › Verificar agora.

Instala sozinha com o balcão parado (versão 0.3.12 em diante)

Com a versão nova baixada, o app confere a cada minuto se está tudo parado há 10 minutos:

  • ninguém mexeu no teclado nem no mouse do computador;
  • o painel não recebeu nada: mensagem do WhatsApp, pedido novo, pedido mudando de etapa, chamado de mesa, comanda para imprimir;
  • ninguém digitou em nenhum campo do painel;
  • nenhuma comanda está sendo impressa.

Tudo parado, aparece no canto da tela por 30 segundos: “Atualizando o iLarika para a versão X em 30 segundos…”, com Agora e Depois.

  • Agora reinicia na hora.
  • Depois, mexer no mouse ou no teclado, ou qualquer movimento no painel cancela o aviso, e os 10 minutos começam a contar de novo.
  • Comanda imprimindo segura o reinício até ela terminar.

O app fecha, instala e abre de novo sozinho, na mesma tela e com a mesma pessoa conectada (não precisa entrar de novo). Na prática a versão nova entra num intervalo de movimento ou de madrugada, com o computador ligado.

Para as lojas que estão na 0.3.11 ou antes: essas versões ainda só instalam ao fechar. Feche e abra o app uma vez (ou clique em Instalar agora) para chegar na 0.3.12; dali em diante ele se atualiza sozinho.

Desligar (só suporte): no arquivo preferencias.json da pasta de dados do app (em %APPDATA%, a pasta do iLarika Negócios), coloque "reinicioAutomatico": false e abra o app de novo. A versão nova volta a entrar só ao fechar o app ou no Instalar agora.

O painel novo entra sozinho (versão 0.3.13 em diante)

O painel (as telas, os botões) vem do servidor e muda a cada atualização da iLarika, sem precisar de app novo. Antes, com o app aberto dias seguidos, a loja só via o painel novo apertando F5 ou fechando o app. Agora:

  1. A cada 5 minutos (e ao voltar para a janela do app ou quando a internet volta) o app pergunta ao servidor se saiu painel novo.
  2. Saiu: ele espera o balcão ficar parado, com as mesmas regras de cima (10 minutos sem teclado/mouse, sem nada chegando no painel, ninguém digitando, nenhuma comanda imprimindo) e, além disso, nenhuma janelinha aberta e nenhum pedido sendo montado no painel.
  3. Aparece no canto por 30 segundos: “Atualizando o painel em 30 segundos…”, com Agora e Depois (mexer no mouse também adia).
  4. Só a tela recarrega: o app não fecha, a pessoa continua conectada, as impressoras continuam imprimindo e o painel volta para a mesma tela.

Se o balcão passa 2 horas sem parar com o painel novo esperando, aparece uma faixa discreta Nova versão do painel — Atualizar agora. Ela não força nada: atualiza quando você tocar (ou sozinha, no próximo intervalo parado).

Se o app tiver uma versão nova dele mesmo para instalar, ela tem a vez: o reinício já abre o painel novo. Com "reinicioAutomatico": false (abaixo) o painel também não recarrega sozinho: fica só a faixa Atualizar agora.

Servidor próprio que não publica o pacote web do painel: nada muda, F5 continua trazendo o painel novo.

Como o app percebe que a comanda não saiu (versão 0.3.17 em diante)

Numa impressora instalada no Windows (USB, como a MP-100S TH), o Windows aceita a comanda mesmo quando ela não tem como sair: a impressora está marcada como “Usar impressora offline”, a fila está pausada, falta papel, a tampa está aberta, ou o cabo USB foi para outra porta e o Windows criou uma fila nova, “MP-100S TH (Cópia 1)”. A comanda fica parada na fila do Windows e nada sai. Até a 0.3.16 o app tomava esse “aceitei” como “imprimiu”.

Agora o app pergunta ao próprio Windows:

  1. Antes de mandar. Se a fila está offline, pausada ou não existe mais, a comanda nem é enviada. O mesmo vale para a impressora com erro ou desconectada (é assim que o Windows mostra a USB sem cabo), mas só depois de duas leituras seguidas com 10 segundos ou mais entre elas: um erro de um instante não segura comanda nenhuma. Ela volta para a fila do iLarika com o motivo e o painel mostra a faixa “A comanda … não imprimiu” (com o botão de mandar para outra impressora). Quando a impressora volta, ela sai sozinha.
  2. Depois de mandar. O app acompanha a comanda na fila do Windows por até 45 segundos. Se ela some da fila e a impressora não acusa problema, está impressa. Se ela fica parada, dá erro, ou a impressora fica offline/sem papel, a comanda vira incerta com o motivo, por exemplo “A impressora MP-100S TH está offline no Windows. A comanda não saiu: confira o papel antes de reimprimir.” Na faixa, Imprimir de novo ou Já saiu, tudo certo. Ela não é reimpressa sozinha: a comanda continua na fila do Windows e pode sair quando a impressora voltar, e aí sairiam duas.
  3. A cada minuto. O app conta ao painel como está cada impressora. Uma impressora com problema aparece numa faixa amarela, “A impressora MP-100S TH está offline no Windows.”, com o atalho Ver impressoras, e em Configurações › Impressão como Atenção ou Offline. Se a fila sumiu e existe a “(Cópia 1)”, a mensagem diz isso: volte o cabo para a porta de antes ou escolha a fila “(Cópia 1)” na impressora do iLarika.

Se o Windows não responde à consulta (PowerShell bloqueado, computador muito lento), o app imprime como antes e só registra no log. A consulta nunca impede uma comanda de sair. O tempo de espera pode ser mudado com a variável de ambiente ILARIKA_CONFERENCIA_FILA_MS (em milissegundos, mínimo 5000).

O app reconhece a comanda na fila do Windows pelo número do trabalho: ele anota o que já estava na fila logo antes de mandar, e o trabalho novo que aparece é o da comanda. Ele também dá à comanda o título iLarika #<número> <código>, mas o Windows pode mostrar outro nome em Ver o que está sendo impresso, então o app não depende do nome.

A lista de impressoras deste computador (versão 0.3.18 em diante)

Em Configurações › Impressão › Filas deste computador, o app agora pergunta ao Windows a porta, o driver e qual é a impressora padrão de cada fila. Com isso:

  • as filas que não imprimem em papel (PDF, XPS, OneNote, Fax, AnyDesk…) ficam escondidas mesmo que tenham sido renomeadas; Mostrar todas traz de volta;
  • a etiqueta padrão do Windows volta a aparecer na impressora certa;
  • a impressora já cadastrada aparece como Já configurada ✓, sem o botão Cadastrar;
  • o Imprimir teste das impressoras cadastradas é impresso por este app (versões antigas deixam o teste esperando, com o aviso para atualizar).

O passo a passo completo está em Configurar e testar as impressoras.

Notificações do Windows

Comanda que não imprimiu e WhatsApp desconectado aparecem também como notificação do Windows. Para tocar o som do Windows junto, ligue Som nas notificações em Configurações › Este computador › Notificações do Windows.

Trocar servidor

Só para quem tem servidor próprio. Em Configurações › Este computador › Trocar servidor… (ou Ctrl+Shift+S, ou o link Trocar servidor na tela de entrar), digite o endereço e toque em Conectar. Usar o padrão volta para app.ilarika.com.br. Voltar sem trocar retorna ao painel.

Perguntas comuns

Cadê o menu “Arquivo / Exibir / Ajuda”? Saiu para o app ter cara de programa. Tudo o que estava lá agora fica no menu da sua foto, em Configurações › Este computador e nos atalhos acima.

O painel mostra uma versão antiga. Da versão 0.3.13 em diante ele se atualiza sozinho (veja O painel novo entra sozinho). Para não esperar, use Recarregar (F5) ou Limpar cache e recarregar (Ctrl+Shift+R). Você continua conectado.

Se der errado

  • “Não foi possível conectar”: o app não alcançou o servidor. Confira a internet e toque em Conectar de novo; se a loja usa servidor próprio, confira o endereço.
  • “Não deu para verificar a atualização”: a mensagem mostra o motivo. Se persistir, baixe o instalador mais novo em github.com/ilarika-org/ilarika-releases/releases/latest.
  • “A impressora … está offline no Windows”: no Windows, abra Configurações › Bluetooth e dispositivos › Impressoras, clique na impressora, em Abrir fila de impressão › menu Impressora, e desmarque Usar impressora offline e Pausar impressão. Confira o cabo e se a impressora está ligada e com papel.
  • “…mas existe a fila “… (Cópia 1)”“: o cabo USB foi para outra porta. Volte para a porta de antes ou, em Configurações › Impressão, remova a impressora antiga em Impressoras cadastradas e cadastre a “(Cópia 1)” (veja Configurar e testar as impressoras).
  • Persistindo, abra um chamado em Suporte no painel.