Funcionalidades e Fluxos do Sankhya Retail - PDV Web

O que é e para que serve

O PDV é a aplicação de frente de caixa do Sankhya Om, usada para realizar vendas, receber pagamentos, emitir documentos fiscais e controlar o caixa em operações de varejo. Ele atende operadores de caixa, supervisores e gestores de loja, funcionando de forma independente da conexão com a internet. O PDV não substitui o Sankhya Om: ele opera como terminal de venda que sincroniza dados com o ERP e não realiza parametrizações fiscais avançadas, cadastros complexos de produtos ou gestão financeira consolidada, que continuam sendo feitos no Sankhya Om.

Antes de começar

Antes de operar o PDV, resolva os pontos abaixo fora da tela de vendas:

• Tenha o terminal identificado e vinculado a uma empresa (veja Identificação do PDV)
• Configure a integração com o ERP Sankhya com um token válido (veja Integração com ERP Sankhya)
• Cadastre o certificado CSC usado na emissão fiscal (veja Gestão de certificados)
• Realize a carga inicial de produtos, preços e formas de pagamento (veja Carga de dados)

↑ Voltar ao início

---

1. Vendas

A categoria Vendas reúne as funcionalidades da tela principal do PDV, desde a busca de produtos até a finalização da venda e a emissão do documento fiscal.

Busca de produtos

Permite localizar e adicionar produtos à venda por código, nome ou EAN (código de barras).

1. Acesse a tela de vendas ("frente de caixa") após o login e a vinculação ao PDV.
2. Digite o nome, código ou EAN no campo de busca da tela principal, ou clique em Consultar Produto (ou pressione F8) para abrir o modal de busca.
3. Digite pelo menos 3 caracteres para que os produtos correspondentes apareçam na lista de sugestões.
4. Navegue pela lista com as setas do teclado e pressione Enter, ou clique sobre o produto, para selecioná-lo.
5. Confira a disponibilidade do item (estoque, validade e preço), verificada automaticamente antes da adição ao carrinho.

Atalhos de teclado	Abre/fecha o modal de busca e seleciona rapidamente com teclas (ex.: F8, Enter).
Busca por EAN/código	Suporta leitura de código de barras ou digitação direta.
Consulta rápida	Termo com menos de 3 caracteres não dispara nenhuma consulta.
Offline ready	A busca funciona em modo offline, usando dados previamente sincronizados localmente.
Integração ERP	Os dados do produto vêm do ERP, via sincronização e cargas programadas.

Carrinho de compras

Reúne os itens da venda em andamento, exibindo nome, quantidade, valor unitário e subtotal de cada produto, além do valor total parcial.

1. Adicione produtos ao carrinho pela busca ou pela leitura de código de barras.
2. Confira em tempo real a lista de itens, com quantidade, valor unitário, valor total por item e total parcial da venda.
3. Altere a quantidade ou remova um item diretamente na lista; o PDV recalcula os subtotais e o total automaticamente.
4. Aplique desconto ou acréscimo ao item ou à venda, quando necessário, pelas opções avançadas do carrinho (botão de opções ou atalho).
5. Identifique o vendedor e/ou o cliente antes de seguir para o pagamento, se essa informação for exigida.
6. Pressione F7, ou clique em Finalizar Venda, para levar o carrinho já validado à tela de pagamento.

Gestão via estado global	Uso de Zustand para manter e atualizar o estado do carrinho (produtos, valores, seleção).
Persistência offline	O carrinho funciona mesmo sem internet, com sincronização posterior dos dados.
Atalhos PDV	F7 (pagamento), ações rápidas para cancelar, adicionar desconto e selecionar formas de pagamento.
Interface responsiva	Botões e atalhos para manipulação de itens, descontos, acréscimos e cancelamento de pedido.
Popups modais	Confirmação e edição (ex.: quantidade/desconto) acontecem via popups/modal.

Referências técnicas: venda.spec.ts (teste de manipulação do carrinho — adição/remoção/verificação), zustand.ts (estado e gestão do carrinho), MoreOptionsButton.tsx (opções avançadas: desconto, acréscimo, cancelar), SalesPage.tsx (página principal de vendas e estado do carrinho).

Pagamento multi-modal

Permite quitar a venda em dinheiro, cartão de crédito, TEF ou POS, inclusive dividindo o valor entre mais de uma forma de pagamento.

1. Na tela de pagamento, escolha a forma desejada — Dinheiro, Cartão de Crédito ou outra habilitada na configuração do PDV — clicando no botão correspondente ou usando o atalho definido (ex.: uma tecla para dinheiro, outra para cartão).
2. Em pagamento no cartão, informe parcelamento e bandeira quando solicitado; se houver integração TEF, o PDV aciona a comunicação com o terminal de cartão.
3. Para dividir o pagamento entre modalidades, informe o valor de cada uma; o PDV soma os valores e mostra em tempo real quanto falta para cobrir o total.
4. Confirme o pagamento somente quando a soma das modalidades cobrir o valor total da venda.
5. Corrija o método ou tente novamente se houver erro de integração (TEF) ou falta de conexão; é possível cancelar o pagamento antes da conclusão.

Recursos e observações: pagamentos podem ser feitos só com dinheiro, só cartão ou misturados (multi-modal); o PDV oferece atalhos de teclado para seleção rápida da forma de pagamento; troco e parcelamento são calculados automaticamente; a tela e os botões são responsivos para operação em balcão, computador ou tablet; o fluxo opera offline, registrando tudo localmente para posterior sincronização, com geração de NFC-e e integração fiscal logo após o pagamento bem-sucedido.

Referências técnicas: venda.spec.ts (teste de venda simples com pagamento em dinheiro), atalhos-pagamento.ts (atalhos de pagamento), componente PagamentoPage (controle de entrada de valores para cada modalidade).

Cálculo automático de parcelas

Calcula automaticamente o valor de cada parcela em vendas parceladas no cartão de crédito, incluindo o arredondamento necessário.

1. Selecione Cartão de Crédito como forma de pagamento.
2. Escolha o número de parcelas entre as opções disponíveis, configuradas para o PDV (ex.: 2x, 3x, 6x).
3. Confira o valor calculado para cada parcela, já com o arredondamento aplicado — quando a divisão não é exata, o PDV ajusta a diferença na última parcela.
4. Altere o número de parcelas se necessário; o PDV recalcula os valores em tempo real, incluindo eventuais taxas ou acréscimos configurados.
5. Confirme o pagamento após revisar as parcelas exibidas na tela.

Recursos e observações: o cálculo considera frações de centavos e ajusta a última parcela quando a divisão não é exata; a interface apresenta de forma clara o número de parcelas, o valor individual, o valor total e eventuais ajustes; o cliente tem ciência dos valores e das parcelas no momento da confirmação; atalhos podem agilizar a escolha, conforme a configuração do PDV.

Referências técnicas: testes de fluxo de vendas garantem o "cálculo automático de parcelas com arredondamento" sempre que o cartão é parcelado; trecho do README.md: "Cálculo automático de parcelas com arredondamento".

Gestão de troco

Calcula automaticamente o troco a devolver ao cliente em pagamentos em dinheiro.

1. Selecione Dinheiro na tela de pagamento.
2. Informe o valor recebido do cliente.
3. Confira o troco calculado automaticamente (valor recebido menos valor da venda), destacado na tela.
4. Corrija o valor informado se o PDV alertar que ele é menor que o total da compra — a finalização só é liberada quando o valor recebido é igual ou maior que o total.
5. Confirme o pagamento para registrar a venda e o troco devolvido no movimento financeiro do caixa.

Recursos e observações: há um campo dedicado para o valor recebido, com destaque visual para o troco; em caso de valor insuficiente, o PDV impede prosseguir e permite correção; os cálculos e o registro do troco funcionam mesmo offline; o cálculo do troco está presente tanto em vendas comuns quanto em suprimentos e movimentações de caixa.

Referências técnicas: venda.spec.ts (teste de fluxo de pagamento com gestão do troco); trecho do README.md: "Gestão de troco para pagamentos em dinheiro".

Finalização de movimento

Conclui a venda gerando a NFC-e (Nota Fiscal do Consumidor Eletrônica) e registrando o movimento no PDV.

1. Revise os itens, valores, descontos e acréscimos do carrinho antes de seguir para o pagamento.
2. Efetue o pagamento em uma ou mais formas, conforme necessário.
3. Clique em Finalizar Venda (ou pressione F7) para concluir a operação após validar o pagamento.
4. Aguarde a geração e a transmissão automática da NFC-e à SEFAZ, quando online, ou o registro em contingência, quando offline; a impressão do cupom ocorre na impressora configurada, se habilitada.
5. Confira o cupom fiscal impresso e/ou exibido em tela, com itens, valores, forma de pagamento, troco e dados fiscais (QR Code, número da NFC-e).

Recursos e observações: a persistência é sempre local, garantindo funcionamento offline com sincronização posterior; todos os dados fiscais seguem a legislação vigente (NFC-e, QR Code, contingência); o histórico do fechamento da venda ("movimento") fica salvo para acompanhamento futuro, acerto de caixa e integração com o ERP; a operação é ágil via atalhos de teclado e interface amigável.

Referências técnicas: trecho do README.md: "Finalização de movimento com geração de NFC-e"; testes automatizados em venda.spec.ts; NFC-e gerada e impressa, com suporte a contingência.

Promoções

Aplica automaticamente as condições promocionais configuradas no Sankhya Om ou no Portal PDV aos produtos elegíveis da venda.

1. Inclua os produtos normalmente no carrinho.
2. Deixe que o PDV identifique, entre os itens inseridos, quais promoções cadastradas se aplicam.
3. Consulte quais itens estão com desconto promocional e qual regra foi aplicada a cada um (desconto progressivo, leve mais por menos, brinde, entre outras).
4. Finalize a venda normalmente — o cupom fiscal detalha todos os descontos promocionais aplicados.

Recursos e observações: é possível manter um histórico/auditoria de promoções concedidas por venda; o PDV exibe mensagens informativas ou visuais sobre as promoções automaticamente; promoções podem ser criadas e alteradas conforme datas especiais, estoque ou perfis de cliente.

Desconto

Permite aplicar descontos configuráveis a um item, ao subtotal ou ao total da venda, conforme a política comercial da empresa.

1. Escolha Aplicar Desconto no item, no subtotal ou no total da venda.
2. Informe o valor absoluto ou o percentual do desconto, respeitando o limite configurado para o seu perfil.
3. Informe o motivo da concessão, quando a configuração exigir justificativa.
4. Confirme a operação — o PDV recalcula o total e detalha o desconto aplicado no resumo do pedido e no cupom.

↑ Voltar ao início

---

2. Emissão fiscal

A categoria Emissão fiscal reúne a geração do documento fiscal da venda e a gestão dos certificados usados para emiti-lo.

Emissão de NFC-e

Gera e transmite a NFC-e automaticamente ao final de cada venda, garantindo a conformidade fiscal da operação.

1. Finalize o pagamento da venda e clique em Finalizar Venda (ou pressione o atalho correspondente).
2. Aguarde o PDV coletar e validar os dados fiscais necessários: itens, pagamento, série fiscal e certificado digital (CSC).
3. Aguarde a montagem e a assinatura digital do XML da NFC-e, conforme os requisitos da SEFAZ do estado.
4. Em operação online, aguarde a transmissão à SEFAZ e a autorização com o número da NFC-e; sem conexão, o PDV salva o documento em contingência para envio posterior.
5. Confira o cupom fiscal impresso ou exibido em tela, com QR Code, código de barras e os dados obrigatórios do estabelecimento.
6. Consulte o status da NFC-e emitida ou reenvie documentos pendentes de contingência pelo histórico do PDV.

Recursos e observações: o QR Code é gerado automaticamente para validação e consulta pública da nota; há suporte a contingência, garantindo vendas e emissão de notas mesmo em cenários offline; o layout do cupom segue a legislação vigente; o operador pode consultar o status da NFC-e emitida; ao restabelecer a conexão, o PDV envia automaticamente as NFC-e geradas em contingência para a SEFAZ.

Gestão de certificados

Centraliza o cadastro e a manutenção do certificado CSC (Código de Segurança do Contribuinte) usado na emissão fiscal, evitando interrupções por falha de autenticação.

1. Acesse a área de configuração fiscal do PDV.
2. Cadastre um novo certificado CSC ou atualize um já existente, informando ID, código CSC, validade e empresa/PDV vinculados.
3. Corrija os dados apontados pelo PDV em caso de formato inválido ou campo obrigatório não preenchido.
4. Consulte, inative ou exclua certificados vencidos, mantendo apenas os válidos.

O certificado cadastrado é usado automaticamente pelo PDV na geração da NFC-e, sem ação manual do operador; o PDV verifica a validade do CSC antes de cada emissão e pode alertar sobre expiração próxima ou problemas de configuração.

Recursos e observações: os certificados são salvos de forma protegida, dificultando acesso indevido; a operação continua mesmo sem internet, sincronizando certificados e usos posteriormente; há suporte para vincular diferentes certificados a diferentes PDVs ou empresas; todas as operações de gestão de certificado ficam registradas, facilitando a rastreabilidade.

Referências técnicas: modelo/tabela certificados em pdv-db.ts; serviço CertificadoService (cadastro/atualização de certificado); changelog: "criado entidade 'certificado'", "gestão de certificados para emissão fiscal".

↑ Voltar ao início

---

3. Caixa

A categoria Caixa reúne as operações financeiras do turno: abertura, suprimento, sangria e fechamento.

Abertura de caixa

Marca o início das operações diárias no PDV, registrando o valor inicial disponível para o turno.

1. Acesse a área de operações de caixa, disponível na tela principal ou em menu específico de gestão financeira.
2. Selecione Abertura de Caixa para iniciar o registro do caixa do turno.
3. Informe o valor inicial disponível em espécie (dinheiro, cartões, cheques etc.) e, se exigido pela política da empresa, uma observação ou justificativa.
4. Revise os dados e confirme a abertura clicando em Confirmar ou Abrir Caixa, ou usando o atalho correspondente.
5. Aguarde o registro da abertura — o PDV grava data, horário, valor e identificador do operador, e habilita a realização de vendas e demais operações financeiras.
6. Visualize ou imprima o comprovante da operação, se necessário.

Recursos e observações: a abertura de caixa pode ser restrita a operadores autorizados via controle de acesso; o PDV impede a abertura caso já exista um caixa aberto não finalizado; todo movimento posterior (suprimentos, sangrias, vendas, fechamento) fica associado à abertura registrada.

Suprimento de caixa

Registra entradas de dinheiro no caixa ao longo do turno (reforço de troco, recebimento de valores etc.), garantindo o controle rigoroso de todo o numerário.

1. Acesse o menu de caixa do PDV, disponível na tela principal ou em "Operações de Caixa"/"Gestão de Caixa".
2. Selecione Suprimento de Caixa.
3. Informe o valor a suprir, o motivo (ex.: reforço de troco, recebimento de valores) e, opcionalmente, observações complementares.
4. Revise os dados e confirme a operação em Salvar, Confirmar ou via atalho.
5. Aguarde o PDV atualizar o saldo do caixa com o acréscimo do valor e salvar a movimentação (motivo, valores, horário e operador).
6. Confira a impressão ou a exibição do comprovante da operação.
7. Consulte o histórico de suprimentos pelo menu de extrato, fechamento ou relatório de caixa, quando necessário.

Recursos e observações: a operação normalmente exige login/autenticação ou confirmação do operador; o suprimento pode ser feito em dinheiro, cartão, cheque etc., conforme a configuração do PDV; os motivos podem ser personalizados conforme a política da empresa; o histórico detalhado permite controle e prevenção de erros ou fraudes; em operação offline, o suprimento é registrado normalmente e sincronizado com o ERP/retaguarda assim que houver conexão.

Fechamento de caixa

Encerra o turno com a conferência entre o saldo esperado pelo PDV e o valor efetivamente contado.

1. Acesse Fechamento de Caixa no menu de operações financeiras, ao final do turno.
2. Confira o saldo inicial, as movimentações do dia (suprimentos, vendas, sangrias, trocos) e o saldo final esperado, exibidos pelo PDV.
3. Conte o dinheiro e os demais valores do caixa (cartões, cheques) e informe o valor total encontrado.
4. Registre uma justificativa quando houver divergência entre o valor informado e o esperado — o PDV destaca a diferença automaticamente.
5. Confirme o fechamento; o PDV grava data, hora, saldo, divergência e observações, e gera o comprovante do fechamento.

Referências técnicas: changelog: "tela de fechamento kb-107172" (CHANGELOG.md).

Sangria

Registra a retirada de valores em dinheiro do caixa durante o turno, prevenindo excesso de numerário.

1. Acesse Sangria no menu de operações financeiras.
2. Informe o valor a retirar, a espécie e o motivo (ex.: prevenção de excesso de numerário, transferência para cofre).
3. Confirme a operação — o PDV registra valor, motivo, data, hora e operador responsável.
4. Consulte o comprovante ou o histórico de sangrias no extrato do caixa, quando necessário.

↑ Voltar ao início

---

4. Estoque

A categoria Estoque reúne a consulta de saldo de produtos diretamente no PDV.

Consulta de estoque

Permite verificar rapidamente o saldo e a disponibilidade de um produto sem sair da tela de vendas, evitando vender itens indisponíveis.

1. Acesse a tela de vendas ou o atalho/menu de Consulta de Estoque.
2. Digite o nome, código ou EAN do produto no campo de busca, ou use o leitor de código de barras.
3. Confira o saldo disponível, atualizado conforme a última sincronização.
4. Use a informação para orientar o cliente sobre indisponibilidade ou propor um produto alternativo.

Recursos e observações: o estoque exibido pode ser do próprio PDV, de filiais próximas ou conforme a parametrização da empresa; em modo offline, a informação corresponde ao último estoque sincronizado; a consulta rápida agiliza o atendimento e evita ruptura de vendas.

↑ Voltar ao início

---

5. Perfis e Configurações

A categoria Perfis e Configurações reúne a definição de regras por terminal e a identificação do PDV junto à empresa.

Perfis de PDV

Define regras e permissões distintas para cada terminal, padronizando processos e reforçando a segurança operacional.

1. Acesse o menu de administração do PDV com um perfil autorizado (geralmente TI ou gerência).
2. Selecione a empresa/filial e o terminal de PDV que deseja configurar.
3. Vincule um perfil existente ao terminal, ou altere o perfil vigente conforme a nova necessidade, podendo também criar ou editar um perfil (descrição, permissões e regras), se a configuração permitir.
4. Confirme a vinculação — o PDV aplica automaticamente as permissões, regras fiscais e operacionais, o layout de telas e as configurações de operação (offline, integração com o ERP etc.) do perfil escolhido.

Recursos e observações: perfis podem ser personalizados pelo gestor para cada cenário de loja ou PDV; a configuração é mantida offline e sincronizada com o ERP quando possível; o gestor pode revisar qual perfil está ativo em cada terminal e consultar o histórico de alterações, justificativas e permissões.

Referências técnicas: perfil-pdv.model.ts (estrutura/modelo de perfil); perfil-pdv.service.ts (serviço e lógica de vinculação); StepEmpresaPDV/index.tsx (componentes de setup e seleção de perfil).

Configurações de perfil

Garante o carregamento automático dos parâmetros específicos de cada perfil de PDV, mantendo padronização e segurança.

1. Acesse o perfil de PDV que deseja configurar (ex.: perfil fiscal, perfil de caixa rápido, perfil administrativo).
2. Revise as configurações já aplicadas: formas de pagamento disponíveis, limites de desconto, regras de contingência, permissões de operações (cancelamento, sangria, suprimento), layout de telas e atalhos.
3. Altere os parâmetros necessários e salve as alterações — o PDV valida tipo, valor, restrições e obrigatoriedade de cada campo.
4. Aguarde a aplicação imediata das novas configurações em todos os terminais vinculados a esse perfil (menus, telas, restrições e atalhos atualizados).

Recursos e observações: cada perfil funciona como um conjunto de regras facilmente adaptável às necessidades de operação; toda alteração exige autenticação adequada, garantindo auditoria; as configurações personalizadas sincronizam com a retaguarda para centralização das regras; mudanças afetam todos os PDVs vinculados ao perfil em tempo real, e é possível consultar o histórico e reverter configurações.

Referências técnicas: configuracoes_perfis_pdvs em pdv-db.ts; perfil-pdv.service.ts (serviço de configuração de perfil); StepEmpresaPDV/index.tsx (fluxo visual de setup/configuração).

Identificação do PDV

Vincula o terminal a uma empresa e a uma configuração específica antes de liberar a operação de venda.

1. No primeiro acesso ou durante o setup, selecione a empresa ou filial à qual o PDV será vinculado.
2. Selecione o terminal de PDV entre os disponíveis para vinculação, ou cadastre um novo, se a empresa permitir.
3. Informe os identificadores solicitados (número/série do terminal, código de vinculação e demais dados de perfil).
4. Corrija os dados apontados pelo PDV em caso de vinculação já existente ou campo obrigatório ausente.
5. Aguarde a confirmação de sucesso — a partir daí, todas as vendas e movimentações ficam registradas sob o terminal identificado.

Recursos e observações: o PDV só permite operações quando o terminal está identificado/vinculado corretamente; há suporte ao cenário multiempresa, com múltiplos PDVs e perfis distintos; a identificação pode ser feita mesmo offline, sincronizando posteriormente; operações e vendas ficam vinculadas ao identificador correto, facilitando controles e relatórios.

Referências técnicas: identificador-pdv.service.ts e pdv.model.ts (modelo e serviço técnico); StepEmpresaPDV/index.tsx (fluxo visual de setup).

↑ Voltar ao início

---

6. Integrações e Dados

A categoria Integrações e Dados reúne a sincronização do PDV com o ERP Sankhya e a operação contínua mesmo sem conexão.

Integração com ERP Sankhya

Sincroniza dados automaticamente entre o PDV e o ERP Sankhya por meio de um token de integração, eliminando retrabalho.

1. Acesse o menu de integração do PDV com um perfil administrativo.
2. Informe as credenciais de acesso ao ERP Sankhya para autenticação via API.
3. Aguarde o recebimento do token de integração, que passa a sincronizar os dados entre o PDV e o ERP.
4. Aguarde a sincronização inicial de produtos, preços, clientes, formas de pagamento, vendedores, certificados e dados de empresas/filiais.
5. Monitore o status da integração, revalide o token ou force uma nova sincronização em caso de falha.

Recursos e observações: a integração exige autenticação robusta (token, login, senha); a sincronização dos dados do ERP pode ser programada automaticamente ou feita manualmente; o usuário acompanha o status na tela e recebe feedback dos dados sincronizados.

Referências técnicas: api-pdvs.service.ts (código de integração/serviço); pdv.loader.ts (carga inicial de dados); sign-in.tsx (setup/tela de integração).

Carga de dados

Importa para o terminal os dados essenciais à operação — produtos, preços, clientes e demais cadastros — a partir do Portal PDV ou do ERP Sankhya.

1. Acesse o menu de Carga de Dados do PDV.
2. Selecione o tipo de dado a carregar: produtos, preços, clientes, empresas/filiais, formas de pagamento, vendedores ou certificados fiscais — em carga completa ou parcial.
3. Informe o token de integração, quando solicitado, para garantir que os dados venham da origem correta.
4. Inicie a carga e acompanhe o progresso pela barra de status, log ou mensagens em tempo real; em grandes volumes, o processo pode ocorrer em lotes.
5. Corrija os dados apontados como inválidos pelo PDV (formato, duplicidade ou integridade) e repita a carga, se necessário.
6. Confira a confirmação de sucesso, com a lista do que foi atualizado ou importado.

Recursos e observações: toda carga exige validação de origem e/ou token de autenticação; os dados baixados ficam disponíveis mesmo sem conexão posterior; o usuário visualiza status, mensagens de erro ou sucesso; há suporte a grandes volumes de dados via processamento paginado.

Referências técnicas: pdv.loader.ts (processo técnico de carga, requisições e armazenamento); sign-in.tsx (funções de setup e tela de carga); trecho do README.md: "Carga de dados pelo Portal PDV por meio de token".

Sincronização offline

Garante a continuidade da operação e a posterior sincronização dos dados registrados localmente, sem intervenção manual do operador.

1. Continue operando o PDV normalmente durante a ausência de conexão — vendas, movimentações de caixa, emissão fiscal em contingência e cadastros ficam registrados localmente.
2. Observe o indicador de status "sem conexão" ou "operando offline" na interface.
3. Aguarde a sincronização automática dos dados pendentes assim que a conexão com o ERP/retaguarda for restabelecida.
4. Resolva eventuais conflitos apontados pelo PDV (duplicidade ou dados corrompidos) antes da confirmação final da sincronização.
5. Consulte os logs de operações offline e de sincronização para auditoria, quando necessário.

Recursos e observações: a sincronização offline é automática e não exige intervenção manual; os dados são salvos localmente de forma segura e persistente até o envio; o suporte contingencial mantém o PDV "offline ready" mesmo em cenários fiscais, respeitando a legislação; indicadores visuais mostram o status atual e o resultado da sincronização.

Referências técnicas: pdv-db.ts (estrutura de persistência e sincronização); trecho do README.md: "Offline-ready com Service Worker"; pdv.loader.ts (processos de sincronização).

Push notification

Envia alertas e mensagens instantâneas do backend para o terminal, mesmo com o PDV em segundo plano.

1. Aceite a permissão de notificações solicitada no primeiro acesso ou em uma atualização do PDV.
2. Aguarde a inscrição do terminal no canal de notificações da empresa, filial ou tipo de operação correspondente.
3. Visualize as notificações recebidas (alertas operacionais, mensagens administrativas ou pendências fiscais) por toast, alerta visual ou som.
4. Consulte o histórico de notificações na área de mensagens do PDV, quando disponível.
5. Desative o recebimento de notificações nas configurações do PDV, se desejar.

Recursos e observações: o Service Worker permite receber notificações mesmo com o PDV fechado/em segundo plano; as notificações podem ser direcionadas por terminal, empresa, perfil ou tipo de operação; apenas usuários autorizados/PDVs inscritos recebem notificações, geralmente como toasts, banners ou popups.

Referências técnicas: changelog: "inscrição push notification por pdv selecionado" (CHANGELOG.md); serviço de push notification; visualização via sistema de toasts e notificações no frontend.

↑ Voltar ao início

---

7. Interface de usuário

A categoria Interface de usuário reúne os recursos que tornam a operação do PDV mais rápida e resiliente, mesmo offline.

Sistema de atalhos

Disponibiliza comandos de teclado para acelerar as operações do PDV, reduzindo a dependência do mouse ou do toque.

1. Use os atalhos disponíveis para o contexto atual da tela (venda, modal de consulta ou navegação geral).
2. Pressione o atalho correspondente à ação desejada.
3. Observe o destaque visual (campo em foco, modal aberto) que confirma o reconhecimento do atalho.
4. Combine atalhos em sequência para agilizar o atendimento no balcão.

F8	Abrir modal de consulta/busca de produto
F7	Ir ao pagamento/finalizar venda
A	Selecionar pagamento em dinheiro
B	Selecionar pagamento em cartão
Enter	Confirmar seleção ou ação em modais/listas
Esc	Fechar modais, cancelar operação
Outros	Atalhos personalizáveis por contexto/área, especificados por camada no sistema

Recursos e observações: os atalhos mudam de acordo com o contexto ativo (modal, tela principal, caixa de diálogo); em caso de conflito, o atalho mais relevante ao contexto ativo prevalece; o operador consegue operar o PDV quase todo sem mouse, com confirmação visual imediata de cada ação feita via atalho.

Referências técnicas: trecho do README.md: "Sistema de atalhos global/contextual por camadas, navegação por teclas, prioridades de contexto"; código dos handlers em ConsultarProduto/index.tsx e atalhos-pagamento.ts; a lógica das camadas/contextos prioriza modais, componentes e tela principal conforme o fluxo (descrita nos handlers de cada área/componente).

Interface moderna PWA

Oferece uma aplicação responsiva (PWA) que funciona em navegador ou instalada como aplicativo, reduzindo custos de infraestrutura.

1. Acesse o PDV pelo navegador em desktop, tablet ou smartphone.
2. Aceite a sugestão de instalação como PWA ("Adicionar à tela inicial"), se desejar acesso como aplicativo nativo.
3. Navegue pelas funções do PDV (venda, caixa, consulta de produtos, relatórios) pela interface responsiva, adaptada ao tamanho da tela.
4. Continue a operação normalmente mesmo sem conexão, com feedback visual do estado offline/online.
5. Feche e reabra o PDV quando indicado para aplicar atualizações — a nova versão é entregue de forma transparente ao reconectar.

Recursos e observações: o layout é moderno e responsivo, construído com Tailwind CSS; a instalação como app é opcional, com a mesma aparência e funcionalidade em todos os dispositivos suportados; popups, toasts, inputs personalizados e modais para operações críticas seguem o mesmo padrão visual; a operação offline é 100% funcional, com sincronização automática posterior e feedback visual constante (popups, toasts, barras de progresso, status de sincronização).

Referências técnicas: trechos do README.md: "Layout responsivo com Tailwind CSS", "Offline-ready com Service Worker"; MainLayout.tsx (estrutura de componentes e layout); uso de Service Worker, push notification e componentes para manipulação offline.

Login offline

Garante a autenticação do operador mesmo sem conexão à internet, assegurando a continuidade das operações do PDV.

1. Acesse a tela de login sem conexão, ou com conexão instável.
2. Selecione a opção Acessar em modo offline, exibida automaticamente pelo PDV.
3. Informe as credenciais previamente sincronizadas (usuário e senha).
4. Aguarde a validação local das credenciais para liberar o acesso ao PDV.

Recursos e observações: recomenda-se sincronizar periodicamente os dados de autenticação/usuários para assegurar o uso offline; para auditoria e segurança, as informações de login e de movimentação ficam registradas localmente.

Experiência offline

Permite que o PDV continue funcional mesmo desconectado, eliminando a ociosidade do operador e a frustração do cliente.

1. Continue vendendo, aplicando descontos, calculando troco e parcelas normalmente durante a indisponibilidade de internet.
2. Emita a NFC-e em contingência, de acordo com a legislação vigente, quando offline.
3. Registre suprimentos, sangrias e fechamento de caixa normalmente, mesmo sem conexão.
4. Acompanhe o status "offline" e a confirmação de que os dados foram salvos localmente, aguardando sincronização.
5. Consulte o histórico de vendas aguardando envio, quando a conexão retornar.

Recursos e observações: o PDV funciona independentemente da disponibilidade de internet; o usuário não precisa realizar ações manuais para sincronizar os dados; há feedback constante do estado de conexão e sincronização; a persistência local é robusta, com proteção de dados; a operação fiscal contingencial garante adequação à legislação para emissão de notas e auditoria.

Referências técnicas: trechos do README.md: "Offline-ready com Service Worker", "Persistência segura e controle transacional"; pdv-db.ts (Service Worker e IndexedDB); telas de feedback do status offline e sincronização implementadas em diversos componentes da interface.

↑ Voltar ao início

---

8. Administração e Infraestrutura

A categoria Administração e Infraestrutura reúne os recursos de gestão multiempresa e de integridade dos dados do PDV.

Gestão de empresas e séries

Gerencia as informações de múltiplas empresas e as séries fiscais vinculadas aos terminais de PDV, viabilizando a escalabilidade e a gestão multiempresa.

1. Acesse o menu de administração do PDV com um perfil administrativo (TI ou gerência).
2. Consulte a lista de empresas/filiais cadastradas; cadastre uma nova (nome, razão social, CNPJ, endereço, dados fiscais etc.), edite uma existente ou consulte seu histórico de alterações, séries vinculadas e PDVs associados.
3. Acesse, para cada empresa, as séries fiscais vinculadas (numeração usada na emissão de NFC-e, SAT etc.); cadastre uma nova série (número, tipo de documento, ativa/inativa), edite ou inative/exclua séries antigas, conforme a política da empresa ou a legislação.
4. Associe empresa, série e PDV para configurar o relacionamento correto, garantindo a rastreabilidade dos documentos fiscais.
5. Consulte o histórico de operações (quem alterou, quando e qual empresa/série/PDV foi impactado) e os relatórios de empresas e séries, quando necessário.

Recursos e observações: há suporte completo para operação com várias empresas/filiais e múltiplas séries fiscais em um ou mais PDVs; ações são restritas a perfis administrativos, com rastreabilidade e controle de alterações; os dados são mantidos offline e sincronizados posteriormente com o ERP; as empresas e séries cadastradas determinam os dados fiscais e legais usados nas vendas, na emissão de NFC-e e nas operações de caixa, e mudanças de série/empresa refletem na operação do PDV imediatamente após a alteração.

Controle de versionamento

Garante que o software do PDV seja mantido atualizado e que a estrutura de dados local seja compatível com a versão mais recente da aplicação.

1. Deixe que o PDV verifique automaticamente, ao ser acessado, se há atualizações disponíveis no backend, portal ou ERP; consulte a versão atual pela área de administração ou menu de informações do sistema.
2. Observe o aviso visual quando uma nova versão estiver disponível ("Nova versão disponível para atualização") e siga a orientação exibida (o processo pode ser automático ou manual).
3. Aguarde a execução dos scripts SQL de migração e atualização, que garantem a compatibilidade do banco local (IndexedDB/Dexie.js) com a nova versão — dados, estrutura de tabelas e configurações fiscais e operacionais são processados e versionados.
4. Feche e reabra o PDV para concluir a atualização automática via Service Worker, já com as novidades e correções.
5. Consulte o histórico de atualização, scripts executados, problemas ou pendências, caso necessário; em caso de erro ou incompatibilidade, o PDV orienta o suporte ou a correção manual.

Recursos e observações: a atualização é transparente e não exige interferência manual, exceto em caso de erro; scripts de banco e estrutura são versionados para não perder compatibilidade; o PWA consegue atualizar a estrutura local via scripts mesmo offline, sincronizando depois; logs detalhados ficam disponíveis para controle gerencial e de tecnologia; após o update, o PDV sincroniza os dados operacionais com o ERP para garantir compatibilidade e evitar conflitos, principalmente em integrações fiscais.

Persistência segura

Garante que todos os dados gerados no PDV sejam armazenados de forma íntegra e não sejam perdidos, especialmente em cenários offline ou de falhas.

1. Realize operações rotineiras no PDV (vendas, movimentações de caixa, cadastros, emissão fiscal) normalmente.
2. Deixe que o PDV grave cada operação imediatamente em um banco local seguro do dispositivo (IndexedDB, via Dexie.js), garantindo que vendas não fiquem pendentes ou sejam perdidas e que movimentações e fluxos fiscais sejam salvos com integridade.
3. Confie no controle transacional: cada gravação é feita via transações atômicas — se alguma etapa falhar, nenhum dado é parcialmente salvo, evitando inconsistência de registros, principalmente offline.
4. Em caso de erro, pane do navegador ou queda de energia, conte com a recuperação automática dos dados ao reiniciar o PDV, a partir dos backups locais periódicos.
5. Ao restabelecer a conexão, deixe que o PDV sincronize os dados locais com o ERP/retaguarda, conferindo duplicidades e integridade e resolvendo eventuais conflitos, sempre priorizando a consistência — os dados locais só são removidos após a sincronização segura ser confirmada.
6. Observe as mensagens de sucesso ("Venda registrada com sucesso", "Movimentação salva") ou os alertas e orientações de correção em caso de falha na gravação.

Recursos e observações: a persistência é atomizada e segura, com controle transacional (commit/rollback); o banco local é robusto (IndexedDB/Dexie.js); a sincronização é garantida — os dados locais são mantidos até que a retaguarda confirme o recebimento; a recuperação é automática, sem perda de dados em caso de pane; todas as operações de persistência geram logs/auditoria (data, ação, operador, resultado da gravação), rastreáveis para solução de problemas ou compliance fiscal.

↑ Voltar ao início

---

9. Segurança

A categoria Segurança reúne o controle de acesso ao PDV e a gestão dos certificados usados na emissão fiscal.

Controle de acesso

Autentica o operador e valida suas permissões, prevenindo fraudes e acessos não autorizados.

1. Informe usuário e senha (e PIN ou segundo fator, se habilitado) na tela de login do PDV.
2. Aguarde a validação das credenciais, feita localmente ou junto ao ERP Sankhya, conforme a disponibilidade de conexão.
3. Opere apenas os menus, atalhos e funcionalidades liberados para o seu perfil (caixa, supervisor, gerente).
4. Solicite a um usuário autorizado a revalidação (nova senha ou aprovação de supervisor) em operações sensíveis, como cancelamento de venda, desconto acima do limite ou reabertura de caixa.
5. Encerre a sessão (logout) ao final do uso, ou aguarde o logout automático por inatividade.

Recursos e observações: cada usuário tem permissões específicas, configuradas centralmente ou por PDV; mesmo sem internet, autenticação básica e permissões locais são respeitadas; todas as operações ficam registradas para revisão posterior; a política de bloqueio minimiza o risco de acesso indevido.

Referências técnicas: auth.service.ts, login.tsx (autenticação, bloqueio e permissões); trecho do README.md: "Fluxo de login por perfil de acesso, autorização para operações críticas, logs de auditoria".

Gestão de certificados CSC

Gerencia os Códigos de Segurança do Contribuinte (CSC) usados na emissão de documentos fiscais eletrônicos.

1. Acesse o menu de configurações fiscais ou administração do PDV com um perfil autorizado.
2. Cadastre um novo certificado CSC, informando código, identificador, empresa/filial vinculada e data de validade.
3. Corrija os campos apontados pelo PDV em caso de erro de formato ou duplicidade para a mesma empresa/filial.
4. Atualize, inative ou exclua certificados existentes, conforme a política da empresa.

O PDV usa automaticamente o CSC correto na geração da NF-e/NFC-e, validando existência, status e validade antes de cada emissão.

Recursos e observações: permissões restritas garantem que apenas perfis autorizados cadastrem, editem ou excluam CSC; a proteção de dados inclui exibição mascarada e gravação segura, com restrição de visualização/edição; a operação é offline ready, com registro e uso do CSC disponíveis mesmo sem internet; logs e auditoria ficam acessíveis para revisões e fiscalização.

Referências técnicas: tabela/modelo de certificados no banco local; serviço certificado.service.ts; changelog: "criado entidade 'certificado', gestão de certificados para emissão fiscal".

Sankhya Pass

Permite autenticação unificada no PDV pelo serviço Sankhya Pass, trazendo mais segurança e praticidade ao operador.

1. Na tela de login, selecione Entrar com Sankhya Pass.
2. Informe o usuário e a senha válidos do Sankhya Pass.
3. Aguarde a validação centralizada no serviço do Sankhya Pass.
4. Acesse o PDV conforme o perfil e as permissões definidos para o seu usuário.

Recursos e observações: políticas de bloqueio, senha expirada, autenticação em dois fatores e perfis diferenciados são respeitadas conforme a configuração do Sankhya Pass; o login pode ser usado tanto online quanto, em casos específicos, com cache de permissões previamente sincronizadas.

↑ Voltar ao início

---

Pontos de atenção

• O PDV é offline-first: vendas, caixa e emissão fiscal em contingência funcionam sem conexão, e os dados são sincronizados automaticamente com o ERP assim que a conexão retorna.
• A emissão fiscal depende de um certificado CSC válido; um CSC vencido ou ausente impede a emissão da NFC-e mesmo com a venda já paga.
• Trocar o perfil vinculado a um terminal, ou alterar as configurações de um perfil, afeta imediatamente todos os PDVs vinculados a ele.
• Os atalhos de teclado seguem o contexto ativo (modal, tela principal): em caso de conflito, prevalece o atalho do contexto mais específico.
• Toda a persistência local usa controle transacional (tudo ou nada): os dados locais só são descartados depois que a sincronização com o ERP é confirmada.