Operador de Caixa

Guia completo para o dia a dia na frente de caixa.

Antes de começar

  1. Abra o PDV Terminal e confirme a conexão com o servidor da loja.
  2. Faça login; informe o segundo fator quando solicitado.
  3. Selecione a loja correta (se houver mais de uma).
  4. Abra o caixa informando o fundo de troco, ou retome o caixa encontrado.
  5. Verifique se o Terminal alcança o servidor da loja. Pix e cartão via TEF também precisam das

integrações externas; cartão em maquininha separada pode ser registrado com o NSU do comprovante.

A interface WPF cobre busca, carrinho, desconto, cancelamento de item com motivo, cliente e

fidelidade, dinheiro, cartão, Pix, voucher, pagamentos mistos, sangria, reforço, fechamento com

aprovação, acompanhamento fiscal, impressão térmica, gaveta, reimpressão de vendas anteriores,

balança (etiqueta e pesagem serial), receituário de controlados e quadro de produção.

Realizando uma venda

Montar o carrinho no terminal WPF

Frente de caixa do PDV Terminal com pesquisa, carrinho e recebimento

  1. Pressione F2 para voltar imediatamente ao campo de produto.
  2. Para buscar, digite pelo menos 2 caracteres do nome ou SKU e pressione Enter.
  3. Para leitura direta, escaneie o código de barras e pressione Enter. O item encontrado é

adicionado automaticamente.

  1. Se necessário, informe a quantidade antes de adicionar. Produtos fracionados aceitam até três

casas decimais.

  1. Nos resultados, use as setas e Enter ou dê duplo clique no produto.
  2. No carrinho, use + e para ajustar a quantidade e × para remover a linha.
  3. Pressione F9 para cancelar a venda inteira e confirme a ação.

O total e a quantidade são atualizados imediatamente. Ofertas usam o preço promocional informado

pelo servidor. O PDV bloqueia a troca de operador e avisa ao fechar a janela quando há itens.

Concluir o pagamento no terminal WPF

O recebimento fica na coluna da direita, sempre visível — não é uma janela que abre e fecha.

Você pode continuar bipando produtos enquanto compõe o pagamento; o total acompanha. A faixa verde

no rodapé da tela mostra o total e o botão de concluir, que nunca sai da vista, em qualquer

tamanho de monitor.

  1. Escolha um dos cards: 1 Dinheiro, 2 Débito, 3 Crédito, 4 Pix, 5 Voucher ou

6 Crediário — pela tecla ou pelo clique. Com o campo de valor zerado, o card recebe **tudo

o que falta**, que é o caso da venda paga de uma vez só. Ordem, cores e teclas são as mesmas da

frente de caixa web.

  1. Para dividir a venda, informe antes o valor desta parte e então escolha o card: valor digitado

sempre prevalece sobre o restante. F7 leva o foco ao campo (ou clique nele) e F5

preenche o que falta.

  1. Os cards Débito e Crédito iniciam o TEF integrado. Para maquininha externa, selecione

a forma, escolha Maquininha externa, informe o NSU do comprovante e registre o cartão.

Para crédito, informe de 1 a 12 parcelas. Para Pix, mostre o QR ao cliente — ele aparece no

painel junto do código copia-e-cola — e use Consultar pagamento até a confirmação.

  1. Repita para combinar meios. Confira Já recebido, Falta e Troco.
  2. Informe CPF/CNPJ somente quando o cliente solicitar identificação; deixe vazio nos demais casos.
  3. Pressione F12 ou clique em Concluir venda, na faixa do rodapé. Se ainda faltar valor,

o terminal informa o pagamento insuficiente sem preencher nem alterar a composição.

  1. Aguarde a confirmação com o número da venda. Entregue o troco destacado e clique em

Iniciar nova venda.

A conclusão registra venda, baixa de estoque e movimento de caixa juntos. Uma autorização

eletrônica confirmada não pode ser removida: conclua a venda antes de trocar operador ou fechar o

terminal.

Depois que um cartão é autorizado, o carrinho trava. Não dá para incluir nem tirar item, nem

cancelar a venda: o valor já saiu da mão do cliente e o total não pode divergir do que foi

cobrado. Conclua a venda — para devolver, use o cancelamento fiscal.

Se a resposta de uma autorização cair, repita exatamente o mesmo meio e valor. Se a comunicação da

venda cair, use Tentar novamente. Em ambos os casos, o servidor reaproveita a chave idempotente

e evita cobrança ou venda duplicada.

Referência visual do cliente web legado

As telas abaixo pertencem ao Angular administrativo legado e podem diferir do terminal WPF. O

Angular agora opera somente online e não deve ser instalado como PWA de caixa.

  1. Na Frente de caixa, uma nova venda inicia automaticamente (ou pressione F2)
  2. Busque o produto pelo nome ou escaneie o código de barras — os resultados mostram a

foto do produto, o preço e a unidade, para confirmar que é o item certo antes de adicionar

Busca de produto mostrando o resultado com foto, código e preço

> Bipou um produto que não está cadastrado? O caixa consulta as bases de produtos e abre um

> cadastro rápido já com o nome sugerido — confirme o preço e o item entra na venda na

> hora, cadastrado para as próximas vendas. (Requer internet para consultar e cadastrar.)

  1. Informe a quantidade se necessário. Para produtos por peso com uma balança conectada,

clique em Pesar (ao lado da quantidade) — o peso é lido da balança e preenche o campo

automaticamente (o botão só aparece quando o gerente configurou a balança em *Configurações ›

Balança*)

  1. Repita para cada item — os itens da venda aparecem com a foto, quantidade e total por linha

Itens da venda com foto do produto, quantidade, preço unitário e total

  1. Revise o total na tela
  2. Escolha a forma de pagamento

Painel de pagamento com o valor em dinheiro preenchido

  1. Pressione F12 ou clique em Finalizar venda

Confirmação de venda registrada com opções de imprimir cupom e nova venda

Produto sem foto aparece com um ícone de pacote no lugar da imagem — a venda funciona

normalmente. A foto é cadastrada pelo estoquista (ver

Estoque e compras).

Formas de pagamento

TeclaForma
1Dinheiro
2Cartão débito via TEF integrado
3Cartão crédito via TEF integrado
4Pix
5Voucher

O card 6 Crediário também está disponível na tela. Ele não tem atalho global no mapa padrão

da loja, da mesma forma que no caixa web.

Para dinheiro, informe o valor recebido — o sistema calcula o troco.

Para Pix, um QR Code ou código copia-e-cola será exibido. Aguarde a confirmação.

Múltiplas formas de pagamento

É possível dividir: parte em dinheiro, parte no cartão, voucher ou crediário. Para cartão em

maquininha separada, selecione a variante Maquininha externa, espere a aprovação, informe o

NSU exibido no comprovante e só então registre o pagamento. Os cards Débito e Crédito

usam o TEF integrado por padrão, como no caixa web.

Use F5 para completar automaticamente o valor restante.

Cancelamentos

AçãoTecla
Cancelar itemF8
Cancelar venda inteiraF9

F8 abre a lista de motivos (desistência, item errado, preço divergente, avariado, correção de

quantidade ou outro). Escolha o motivo e confirme; "Outro motivo" pede uma descrição. O item sai do

carrinho depois de o motivo ser registrado — se o servidor da loja não responder, o item

permanece na venda e a tela avisa. Isso é proposital: o registro é o que a auditoria enxerga.

Sem seleção, o F8 age sobre o último item incluído; clicando no × da linha, age sobre ela.

O motivo fica na auditoria da loja com operador, item, quantidade e valor. Não é cancelamento

fiscal — a venda ainda nem foi para o servidor —, é a trilha de prevenção de perdas.

Venda já finalizada

Abra Vendas recentes, selecione a venda e use Cancelar venda. Esse fluxo é diferente de

F9: ele atua sobre uma venda já paga e exige justificativa entre 15 e 255 caracteres e

autorização de gerente ou dono.

O cancelamento pós-venda disponível nesta versão é **integral e somente para pagamento totalmente

em dinheiro**. O servidor persiste a intenção, cancela a NFC-e autorizada, restaura estoque e

pontos e lança uma Devolução negativa na sessão de caixa aberta. Entregue ao cliente o valor

mostrado somente depois da confirmação. Se a gaveta não tiver numerário suficiente, faça um

reforço e tente novamente.

Se a SEFAZ ou a rede falhar depois da autorização gerencial, não crie outro cancelamento nem feche

o caixa: a intenção já está salva e o servidor tentará novamente automaticamente. O fechamento da

gaveta vinculada fica bloqueado até a conclusão; a mensagem orienta aguardar ou fazer o reforço

necessário. A venda só aparece como cancelada depois que fiscal, estoque, pontos e devolução

estiverem reconciliados.

Vendas com Pix, cartão, voucher, crediário ou pagamento misto não podem ser canceladas por esse

botão: o estorno precisa acontecer de verdade no PSP/TEF antes de o PDV alterar estoque e fiscal.

Devolução parcial também não é este fluxo; ela exige documento fiscal próprio.

Descontos

Desconto na venda inteira: F10 (requer permissão de gerente). Disponível na web e no terminal —

o passo a passo do terminal está em Desconto na venda mais abaixo.

Para descontar um item só, clique no % da linha no carrinho (também exige gerente). O valor

riscado ao lado do total da linha mostra quanto ela valia antes. Os dois descontos convivem: o do

item abate a linha, o da venda abate o subtotal já abatido — não são somados na mesma base.

As teclas são as mesmas nos dois clientes e vêm da configuração da loja, não do programa. O

gerente pode remapeá-las em Configurações › Atalhos; a barra no rodapé da tela sempre mostra o

que está valendo naquele caixa.

Cliente e fidelidade

F3 abre a busca de clientes cadastrados (nome, documento ou telefone). Escolha e confirme: o

cliente fica visível no resumo, com o saldo de pontos, e a venda passa a ficar vinculada a ele no

histórico. O × ao lado do nome desvincula.

Cliente e CPF na nota são coisas diferentes. O cliente é cadastro (histórico e pontos); o

CPF/CNPJ é o que sai na nota fiscal, e fica no painel de pagamento. Dá para emitir cupom com CPF

sem ter cliente, e para vincular cliente sem pôr CPF na nota. Como conveniência, ao vincular um

cliente cujo cadastro tem documento válido, o campo da nota é preenchido se estiver vazio

o que você já digitou nunca é sobrescrito.

Quando a empresa habilita o programa, os pontos são creditados automaticamente ao finalizar:

piso do total após desconto × taxa configurada. Exemplo: com 1 ponto por real, uma compra de

R$ 10,90 rende 10 pontos. Todos os meios de pagamento contam; troco não conta. Se a venda for

cancelada, o sistema estorna exatamente os pontos que ela gerou.

Se a taxa estiver em 0, o programa fica desabilitado e a venda apenas mantém o vínculo do cliente.

Sangria, reforço e fechamento — exigem aprovação

Como operador, **reforço, sangria e fechamento de caixa precisam da aprovação de um gerente ou

dono. Pressione F4 ou clique em Operações**. Ao solicitar, você verá duas opções:

código 2FA) na sua tela. A operação executa na hora.

estado automaticamente a cada poucos segundos. Quando o gerente aprovar, a operação é aplicada;

se rejeitar, o motivo fica visível até você confirmar.

Enquanto o pedido estiver pendente, não é possível trocar o operador nem fechar normalmente o

terminal. Use Cancelar solicitação se a operação não for mais necessária.

Você pode ter apenas um caixa aberto por vez. Para abrir em outra loja, feche o atual primeiro

(o fechamento também passa por aprovação).

Sangria e reforço

Fechar o caixa

  1. Pressione Ctrl+F12 ou acesse Fechar caixa.
  2. Conte o dinheiro físico na gaveta e informe o valor contado.
  3. O sistema mostra a diferença (quebra/sobra).
  4. Confirme — o fechamento segue para aprovação do gerente/dono.
  5. Depois de aprovado, o terminal volta à tela de abertura de caixa.

Tela do cliente

O terminal abre uma segunda janela voltada ao cliente, com a marca da loja (logo e cores definidas

em Empresas → Tela do cliente).

  1. Clique em Tela do cliente (ou pressione Ctrl+D) na barra superior.
  2. Arraste a janela para o monitor do cliente e pressione F11 para tela cheia (Esc sai).

O que o cliente vê acompanha a venda automaticamente:

valor da cobrança.

A janela é só exibição: não recebe cliques, não mostra dados do operador e continua funcionando com

a internet fora do ar. Fechar o terminal fecha a tela do cliente junto.

Sair do terminal sem fechar o caixa

Encerrar o aplicativo não encerra o caixa. A sessão de caixa fica no servidor da loja, então

desligar o computador no fim do expediente, reiniciar o Windows ou trocar de terminal não obriga

ninguém a fechar o caixa antes.

  1. Clique em Sair (ou pressione Ctrl+Q) na barra superior da frente de venda.
  2. A confirmação mostra desde quando o caixa está aberto e quanto há em gaveta, com a situação

Permanece aberto.

  1. Confirme em Sair do terminal. No próximo login — neste terminal ou em outro — o mesmo caixa

é retomado com o valor em gaveta preservado.

O fechamento pela barra de título (o X da janela) leva à mesma confirmação.

Quando a saída não é liberada:

solicitação é acompanhada por este terminal.

venda ter sido registrada.

ainda não finalizados não ficam guardados.

Trocar de operador é diferente de sair: use Trocar operador para encerrar apenas o login e

deixar o terminal pronto para o próximo colega, sem fechar o aplicativo nem o caixa.

Desconto na venda (F10)

gerente ou dono. Com itens no carrinho, F10 (ou o botão Desconto no resumo) abre a

janela: escolha Valor (R$) ou Percentual (%), digite e confirme com Enter. A linha abaixo

do campo mostra quanto vai sair e qual fica sendo o total, antes de aplicar.

O desconto vale para a venda inteira e nunca passa do subtotal — descontar mais que o valor da

compra deixa o total em zero, não em negativo. Se você remover itens depois de descontar, o desconto

acompanha e continua limitado ao que sobrou. Remover desconto volta ao valor cheio.

Produtos por peso

Etiqueta de balança (produto pesado na seção)

Não exige balança no caixa. Bipe a etiqueta no campo de busca, como qualquer código de barras:

o terminal reconhece o layout, encontra o produto pelo código embutido e lança a linha já com o

peso correto.

A etiqueta pode trazer o preço (o mais comum) ou o peso. Quando traz o preço, o terminal

divide pelo preço por quilo do cadastro para chegar à quantidade — é isso que faz o total do cupom

bater com o da etiqueta colada no produto.

Se aparecer "Produto da etiqueta não encontrado", o código embutido não está no cadastro: confira

se o produto tem esse código como código de barras ou SKU.

Pesar no caixa (balança serial)

Com uma balança ligada ao terminal, aparece o botão Pesar ao lado da busca. Coloque o produto,

clique em Pesar e o peso vira a quantidade do próximo item — depois leia o produto normalmente.

Pesar antes de bipar é a ordem natural do balcão.

O terminal abre e fecha a porta a cada pesagem, de propósito: manter a porta aberta deixa bytes

antigos no buffer e a pesagem seguinte devolveria o peso do item anterior.

Configurar a balança (gerente)

Com o carrinho vazio, abra Operações (F4) e clique em Balança. A tela tem duas partes

independentes:

Pesagem serial — marque Usar a balança deste terminal, escolha a porta (o botão

Detectar lista as portas do Windows), o protocolo (Toledo, Filizola ou genérica) e a

velocidade. Clique em Testar pesagem com algo no prato: é a única forma de saber se os três

estão certos, porque nenhum deles avisa quando está errado — a balança só devolve um número.

Etiqueta de peso variável — prefixo, quantos dígitos são o código do produto, quantos são o

valor, e se o valor embutido é preço ou peso. O exemplo abaixo dos campos mostra uma

etiqueta lida com o layout atual; se ele não parecer com as etiquetas da sua loja, o layout está

errado. É aqui que se ajusta quando o operador bipa a etiqueta e o produto "não é encontrado".

A configuração vale só para este caixa (é hardware local) e é gravada em

%LocalAppData%\PDV\Terminal\scale.json. Deixar a balança desmarcada é uma configuração legítima:

a leitura de etiqueta continua funcionando, e é assim que a maior parte do varejo opera.

Na frente de caixa web o caminho é Configurações › Balança, com os mesmos campos.

Produção (padaria e cozinha)

O botão Produção na barra superior abre o quadro da loja, com três colunas: na fila, **em

produção e pronto**. Serve para padaria e cozinha que não têm um monitor dedicado — dá para

operar tudo pelo próprio caixa.

Para enfileirar: escolha a ficha técnica, a quantidade (multiplicador da receita) e, se

quiser, uma observação. Avançar empurra o ticket para a coluna seguinte; Cancelar o remove.

Concluir um ticket movimenta o estoque: baixa dos insumos e entrada do produto acabado. Por

isso um ticket na coluna pronto não tem mais botões — desfazer ali significaria mexer em estoque

já movimentado.

O quadro se atualiza sozinho a cada 10 segundos enquanto está aberto, e o botão Atualizar força

a leitura. Loja sem fichas técnicas cadastradas abre o quadro vazio, sem erro.

Medicamento controlado (farmácia)

Produtos controlados aparecem no resultado da busca com a tarja CONTROLADO. Ao concluir a

venda, o terminal abre o receituário antes de enviar: um bloco por medicamento controlado, com

paciente, CPF do paciente, prescritor, CRM/CRO, lote e data da receita.

Paciente e prescritor são obrigatórios — o botão de concluir só libera com os dois. O que você

digita fica guardado se voltar ao carrinho e retornar.

A venda não fecha sem o receituário, e isso não é escolha da tela. Quem recusa é o servidor,

dentro da mesma transação que dá baixa no estoque: ou o controlado sai da prateleira e entra

no livro, ou nenhum dos dois acontece. A quantidade escriturada é sempre a da venda.

Os registros alimentam o SNGPC. O gerente consulta e baixa o arquivo em Farmácia › SNGPC.

Reimprimir o cupom de uma venda anterior

O cliente voltou dizendo que perdeu o cupom? Clique em Vendas na barra superior (ou pressione

F11 quando não houver venda recém-concluída na tela). A lista traz as vendas concluídas da loja,

da mais recente para a mais antiga, com número, horário, quantidade de itens e total.

Selecione e clique em Reimprimir cupom. O cupom é montado pelo servidor a partir da venda

gravada, então sai exatamente igual ao original. A gaveta não abre — reimpressão não é

recebimento.

Se o botão estiver desabilitado, a mensagem no rodapé diz o porquê (normalmente impressora ainda

não configurada neste terminal).

Configurar os atalhos da loja (gerente)

Gerente ou dono têm o botão Atalhos na barra superior. Cada ação mostra a tecla em vigor;

clique em Trocar e pressione a tecla desejada — F1F12, dígitos, ou Ctrl + letra. Esc

cancela a captura.

Ações de sistema (Confirmar, Cancelar, Ajuda) não são reatribuíveis. Salvar atalhos aplica para

a loja inteira: vale neste terminal na hora, nos outros caixas e na frente de caixa web no próximo

ciclo. Restaurar padrão volta às teclas de fábrica.

Se duas ações ficarem com a mesma tecla, o servidor recusa e a mensagem aparece no rodapé — nada é

salvo pela metade.

O que ainda não está no terminal instalado

O terminal cobre a operação de caixa dos seis segmentos, com paridade com a frente de caixa web.

Detalhes em Arquitetura do terminal → Paridade com a frente de caixa web.

Acompanhar a NFC-e no terminal

Com o carrinho vazio, pressione F6 ou clique em Fiscal. A tela mostra as NFC-e da loja nos

últimos sete dias e mantém visível qualquer contingência ou rejeição mais antiga.

número de tentativas.

resolve a rejeição.

O servidor tenta retransmitir contingências automaticamente. Se precisar antecipar a tentativa,

clique em Retransmitir agora e aguarde o novo status. Não feche a venda novamente e não emita

outro documento para substituir a NFC-e exibida.

Quando a internet externa cair

relê do servidor a sessão de caixa, os atalhos e os motivos de cancelamento — útil quando a

LAN oscilou —, mas não envia venda nenhuma e não mexe no carrinho em digitação.

Imprimir cupom

  1. Com o carrinho vazio, abra Operações → Impressora e gaveta.
  2. Clique em Detectar e selecione a fila da impressora instalada neste Windows.
  3. Escolha papel de 58 ou 80 mm e clique em Imprimir teste.
  4. Marque corte, impressão automática e gaveta conforme o equipamento e clique em Salvar.

Com a impressão automática habilitada, o cupom sai após a confirmação da venda. Se faltar papel ou

a fila estiver indisponível, a venda continua concluída e a mensagem fica visível. Corrija o

equipamento e use Reimprimir cupom na tela de conclusão.

O servidor monta o conteúdo do cupom e do DANFE NFC-e; o terminal envia os bytes ESC/POS à fila do

Windows. Uma reimpressão não abre a gaveta. Quando a abertura automática está habilitada, ela ocorre

somente em vendas com dinheiro; Pix e cartão não acionam a gaveta.

Sons do caixa no cliente web

Em Configurações › Sons do caixa, o cliente web sugere automaticamente um perfil no primeiro uso

do dispositivo:

A sugestão não substitui configurações existentes. Ao mudar volume, timbre, mudo global ou um aviso

individual, o perfil passa a aparecer como Personalizado e permanece salvo somente naquele

dispositivo. Também é possível selecionar novamente qualquer perfil e ouvir sua sequência de teste.

Dicas

Problemas comuns

ProblemaSolução
"Caixa não aberto"Abra o caixa antes de vender
Produto não encontradoVerifique cadastro com estoquista
Pix não confirmaVerifique a internet do servidor e use Consultar pagamento
Venda sem respostaUse Tentar novamente sem alterar itens ou pagamentos