PDV Multi-Commerce — Manual do Usuário

Sistema de frente de caixa (PDV) multi-segmento: **mercado, padaria, farmácia, açougue, hortifruti e

varejo**. Este manual cobre o uso diário. Guias detalhados por perfil ficam em

docs/manual/.

Primeiros passos

  1. Abra o PDV Terminal instalado no caixa. No primeiro uso, informe o nome do terminal e o

endereço do servidor da loja.

  1. Faça login com seu usuário. Se a conta tiver 2FA, informe o código do autenticador ou um código

de recuperação.

  1. Selecione a loja e informe o fundo de troco. Se já existir uma sessão de caixa para o operador,

ela será retomada automaticamente.

  1. O que você vê depende do segmento da loja e do seu perfil (operador, gerente…). Cada

segmento habilita módulos diferentes (vendas, estoque, fiscal, padaria, farmácia, fidelidade…).

  1. Detalhes: Primeiros passos.

A interface WPF cobre conexão, login, seleção de loja, abertura/retomada do caixa, busca,

carrinho, dinheiro, Pix, cartão, pagamentos mistos, operações de caixa com aprovação e monitor

fiscal. Impressão térmica e abertura da gaveta são feitas pelo próprio terminal; a balança ainda

está em reconstrução.

Operador de caixa

A tela de venda é otimizada para teclado (agilidade no balcão).

código de barras e pressione Enter. Informe a quantidade antes de adicionar quando necessário.

F2 para voltar à busca e F9 para cancelar o carrinho inteiro.

1–6 ou pelo card correspondente e ele recebe o que falta; para dividir a venda, informe

antes o valor da parte (F7 foca o campo, F5 preenche o restante). O painel mostra

recebido, restante e troco.

fechamento. Operadores aguardam gerente/dono; a aprovação pode ocorrer no próprio terminal com

senha/TOTP ou remotamente pelo painel de gestão.

autorizações, contingências, rejeições e prazos. Uma NFC-e em contingência pode ser retransmitida

imediatamente; o servidor também tenta novamente de forma automática.

sozinho até eles quando a cobrança nasce. Depois do pagamento, use Consultar pagamento; o

servidor também recebe confirmação por webhook quando configurado. Cancelar cobrança desfaz

uma cobrança pendente sem esperar os 30 minutos da expiração — o servidor reconsulta o provedor

antes, então quem pagou no último instante tem o Pix confirmado, não descartado.

autorização antes de concluir.

um teste. O cupom pode sair automaticamente; na conclusão também há Reimprimir cupom.

dinheiro e use Cancelar venda. Informe uma justificativa de 15 a 255 caracteres e obtenha a

autorização do gerente/dono. O servidor cancela a NFC-e autorizada, restaura estoque e pontos e

registra a devolução como saída da gaveta. Se a SEFAZ estiver indisponível, a solicitação fica

protegida e o servidor tenta novamente; o caixa usado na devolução deve permanecer aberto até a

conclusão. Se faltar numerário, faça um reforço antes. Pix, cartão, voucher e crediário

permanecem bloqueados até existir estorno confirmado pelo provedor.

com dinheiro. Pix e cartão não abrem a gaveta.

empresa, os pontos são creditados sozinhos ao concluir — piso do total após desconto × taxa

configurada, em qualquer meio de pagamento. Cancelar a venda estorna exatamente o que ela gerou.

erro, cartão aprovado/recusado, Pix, venda concluída, gaveta, aprovação e nova comanda. No

desktop, use Som/Mudo no cabeçalho para silenciar ou reativar; a escolha fica

salva somente naquele computador. No web, Configurações → Sons do caixa também permite

ajustar volume, timbre e cada aviso. No primeiro uso, ambos adotam o perfil recomendado pelo

segmento da loja: Loja movimentada, Discreto, Produção ou Equilibrado.

Operação sem internet externa

O Angular não possui mais modo PWA/offline e o terminal WPF não mantém banco ou fila de vendas.

Todos os caixas usam o servidor local como autoridade. Se a internet externa cair, vendas em

dinheiro continuam pela LAN; Pix/cartão dependem do provedor e a NFC-e segue a contingência fiscal

do servidor. Se o servidor local ou a rede da loja cair, o terminal bloqueia novas operações para

evitar divergência de estoque, caixa e numeração.

Fiscal (NFC-e / NF-e)

autorização superior, reposição de estoque e devolução registrada na gaveta.

retransmissão individual de contingências.

Gerente

vendas, ticket médio, descontos e alertas de estoque; o Angular web continua disponível.

os módulos permitidos pelo plano e, se o catálogo estiver vazio, criar modelos iniciais. Os

modelos ficam inativos e sem tributação ou preço; revise-os com o contador antes de ativar.

Agora não adia a configuração sem alterar a loja.

Depois de atualizar os dados, use Exportar Excel para obter uma planilha com abas separadas ou

Exportar PDF para gerar um documento paginado. Os arquivos são gravados em

Documentos\PDV\Relatorios; ao mudar o período, atualize o relatório antes de exportar.

A tela reúne evolução diária da loja ativa, ranking multi-loja, recebimentos, produtos de maior

receita e situação fiscal separada por modelo e ambiente.

Em Envio automático por e-mail, escolha frequência diária, semanal ou mensal, horário e até

cinco destinatários. O relatório diário cobre ontem; o semanal, os sete dias encerrados ontem;

e o mensal, o mês anterior. A tela informa próxima execução, último envio ou falha do provedor.

participação no catálogo global.

último custo, movimentos e lotes a vencer. Ajustes de saldo exigem motivo e mantêm o histórico.

não alteram saldos; no recebimento, confira quantidade, custo, lote e validade antes de confirmar

a entrada no estoque.

endereço, taxa e itens do catálogo e avance a fila. No caixa WPF, use Delivery, selecione o

pedido e carregue-o: preços, quantidades, desconto, taxa e CPF/CNPJ são preenchidos e protegidos

contra edição. Ao receber o pagamento, o servidor vincula pedido e venda, baixa estoque e grava

a taxa como frete da NFC-e na mesma transação. No Gerencial, a conclusão reconhece esse vínculo

automaticamente. Em Entregadores, mantenha nome, telefone, veículo e placa da equipe. Um

pedido de entrega pronto só é despachado após selecionar um entregador ativo; a fila passa a

mostrar responsável e horário de saída. Entregador com pedido em rota não pode ser desativado.

A interface Angular preservada também oferece Delivery com fila, indicadores, novo pedido,

histórico e entregadores. Em loja on-premise, conecte Gerencial, Angular e caixas ao servidor local.

dados no checkout. O servidor reconfirma preço, promoção, frete e estoque antes de criar o pedido.

Quando a faixa Ambiente de demonstração estiver visível, todo o fluxo é simulado e pedido,

Pix e documento fiscal exibidos não têm valor real; use-o apenas para treinamento e validação.

Em loja cloud, o saldo é reservado imediatamente; em loja on-premise, a tela aguarda a confirmação

do servidor local sem cobrar o cliente. O código e o acompanhamento ficam disponíveis no mesmo

navegador. A reserva expira após 15 minutos sem avanço e o saldo é liberado automaticamente.

Depois da reserva, o acompanhamento mostra o Pix copia e cola. Ao confirmar o pagamento, o pedido

entra em Loja virtual no aplicativo do gerente: Pago → Em separação → Pronto; retirada pode

ser concluída, enquanto entrega local precisa registrar a saída antes da conclusão. Cada mudança

pode gerar aviso transacional pelo WhatsApp configurado. O CPF/CNPJ na nota é opcional no checkout.

Antes da separação, o sistema registra a venda, consome a reserva uma única vez e entrega o evento

ao fiscal. Para cancelar, informe justificativa de 15 a 255 caracteres; pedidos pagos ficam em

Estorno pendente até PSP, NFC-e e estoque serem reconciliados, sem cobrança ou baixa duplicada.

manual com motivo. Em Pontos por R$ 1,00 defina a taxa da empresa (0 desliga o crédito

automático; frações como 0,5 são aceitas). O saldo é da empresa: o cliente acumula numa filial e

resgata em outra.

aplicativo fica protegida pelo Windows.

emissão automática e contingência. O token CSC vazio preserva o valor já cadastrado.

loja. Resolva primeiro os bloqueados; depois execute os testes manuais indicados para SEFAZ,

impressora, balança e pinpad. Verificar agora atualiza o diagnóstico sem emitir ou cobrar.

com a data em que cada terminal apareceu pela última vez. Quando há versão publicada, a tela mostra

o endereço e o código de verificação (SHA-256) — o sistema não instala nada sozinho; a atualização

é feita pelo instalador. Se aparecer aviso de migrations pendentes, resolva isso antes de

atualizar qualquer aplicativo. No cliente web a mesma informação fica em Operação, junto com a

saúde das integrações.

catálogo, indicadores e integração fiscal sem visualizar segredos.

imediatamente e fica gravada apenas para o aplicativo e usuário do Windows atuais.

da plataforma — usam um modelo diferente: Claro, Escuro ou Acompanhar o Windows, mais

uma cor de destaque escolhida entre oito opções (ou a cor do próprio Windows). A mudança vale

na hora e fica gravada só naquele computador e usuário, em appearance.json na pasta do

aplicativo.

aparece na tela de entrada, antes do login, porque é preferência da máquina.

categoria, marcando quais exigem conexão com o servidor.

Equipe e Aprovações.

assinatura (checkout via Mercado Pago).

Participação no catálogo global

Em Lojas → Instalação on-premise, o dono ou gerente pode habilitar **Catálogo global

colaborativo**. A opção começa desligada e vale apenas para a loja selecionada.

Quando habilitada, o servidor local sugere os metadados dos produtos cadastrados na própria loja

que possuem GTIN válido. São enviados GTIN, descrição, marca, NCM, CEST, unidade e imagem. Não são

enviados preço, custo, estoque, dados de clientes/fornecedores nem configuração tributária. Uma

sugestão não altera diretamente o catálogo: itens concordantes de duas lojas podem ser aceitos

automaticamente; divergências aguardam revisão.

O aplicativo PDV Administração da Plataforma é separado do terminal de caixa e das contas das

lojas. Somente a conta global, com senha e código TOTP, consegue entrar.

Na fila de revisão:

  1. filtre por GTIN ou atualize a lista completa;
  2. selecione a contribuição e compare Catálogo atual com Sugestão da loja;
  3. use Aprovar para completar apenas dados ausentes;
  4. marque Substituir dados já preenchidos somente após conferir todos os campos;
  5. para rejeitar, informe um motivo claro — ele fica registrado na contribuição.

O refresh token da sessão fica cifrado por DPAPI no perfil do Windows. O aplicativo não recebe nem

armazena a chave técnica de replicação.

Segmentos (verticais)

Cada segmento tem recursos próprios — padaria (produção/receitas), farmácia (controle

específico), mercado, açougue/hortifruti (peso). Veja Verticais.

Acessibilidade

A frente de caixa tem melhorias de acessibilidade (navegação por teclado, foco, mensagens claras) e

avisos sonoros para eventos da venda, com perfis sugeridos por segmento e mudo global.

Índice completo dos guias por perfil: docs/manual/index.md.

Veja também: Documentação Técnica · Manual de Instalação.