Yvera
Manuais / Manual do Painel Maquininha

Manual do Sistema Yvera - Painel Maquininha

Manual do Operador - Painel Maquininha (terminais POS e tablets)

Este manual cobre o Painel Maquininha da Yvera — o aplicativo usado nas maquininhas (terminais POS) e tablets do salão. Para o painel web completo (computador), consulte o Manual do Sistema Web.

Sumário

  1. Sobre o Aplicativo
  2. Login
  3. Tela Inicial
  4. Mesas
  5. Balcão
  6. Cardápio
  7. Pagamentos
  8. Meus Itens (Garçom)
  9. Tela da Cozinha (KDS)
  10. Registro de Ponto
  11. Reservas e Eventos
  12. Check-in de Eventos
  13. Leitor de QR Code
  14. Emissão de NFCe
  15. Modo Contingência
  16. Contingência — pendências
  17. Configurações do App
  18. Pagamento com Cartão
  19. Impressão de Recibos
  20. Dicas e Solução de Problemas

1. Sobre o Aplicativo

O Painel Maquininha e a versão móvel do sistema de gestão do restaurante — o aplicativo Android da Yvera. Ele funciona em maquininhas com Android (terminais POS) e em tablets, permitindo que garçons, caixas e cozinheiros realizem suas atividades sem precisar de um computador.

Ao longo deste manual, "o aplicativo" e "o app" se referem sempre ao Painel Maquininha. O painel do computador é chamado de painel web.

Principais capacidades

  • Gerenciar mesas e pedidos
  • Processar pagamentos (dinheiro, cartão, PIX)
  • Visualizar pedidos na cozinha (KDS)
  • Emitir NFCe (nota fiscal ao consumidor)
  • Registrar o ponto dos funcionários por reconhecimento facial
  • Escanear QR codes de vouchers
  • Fazer check-in de eventos
  • Seguir vendendo quando o servidor Yvera cai (Modo Contingência, seção 15)

Terminais compatíveis

O app é distribuído em versões específicas por fabricante e adquirente — cada maquininha recebe a versão correspondente ao seu equipamento. Peça ao suporte a versão certa para o seu terminal.

Adquirente Terminais atendidos
Stone Sunmi (P2, P2 Pro, D2 e a linha P2-A11), Positivo (L3, L4, Smart L400), TecToy (T8), Gertec (D195), Ingenico (A8, Move 5000)
Getnet Getnet APÓS e equivalentes (TecToy/Sunmi P2-P3, Gertec)
Cielo Cielo Smart (ex-LIO: DX8000, L300 e similares)
Rede Smart Rede Positivo L400

Importante: a versão instalada define de qual adquirente o app cobra o cartão. Trocar de adquirente exige instalar a versão correspondente — não é uma configuração dentro do app.

O app também funciona em tablets e celulares Android comuns, porém sem impressora térmica e sem leitor de cartão integrados. Nesses aparelhos os pagamentos em cartão precisam ser registrados manualmente, e a impressão depende de impressora configurada no painel web.

2. Login

Login Normal

  1. Abra o Painel Maquininha
  2. Digite seu usuário e senha — o ícone de olho ao lado do campo (Mostrar senha) confere o que você digitou
  3. Toque em Entrar

A própria tela de login tem o alternador de tema (claro/escuro), então dá para acertar a leitura do visor antes mesmo de entrar. O tema também fica em Configurações (seção 17).

Primeira vez? Caso o app não esteja conectado ao servidor correto, o caminho mais rápido é ler o QR Code que o painel web mostra em Configurações -> Conexão da maquininha — veja "Trocar de Servidor", logo abaixo. Sem câmera disponível, toque no botão de configuração (engrenagem) ao lado do campo de servidor e informe o subdomínio do seu restaurante: é a primeira parte do endereço que aparece nessa mesma tela do painel web — um código de letras e números (algo como q7f2k9m1x4a0b3c8d5e6), não o nome do restaurante.

Trocar de Servidor

Se você trabalha em mais de um restaurante ou precisa mudar o servidor:

Pelo QR Code (o jeito rápido, sem digitar):

  1. No painel web, abra Configurações -> Conexão da maquininha (Manual do Sistema Web, seção 14.6) — a tela mostra o QR Code do restaurante
  2. No POS, na tela de login, toque em Configurar servidor
  3. Toque em Ler QR do servidor e aponte a câmera para o código
  4. Confirme — o aplicativo reinicia a conexão e já abre no login do restaurante certo

Digitando (quando a câmera não estiver disponível):

  1. Na tela de login, toque no ícone de configuração
  2. Altere o subdomínio
  3. Toque em Salvar

O diálogo também tem Restaurar Padrão, que devolve o endereço de fábrica do aplicativo — use quando não souber em que servidor o aparelho ficou.

O QR Code carrega apenas o endereço do restaurante — nenhuma senha e nenhuma credencial. Conectar o aparelho não loga ninguém: cada pessoa continua entrando com o login dela.

Continuar em contingência

Não há uma tela de login separada para a emergência. Você entra sempre pelo mesmo caminho; é o app que percebe que o servidor não respondeu.

Quando a tentativa de entrar falha por falta de resposta do servidor, a tela mostra o aviso, o botão Tentar de novo e — se este aparelho já tiver uma sessão salva — o botão Continuar em contingência como seu nome. Toque nele e o app segue para as telas de sempre, com o que já estava carregado aqui.

A pré-condição é a sessão salva neste aparelho, criada por um login normal anterior com o servidor no ar. Aparelho recém-configurado, ou de onde alguém saiu pelo Sair, não oferece o botão: sem sessão salva, não há como entrar em contingência. O que a contingência libera está na seção 15.

3. Tela Inicial

Após o login, você verá a tela principal com:

Cabeçalho

  • O nome do restaurante com a data e a hora atual (atualizada em tempo real)
  • Uma linha de ocupação — "N mesas ocupadas" — para você saber como está o salão sem abrir o mapa
  • Botão de Sincronização (seta circular) — mostra um número se houver sessões offline pendentes
  • Escanear comprovante — abre o leitor de QR (seção 13)
  • Fale conosco — abre o canal de suporte direto do aparelho
  • Botão de Sair — faz logout do app
Botão Subtítulo Função
Mesas Mesas e sessões Gerenciar mesas do salão
Balcão Pedidos rápidos Pedidos rápidos de balcão
Cardápio Catálogo Navegar no cardápio completo
Pagamento Caixa e cobrança Ver histórico de pagamentos e estornar
Meus Itens Fila pessoal Histórico dos itens que você já serviu
KDS Cozinha Itens prontos, para marcar como servidos
Reservas Eventos e booking Gerenciar reservas de eventos
Check-in Scanner Check-in de convidados
Ponto Registro facial Registrar entrada/saída por reconhecimento facial
Cadastrar Rosto Ponto facial Cadastrar o rosto de um funcionário

Os botões que aparecem dependem da permissão do seu perfil — quem não tem acesso a uma área simplesmente não vê o botão dela.

O aplicativo não tem checklists, relatórios nem cadastro de produtos — essas telas são do painel web.

Se houver pagamentos PIX aguardando confirmação, um aviso "Alertas de PIX pendentes" aparece nesta tela.

4. Mesas

Visualizando as Mesas

  1. Na tela inicial, toque em Mesas
  2. Você verá todas as mesas do restaurante organizadas em grade
  3. Cada mesa mostra seu status por cor — as mesmas cores do painel web:
Cor Significado
Verde Mesa ocupada
Cinza claro Mesa livre (a legenda da tela usa "Disponível", não "Livre")
Azul Mesa reservada
Amarelo Sem consumo há mais que o 1º limite
Amarelo escuro Sem consumo há mais que o 2º limite

As cores são as mesmas no computador, na maquininha e no celular. Verde é sempre mesa ocupada; cinza é sempre mesa livre. Quem olha o mapa no PC e quem olha na maquininha estão vendo a mesma coisa — não há referência a combinar com a equipe.

A tela se chama Mapa operacional e traz, além do total de mesas, o atalho Comandas Individuais.

Quando há mais de um sinal ao mesmo tempo, o pior manda na cor: uma mesa ocupada que passa do tempo sem consumo fica amarela.

Dois avisos de mesa parada aparecem na legenda e mudam a cor da mesa ocupada — são o motivo principal de olhar o mapa:

  • Sem consumo há 1h30+ — a mesa está ocupada e não lança nada há uma hora e meia
  • Sem consumo há 4h+ — o mesmo caso, agravado; cor mais forte

O relógio conta o tempo desde a última mexida na conta (novo item, pagamento parcial, desconto, couvert) — não desde a abertura da mesa. Uma mesa que só está demorando não acende alerta; uma mesa esquecida acende. Mesas já pagas não acendem alerta.

1h30 e 4h são os valores de fábrica. Os dois limites são configuráveis por restaurante no painel web (Configurações -> Informações do Restaurante, seção Atendimento -> "Alertas no mapa de mesas"), e a maquininha usa os mesmos limites — a legenda da tela mostra os valores do seu restaurante.

Esses dois avisos não dizem que a mesa está livre: dizem que ninguém pede nada há tempo demais. Pode ser conta esquecida de fechar, cliente que já foi embora, ou mesa que precisa de atenção.

Se a mesa estiver livre mas houver uma reserva se aproximando, ela aparece com a cor de reservada e o horário da reserva.

Busca e Filtros

  • Use a barra de busca no topo para encontrar uma mesa pelo número
  • Use as abas de área para filtrar por setor (Salão, Varanda, VIP, etc.)
  • Toque no botão Atualizar para recarregar as informações

Abrindo uma Mesa

  1. Toque em uma mesa livre
  2. O app abrirá uma nova sessão de atendimento
  3. Você será levado para a tela de conta da mesa

Se o restaurante tiver ligado a opção "Perguntar o nº de pessoas ao abrir a mesa" (no painel web, em Configurações -> Informações do Restaurante), o app pedirá a quantidade de pessoas antes de abrir. Essa opção vem desligada — quem usa couvert artístico normalmente liga, porque o couvert cobra por pessoa.

Tela da Conta (Bill)

Ao tocar em uma mesa ocupada, você vê a conta completa:

Informações Exibidas

  • Número da mesa e quantidade de clientes
  • Lista de itens com: nome do produto, quantidade, preço unitário, preço total
  • Status de cada item: Pendente, Enviado para Cozinha, Em Preparo, Pronto, Entregue
  • Observações e modificadores de cada item
  • Quem lançou: cada pedido da conta mostra o garçom que o registrou
  • Resumo da conta: Subtotal, taxa de serviço, desconto, gorjeta, total, valor já pago, saldo restante

A tela atualiza automaticamente a cada 30 segundos.

Opções de Visualização

  • Detalhada: Mostra cada item individualmente
  • Consolidada: Agrupa itens iguais

Botões de Ação

Botão Função
Adicionar Pedido Abre a tela para incluir novos itens
Conta Imprime a conta na impressora do terminal
Pagar Vai para a tela de pagamento
Fechar Sessão Finaliza o atendimento da mesa

5. Balcão

O modo balcão é para atendimentos rápidos, sem mesa atribuída.

Fazendo um Pedido no Balcão

  1. Na tela inicial, toque em Balcão
  2. Navegue pelas categorias ou use a busca para encontrar produtos
  3. Toque no produto desejado
  4. Ajuste a quantidade usando os botões + e -
  5. Adicione modificadores se necessário (ex.: "sem gelo", "bem passado")
  6. O item será adicionado ao carrinho

Carrinho de Compras

  • Um botão flutuante no canto da tela mostra a quantidade de itens e o valor total
  • Toque nele para ver o carrinho completo
  • No carrinho você pode:
    • Ver todos os itens
    • Remover itens individuais
    • Adicionar observações
    • Limpar tudo
    • Enviar o pedido

Combos

Se houver combos disponíveis, um botão "Combos" aparecerá na barra de ferramentas. Toque para ver e adicionar combos ao pedido.

Sessões do Balcão

Toque em Sessões para ver todos os pedidos de balcão ativos:

  • Filtre por status: todos, pagos, não pagos, fechados
  • Cada sessão mostra o número, valor total, status e horário
  • Toque em uma sessão para continuar adicionando itens ou pagar

6. Cardápio

Função: Navegar pelo cardápio completo sem criar um pedido.

  1. Na tela inicial, toque em Cardápio
  2. Navegue pelas categorias e veja os produtos disponíveis com preços
  3. Um banner "Modo de Navegação" aparece indicando que você está apenas consultando

Útil para consultar preços e disponibilidade sem estar em uma mesa ou balcão.

7. Pagamentos

Processando um Pagamento

  1. Na tela da conta de uma mesa (ou balcão), toque em Pagar
  2. Você verá o valor total a ser pago
  3. Toque em Adicionar Pagamento
  4. Selecione o método de pagamento:
Método Como funciona
Dinheiro Informe o valor recebido
Cartão de Crédito Insira ou aproxime o cartão no terminal
Cartão de Débito Insira ou aproxime o cartão no terminal
PIX Gera um QR Code para o cliente escanear (ver seção 18)
Voucher Informe o código do voucher
  1. Informe o valor (o sistema sugere o saldo restante)
  2. Confirme o pagamento

Dividindo o Pagamento

Você pode dividir a conta em vários métodos:

  1. Adicione o primeiro pagamento (ex.: R$ 50 em dinheiro)
  2. Adicione o segundo pagamento (ex.: R$ 30 no cartão)
  3. Continue até cobrir o valor total
  4. Toque em Finalizar quando o saldo for zerado

O botão Limpar Tudo permite recomeçar caso você erre.

Pagamento com Cartão (Passo a Passo)

  1. Selecione Crédito ou Débito
  2. O terminal exibirá: "Insira ou aproxime o cartão"
  3. O cliente insere o cartão ou aproxima para pagamento por aproximação
  4. Aguarde a autorização
  5. O app mostrará a bandeira do cartão e os últimos 4 dígitos
  6. Pagamento confirmado!

Pagamento com PIX

  1. Selecione PIX como método
  2. Um QR Code é exibido para o cliente escanear com o celular
  3. O cliente confirma o pagamento no aplicativo do banco
  4. O app detecta a confirmação automaticamente

Dependendo da maquininha, o QR aparece na tela do próprio app Yvera ou na tela do aplicativo da adquirente (ver seção 18). Se um pagamento PIX ficar sem confirmação, ele aparece como alerta de PIX pendente na tela inicial — confira antes de fechar o caixa.

Histórico de Pagamentos

Na tela inicial, toque em Pagamento para ver:

  • Totais do dia: Dinheiro, cartão e PIX
  • Lista de todos os pagamentos com método, valor, horário e detalhes
  • Filtros por método, data e terminal
  • Estorno: Mantenha pressionado um pagamento recente para estornar (requer confirmação)

8. Meus Itens (Garçom)

Função: o histórico dos itens que VOCÊ já serviu — conferência rápida do tipo "levei ou não levei aquele prato?".

  1. Na tela inicial, toque em Meus Itens
  2. A lista mostra os itens servidos por você, com produto, mesa, quantidade e o selo SERVIDO
  3. No topo há três períodos — Última Hora, 6 Horas e 12 Horas. Sem item no período escolhido, a tela diz "Nenhum item servido nas últimas 1h" (ou o período correspondente)

É uma tela de CONSULTA — não há ação nela. A fila do que está pronto para levar às mesas é a tela KDS (seção 9).

9. Tela da Cozinha (KDS)

Função: a fila do que a cozinha já deixou PRONTO, esperando alguém levar à mesa. Não é a tela de preparo.

  1. Na tela inicial, toque em KDS
  2. Cada cartão mostra produto, quantidade, mesa/pedido, observações e há quanto tempo está pronto

Ações

Ação Descrição
Marcar como Servido O item foi entregue ao cliente
Todos Marca o cartão inteiro como servido de uma vez

No app NÃO existem botões "Em Preparação"/"Pronto" — quem prepara usa o KDS do painel web (Manual do Sistema Web, seção 5.1), que é onde se aceita, inicia e marca pronto. E a cor dos cartões indica o ESTADO do item (pronto, cancelado), não urgência por tempo — o tempo aparece como texto.

Filtros

Toque no ícone de filtro para:

  • Filtrar por área de produção (cozinha, grill, bar, etc.)
  • Filtrar por área do restaurante (salão, varanda)
  • O número de filtros ativos aparece como badge no ícone

Uma área só aparece no KDS se estiver configurada como KDS · Tela ou KDS + Impressora no painel web (Produção -> Áreas de Produção). Áreas do tipo Impressora apenas imprimem e não aparecem em nenhuma tela de cozinha.

A tela atualiza automaticamente a cada 30 segundos.

10. Registro de Ponto

O app pode funcionar como relógio de ponto por reconhecimento facial, usando a câmera do terminal. As batidas ficam gravadas no sistema e aparecem no painel web, em Gestão de Pessoas -> Controle de Jornada.

Cadastrar o rosto de um funcionário

Antes da primeira batida, cada funcionário precisa ter o rosto cadastrado uma vez:

  1. Na tela inicial, toque em Cadastrar Rosto
  2. Informe a Matrícula do funcionário
  3. Toque em INICIAR CAPTURA e posicione o rosto na área indicada
  4. Aguarde enquanto o app processa a captura
  5. Ao final, toque em CADASTRAR OUTRO para seguir com o próximo funcionário, ou em CONCLUIR

Na primeira vez, o Android pedirá autorização para usar a câmera — toque em CONCEDER PERMISSÃO.

Bater o ponto

  1. Na tela inicial, toque em Ponto
  2. O funcionário informa a Matrícula e toca em CONTINUAR
  3. Posiciona o rosto na câmera e aguarda a mensagem "Confirmando o rosto..."
  4. O registro e confirmado na tela

Se o rosto não for reconhecido, toque em RECOMEÇAR e tente de novo com melhor iluminação. Para atender uma fila de funcionários em sequência, use PRÓXIMO FUNCIONÁRIO; ao terminar, FECHAR.

O app registra as batidas de entrada e saída. A conferência da jornada, os ajustes e os espelhos ficam no painel web.

11. Reservas e Eventos

Função: Gerenciar reservas vinculadas a eventos do restaurante.

Visualizando Eventos

  1. Na tela inicial, toque em Reservas
  2. Veja a lista de eventos com: nome, data, capacidade e status

Visualizando Reservas de um Evento

  1. Toque em um evento para ver suas reservas
  2. Filtre por status: pendente, confirmada, paga, cancelada
  3. Cada reserva mostra: nome do cliente, contato, valor, quantidade de ingressos, status de pagamento

Criando uma Nova Reserva

O processo segue 4 etapas:

Etapa 1 — Dados do Cliente

  • Nome (obrigatório)
  • E-mail e telefone (opcionais)
  • Número de convidados

Etapa 2 — Seleção de Ingressos

  • Veja os ingressos/produtos disponíveis para o evento
  • Selecione a quantidade de cada tipo
  • O valor total e calculado automaticamente

Etapa 3 — Pagamento

  • Valor total a pagar
  • Selecione o método de pagamento
  • Aceita múltiplos métodos (dividir)
  • Pagamento com cartão ou PIX pelo próprio terminal

Etapa 4 — Revisão e Confirmação

  • Resumo de todas as informações
  • Confirme para finalizar a reserva
  • Tela de confirmação com o ID da reserva

12. Check-in de Eventos

Função: Registrar a chegada de convidados em eventos.

  1. Na tela inicial, toque em Check-in
  2. Use o leitor de QR Code para escanear o voucher/ingresso do convidado
  3. O app verifica o código e registra o check-in
  4. Você vê os detalhes do ingresso e a confirmação

O sistema impede check-ins duplicados e mostra alerta caso o voucher já tenha sido utilizado.

13. Leitor de QR Code

Função: Escanear QR Codes de vouchers para marcar itens como servidos.

  1. Na tela inicial, toque no botão de QR Code (no cabeçalho)
  2. Aponte a câmera para o QR Code do voucher
  3. O app lerá o código automaticamente
  4. Se válido:
    • Mostra os detalhes do item (produto, pedido, mesa)
    • Marca o item como servido
  5. Se inválido ou já utilizado:
    • Mostra mensagem de erro apropriada

Útil para controle de entrega de pedidos em eventos ou sistemas com vouchers impressos.

14. Emissão de NFCe

A emissão de NFCe (Nota Fiscal de Consumidor Eletrônica) pode ser feita ao finalizar um pagamento.

Como Emitir

  1. Após processar o pagamento, uma opção de NFCe aparecerá
  2. Preencha os dados do cliente (opcionais):
    • CPF ou CNPJ
    • Nome
    • E-mail
    • Telefone
  3. Escolha a ação:
Opção Descrição
Apenas Emitir Gera a nota fiscal sem imprimir
Imprimir Emite e imprime o cupom fiscal no terminal
E-mail Emite e envia por e-mail ao cliente
Visualizar Emite e mostra na tela
  1. Aguarde o processamento (o app mostra um indicador de carregamento)
  2. Nota emitida!

O CPF do cliente é opcional na NFCe. Preencha apenas se o cliente solicitar.

15. Modo Contingência

O Modo Contingência é o app trabalhando sem o servidor Yvera. Ele liga sozinho quando o servidor para de responder, e sai sozinho quando ele volta — não há botão para ligá-lo.

Se você conhecia isto como modo offline ou modo de emergência, é a mesma coisa: o nome mudou para Modo Contingência.

A faixa no topo

Depois de entrar, uma faixa acima de todas as telas diz o que está acontecendo:

  • MODO CONTINGÊNCIA (vermelha) — o servidor Yvera não está respondendo
  • SEM INTERNET NO TERMINAL (vermelha) — quem está fora é o Wi-Fi/chip deste aparelho; nesse caso cartão e PIX também não passam
  • CONEXÃO INSTÁVEL / RECUPERANDO CONEXÃO (âmbar) — uma chamada falhou, ou o servidor respondeu e o app está confirmando antes de sair da contingência

Toque na faixa para abrir ou fechar a explicação. Quando há coisa esperando para subir, ela mostra a contagem — e, se o mais antigo já passou de 5 minutos, há quanto tempo.

"Assumo o risco"

A contingência nasce em só leitura: você vê o cardápio, as mesas e as contas que este aparelho já tinha carregado, e imprime a conta, mas nada é gravado. Para lançar e cobrar, ligue o interruptor "Assumo o risco", na própria faixa (o rótulo ao lado dele mostra em qual dos dois estados você está: Assumo o risco ou Só leitura).

Não lance a mesma conta em mais de um terminal. Sem servidor, um aparelho não enxerga o que o outro registrou.

O que funciona sem servidor

Funcionalidade Disponível?
Pedidos de balcão e de mesa Sim, com "Assumo o risco" ligado
Consulta do cardápio, mesas e contas Sim, com o que o aparelho já tinha carregado
Pagamento com cartão Sim (a maquininha processa direto com a adquirente)
Pagamento com PIX Sim (a maquininha processa direto com a adquirente)
Pagamento em dinheiro Sim (se habilitado)
Imprimir a conta Sim
Estorno Não
Registro de ponto Não
Relatórios Não
Emissão de NFCe Não

Importante

  • Tudo o que você lança e cobra fica guardado neste aparelho e sobe quando a conexão voltar; acompanhe em Contingência — pendências (seção 16)
  • O pagamento com cartão continua funcionando porque a maquininha fala direto com a adquirente — mas ela precisa da própria conexão (chip de dados ou Wi-Fi). Se a internet caiu por completo, o cartão também para.
  • Estorno, fechamento de mês e nota fiscal só saem com o servidor no ar

16. Contingência — pendências

O que você fez sem servidor fica guardado no aparelho até subir. Quando a conexão volta, o app envia sozinho — esta tela é onde você confere e, se quiser, empurra na mão.

Como abrir

  1. Na tela inicial, o botão de sincronização (seta circular) fica no cabeçalho
  2. Se houver sessões esperando, um número aparece no botão
  3. Toque nele para abrir Contingência — pendências

O que a tela mostra

  • Status da conexão
  • Pedidos Pendentes: quantas sessões estão aguardando
  • Resumo da Sincronização: sessões, itens e valor total do que vai subir
  • Lista de sessões, uma a uma, com mesa, horário, quantidade de itens e valor

Toque em uma sessão para expandir e ver os detalhes: cliente, itens com valores, formas de pagamento, modificadores e observações.

Enviando

  • Toque em Enviar agora para subir tudo o que está pendente
  • Se o servidor recusar alguma sessão, o motivo aparece na linha dela, nas palavras do servidor (o mais comum é "Nenhuma sessão de caixa aberta"). Resolva o que a mensagem pede e toque em Enviar agora de novo
  • Sem permissão para sincronizar, o botão fica travado e a tela explica — peça ao gestor

Dica: envie o quanto antes depois que a conexão voltar, para manter os relatórios e o controle financeiro em dia.

E a nota fiscal? A NFC-e não é emitida em contingência. Depois que a venda sincroniza, ela aparece no painel web em Pedidos -> Gerenciamento de Sessões, e a nota é emitida de lá (ação Emitir NFC-e — Manual do Sistema Web, seção 3.7).

17. Configurações do App

Tema (Claro / Escuro)

  • Na tela de login ou na tela inicial, toque no ícone de tema
  • Alterne entre o tema claro e escuro
  • A preferência é salva e mantida entre reinicializações do app

Servidor

  • Na tela de login, toque no ícone de configuração
  • Altere o subdomínio do servidor
  • Toque em Salvar

Sessão de Caixa

Antes de processar pagamentos, certifique-se de que há uma sessão de caixa aberta. Se não houver, o app exibirá um aviso:

"Caixa Fechado — Abra o caixa antes de processar pagamentos"

A abertura e o fechamento de caixa são gerenciados pelo painel web.

18. Pagamento com Cartão

O app cobra cartão e PIX direto na maquininha. Qual adquirente atende depende da versão instalada no terminal (ver seção 1): Stone, Getnet, Cielo ou Rede.

Cartões Aceitos

As bandeiras aceitas (Visa, Mastercard, Elo e outras) são as do credenciamento do restaurante junto à adquirente — não é uma configuração do app. Consulte seu contrato.

Tipos de Pagamento

  • Crédito: A vista ou parcelado
  • Débito: Pagamento imediato
  • PIX: Via QR Code

Fluxo de Pagamento com Cartão

  1. Selecione o método (crédito ou débito) na tela de pagamento
  2. Informe o valor
  3. O terminal mostrará: "Insira ou aproxime o cartão"
  4. O cliente insere o chip ou aproxima o cartão
  5. Se crédito, pode ser solicitada a opção de parcelamento
  6. Aguarde a autorização (alguns segundos)
  7. O app mostra a confirmação com a bandeira e últimos 4 dígitos do cartão

Diferenças entre as adquirentes

O comportamento muda um pouco conforme a maquininha. O que você percebe na prática:

Comportamento Stone Getnet Cielo Rede
Onde aparece a tela da cobrança No próprio app Yvera No app da adquirente No app da adquirente No app da adquirente
Onde aparece o QR do PIX Na tela do app Yvera Na tela da adquirente Na tela da adquirente Na tela da adquirente
Cancelar a cobrança pelo app, no meio Sim Não Não Não
Prazo de estorno pelo terminal Sem limite de mesmo dia Só no mesmo dia da venda Definido pela adquirente Definido pela adquirente

Nas versões Getnet, Cielo e Rede, o app abre o aplicativo da adquirente para cobrar e recebe o resultado de volta. Não feche esse aplicativo no meio da cobrança — aguarde a tela voltar sozinha para o app Yvera.

Estorno de Cartão

Para estornar um pagamento com cartão:

  1. Acesse Pagamento na tela inicial
  2. Encontre o pagamento na lista
  3. Mantenha pressionado para abrir as opções
  4. Selecione Estornar
  5. O terminal processará o cancelamento junto à adquirente

Os prazos de estorno são definidos pela adquirente, não pela Yvera. Na Getnet, o estorno pelo terminal só funciona no mesmo dia da venda; fora disso, trate direto com a adquirente.

19. Impressão de Recibos

Nas maquininhas com impressora térmica embutida, o app imprime direto no terminal.

Tipos de Impressão

Tipo Quando
Conta da mesa Ao tocar em "Conta" na tela da mesa
Comprovante de pagamento Após processar um pagamento
Cupom fiscal (NFCe) Ao emitir NFCe com opção "Imprimir"
Ticket de pedido Enviado automaticamente para a impressora da cozinha

Onde sai cada impressão

  • Impressora embutida da maquininha: conta, comprovante e cupom fiscal, quando o terminal tem impressora (a maioria dos POS tem; tablets e celulares não).
  • Impressoras da cozinha e do caixa: são as cadastradas no painel web e atendidas pelo aplicativo de impressão BRS instalado no computador do restaurante. O Painel Maquininha não fala direto com elas — ele envia o pedido, e a impressão sai por la.

A reimpressão do comprovante da adquirente é limitada pelo terminal: em alguns modelos só é possível reimprimir o último comprovante.

20. Dicas e Solução de Problemas

Boas Práticas

  • Envie as pendências assim que o servidor voltar — não termine o turno com sessões esperando (seção 16)
  • Verifique o caixa antes de começar a processar pagamentos
  • Confira os alertas de PIX pendente antes de fechar o turno
  • Atualize a tela se as informações parecerem desatualizadas (botão de atualizar)
  • Carregue o terminal — mantenha a bateria acima de 20% durante o turno

Problemas Comuns

Problema Solução
App não conecta ao servidor Verifique a internet e o subdomínio nas configurações
"Caixa Fechado" ao pagar Abra uma sessão de caixa pelo painel web
Cartão não reconhecido Tente inserir novamente; limpe o leitor de chip
A tela travou no app da adquirente Conclua ou cancele por la — nas versões Getnet, Cielo e Rede a Yvera não consegue abortar a cobrança de fora
PIX pago mas não confirmou Veja os alertas de PIX pendente na tela inicial antes de cobrar de novo
QR Code não lido Limpe a câmera; garanta boa iluminação
Rosto não reconhecido no ponto Toque em RECOMEÇAR, melhore a iluminação e evite contraluz
Funcionário sem cadastro de rosto Use "Cadastrar Rosto" na tela inicial antes da primeira batida
Não aparece "Continuar em contingência" Este aparelho não tem sessão salva. É preciso ter entrado pelo menos uma vez com o servidor no ar — e não ter usado o Sair
Pagamento com cartão falha A maquininha precisa da própria conexão para autorizar — verifique o chip de dados ou o Wi-Fi
Impressão não funciona Verifique se há papel na impressora térmica
App travou Feche e reabra o app; se persistir, reinicie o terminal
Dados desatualizados Toque em Atualizar ou saia e entre novamente
Uma sessão não sobe O motivo aparece na linha dela em Contingência — pendências; resolva o que ele diz e toque em Enviar agora

Cuidados de Segurança

  • Não compartilhe seu login — cada funcionário deve ter seu próprio usuário
  • Faça logout ao entregar o terminal para outra pessoa
  • Não deixe o terminal desbloqueado sem supervisão
  • Em caso de perda ou roubo do terminal, comunique imediatamente ao administrador

Manual do Sistema Yvera - Painel Maquininha Em caso de dúvidas, entre em contato com o suporte técnico.