Pular para o conteúdo principal

Frente de Caixa

A tela de Frente de Caixa é o coração do PDV do idworks — é onde o operador de loja atende o cliente, monta o pedido, recebe o pagamento (dinheiro, cartão de crédito/débito via maquininha PayGo, Pix via Stark Bank ou Pagar.me, vale-presente, crédito loja, boleto, fiado etc.), emite a nota fiscal (NFC-e ou NF-e) e imprime o cupom. Tudo isso acontece em uma única tela em tela cheia, projetada para operação rápida com atalhos de teclado (F4, F5, F7, F9, F10, F12, Ctrl+1 a Ctrl+7), suporte a leitor de código de barras, balança Toledo, maquininha de cartão integrada e múltiplos terminais simultâneos.

A vida do caixa segue um ciclo bem definido: (1) o operador chega na loja e abre o caixa (informa o saldo físico inicial em dinheiro, senha pessoal e — opcionalmente — observações); (2) durante o expediente, atende um ou mais clientes em sequência, montando carrinho, aplicando descontos manuais e promoções automáticas, faturando, imprimindo cupons; (3) se precisar tirar dinheiro do caixa para o cofre, faz uma sangria; se precisar colocar troco, faz um reforço; (4) no fim do dia, fecha o caixa, informando o valor apurado fisicamente — qualquer divergência gera um lançamento de ajuste automaticamente, e o operador imprime o recibo de fechamento e o resumo fiscal para conferência com a contabilidade.

A tela tem uma arquitetura em 3 passos numerados (Stepper) visíveis no topo: (1) Cliente — identifica/cadastra o cliente da venda; (2) Produtos — monta o carrinho com leitor de código de barras, busca por descrição ou grade de variações; (3) Pagamento — define os tipos de pagamento (pode dividir em vários), aplica promoções, dispara o TEF/Pix, emite a NFC-e e imprime. Cada passo tem suas próprias regras de validação e suas próprias modais auxiliares (cadastro de cliente, consulta de produto, troca/devolução, descontos excepcionais com senha de gerente, transferência de saldo entre caixas etc.).

A tela é resiliente a perda de conexão (ou a fechamento acidental do navegador): a cada alteração do carrinho, o estado é salvo localmente no navegador e também enviado ao sistema como rascunho de pedido — quando o operador reabre o PDV, a tela detecta a venda interrompida e oferece automaticamente o resumo "Venda interrompida recuperada". Esse mesmo mecanismo permite retomar a venda em outro terminal (ex.: o operador começa no Caixa 1, vai para o Caixa 2 com o cliente, e retoma o carrinho lá via menu Rascunho de pedido).

Toda operação que mexe com dinheiro ou status do pedido (alteração de detalhes de transação TEF, cancelamento de pedido, remoção de item antes do faturamento, desconto acima do limite do vendedor) exige senha do gerente se o operador corrente não tiver o privilégio. O sistema integra com a tela de Promoção PDV (motor de cálculo em tempo real) e Transações TEF (auditoria das cobranças), além de emitir NFC-e/NF-e via SEFAZ na hora do fechamento da venda.

Índice​

Conceito e arquitetura

Abertura de caixa

Operação — Passo 1 (Cliente)

Operação — Passo 2 (Produtos)

Operação — Passo 3 (Pagamento)

Finalização da venda

Funções do menu auxiliar (Ctrl+1 a Ctrl+7)

Sangria e reforço

Fechamento de caixa

Recuperação de venda interrompida

Parametrizações (CompanyParameters)

Senha de gerente e autorizações

Regras de negócio (avançadas)

Referência rápida

O que é a Frente de Caixa?​

É a tela do PDV operacional — onde o cliente é atendido, a venda é montada, o pagamento é recebido (cartão na maquininha, Pix, dinheiro, vale etc.) e a nota fiscal é emitida. É a única tela do idworks projetada para operação em tela cheia, com atalhos de teclado, leitor de código de barras, balança e maquininha PayGo integrados.

📍 Onde: menu lateral → PDV → Frente de Caixa.

Como o caixa funciona no idworks?​

Cada caixa do PDV é uma conta bancária do tipo "Caixinha" — ela acumula entradas (vendas em dinheiro, reforços) e saídas (sangrias, devoluções em dinheiro). O conceito de "caixa" no idworks unifica caixas físicos (gaveta com dinheiro) e maquininhas (PayGo) — quando você quer rastrear o saldo de uma maquininha separadamente, cadastra uma conta bancária para ela.

Cada sessão de caixa é o período entre uma abertura e o fechamento. Tudo que acontece dentro da sessão (vendas, sangrias, reforços) é vinculado a ela — o que permite o fechamento diário (você fecha o caixa no fim do dia e abre uma sessão nova no dia seguinte).

Em produção, o setup típico é: 1 caixa físico (gaveta) + 1 maquininha = 2 contas bancárias. O operador abre as duas no início do dia e escolhe qual usar em cada venda dependendo do tipo de pagamento.

Quais os 3 passos da venda no PDV?​

A tela tem um Stepper (componente Ant Design) com 3 passos numerados:

PassoNomeO que faz
0ClienteIdentifica o cliente (por CPF/CNPJ, telefone, e-mail ou nome). Cadastra na hora se não existe. Também é onde escolhe a empresa faturadora, o tipo de pedido, a política comercial, o vendedor e o armazém de saída.
1ProdutosMonta o carrinho. Adiciona itens por leitor de código de barras (com a campo de input no topo), busca por descrição, grade de variações ou consulta de SKU. Ajusta quantidade, preço e desconto por item.
2PagamentoDefine os tipos de pagamento (pode dividir em vários), aplica promoções automáticas (motor de Promoção PDV), dispara TEF/Pix se for cartão/Pix, e finaliza a venda (emite NF e imprime cupom).

Você pode voltar do passo 2 para o 1 se precisar (ex.: cliente esqueceu um item). Mas voltar do passo 2 depois de adicionar pagamentos está bloqueado — você precisa limpar os pagamentos primeiro.

O que é uma "sessão de caixa"?​

Uma sessão é o período entre uma abertura e o fechamento de um caixa. Cada sessão guarda:

  • Identificador único da sessão.
  • Caixa físico (a conta bancária do tipo "Caixinha" associada).
  • Operador que abriu a sessão.
  • Data/hora de abertura.
  • Data/hora de fechamento (vazio enquanto a sessão estiver aberta).
  • Observações de abertura e fechamento (texto livre).

Cada venda fechada no PDV fica vinculada à sessão do caixa. Cada sangria, reforço ou ajuste também fica vinculado à sessão. O histórico do caixa (tela Histórico Caixa) lista todas as sessões para auditoria.

Posso ter vários caixas abertos ao mesmo tempo?​

Sim, na empresa. Cada caixa físico é independente — vários operadores podem trabalhar simultaneamente, cada um no seu caixa.

Mas não pelo mesmo usuário. O sistema valida que cada usuário só pode ter 1 caixa aberto por vez. Se você tentar abrir um segundo caixa, recebe Usuário já possui outro caixa aberto. Para mudar de caixa, feche o atual primeiro.

Por outro lado, um caixa não pode ter 2 operadores ao mesmo tempo. Se o caixa X está aberto por Maria, João não consegue abrir o mesmo caixa enquanto ela não fechar (mensagem: Caixa já esta aberto e precisa fechar antes de abrir novamente).

Como abrir o caixa?​

  1. Acesse PDV → Frente de Caixa.
  2. Tela inicial mostra um botão Abrir Frente de Caixa se você nunca abriu nada hoje, ou cards de caixas em aberto pelo seu usuário ("Selecione um caixa") para retomada rápida.
  3. Clique em Abrir Frente de Caixa. Modal Abertura de Caixa abre.
  4. Selecione a Empresa (faturador da NFC-e). Quando a empresa tem só 1 faturador, vem pré-selecionada.
  5. Selecione o Caixa — lista filtrada por faturador, mostrando o status (Aberto/Fechado) e o operador atual. Caixas abertos por outros operadores ficam bloqueados.
  6. Valor em Caixa mostra o saldo calculado pelo sistema. Valor de Abertura é o saldo físico que você está colocando (geralmente o troco inicial — pode ser igual ou diferente do calculado). Observação é opcional.
  7. Digite sua Senha (a mesma que você usa para entrar no idworks).
  8. Enter ou clique em Entrar (Enter).

Se a senha está correta e nenhuma validação falha, o caixa abre e a tela do PDV aparece em tela cheia (o Intercom é desligado para liberar espaço).

O que é "Retomar Caixa"?​

Quando o operador já tinha um caixa aberto antes (ex.: trabalhou na manhã, foi almoçar, voltou), o sistema não obriga ele a fechar e abrir de novo — basta Retomar a sessão existente.

Na tela inicial do PDV, os caixas em aberto pelo seu usuário aparecem em cards com o botão Entrar — clique para retomar a sessão. O modal abre com os campos pré-preenchidos (o Valor em Caixa é mostrado para informação), e você só precisa digitar a senha para entrar. Nenhum lançamento de ajuste é gerado — o saldo continua exatamente onde estava.

O sistema detecta que o mesmo usuário já tinha aberto aquela sessão e a devolve sem criar uma nova.

O que é o "Valor de Abertura"?​

É o dinheiro físico que você está colocando no caixa no momento da abertura — geralmente o troco inicial (R$ 200,00 em notas e moedas pequenas, por exemplo). O sistema compara esse valor com o saldo calculado do caixa:

  • Se forem iguais (diferença < R$ 0,01) → nenhum lançamento extra.
  • Se forem diferentes → o sistema gera automaticamente um lançamento de ajuste no extrato bancário com descrição "Ajuste abertura de caixa" para conciliar a divergência. Tipo crédito se o valor declarado é maior, débito se for menor.

Isso registra a discrepância (ex.: "tinha mais dinheiro do que o sistema esperava", que pode indicar erro de fechamento anterior).

Por que pede senha na abertura?​

Para autorizar a operação com a identidade do operador. A senha é validada de forma criptografada contra o cadastro do usuário — sem ela, o sistema não tem como provar que foi você que abriu o caixa.

Quando a senha está errada, retorna Senha incorreta. Quando o usuário não tem senha cadastrada (caso raro), retorna Usuário não tem senha cadastrada.

A senha não é a do gerente, é a sua senha pessoal do idworks — a mesma que você usou para entrar no sistema. Se você esqueceu, peça reset ao administrador.

Quais validações o sistema faz ao abrir o caixa?​

A abertura do caixa passa pelas validações na ordem:

  1. Trava de concorrência — se o mesmo caixa está em processo de abertura agora (dois operadores ao mesmo tempo), retorna Caixa já esta em processo de abertura (vale por 10 segundos).
  2. Tipo de caixa — a conta bancária precisa estar cadastrada como caixa do PDV. Caso contrário: Banco informado não é do tipo Caixinha.
  3. Tipo de pedido padrão — o caixa precisa ter um tipo de pedido padrão vinculado. Caso contrário: Banco informado não tem tipo de pedido padrão cadastrado.
  4. Estado — não pode haver outra sessão aberta por outro usuário. Caso contrário: Caixa já esta aberto e precisa fechar antes de abrir novamente.
  5. Configurações fiscais (apenas quando a parametrização Verificar configuração na abertura do caixa está ativa):
    • Última NFCe preenchida (Precisa preencher o número da última NFCe...).
    • Série da NFCe preenchida.
    • CSC da NFCe preenchido.
    • ID do CSC da NFCe preenchido.
    • Existe ao menos uma regra fiscal habilitada para emissão de NFCe (Não existe nenhuma regra fiscal para emissão de NFCe...).
    • Essa regra tem ao menos uma configuração de ICMS para consumidor final (Não existe nenhuma configração de ICMS na regra fiscal para consumidor final).
    • Existe ao menos um tipo de pagamento habilitado para frente de caixa (Não existe tipo de pagamento configurado para frente de caixa).
  6. Usuário — existe, está ativo, tem vínculo ativo com a empresa e a empresa está ativa.
  7. Senha — comparada com a senha cadastrada do usuário (de forma criptografada).
  8. Único caixa por usuário — se você já tem outro caixa aberto, retorna Usuário já possui outro caixa aberto.

Tudo isso para garantir que o caixa só abre em condições válidas — abrir com NFCe mal configurada quebraria todas as vendas do dia.

Por que recebi "Banco informado não é do tipo Caixinha"?​

A conta bancária que você escolheu não é um caixa do PDV — é uma conta bancária normal (Bradesco, Itaú etc.). Caixas do PDV são contas marcadas como "Caixinha" no cadastro (uma convenção interna do idworks para distinguir caixas físicos de bancos reais).

Como resolver: vá em Financeiro → Contas Bancárias e edite a conta — marque como Caixinha e configure Tipo de pedido padrão, Empresa faturadora e Integração de pagamento. Ou crie uma nova conta especificamente como caixa.

Por que o caixa aparece bloqueado para mim?​

Dois cenários:

  1. O caixa está aberto por outro operador. Você consegue ver na lista que está "Aberto - João", mas não consegue entrar — só o João pode operar nesse caixa enquanto a sessão dele está ativa. Quando João fechar, libera para outros.
  2. Você já tem outro caixa aberto. A lista mostra todos os outros caixas em disabled (cinza) — o sistema bloqueia para evitar que você opere em 2 caixas ao mesmo tempo. Para liberar, feche seu caixa atual.

Como identificar o cliente da venda?​

No Passo 1 (Cliente), use a busca no topo. Há 4 modos de busca:

  • CPF/CNPJ (default) — digite o documento e pressione Enter. O sistema valida o dígito antes de buscar.
  • Telefone — busca por telefone (precisa ter ≥ 10 dígitos para validar). Se retornar vários clientes com o mesmo telefone, abre uma lista para você escolher.
  • E-mail — busca por e-mail exato.
  • Nome — busca por nome/razão social (parcial).

Quando encontra um único cliente, preenche os campos automaticamente (nome, telefone, endereço, vale do cliente etc.). Quando encontra vários (por telefone ou nome), mostra a lista para selecionar.

Quando não encontra, abre uma modal "Não existe nenhum cliente cadastrado com o ... informado. Deseja cadastrar?" — clique em Sim para abrir o formulário de cadastro rápido.

Posso vender sem informar o cliente?​

Sim. O cliente é opcional na maioria dos cenários — você pode pular o Passo 1 e ir direto para Produtos. A venda fica como "Consumidor Final" sem CPF na nota.

Algumas regras tornam o cliente obrigatório:

  • Promoções marcadas como "Somente cliente cadastrado" só são aplicadas se o pedido tem cliente.
  • Crédito loja / vale-presente só pode ser usado se o cliente tem saldo cadastrado.
  • Quando o operador pede para incluir o CPF na nota (modal "Solicitar CPF cupom fiscal"), o sistema valida que existe cliente cadastrado.

Como cadastrar um cliente novo na hora?​

Quando a busca não encontra ninguém, a modal "Deseja cadastrar?" aparece automaticamente. Clique em Sim.

Abre o formulário Cadastro de Cliente com os campos básicos: CPF/CNPJ, Nome/Razão Social, Nome Fantasia (CNPJ), E-mail, Telefone, Endereço (CEP, rua, número, bairro, cidade, estado). O documento já vem pré-preenchido com o que você digitou.

Ao salvar, o cliente é criado e vinculado automaticamente à venda atual — você não precisa buscar de novo, basta avançar para o Passo 2.

Se o cliente tiver endereço cadastrado, o endereço também é gravado no cadastro dele para uso futuro.

Como mudar o vendedor da venda?​

No Passo 1, há um seletor Vendedor com a lista de usuários marcados como vendedor na empresa. Selecione o vendedor responsável pela venda.

Quando o vendedor é selecionado, o sistema carrega o limite de desconto dele — isso vai ser usado depois no Passo 2 para validar descontos manuais (vendedor com limite de 10% não consegue dar 20% sem Desconto Excepcional autorizado por gerente).

Por que a tela exige vendedor obrigatório?​

Quando a parametrização Vendedor obrigatório está ativa (em Configurações → Parametrizações → Frente de Caixa (PDV)), o operador não pode fechar a venda sem selecionar um vendedor. A tela foca automaticamente no campo de vendedor ao entrar no Passo 1.

Use essa parametrização em lojas onde a comissão é por vendedor — sem selecionar o vendedor na venda, não há como atribuir a comissão corretamente depois.

Como mudar a empresa faturadora ou o tipo de pedido?​

No Passo 1, há seletores no topo:

  • Empresa (Faturador) — quando você tem múltiplas empresas (matriz + filiais) que faturam pelo mesmo caixa. O padrão é a empresa faturadora configurada no cadastro do caixa.
  • Tipo de Pedido — lista filtrada pela empresa selecionada e pelos tipos habilitados para frente de caixa. Define a regra fiscal aplicada (NFC-e/NF-e), a CFOP, a finalidade da nota etc.
  • Política Comercial — herdada do tipo de pedido por padrão, pode ser sobreposta.
  • Armazém — herdado do tipo de pedido, pode ser sobreposto.

Mudanças nesses seletores afetam todas as buscas de produto subsequentes (preços vêm da política comercial, estoque vem do armazém).

Como mudar a política comercial no meio da venda?​

Quando você muda o seletor de Política Comercial com itens já no carrinho, a tela pergunta:

"Existem itens no pedido. Deseja atualizar os preços dos itens já adicionados para a nova política comercial? Os descontos manuais serão sobrescritos."

  • Sim, atualizar → o sistema busca os preços novos da política comercial selecionada e substitui em todos os itens. Descontos manuais aplicados antes são perdidos (e promoções precisam ser recalculadas no Passo 2).
  • Não, manter → mantém os preços atuais (mas a política da venda no banco vai ser a nova).

Use isso quando identifica o cliente no meio da venda e ele tem um perfil de preço diferente (cliente VIP, atacado etc.).

Como adicionar um produto?​

No Passo 2 (Produtos), há um campo de busca no topo (searchProductInputRef). Várias formas de adicionar:

FormaComo
Leitor de código de barrasPosicione no campo de busca, leia o código com o leitor. O sistema busca automaticamente e adiciona ao carrinho.
Digitar o código manualmenteDigite o código de barras ou o código interno do produto (SKU) e pressione Enter.
Buscar por nome (F4)Pressione F4 ou clique em Consultar Produto. Modal de busca abre com seletor de modo (código vs. nome) e lista de resultados.
Adicionar grade (F9)Para produtos com variações (tamanho, cor), abre a tela de grade para selecionar quantidades de cada variação.
Consulta de estoque (F7)Mostra disponibilidade por armazém antes de decidir.

Cada item vai para a tabela com colunas: imagem, código, nome, preço, quantidade, desconto, valor total. Os totais do pedido e a quantidade de itens são recalculados a cada alteração.

Como funciona o leitor de código de barras?​

O leitor de código de barras (físico, USB ou Bluetooth) emula um teclado — ele "digita" o código e pressiona Enter automaticamente. A tela do PDV precisa estar com o foco no campo de busca de produto (que é o default no Passo 2).

O sistema busca o item pelo código de barras e adiciona com quantidade 1 automaticamente. Se você precisa adicionar 5 unidades, lê o código 5 vezes (ou ajusta a quantidade depois clicando no item).

Quando o produto não é encontrado, abre um warning "Produto não encontrado." e o foco volta para o campo de busca.

Como adicionar produto pesado na balança Toledo?​

Quando a parametrização Usar balança Toledo está ativa, o sistema interpreta códigos de barras no padrão EAN-13 Toledo (começam com 2 + código interno + peso/preço + dígito verificador). O leitor da balança "dispara" um código que já tem o peso embutido — o sistema extrai a quantidade automaticamente e adiciona o item com a quantidade correta.

Útil para mercados, padarias, açougues — qualquer venda por peso onde o operador pesa o produto na balança e o leitor envia o código já com a quantidade pronta.

Como buscar produto por nome/descrição?​

Pressione F4 ou clique em Consultar Produto. Modal abre com 2 modos:

  • Modo Código (padrão) — busca exata pelo código interno do produto (SKU) ou pelo código de barras.
  • Modo Pesquisa — busca textual no nome, código interno ou código de barras (com um pequeno atraso de 1 segundo para evitar muitas chamadas).

Resultado vem em uma lista — selecione e clique em Adicionar (ou pressione Enter). A quantidade pode ser ajustada antes de adicionar.

Como adicionar uma grade (variações)?​

Para produtos com variações (camisa P/M/G em 3 cores, por exemplo), o sistema oferece a grade:

  • Pressione F9 ou clique em Adicionar Grade.
  • Tela abre com matriz de variações (linhas: cores, colunas: tamanhos).
  • Digite a quantidade em cada cela.
  • Salve. Cada cela vira um item separado no carrinho.

Útil para confecções, calçados — quando o cliente compra "2 azuis P + 1 vermelho M + 3 verdes G" de uma vez.

Como consultar o estoque disponível?​

  • Por SKU: ao adicionar um item, a quantidade disponível já aparece no card do produto.
  • Geral: pressione F7 ou clique em Estoque para abrir o modal de Disponibilidade de Estoque — busca por SKU e mostra saldo por armazém.
  • Bloqueio: quando a parametrização Bloquear venda sem estoque está ativa, o sistema bloqueia com a mensagem "Estoque insuficiente. Saldo disponível: X."

Como mudar o armazém de saída do item?​

O armazém padrão vem do tipo de pedido vinculado à venda. Para mudar:

  • O seletor de Armazém no Passo 1 aceita troca manual.
  • A lista é filtrada pelo mesmo centro de distribuição do PDV.
  • A parametrização Permitir trocar armazém no PDV controla se o seletor aparece ou não.

Útil em redes que têm múltiplos depósitos no mesmo CD (ex.: depósito principal + depósito de exposição).

Como alterar quantidade, preço ou desconto de um item?​

Na tabela de itens (Passo 2), cada linha tem ícones de ação à direita. Clique no lápis para abrir o Set Discount Modal:

  • Quantidade — ajuste para mais/menos. O valor total é recalculado.
  • Novo Preço de Venda — substitui o preço do item. O desconto % é calculado automaticamente.
  • % Desconto — desconto percentual sobre o preço de tabela. O novo preço é calculado.

Quando o desconto ultrapassa o limite do vendedor (salesmanDiscountPercentLimit), aparece um aviso e um botão Desconto Excepcional — clique para abrir a modal de autorização por gerente (digite login + senha de um usuário com privilégio).

A coluna Quantidade pode ser editada inline também (sem abrir o modal). Pré-requisito: privilégio Editar quantidade no PDV.

Como remover um item do carrinho?​

Clique no ícone de lixeira na linha do item.

Se o operador não tem o privilégio Remover item pedido, abre a modal de Senha de Gerente — gerente digita login + senha para autorizar. Após autorizado, o item é removido.

O que é "Desconto Excepcional"?​

É a forma de dar um desconto acima do limite do vendedor. Cada vendedor tem um limite de desconto (configurado em Configurações → Comissão). Se o operador tenta dar um desconto além desse limite, o sistema bloqueia e oferece:

  1. Botão Desconto Excepcional aparece no aviso.
  2. Modal abre pedindo Login + Senha de um usuário com autorização (geralmente gerente).
  3. O sistema valida a credencial — se aprovada, libera o desconto e registra quem autorizou no item (para auditoria do desconto excepcional).

Útil para fechar vendas em negociações específicas — o gerente assume a responsabilidade pelo desconto e fica registrado no banco.

Posso vender sem estoque?​

Depende da parametrização Bloquear venda sem estoque:

  • Desligada (padrão) — pode vender mesmo zerando o estoque. Útil para vendas a pedido, encomenda, produtos virtuais.
  • Ligada — o sistema valida se há saldo suficiente e bloqueia com "Estoque insuficiente".

Use bloqueado em lojas com estoque físico crítico (perfumaria, supermercado) onde não dá para vender o que não tem.

Por que não consigo adicionar um item com preço zerado?​

Quando o item não tem preço cadastrado para a política comercial em uso, e a parametrização Bloquear item sem preço está ativa, o sistema bloqueia:

"Não é possível adicionar o item ao pedido. Verifique se existe preço para essa política comercial."

Caso contrário, o item é adicionado com preço 0 e você precisa ajustar manualmente.

Use bloqueado em lojas onde erros de preço causam prejuízo — melhor o operador identificar que falta cadastro do que vender por R$ 0.

Como aplicar um desconto no pedido inteiro?​

Hoje a tela aplica desconto por item (via modal de Set Discount). Para um desconto no pedido inteiro, você precisa aplicar em cada item individualmente, OU criar uma Promoção Regular ativa (ver tela de Promoção PDV) que vale para o pedido todo.

Versões antigas tinham um campo de desconto global no Passo 3, mas o motor de promoções tornou ele redundante — a recomendação é usar promoções automáticas.

Como as promoções automáticas são aplicadas?​

Ao entrar no Passo 3 (Pagamento) com itens no carrinho, o sistema dispara automaticamente o motor de Promoção PDV — que avalia todas as promoções vigentes para a empresa e devolve:

  • Preços recalculados por item.
  • Lista de promoções aplicadas (com nome de cada promoção).
  • Itens de brinde adicionados automaticamente (no caso de "Compre e Ganhe").
  • Múltiplas linhas do mesmo produto quando "Desconto Progressivo" com "Aplicar somente na quantidade exata da faixa" quebra a quantidade em faixas.

O cliente vê os descontos aplicados como uma badge na linha do item ("Compre e ganhe - " etc.). O total é atualizado.

Veja a FAQ de Promoção PDV para as 4 modalidades (Regular, Compre e Ganhe, Progressivo, Compre Junto) e suas regras.

Como adicionar tipos de pagamento?​

No Passo 3, abaixo do resumo, há a área de Pagamentos. Clique em + Adicionar Pagamento para abrir um cartão com:

  • Tipo de Pagamento (Crédito, Débito, Pix, Dinheiro, Vale, Crédito Loja, Fiado, Boleto etc.) — lista filtrada por empresa e pelos tipos habilitados para frente de caixa.
  • Valor — quanto desse tipo vai entrar (pode ser parcial).
  • Parcelamento (apenas para Crédito) — número de parcelas.
  • TID/NSU (apenas para Crédito/Débito processados fora do TEF — entrada manual).
  • Data de Vencimento (apenas para Boleto, Fiado, Cheque).

Adicione quantos pagamentos forem necessários. O sistema mostra o valor restante que ainda falta cobrir do total a pagar. Quando chega a 0 (ou negativo, se houve troco), libera o botão Finalizar Venda.

Posso dividir o pagamento em vários tipos?​

Sim. Quantos pagamentos quiser. Exemplos:

  • Pedido de R$ 150 = R$ 50 dinheiro + R$ 100 cartão de crédito 3x.
  • Pedido de R$ 300 = R$ 100 Pix + R$ 200 crédito loja do cliente.
  • Pedido de R$ 1.000 = R$ 200 dinheiro + R$ 300 cartão débito + R$ 500 fiado (boleto 30 dias).

Cada pagamento vira uma linha na lista de pagamentos. O sistema soma e mostra o valor restante. Cobranças via TEF (Crédito/Débito/Pix) são processadas uma a uma quando você clica em Finalizar — você opera a maquininha para cada uma.

Como funciona o pagamento via maquininha (TEF)?​

Quando o tipo de pagamento tem categoria Crédito (22), Débito (23) ou Pix (24) e a integração da conta bancária é PayGo:

  1. Você adiciona o pagamento (tipo + valor + parcelamento).
  2. Clica em Finalizar Venda.
  3. O sistema manda a venda para a maquininha PayGo para cada pagamento TEF.
  4. A maquininha acende mostrando o valor — o cliente passa o cartão e digita a senha.
  5. Em paralelo, o PDV verifica a maquininha a cada 2 segundos por até 90 segundos (passando disso, aborta e mostra "Consultar Status do Pagamento").
  6. Quando a maquininha responde aprovado, o status vai para Creditado e o sistema captura TID, código de autorização, adquirente, comprovante via estabelecimento e comprovante via cliente.
  7. Se houver mais pagamentos na fila, processa o próximo.
  8. Quando todos os pagamentos foram aprovados, o sistema fecha o pedido e emite a NFC-e.

Veja a FAQ de Transações TEF para detalhes da verificação, status e tratamento de falhas.

Como funciona o pagamento via Pix?​

Mesma rotina do TEF, mas a integração pode ser Stark Bank, Pagar.me ou PayGo Pix (via maquininha). Os 2 primeiros geram um QR Code dinâmico que aparece na tela do PDV — o cliente lê o QR Code com o app do banco e paga.

Após o pagamento, a verificação detecta o sucesso e a venda é fechada.

O QR Code expira em 1 hora por padrão (configurável).

Como funciona o pagamento em dinheiro com troco?​

Quando o tipo é Dinheiro:

  1. Adicione o pagamento informando o valor recebido do cliente (geralmente igual ou maior que o pedido).
  2. O sistema calcula ChangeValue = ValorRecebido - TotalAPagar.
  3. Mostra o troco em destaque ("Troco: R$ X,XX") para o operador devolver ao cliente.

Apenas o valor do pedido é gravado no pagamento da venda — o troco não vira lançamento (é só uma operação física na gaveta).

Como usar vale-presente ou crédito loja do cliente?​

Quando o cliente identificado tem crédito loja (Consumer.ConsumerVoucherValue > 0), o sistema mostra o saldo no Passo 1.

No Passo 3, ao adicionar pagamento, escolha um tipo com categoria Vale (14) ou Crédito Loja. Informe o valor (até o saldo disponível). O sistema valida:

"O cliente possui apenas R$ X de crédito na loja." — se você tentar usar mais.

Quando a venda é fechada, o crédito é debitado do cliente (via integração com o módulo de cliente).

Como vender fiado / boleto / a prazo?​

Tipos de pagamento com categoria Boleto, Fiado ou Cheque não exigem confirmação TEF — eles geram apenas um recebimento em aberto (uma conta a receber com vencimento futuro).

Para esses tipos, o sistema exige o campo Data de Vencimento preenchido. Se omitido:

"Por favor, o campo *DATA VENCIMENTO deve ser preenchido."

Após fechar, a venda vai para o Contas a Receber para gestão financeira (cobrança via boleto bancário, controle do fiado etc.).

Como informar parcelamento e data de vencimento?​

  • Parcelamento (InstallmentTotal) — apenas para tipos de pagamento que aceitam parcelas (Crédito, Boleto, Fiado). Default: 1 (à vista).
  • Data de Vencimento (DateDue) — primeiro vencimento. Para parcelas múltiplas, o sistema calcula as outras automaticamente com base no intervalo configurado no tipo de pagamento.

O parcelamento no TEF Crédito é enviado para a maquininha (que pergunta ao cliente "Loja ou Administradora?") — o parcelamentoAdmin da integração PayGo decide se é "admin" (1) ou "loja" (0).

Como definir frete e despesas acessórias da NF?​

No Passo 3, há campos extras:

  • Valor do Frete — soma ao total a pagar e aparece como frete na nota fiscal.
  • Despesas Acessórias — campo separado para outras despesas (seguro, embalagem etc.).
  • Transportadora — opcional, define a transportadora para a NF.

Esses campos são gravados no pedido e usados na geração da NFC-e/NF-e.

Como cancelar um pagamento TEF aprovado antes de fechar a venda?​

Se você aprovou o cartão na maquininha mas o cliente desistiu antes de fechar a venda, você precisa cancelar a transação TEF para devolver o dinheiro:

  1. Clique no botão Cancelar TEF no Passo 3.
  2. Modal Cancelar Transação TEF abre com a lista de pagamentos aprovados.
  3. Digite a Senha Técnica TEF (fornecida pela PayGo).
  4. Confirme. O sistema cancela cada pagamento aprovado na maquininha.
  5. Mostra mensagens: "Processando..." → "Aguarde ou digite o número do cartão..." (o cliente precisa passar o cartão original em alguns adquirentes) → "Transação cancelada com sucesso!" ou erro.

O tempo limite da verificação é 120 segundos (mais curto que o cancelamento da tela de Transações TEF, que é 180s).

Veja a FAQ de Transações TEF para o fluxo completo de cancelamento.

O que aparece quando o cartão é recusado?​

Quando a maquininha retorna Pagamento recusado ou Expirado:

  • Aparece um bloco vermelho com a mensagem do adquirente: "Pagamento não foi concluído. Valor: R$ X. Forma de pagamento: ...". Motivo: ...".
  • O pagamento fica como não aprovado na lista de pagamentos.
  • A venda não é fechada — você precisa remover o pagamento problemático e tentar outro tipo (outro cartão, dinheiro, Pix etc.).

Quando há erro de comunicação (rede caiu antes da maquininha responder), aparece o botão Consultar Status do Pagamento — clique para verificar de novo e ver se a venda foi processada mesmo assim (PayGo guarda o estado por algum tempo).

Como fechar a venda e emitir o cupom?​

Após adicionar todos os itens (Passo 2) e todos os pagamentos cobrindo o total a pagar (Passo 3):

  1. Clique em Finalizar Venda (F5).
  2. Se algum pagamento é TEF/Pix, o sistema processa cada um (verificação da maquininha/QR Code).
  3. Se a parametrização Permitir escolher tipo de nota está ativa, abre o modal "Qual nota fiscal você quer emitir?" — escolha NFCe ou NF-e.
  4. Se a parametrização Pedir CPF na nota está ativa, abre o modal "Incluir CPF na nota?" — escolha Sim ou Não.
  5. O sistema cria o pedido com tudo: itens + pagamentos + cliente + cabeçalho.
  6. O pedido gera os recebimentos, emite a NFC-e na SEFAZ (ou NF-e) e gera o cupom fiscal eletrônico (DANFE 65) pronto para impressão.
  7. O PDV imprime automaticamente na impressora padrão configurada.
  8. Mensagem "Venda finalizada com sucesso!" e o carrinho é limpo para a próxima venda.

Como é decidido qual nota fiscal emitir (NFCe vs NFe)?​

  • Quando o tipo de pedido está configurado para emitir NFCe → NFCe (modelo 65) automaticamente.
  • Quando está configurado para emitir NF-e → NF-e (modelo 55).
  • Quando o tipo aceita os dois e a parametrização Permitir escolher tipo de nota está ativa, o sistema pergunta ao operador no momento de finalizar.

NFCe é típica de varejo presencial (consumidor final). NF-e é típica de B2B ou quando o cliente pede a nota completa.

O que é a pergunta "Incluir CPF na nota"?​

Quando a parametrização Pedir CPF na nota está ativa, ao finalizar a venda o sistema mostra:

"Deseja incluir o CPF do cliente na nota fiscal? Sim / Não"

  • Sim → o CPF/CNPJ do cliente vai para o campo de destinatário da NFCe (para o cliente abater no IR/PIS-COFINS depois).
  • Não → a NFCe é emitida como "Consumidor Final" sem CPF.

Quando você diz Sim mas o pedido não tem cliente vinculado, o sistema bloqueia: "Não é possível informar CPF na nota sem cliente vinculado. Por favor, selecione um cliente, adicione novamente os pagamentos e tente novamente."

Como imprimir o cupom da venda?​

Automático ao finalizar — o sistema envia o DANFE 65 (cupom fiscal eletrônico) para a impressora padrão configurada nas parametrizações da empresa (precisa do QzTray instalado e configurado no terminal).

Se a impressão falha (erro de comunicação, papel acabou), aparece a mensagem e você pode reimprimir (botão "Imprimir" continua disponível na tela de sucesso).

Como reimprimir um cupom anterior?​

Use o menu Histórico (Ctrl+4) — lista todos os pedidos do caixa. Clique no ícone de impressora ao lado do pedido desejado:

  • O sistema regenera o cupom a partir do pedido.
  • Envia para a impressora padrão.

Funciona até fim do dia (depois disso, use a tela de Pedidos ou Cupons Fiscais no menu Fiscal).

O que acontece se a NF dá erro na SEFAZ?​

A SEFAZ pode rejeitar a NFCe por várias razões (CFOP errada, CSC inválido, certificado vencido, sistema da Receita fora do ar etc.). Quando isso acontece, o sistema mostra a mensagem da SEFAZ retornada na tentativa de emissão.

A tela mostra a mensagem em vermelho e não fecha a venda. O operador pode:

  1. Tentar de novo (se for erro intermitente da SEFAZ).
  2. Voltar para o Passo 2 e ajustar (ex.: trocar o tipo de pedido para um com CFOP correta).
  3. Cancelar a venda e voltar para a tela inicial.

Quando o erro é da contingência (a SEFAZ está fora do ar há horas), o sistema pode operar em modo offline (depende da configuração da empresa) — emite o cupom localmente e sincroniza com a SEFAZ depois.

Posso cancelar uma venda já fechada?​

Sim, com privilégio. Use o menu Histórico (Ctrl+4) — abre a lista de pedidos do caixa. Selecione o pedido e clique em Cancelar Pedido.

  • Privilégio: Cancelar pedido. Sem ele, o sistema pede senha de gerente.
  • O cancelamento gera a NFCe de cancelamento automaticamente (envia para a SEFAZ).
  • O dinheiro recebido não é estornado automaticamente — você precisa fazer uma devolução em dinheiro manualmente (sangria + entregar o dinheiro ao cliente) ou cancelar a transação TEF na tela de Transações TEF.

Cancelamento de venda só funciona até 30 minutos após a emissão (limite da SEFAZ para NFCe). Depois disso, precisa estornar via NFCe complementar.

O que é "Venda como brinde / Bipar Brinde"?​

Quando o pedido tem itens de brinde (gerados por uma promoção Compre e Ganhe), eles aparecem na tabela com badge Brinde e preço R$ 0,00.

Antes de finalizar a venda, o operador precisa bipar cada brinde (passar o leitor de código de barras no produto físico) para confirmar que separou e entregou o brinde ao cliente:

  1. Foque no campo de busca de brinde.
  2. Leia o código do brinde com o leitor.
  3. O status do brinde muda para Bipado na linha.
  4. Repita para cada brinde da lista.

Se você tentar finalizar sem bipar todos os brindes, aparece o modal: "Há brindes que não foram bipados, deseja continuar?" — você pode escolher continuar mesmo assim (os brindes não bipados não vão para a NF).

A regra protege contra brindes "esquecidos" — quem implementou se preocupou em garantir que o cliente leve o brinde fisicamente.

Quais os atalhos do menu principal?​

TeclaAçãoQuando habilita
F4Consultar ProdutoPasso 2
F5Finalizar VendaPasso 3
F7Estoque (modal de disponibilidade)Passo 2
F8Cancelar Pedido / Limpar CarrinhoQualquer momento
F9Grade de variaçõesPasso 2
F10Voltar StepQualquer momento
F12Próximo StepQualquer momento
Ctrl+1Fechamento de CaixaSem itens no carrinho
Ctrl+2SangriaSem itens no carrinho
Ctrl+3ReforçoSem itens no carrinho
Ctrl+4Histórico de pedidosSempre
Ctrl+5Retirada (Withdrawal)Sem itens no carrinho
Ctrl+6Troca / DevoluçãoSem itens no carrinho
Ctrl+7Salvar Pedido (rascunho)Sempre

Operações que mexem com caixa físico (sangria, reforço, fechamento) ou com outro pedido (troca/devolução, retirada) só funcionam com o carrinho vazio — para evitar perder a venda em montagem.

O que é Histórico no menu?​

Menu Ctrl+4 → Histórico. Abre uma modal listando todos os pedidos da sessão atual (vendas fechadas no caixa hoje). Cada linha mostra:

  • Data/hora
  • Nº do pedido
  • Cliente
  • Valor
  • Forma de pagamento principal
  • Status (Faturado, Cancelado, Pendente NF)
  • Ações: Imprimir cupom, Cancelar pedido

Útil para reimprimir cupons, conferir vendas e cancelar erros recentes sem sair do PDV.

O que é Retirada (Withdrawal)?​

Menu Ctrl+5 → Retirada. Abre uma modal para registrar uma retirada de produto pelo cliente — usada em vendas anteriores onde o cliente comprou mas não levou (ex.: encomenda, retirada futura).

Permite buscar o pedido em aberto, identificar quais itens são para retirada e marcar como entregue. Gera o registro de saída do estoque sem emitir nova NF.

O que é Troca / Devolução?​

Menu Ctrl+6 → Troca / Devolução. Abre o fluxo de devolução de produtos de uma venda anterior. Permite:

  1. Buscar o pedido original (por código ou cliente).
  2. Selecionar quais itens estão sendo devolvidos.
  3. Decidir: Devolução total (estorno em dinheiro/crédito loja) ou Troca (devolve A e leva B com diferença a pagar/receber).

Gera a NF de Devolução (modelo 55 com CFOP de retorno) na SEFAZ e cria os lançamentos financeiros correspondentes (estorno do recebimento ou crédito ao cliente).

O que é Rascunho de Pedido?​

Menu Rascunho de Pedido. Abre a lista de rascunhos salvos no caixa — pedidos que foram iniciados mas não finalizados (cliente foi pegar mais coisas, terminal travou, operador saiu para almoçar etc.).

Selecione um rascunho e clique em Retomar — o sistema restaura o estado completo: itens, cliente, pagamentos, observações etc. Você continua de onde parou.

Os rascunhos são gerados automaticamente pelo motor de promoções a cada alteração do carrinho — então sempre há um snapshot recente disponível.

O que é Consultar Preços?​

Menu Consultar Preços. Abre uma modal de consulta rápida de preços — útil para responder "Quanto custa esse produto?" sem precisar adicionar ao carrinho. Busca por código ou nome e mostra o preço de venda + saldo em estoque.

Não consome estoque nem altera o carrinho atual.

O que é Transferência de Saldo?​

Menu Transferência de Saldo. Permite mover dinheiro entre dois caixas do PDV — útil quando você precisa abastecer outro caixa com troco ou consolidar valores no fim do dia.

Exemplo: o Caixa 1 está com R$ 5.000 em dinheiro e o Caixa 2 abre o dia precisando de troco. Transferência de R$ 200 do Caixa 1 para o Caixa 2 gera 2 lançamentos: uma sangria no Caixa 1 (saída) e um reforço no Caixa 2 (entrada).

O que faz "Salvar Pedido" (Ctrl+7)?​

Salva o estado atual do carrinho como rascunho de pedido mantendo a tela aberta. Útil quando o cliente pede uma pausa ("vou pegar mais um produto") e você quer garantir que se algo acontecer (travamento, queda de luz), a venda não é perdida.

O salvamento na verdade já acontece automaticamente a cada alteração do carrinho — o Ctrl+7 apenas força o salvamento e mostra notificação visual de confirmação.

O que é sangria?​

Sangria é a retirada de dinheiro físico do caixa durante o expediente — para reduzir o volume guardado na gaveta (segurança), enviar para o cofre, depositar no banco etc. É um lançamento de débito no caixa.

O que é reforço?​

Reforço é a adição de dinheiro físico ao caixa durante o expediente — geralmente para abastecer com troco quando o caixa está com pouco dinheiro miúdo. É um lançamento de crédito no caixa.

Como fazer uma sangria?​

  1. Ctrl+2 (com o carrinho vazio) ou menu → Sangria.
  2. Modal Sangria abre.
  3. Informe o Valor (em R$, positivo).
  4. Observação opcional (motivo: "Envio para cofre", "Pagamento de fornecedor", etc.).
  5. Digite sua Senha.
  6. Confirme.

O sistema valida que o saldo do caixa cobre o valor da sangria (não pode sangrar mais do que tem disponível). Se passa, cria o lançamento no extrato bancário do caixa com descrição "Sangria: <Observação>" e gera o recibo (impresso automaticamente — uma via fica com você, outra com quem recebeu o dinheiro).

Por que a sangria foi recusada por "valor maior que disponível"?​

O caixa tem menos dinheiro disponível do que o valor que você quer sangrar. O cálculo é:

Balance = soma(créditos) - soma(débitos) até agora
Valor disponível = Balance

Quando você tenta sangrar mais que o Balance, o sistema bloqueia com Sangria não pode ser realizada, pois valor é maior que disponível. Isso evita "saldos negativos" no caixa (que indicariam erro de operação).

Como resolver: confira o saldo real do caixa, conte fisicamente o dinheiro disponível, e sangre apenas o que tem. Se a divergência for real, registre como observação no fechamento do caixa.

Posso fazer sangria/reforço com itens no carrinho?​

Não. O menu desabilita as opções de Fechamento, Sangria, Reforço, Retirada, Troca, Rascunho e Sair quando há itens no carrinho. Se você forçar (tentar usar o atalho Ctrl+1/2/3), aparece o aviso:

"Esta ação não pode ser realizada pois existem itens no pedido."

O motivo é proteger a venda em montagem — sangria/reforço/fechamento são operações que não dialogam com o carrinho e poderiam confundir o operador (perder a venda ao mudar de contexto).

Para liberar: finalize a venda atual, ou cancele (F8) e depois faça a operação.

O recibo de sangria/reforço sai impresso?​

Sim, automático. Logo após o lançamento, o sistema gera o recibo em ZPL (formato da impressora Zebra) e o PDV envia direto para a impressora padrão.

O recibo tem:

  • Razão Social + CNPJ da empresa
  • Operador (nome + id)
  • Tipo (REFORÇO ou SANGRIA)
  • Valor formatado em R$
  • Data e hora
  • Caixa + código do caixa
  • Observação (motivo)
  • Espaço para assinatura do responsável (a pessoa que recebeu o dinheiro retirado, no caso de sangria)

Geralmente o operador imprime 2 vias — uma fica anexada ao caixa, outra com quem recebeu/entregou o dinheiro.

Como fechar o caixa no fim do dia?​

  1. Ctrl+1 (com carrinho vazio) ou menu → Fechamento.
  2. Modal Fechamento de Caixa abre.
  3. Tela mostra o resumo financeiro completo:
    • Saldo Anterior
    • Total Vendas por tipo de pagamento
    • Reforços e Sangrias
    • Saldo Final Esperado (o que o sistema calculou)
  4. Conte fisicamente o dinheiro no caixa.
  5. Informe o Valor de Fechamento (o que você apurou na contagem física).
  6. Se houver divergência, preencha a Observação com o motivo (sobra/quebra, dinheiro perdido etc.).
  7. Digite sua Senha.
  8. Confirme.

O sistema grava o RecordTimestampClose, gera ajuste automático se houver divergência, e devolve para a tela inicial do PDV. Antes de fechar de fato, o PDV pergunta se você quer imprimir o extrato e o resumo fiscal — recomendado.

O que é o "Valor de Fechamento"?​

É o dinheiro físico que você apurou na contagem física do caixa no momento do fechamento. Deve ser comparado com o Saldo Final Esperado que o sistema mostra.

  • Iguais (diferença < R$ 0,01) → fechamento limpo, sem ajustes.
  • Diferentes → gera lançamento "Ajuste fechamento de caixa" automaticamente e exige a observação preenchida (motivo da divergência).

Sobras/quebras pequenas (R$ 1-5) são normais (cliente esquece troco, erro de digitação). Divergências grandes (R$ 50+) precisam de investigação — pode ser sangria não registrada, devolução errada, ou problema mais sério.

O que acontece quando o valor declarado é diferente do calculado?​

O sistema gera automaticamente um lançamento no extrato bancário do caixa com:

  • Descrição: "Ajuste fechamento de caixa"
  • Tipo: crédito (se sobra) ou débito (se falta)
  • Valor: a diferença absoluta
  • Vinculado à sessão fechada

Esse ajuste mantém o saldo do caixa coerente com o que tem fisicamente — o próximo dia abre com o valor real, não o teórico.

Além disso, a Observação preenchida pelo operador fica gravada na sessão do caixa para consulta posterior pelo gerente/financeiro (auditoria).

O que é o Extrato do caixa?​

É o detalhamento completo da sessão — todos os pedidos, todas as transações bancárias, todas as sangrias/reforços, totais por tipo de pagamento. Disponível na tela de Histórico Caixa (menu separado).

O PDV oferece um resumo simplificado no fechamento (Saldo Anterior + Total por Tipo + Reforço + Sangria + Saldo Final), mas para a análise detalhada (que pedido fechou em que horário, quem foi o cliente, qual a NF emitida), use o Extrato no Histórico Caixa.

O que é o Resumo Fiscal?​

É o bloco fiscal do recibo de fechamento — quantas NFCe foram emitidas, quantas NF-e, quantas estão pendentes, valor total de cada modelo. Útil para a contabilidade conferir contra os arquivos XML enviados à SEFAZ.

O sistema gera um recibo fiscal em ZPL separado quando o caixa é consultado. O PDV imprime junto com o fechamento ou separadamente.

Como imprimir o relatório de fechamento?​

Na modal de fechamento, antes de confirmar, o sistema oferece Imprimir Extrato e Imprimir Resumo Fiscal — os dois recibos (em ZPL) já vêm prontos da consulta do caixa e são enviados para a impressora padrão.

Geralmente recomenda imprimir antes de fechar para conferência, e novamente depois de fechar para o arquivo do dia.

Posso reabrir um caixa fechado?​

Não pelo PDV. Uma vez fechado, a sessão está fechada — o RecordTimestampClose é gravado e a sessão fica imutável.

Para o próximo dia, você abre uma nova sessão no mesmo caixa físico. O saldo continua de onde parou (inclui qualquer ajuste de fechamento do dia anterior).

Se precisa corrigir um fechamento errado, isso é uma operação administrativa (financeiro/TI) — alterar via banco com cuidado, pois afeta o saldo e relatórios.

O que acontece se o navegador fechar no meio da venda?​

A tela salva o estado no próprio navegador (armazenamento local do PDV) a cada alteração do carrinho.

Quando você reabre o PDV (mesmo no mesmo navegador ou em outro), a tela detecta os dados salvos e:

  1. Restaura automaticamente todos os campos (itens, pagamentos, cliente, observações, etc.).
  2. Mostra a notificação: "Venda interrompida recuperada automaticamente."
  3. Você continua de onde parou.

Quando a venda é finalizada com sucesso, o armazenamento local do PDV é limpo.

Como retomar uma venda iniciada em outro terminal?​

Para retomar venda iniciada em outro computador (caso a recuperação local não vale), use o menu Rascunho de Pedido:

  1. Acesse o menu (item Rascunho de Pedido).
  2. Lista de rascunhos disponíveis no caixa atual.
  3. Selecione e clique Retomar.
  4. A tela restaura o estado completo (mesmo fluxo da recuperação automática).

Útil quando você começou uma venda no terminal A, foi com o cliente para o terminal B (atendimento personalizado, prova de roupa etc.) e quer continuar lá.

Qual a diferença entre rascunho local e rascunho do servidor?​

AspectoRascunho localRascunho no servidor
OndeNo navegador (terminal local)No servidor do idworks
Disponível em outro terminal?NãoSim
Atualizado quando?A cada alteração do estado (em tempo real)Sempre que o motor de promoções recalcula o pedido
Quando é limpo?Ao finalizar a venda ou ao limpar o carrinhoAo apagar manualmente ou ao finalizar a venda
Resiliente a queda do servidor?SimNão

Os dois coexistem: o rascunho local cobre o cenário "meu navegador travou" (mais frequente, recuperação instantânea), e o rascunho no servidor cobre o cenário "preciso continuar em outro terminal" (raro, mas crítico).

Quais parametrizações afetam o PDV?​

Em Configurações → Parametrizações:

ParametrizaçãoSubmenuO que muda quando ativada
Verificar configuração na abertura do caixaFrente de Caixa (PDV)Valida configurações fiscais (NFCe, regra fiscal, tipo de pagamento) antes de permitir abrir o caixa.
Permitir escolher tipo de notaFrente de Caixa (PDV)Pergunta ao operador qual NF emitir (NFCe ou NF-e) antes de finalizar.
Casas decimais da quantidadeFrente de Caixa (PDV)Casas decimais permitidas no campo de quantidade do item (máx. 2; 0 para inteiros).
Vendedor obrigatórioFrente de Caixa (PDV)Exige vendedor selecionado para fechar a venda.
Bloquear item sem preçoFrente de Caixa (PDV)Bloqueia adição de item sem preço para a política comercial em uso.
Permitir trocar armazém no PDVFrente de Caixa (PDV)Permite mudar o armazém de saída do item ao adicionar.
Usar balança ToledoFrente de Caixa (PDV)Interpreta códigos de barras da balança Toledo (EAN-13 com peso embutido).
Limitar políticas no PDVFrente de Caixa (PDV)Mostra no PDV apenas políticas comerciais do tipo de pedido configurado.
Cor do PDVFrente de Caixa (PDV)Cor de destaque do PDV (em hexadecimal, ex.: #FF5733).
Bloquear venda sem estoqueFrente de Caixa (PDV)Bloqueia venda sem estoque (não permite adicionar item com saldo zerado).
Pedir CPF na notaFrente de Caixa (PDV)Pergunta se quer incluir CPF na nota antes de finalizar.
Impressora ZPL padrãoImpressãoNome da impressora padrão para ZPL (cupom fiscal). Usada via QzTray.
Impressora de recibo padrãoImpressãoNome da impressora padrão para recibos (sangria, reforço, fechamento).

Como personalizar a cor do PDV?​

Configure a parametrização Cor do PDV com um código de cor hex (ex.: #0091CE para azul, #18AA8C para verde). O valor precisa ser um hex válido (3 ou 6 dígitos) — caso contrário, o PDV usa a cor padrão.

A cor é aplicada nos elementos de destaque (botões principais, banners, alertas) — útil para diferenciar o PDV de diferentes empresas/marcas no mesmo grupo.

Como configurar a impressora padrão?​

Pré-requisito: QzTray instalado no terminal (download em qz.io, gratuito). É um pequeno serviço que roda em background no PC do operador e expõe as impressoras locais para o browser via WebSocket.

Configure:

  1. Impressora ZPL padrão = nome exato da impressora ZPL (Zebra, Argox, Elgin) — usada para cupom fiscal.
  2. Impressora de recibo padrão = nome exato da impressora de recibos (Bematech, Daruma, Epson térmica) — usada para sangria/reforço/fechamento.

Sem essas configurações, a impressão abre uma janela do QzTray pedindo para o operador escolher a impressora a cada vez — funciona mas é mais lento e propenso a erro.

Quando o sistema pede senha de gerente?​

Em 3 situações principais:

  1. Remover item do carrinho (Passo 2) — privilégio Remover item no PDV.
  2. Cancelar pedido (durante a montagem) — privilégio Cancelar pedido no PDV.
  3. Desconto excepcional (acima do limite do vendedor) — privilégio especial vinculado ao desconto.
  4. Editar transação TEF (alteração de detalhes) — privilégio Editar transação TEF no PDV.

Quando o operador corrente não tem o privilégio, abre a modal Senha de Gerente automaticamente.

Como autorizar uma ação restrita?​

Modal Senha de Gerente:

  1. Operador comum tenta a ação (clica no botão de remover, por exemplo).
  2. Sistema detecta que falta privilégio e abre a modal.
  3. Operador chama o gerente.
  4. Gerente digita o próprio login e a própria senha na modal.
  5. O sistema valida a credencial do gerente contra o privilégio necessário para a ação.
  6. Se o gerente tem o privilégio e a senha está certa → autoriza a ação (executa o que estava bloqueado).
  7. Se falha → "Erro ao autorizar ação" e a operação não acontece.

O log da ação fica no nome do operador original (não do gerente), mas a autorização fica registrada para auditoria.

Como o saldo do caixa é calculado?​

O Saldo do caixa é o somatório do extrato bancário dele:

  • Soma todos os créditos (vendas em dinheiro, reforços, recebimentos baixados em dinheiro).
  • Subtrai todos os débitos (sangrias, devoluções, ajustes negativos).

O cálculo considera todos os lançamentos desde o início do caixa — não apenas a sessão atual. Por isso o saldo persistente entre sessões (você fechou ontem com R$ 850, abre hoje com R$ 850).

Qual a diferença entre Income, Outcome, AdjustIn e AdjustOut?​

São subtotais do movimento da sessão atual (desde a abertura do caixa até agora):

  • Income (entradas) — soma de créditos descontados os pagamentos em dinheiro nos pedidos (para evitar dupla contagem — o dinheiro já entrou na venda; não conta de novo).
  • Outcome (saídas) — soma de débitos (saídas).
  • AdjustIn (reforços) — subconjunto de Income: créditos manuais, não vindos de pedido (entradas avulsas para troco etc.).
  • AdjustOut (sangrias) — subconjunto de Outcome: débitos manuais (retiradas avulsas).

Visualmente, no fechamento o operador vê:

  • Income (Total das entradas)
  • Outcome (Total das saídas)
  • Reforços
  • Sangrias
  • Vendas (resumo de pagamentos por tipo)

Como o pagamento fica vinculado ao pedido final?​

O sistema usa um identificador único da tentativa de pagamento que liga a transação TEF ao pedido final. Funciona assim:

  1. Operador adiciona um pagamento TEF no Passo 3.
  2. O PDV gera o identificador e envia para a maquininha junto com o tipo de pagamento e valor.
  3. O identificador fica gravado na transação TEF.
  4. Cliente paga, a verificação confirma sucesso.
  5. Ao finalizar a venda, o PDV grava o pedido com o mesmo identificador.
  6. O sistema cria a ligação transação TEF → pedido usando esse identificador.
  7. Assim, é possível depois consultar: "esse pagamento virou esse pedido".

Sem isso, não dá para correlacionar uma transação TEF (que aconteceu antes do pedido existir) com a venda final.

Por que existe o rascunho no servidor?​

É a cópia do carrinho guardada no servidor do idworks — para permitir:

  1. Retomar venda em outro terminal (quando a recuperação local não está disponível).
  2. Recuperação de venda interrompida quando o navegador fecha e o armazenamento local é perdido.
  3. Backup automático da operação atual (atualizado sempre que o motor de promoções recalcula).

O conteúdo é o estado completo do carrinho: itens, pagamentos, cliente, tipo de pedido, política comercial, vendedor, observações, etc.

A criação/atualização é automática (sem precisar clicar em "Salvar") — o motor de promoções sempre grava o rascunho no servidor depois de calcular as promoções.

Por que aparece "Total de valor cancelado" no caixa?​

Esse valor no detalhe do caixa é a diferença entre o Income (entradas) do movimento e o total de pagamentos em dinheiro que efetivamente entraram nos pedidos.

Quando há divergência (ex.: uma venda foi cancelada mas o estorno do dinheiro não foi feito ainda), o sistema mostra esse valor "fantasma" — útil para identificar vendas canceladas que ainda precisam de tratamento financeiro.

Em operação limpa, esse valor deve ser R$ 0,00.

Como o sistema impede dois usuários de abrirem o mesmo caixa ao mesmo tempo?​

Quando 2 usuários tentam abrir o mesmo caixa ao mesmo tempo, o sistema usa uma trava de concorrência (vale por 10 segundos):

  1. Primeiro usuário clica em Abrir Caixa.
  2. O sistema verifica se já existe trava para esse caixa — não existe.
  3. O sistema cria a trava com validade de 10 segundos.
  4. Segundo usuário clica em Abrir Caixa (segundos depois).
  5. O sistema verifica a trava — já existe.
  6. Retorna Caixa já esta em processo de abertura (sem chegar a criar nova sessão).
  7. Primeiro usuário termina a operação (a sessão é criada).
  8. A trava expira sozinha (10 segundos).

A trava garante que nunca dois usuários conseguem abrir o mesmo caixa simultaneamente (o que geraria 2 sessões "abertas" em paralelo, quebrando todas as consultas).

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar frente de caixaAcesso à tela. Sem isso, a tela não aparece no menu.
Remover item pedidoRemover item do carrinho durante a montagem. Sem isso, pede senha de gerente.
Cancelar pedidoCancelar a venda em montagem (limpar carrinho). Sem isso, pede senha de gerente.
Alterar detalhes de transação PDVEditar TID, NSU, tipo de pagamento, parcelas de uma transação TEF. Sem isso, pede senha de gerente (ver tela Histórico Caixa).
Visualizar resumo frente de caixaVê o resumo financeiro do caixa no fechamento. Sem isso, opera mas não enxerga totais.
Visualizar valor fechamento de caixaVê o valor de fechamento esperado (campo "Saldo Final Esperado").
Editar quantidade item PDVEdita a quantidade de um item inline na tabela (sem abrir o modal de Aplicar Desconto).

Sem o privilégio principal Visualizar frente de caixa, a tela nem abre — o sistema redireciona para a tela anterior. Os outros privilégios são granulares e podem ser combinados em perfis específicos (ex.: operador comum tem Visualizar + Editar quantidade; gerente tem todos).

Para abertura/fechamento de caixa, o controle é pela senha do usuário — qualquer usuário ativo com vínculo à empresa pode abrir um caixa (não há privilégio específico). Isso é intencional: o controle é operacional (a empresa decide quem fica em qual caixa físico), não por permissão.