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.atalhosda 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:
| Tecla | O 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 |
| Delete | remove o item selecionado |
| Enter | no campo de busca, lança o que foi digitado; é também o Enter que o leitor físico manda ao terminar o bipe |
| Esc | fecha/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#
| Tecla | Rótulo de fábrica | O que faz |
|---|---|---|
| F1 | Consultar preco | consulta rápida de preço, sem lançar item |
| F2 | Abrir caixa | abre o diálogo Abrir turno do caixa (operador, PIN e fundo de troco) |
| F3 | Item | abre Ajuste do item para o item selecionado |
| F4 | Subtotal | abre Ajuste do subtotal (desconto e acréscimo da venda) |
| F5 | CPF | abre o diálogo de CPF/CNPJ e observação da venda |
| F6 | Digitar produto | devolve o foco ao campo de busca, sem lançar nada |
| F7 | Cancelar | cancela a venda em andamento, com confirmação |
| F8 | Sangria | registra retirada de numerário |
| F9 | Sair operador | encerra o turno do operador, com contagem e malote |
| F10 | Receber | abre o diálogo de pagamento |
| F11 | Fechar caixa | encerra a jornada do caixa, com conferência cega |
| F12 | Cartao | abre 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:
| Tecla | Forma |
|---|---|
| F1 | Dinheiro |
| F2 | Pix |
| F3 | Crédito |
| F4 | Débito |
| Esc | cancela a liquidação e volta para a venda, sem perder os itens |
DAbrir o menu Outras funções pelo teclado#
- Aperte a tecla Mais operações do teclado programável de PDV — ela chega ao sistema como Scroll Lock.
- Em teclado comum, use Alt+M.
- 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#
- Na retaguarda, o parâmetro
pdv.atalhos(escopofrente_loja) guarda uma lista em que cada item associa uma tecla a uma ação, e opcionalmente a um parâmetro. - Lista vazia = mapeamento de fábrica. É o padrão do parâmetro.
- Com uma lista preenchida, somente as teclas listadas têm ação.
- 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.
- A ação
nenhumadesliga a tecla: o botão não é desenhado e a tecla não faz nada. - A ação
produtocom o campoparametroapontando 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#
- Comece pelo login: o foco nasce no campo de código do operador.
- Autenticado, o foco vai sozinho para o campo de busca — você já pode bipar o primeiro item.
- 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).
- Em diálogos: Enter avança/confirma, Esc volta/cancela, Tab percorre os campos e as setas navegam em listas.
- 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ábrica | O que executa |
|---|---|---|
consultar_preco | F1 | consulta de preço |
abrir_caixa | F2 | abertura da jornada com turno |
ajustar_item | F3 | ajuste do item selecionado |
ajustar_subtotal | F4 | desconto e acréscimo da venda |
cpf_nota | F5 | CPF/CNPJ e observação |
focar_produto | F6 | foco no campo de busca |
cancelar_venda | F7 | cancelamento da venda em andamento |
sangria | F8 | retirada de numerário |
sair_operador | F9 | encerramento do turno |
pagamento | F10 | diálogo de pagamento |
fechar_caixa | F11 | encerramento da jornada |
pagamento_cartao | F12 | pagamento 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#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Uma tecla que existia sumiu da barra | a loja publicou uma lista parcial em pdv.atalhos sem essa tecla | peç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 conhece | corrija o nome da ação na retaguarda usando a tabela acima |
| A tecla tem rótulo, mas não faz nada | ação ausente ou igual a nenhuma | confira o item da tecla na lista |
| A tecla faz outra coisa que não o rótulo sugere | o rotulo foi fixado à mão na lista | remova o rotulo para o texto acompanhar a ação |
As setas e o +/− não respondem | nenhum item selecionado no cupom | use ↑ ou ↓ para selecionar um item |
| O bipe não entra no cupom | o foco saiu do campo de busca | aperte F6 para devolver o foco e bipe de novo |
| O menu Mais operacoes não abre | teclado sem a tecla Mais operações e sem Alt+M mapeado | use Alt+M; se o teclado bloquear o Alt, use o botão na tela |
| F11 responde que há turno aberto | a jornada não pode fechar com turno ativo | faç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#
| Ponto | Padrão de fábrica | Como fica diferente |
|---|---|---|
| F1 a F12 | o 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ão | a 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ções | a tecla Mais operações chega como Scroll Lock; Alt+M é a alternativa | teclados programáveis variam de fábrica; se a sua tecla dedicada não estiver mapeada, use Alt+M |
| Teclas fixas do cupom | setas, +/=, − e Delete — não são remapeáveis | — |
| Pele do PDV | Android é sempre Touch; no Windows, Mercado por padrão | a 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".