Ir para o conteúdo
clabor Manual do ERPia

Usar o teclado e os atalhos do PDV#

Esta página é a referência de teclado da frente de caixa: o que cada tecla de função faz de fábrica, o que é fixo e não remapeável, como o servidor pode trocar as teclas e como operar sem tirar a mão do teclado. É para o operador do balcão e para quem configura o terminal.

Antes de começar

  • Este guia vale para a pele Mercado (Windows, teclado físico). No Android o PDV é sempre Touch, com teclado desenhado na tela — as teclas de função ali não existem.
  • Confirme se a loja remapeou os atalhos. Se o parâmetro pdv.atalhos da loja tiver uma lista, ela substitui o mapeamento de fábrica inteiro; o que não estiver na lista deixa de existir.

Passo a passo#

AAprender as teclas fixas (não remapeáveis)#

Estas teclas não passam pelo remapeamento — são navegação e edição do cupom:

TeclaO que faz
↑ / ↓seleciona o item anterior / próximo. A resposta é Item N selecionado.
+ ou =aumenta a quantidade do item selecionado em 1
−diminui a quantidade do item selecionado em 1
Deleteremove o item selecionado
Enterno campo de busca, lança o que foi digitado; é também o Enter que o leitor físico manda ao terminar o bipe
Escfecha/cancela o diálogo do topo, como se você tocasse fora dele

Sem item selecionado, +/− respondem Nao ha item para alterar. e Delete responde Nao ha item para cancelar.

BUsar as teclas de função de fábrica#

TeclaRótulo de fábricaO que faz
F1Consultar precoconsulta rápida de preço, sem lançar item
F2Abrir caixaabre o diálogo Abrir turno do caixa (operador, PIN e fundo de troco)
F3Itemabre Ajuste do item para o item selecionado
F4Subtotalabre Ajuste do subtotal (desconto e acréscimo da venda)
F5CPFabre o diálogo de CPF/CNPJ e observação da venda
F6Digitar produtodevolve o foco ao campo de busca, sem lançar nada
F7Cancelarcancela a venda em andamento, com confirmação
F8Sangriaregistra retirada de numerário
F9Sair operadorencerra o turno do operador, com contagem e malote
F10Receberabre o diálogo de pagamento
F11Fechar caixaencerra a jornada do caixa, com conferência cega
F12Cartaoabre o pagamento já na forma Crédito

Três detalhes que evitam erro de operação:

  • F9 e F11 são ciclos diferentes. F9 encerra o turno do operador e gera o malote; F11 encerra a jornada. Veja Abrir e fechar o caixa.
  • F6 não lança item. Ele só põe o cursor de volta no campo de busca — útil quando você clicou em outro lugar sem querer.
  • Não existe tecla de fábrica para suprimento. O suprimento vive no menu (Suprimento) e pode ganhar uma tecla se a loja remapear.

CUsar as teclas dentro dos diálogos#

Dentro do diálogo de pagamento as teclas de função têm outro significado — elas escolhem a forma:

TeclaForma
F1Dinheiro
F2Pix
F3Crédito
F4Débito
Esccancela a liquidação e volta para a venda, sem perder os itens

DAbrir o menu Outras funções pelo teclado#

  1. Aperte a tecla Mais operações do teclado programável de PDV — ela chega ao sistema como Scroll Lock.
  2. Em teclado comum, use Alt+M.
  3. Navegue com Tab e setas; Esc fecha o menu e devolve o foco ao campo de busca.

O botão na barra inferior se chama MENU / Mais operacoes, e o painel aberto tem o título Outras funções · MENU / Alt+M. É ali que vive o que não tem tecla própria: Sangria, Suprimento, Transações do TEF, Consultar meu turno, Pausar e bloquear, Encerrar meu turno (F9), Encerrar com gerente (abandono), 2ª via do último malote, Fechar Caixa Geral, Comprovantes, Impressora simulada, Periféricos, Status operacional, Histórico local, modo treinamento, Desconto / acrescimo, Cliente / observacao, Segurar venda, Limpar cupom e Recuperar venda (n).

EEntender o remapeamento pelo servidor#

  1. Na retaguarda, o parâmetro pdv.atalhos (escopo frente_loja) guarda uma lista em que cada item associa uma tecla a uma ação, e opcionalmente a um parâmetro.
  2. Lista vazia = mapeamento de fábrica. É o padrão do parâmetro.
  3. Com uma lista preenchida, somente as teclas listadas têm ação.
  4. O PDV aceita lista parcial: se a loja mandar só F10 e F12, apenas esses dois botões aparecem na barra de atalhos — os outros somem, sem aviso.
  5. A ação nenhuma desliga a tecla: o botão não é desenhado e a tecla não faz nada.
  6. A ação produto com o campo parametro apontando um código transforma a tecla em lançamento direto daquele produto.

O rótulo do botão na barra acompanha a ação configurada, não a tecla: se F12 for remapeado de pagamento_cartao para outra ação, o texto muda junto. Também é possível mandar um rotulo próprio.

FOperar sem mouse#

  1. Comece pelo login: o foco nasce no campo de código do operador.
  2. Autenticado, o foco vai sozinho para o campo de busca — você já pode bipar o primeiro item.
  3. Depois de cada lançamento o foco volta ao campo de busca, inclusive quando o produto não foi encontrado (é justamente a hora de bipar de novo).
  4. Em diálogos: Enter avança/confirma, Esc volta/cancela, Tab percorre os campos e as setas navegam em listas.
  5. Ao concluir ou cancelar um fluxo, o foco volta ao próximo campo operacional correto.

O foco não é roubado quando: existe diálogo aberto por cima, o campo já está focado, ou não há operador ativo (aí o foco pertence ao login, e roubá-lo impediria o caixa de entrar pelo teclado).

Campos e o que significam#

A tabela abaixo traz o identificador real de cada ação, como ele chega no parâmetro pdv.atalhos. Use estes nomes ao configurar a retaguarda — um nome errado cai na mensagem Atalho F<n>: acao "<nome>" nao disponivel.

Ação (acao)Tecla de fábricaO que executa
consultar_precoF1consulta de preço
abrir_caixaF2abertura da jornada com turno
ajustar_itemF3ajuste do item selecionado
ajustar_subtotalF4desconto e acréscimo da venda
cpf_notaF5CPF/CNPJ e observação
focar_produtoF6foco no campo de busca
cancelar_vendaF7cancelamento da venda em andamento
sangriaF8retirada de numerário
sair_operadorF9encerramento do turno
pagamentoF10diálogo de pagamento
fechar_caixaF11encerramento da jornada
pagamento_cartaoF12pagamento já em Crédito
suprimento— (só por remapeamento)reforço de numerário
produto_rapido—lança o produto de código 000001, se existir
produto—lança o produto do código em parametro
nenhuma—desliga a tecla

Resultado esperado#

  • Cada tecla de função com ação configurada aparece como um "key-cap" clicável na barra inferior, com o rótulo da ação.
  • Clicar no key-cap faz exatamente o que apertar a tecla faria — não existe ação paralela no botão.
  • Teclas sem ação não aparecem na barra e não fazem nada.
  • Após cada lançamento, o cursor volta ao campo de busca.

Se algo der errado#

SintomaCausa provávelO que fazer
Uma tecla que existia sumiu da barraa loja publicou uma lista parcial em pdv.atalhos sem essa teclapeça a lista completa na retaguarda, ou publique a lista vazia para voltar ao padrão de fábrica
Atalho F<n>: acao "<nome>" nao disponivel.a lista traz um identificador de ação que o PDV não conhececorrija o nome da ação na retaguarda usando a tabela acima
A tecla tem rótulo, mas não faz nadaação ausente ou igual a nenhumaconfira o item da tecla na lista
A tecla faz outra coisa que não o rótulo sugereo rotulo foi fixado à mão na listaremova o rotulo para o texto acompanhar a ação
As setas e o +/− não respondemnenhum item selecionado no cupomuse ↑ ou ↓ para selecionar um item
O bipe não entra no cupomo foco saiu do campo de buscaaperte F6 para devolver o foco e bipe de novo
O menu Mais operacoes não abreteclado sem a tecla Mais operações e sem Alt+M mapeadouse Alt+M; se o teclado bloquear o Alt, use o botão na tela
F11 responde que há turno abertoa jornada não pode fechar com turno ativofaça o F9 antes

Como funciona por dentro#

  • Um comando por ação. Teclado, key-cap clicável e botão do menu passam pelo mesmo comando. Não existe caminho que faça "quase a mesma coisa": ou a ação é permitida, ou é recusada com motivo.
  • Uma tecla produz no máximo um comando, e um comando por vez: tentar iniciar outra operação durante uma em andamento responde Conclua a operação em andamento antes de iniciar outra.
  • A tecla não decide sozinha. Toda ação exige estado operacional compatível, o direito do operador e a pré-condição da ação. É por isso que F8 pode ser recusado mesmo existindo.
  • O diálogo tem prioridade. Com um diálogo ou uma rota por cima, o roteador global não intercepta nada, exceto o Esc, que fecha o topo. Sem essa exceção, o F1 da tela principal engoliria o F1 de "Dinheiro" dentro do pagamento.

Divergência conhecida#

A descrição do parâmetro pdv.perfil na retaguarda afirma que "a escolha local (F12) do terminal sempre vence sobre este padrão". No código, a escolha local da pele não está no F12: ela vive no cartão Tela do PDV dentro do diálogo Status do PDV, e o F12 de fábrica é pagamento_cartao. A precedência descrita está correta (escolha local vence o padrão do servidor); só o atalho citado no texto do parâmetro é que não corresponde ao código. Enquanto isso não for ajustado, oriente o operador pelo Status do PDV.

O que é de fábrica e o que a sua loja pode ter mudado#

PontoPadrão de fábricaComo fica diferente
F1 a F12o mapa completo desta página: F1 consultar preço · F2 abrir caixa · F3 item · F4 subtotal · F5 CPF · F6 digitar produto · F7 cancelar · F8 sangria · F9 sair operador · F10 receber · F11 fechar caixa · F12 cartãoa loja pode redefinir pelo parâmetro Atalhos de teclado do PDV (pdv.atalhos). Lista vazia = volta ao padrão acima. Suprimento não tem tecla de fábrica
Tecla do menu de açõesa tecla Mais operações chega como Scroll Lock; Alt+M é a alternativateclados programáveis variam de fábrica; se a sua tecla dedicada não estiver mapeada, use Alt+M
Teclas fixas do cupomsetas, +/=, − e Delete — não são remapeáveis—
Pele do PDVAndroid é sempre Touch; no Windows, Mercado por padrãoa escolha local fica no cartão Tela do PDV, em Status do PDV, e vence o padrão do servidor

Como conferir o mapa vigente da sua loja: abra Administração › Parâmetros e leia Atalhos de teclado do PDV. A lista vazia significa "usa o padrão de fábrica desta página".