Auto Atendimento

```markdown h1. PDV Autoatendimento - Guia Completo para Suporte

h2. Objetivo O módulo de PDV Autoatendimento permite que o cliente finalize compras de forma autônoma em terminal touch, com fluxo de seleção de itens, pesagem (quando aplicável) e fechamento da venda.

Este material orienta o suporte em:

• Entender o fluxo funcional
• Configurar corretamente
• Validar funcionamento
• Diagnosticar problemas comuns

h2. Visão geral do fluxo

1. Operador abre o modo Autoatendimento no PDV.
2. Cliente navega por categorias e produtos na interface touch.
3. Cliente adiciona itens ao carrinho.
4. Para itens com pesagem, o sistema lê a balança e aplica validação de peso conforme parâmetros.
5. Cliente confirma os itens e segue para fechamento.
6. Sistema conclui a venda conforme regras padrão do PDV.

h2. O que foi implementado

• Criação do módulo de Autoatendimento para operação em tela touch.
• Melhorias de usabilidade no painel administrativo interno.
• Ajuste do seletor de porta da balança para toque:
  • Janela maior
  • Itens com maior altura
  • Botões maiores
• Parametrização da validação de peso em Parâmetros Específicos.
• Ajustes para reduzir erros operacionais no uso da balança.

h2. Pré-requisitos

• PDV atualizado com módulo de Autoatendimento.
• Balança instalada e comunicando via serial.
• Porta COM identificada no Windows.
• Permissão para alterar Parâmetros Específicos.
• Terminal touch recomendado.

h2. Configuração inicial

h3. 1) Configurar porta da balança No painel administrativo do Autoatendimento:

1. Abrir configuração de balança.
2. Selecionar a porta COM correta.
3. Confirmar.
4. Validar leitura de peso no fluxo de venda.

Dica de suporte: se houver mais de uma COM, testar leitura rápida até identificar a correta.

h3. 2) Configurar validação de peso Em Parâmetros Específicos:

1. Localizar parâmetros de Autoatendimento relacionados a peso.
2. Definir se a verificação de peso será utilizada.
3. Definir margem de tolerância.

Recomendação: iniciar com margem conservadora em homologação e ajustar após testes reais.

h2. Fluxo operacional detalhado

h3. Itens sem pesagem

• Cliente seleciona item.
• Item é adicionado ao carrinho.
• Total é atualizado normalmente.

h3. Itens com pesagem

• Cliente seleciona item com controle por peso.
• Sistema consulta peso da balança.
• Sistema compara leitura com regra configurada:
  • Verificação habilitada: valida usando margem.
  • Verificação desabilitada: segue sem bloqueio por peso.
• Item é aceito ou sinalizado conforme resultado.

h2. Roteiro de validação (homologação)

1. Abrir Autoatendimento.
2. Incluir itens sem peso.
3. Incluir item com peso e validar leitura.
4. Testar cenário dentro e fora da margem.
5. Confirmar fechamento da venda.
6. Confirmar alteração de porta COM no painel administrativo.

h2. Diagnóstico rápido

h3. Problema: não lê peso Possíveis causas:

• Porta COM incorreta
• Balança desconectada
• Driver/serial indisponível

Ações:

1. Reconfigurar porta COM no painel administrativo.
2. Testar cabo e conexão física.
3. Confirmar disponibilidade da porta no Windows.

h3. Problema: bloqueio indevido em item pesado Possíveis causas:

• Margem configurada muito baixa
• Variação operacional normal fora da margem

Ações:

1. Revisar parâmetros de verificação e margem.
2. Repetir teste com item padrão conhecido.

h3. Problema: dificuldade de uso no touch Possíveis causas:

• Escala/resolução inadequada
• Touch sem calibração

Ações:

1. Validar resolução e escala.
2. Recalibrar touch no sistema operacional.

h2. Boas práticas de implantação

• Executar primeiro ciclo em homologação.
• Registrar porta COM e margem por loja.
• Treinar equipe local para:
  • Acessar painel administrativo
  • Trocar porta COM quando necessário
  • Diferenciar falha física de falha de configuração

h2. Script rápido para atendimento

1. Confirmar versão com Autoatendimento atualizado.
2. Verificar conexão da balança e porta COM.
3. Revisar parâmetros de verificação de peso e margem.
4. Executar teste com item sem peso e com peso.
5. Ajustar parâmetros, se necessário.
6. Registrar configuração final e evidência de teste.

h2. Resultado esperado

• Operação autônoma do cliente com baixa intervenção.
• Validação consistente para itens pesáveis.
• Ajuste rápido de COM em ambiente touch.
• Redução de chamados por configuração de balança e margem.

```