Mudanças entre as edições de "Auto Atendimento"

De Office System
Ir para navegação Ir para pesquisar
Linha 1: Linha 1:
==Escopo desta entrega (PDV Autoatendimento)==
+
==PDV Autoatendimento==
Este conteúdo descreve exatamente o que foi implementado nesta sequência de ajustes, para suporte técnico e implantação.
 
  
===1) Migração de configuração de peso para Parâmetros Específicos===
+
==O que é?==
A configuração de validação de peso do Autoatendimento deixou de ser por usuário e passou para Parâmetros Específicos da empresa.
+
O PDV Autoatendimento é o modo de venda em que o próprio cliente realiza a compra no terminal touch, sem depender do operador para conduzir cada etapa.
  
'''Campos novos em PARAMESP'''
+
Neste modo, o cliente:
* AUTOATEND_VERIF_PESO
+
* seleciona os produtos;
* AUTOATEND_MARGEM
+
* visualiza carrinho e total;
 +
* passa pela validação de peso (quando aplicável);
 +
* escolhe forma de pagamento disponível;
 +
* finaliza a compra.
  
'''Comportamento da atualização'''
+
==Como funciona (visão geral)==
* A atualização de banco cria os campos em PARAMESP.
+
# O cliente inicia o atendimento no terminal.
* Os valores antigos são migrados para PARAMESP.
+
# Seleciona produtos e adiciona ao carrinho.
* O fluxo do Autoatendimento passa a ler esses campos em PARAMESP.
+
# Se houver item de pesagem, o sistema realiza conferência de peso conforme parâmetros.
 +
# O cliente segue para pagamento.
 +
# O sistema exibe somente as formas de pagamento habilitadas para Autoatendimento.
 +
# A venda é finalizada no próprio terminal.
  
'''Importante para suporte'''
+
==Requisitos==
* Se cliente atualizar e a tela não refletir os valores, validar se os campos existem em PARAMESP e se houve migração dos dados.
+
* Master Key / Master Key PDV com módulo de Autoatendimento.
* A configuração antiga por usuário não é mais a referência principal para peso no Autoatendimento.
+
* Terminal com tela touch (recomendado).
 +
* Balança serial instalada (quando houver venda de item pesável).
 +
* Permissão para alterar Parâmetros Específicos, Tipos de Pagamento e Cadastro de Produtos.
  
===2) Ajustes no painel administrativo do Autoatendimento (touch)==
+
==Configuração obrigatória==
Foram feitos ajustes de usabilidade no painel administrativo para operação em tela touch.
 
  
'''O que mudou'''
+
===1) Parâmetros Específicos (empresa)==
* Seleção da porta da balança com janela maior.
+
No grupo de Autoatendimento, configurar:
* Lista de portas com itens maiores (melhor toque).
 
* Botões de ação (confirmar/cancelar) maiores.
 
* Ajuste visual do botão Fechar no painel administrativo para facilitar identificação/uso.
 
  
'''Importante para suporte'''
+
'''1.1) Verificar peso'''
* Em caso de erro de leitura de peso, sempre revisar primeiro a porta COM selecionada no painel administrativo do Autoatendimento.
+
Habilita ou desabilita a conferência de peso no fluxo do Autoatendimento.
  
===3) Fluxo de pesagem no Autoatendimento===
+
'''1.2) Margem de peso'''
O fluxo considera os parâmetros centralizados em PARAMESP.
+
Define a tolerância usada na validação do peso.
  
'''Regras'''
+
Observação:
* Se AUTOATEND_VERIF_PESO estiver habilitado, o sistema valida o peso.
+
Essas configurações são por empresa (Parâmetros Específicos), e não por usuário.
* A tolerância usa AUTOATEND_MARGEM.
 
* Produto de pesagem precisa estar com a '''marquinha de peso variável''' habilitada no cadastro do produto para entrar no fluxo de conferência de peso.
 
  
===4) Tipos de pagamento no Autoatendimento===
+
===2) Tipos de Pagamento (marquinha)==
No fechamento da compra no Autoatendimento, só devem aparecer formas de pagamento com a '''marquinha''' habilitada para esse uso.
+
No cadastro de tipos de pagamento, habilitar a '''marquinha''' de uso no Autoatendimento.
  
'''Importante para suporte'''
+
Regra:
* Se um tipo de pagamento "sumiu" no Autoatendimento, validar a marquinha do tipo de pagamento.
+
* Se não estiver marcado, o tipo de pagamento não aparece no fechamento do Autoatendimento.
* Se item de balança não está validando peso, validar a marquinha de peso variável no produto.
+
* Se estiver marcado, ele fica disponível para o cliente selecionar no terminal.
  
==Como configurar (passo a passo para suporte)==
+
===3) Produto com peso variável (marquinha)==
===A) Parâmetros Específicos===
+
No cadastro do produto, habilitar a '''marquinha de peso variável''' para itens que dependem de balança.
1. Abrir Parâmetros Específicos.
 
2. Localizar grupo de Autoatendimento.
 
3. Configurar:
 
* '''Verificar peso''' (habilita/desabilita conferência)
 
* '''Margem de peso''' (tolerância)
 
4. Salvar.
 
  
===B) Tipo de pagamento (marquinha)==
+
Regra:
1. Abrir cadastro de Tipos de Pagamento.
+
* Produto com marquinha de peso variável entra no fluxo de conferência de peso.
2. Marcar os tipos permitidos no Autoatendimento.
+
* Produto sem marquinha segue como item comum (sem conferência de peso da balança).
3. Salvar.
 
4. Testar no fechamento da venda do Autoatendimento.
 
  
===C) Produto com peso variável (marquinha)==
+
===4) Porta da balança (painel administrativo do Autoatendimento)==
1. Abrir cadastro do produto.
+
No painel administrativo interno do Autoatendimento:
2. Marcar como peso variável (quando aplicável).
+
# Abrir a configuração da balança.
3. Salvar.
+
# Selecionar a porta COM correta.
4. Testar inclusão e conferência no Autoatendimento.
+
# Confirmar e testar leitura.
  
===D) Porta da balança no painel administrativo===
+
Observação:
1. Entrar no painel administrativo do Autoatendimento.
+
O seletor de porta foi otimizado para touch (janela, lista e botões com área maior de toque).
2. Abrir seleção de porta da balança.
 
3. Selecionar COM correta.
 
4. Confirmar.
 
5. Executar teste com produto de peso variável.
 
  
==Fluxo de teste obrigatório (suporte)==
+
==Fluxo funcional completo==
1. Testar item comum (sem peso variável): deve seguir sem conferência de peso.
 
2. Testar item com peso variável:
 
* com peso dentro da margem: deve permitir continuidade;
 
* com peso fora da margem: deve aplicar regra de bloqueio/alerta do fluxo.
 
3. Ir para pagamento e confirmar se só aparecem os tipos com marquinha de Autoatendimento.
 
4. Concluir venda de ponta a ponta.
 
  
==Erros comuns e checagem rápida==
+
===Etapa 1 - Seleção de itens===
===1) Não lê peso===
+
* Cliente navega por categorias/produtos.
 +
* Adiciona itens ao carrinho.
 +
* Total parcial é atualizado.
 +
 
 +
===Etapa 2 - Regras de pesagem===
 +
Quando o item estiver marcado como peso variável:
 +
* o sistema obtém leitura da balança;
 +
* aplica validação conforme "Verificar peso" e "Margem de peso";
 +
* permite continuidade ou bloqueia/sinaliza divergência conforme regra.
 +
 
 +
===Etapa 3 - Pagamento===
 +
* O sistema mostra somente os tipos de pagamento com marquinha habilitada para Autoatendimento.
 +
* Cliente seleciona forma de pagamento.
 +
* Venda é concluída.
 +
 
 +
==Checklist de implantação (suporte)==
 +
# Conferir se o módulo Autoatendimento está disponível no PDV.
 +
# Configurar Parâmetros Específicos de peso (verificar + margem).
 +
# Habilitar marquinha nos tipos de pagamento desejados.
 +
# Habilitar marquinha de peso variável nos produtos pesáveis.
 +
# Configurar porta COM da balança no painel administrativo.
 +
# Executar teste de ponta a ponta.
 +
 
 +
==Roteiro de testes (homologação)==
 +
 
 +
===Teste A - Item sem peso===
 +
# Incluir item comum.
 +
# Confirmar que não entra em conferência de balança.
 +
# Validar finalização.
 +
 
 +
===Teste B - Item com peso variável===
 +
# Incluir item com marquinha de peso variável.
 +
# Confirmar leitura da balança.
 +
# Testar cenário dentro da margem.
 +
# Testar cenário fora da margem.
 +
 
 +
===Teste C - Formas de pagamento===
 +
# Ir ao fechamento.
 +
# Confirmar que aparecem somente tipos com marquinha de Autoatendimento.
 +
# Validar conclusão da venda.
 +
 
 +
==Operação do suporte (diagnóstico rápido)==
 +
 
 +
===1) Item pesável não valida peso===
 
Verificar nesta ordem:
 
Verificar nesta ordem:
1. Porta COM no painel administrativo.
+
# Produto está com marquinha de peso variável.
2. Comunicação física da balança.
+
# Parâmetros de peso estão configurados.
3. Produto está com marquinha de peso variável.
+
# Porta COM da balança está correta.
4. Parâmetros AUTOATEND_VERIF_PESO / AUTOATEND_MARGEM.
+
# Balança está conectada/comunicando.
  
===2) Tipo de pagamento não aparece===
+
===2) Forma de pagamento não aparece===
1. Conferir marquinha do tipo de pagamento para Autoatendimento.
+
# Confirmar marquinha do tipo de pagamento para Autoatendimento.
2. Reabrir fluxo de fechamento após salvar cadastro.
+
# Salvar cadastro e reabrir fluxo de fechamento.
  
===3) Configuração de peso "sumiu" após atualização===
+
===3) Divergência frequente de peso===
1. Validar existência de AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP.
+
# Revisar margem de tolerância.
2. Validar se migração de dados foi aplicada no banco.
+
# Validar leitura real da balança.
3. Confirmar se o cliente não está consultando a configuração antiga por usuário.
+
# Repetir teste com item padrão de referência.
  
==Ajuste adicional entregue na tela de Parâmetros (apoio ao suporte)==
+
===4) Não lê peso no terminal===
Foi adicionada pesquisa na tela de Parâmetros Específicos para facilitar localizar configurações de Autoatendimento.
+
# Testar outra COM.
 +
# Validar cabo/alimentação da balança.
 +
# Confirmar disponibilidade da porta serial no Windows.
  
'''Como funciona'''
+
==Pesquisa de parâmetros (apoio ao suporte)==
* Digita o termo e clica em '''Consultar'''.
+
Na tela de Parâmetros Específicos existe pesquisa para localizar rapidamente configurações do Autoatendimento.
* Navega pelas ocorrências com botões de próximo/anterior.
 
* Exibe contador de ocorrência.
 
* Expande seções automaticamente quando necessário.
 
* Foi corrigido o posicionamento da rolagem para ocorrências em controles desabilitados (Enabled=False), evitando salto para local incorreto.
 
  
'''Uso prático'''
+
Como usar:
* Pesquisar por termos como: "autoatend", "peso", "margem", "estoque", etc.
+
# Digitar termo (ex.: autoatend, peso, margem).
```
+
# Clicar em '''Consultar'''.
 +
# Navegar entre resultados com próximo/anterior.
 +
# Usar contador de ocorrência para validar todas as posições encontradas.
  
Se quiser, eu já te mando uma segunda versão mais curta (estilo "checklist de atendimento"), para ficar como seção separada no final da wiki.
+
==Resumo de regra de negócio==
 +
* Parâmetro de peso: define comportamento global da empresa.
 +
* Marquinha de peso variável: define se o produto exige conferência de balança.
 +
* Marquinha de tipo de pagamento: define o que aparece para o cliente no fechamento.
 +
* Porta COM correta: condição obrigatória para leitura da balança.

Edição das 19h44min de 30 de abril de 2026

PDV Autoatendimento

O que é?

O PDV Autoatendimento é o modo de venda em que o próprio cliente realiza a compra no terminal touch, sem depender do operador para conduzir cada etapa.

Neste modo, o cliente:

  • seleciona os produtos;
  • visualiza carrinho e total;
  • passa pela validação de peso (quando aplicável);
  • escolhe forma de pagamento disponível;
  • finaliza a compra.

Como funciona (visão geral)

  1. O cliente inicia o atendimento no terminal.
  2. Seleciona produtos e adiciona ao carrinho.
  3. Se houver item de pesagem, o sistema realiza conferência de peso conforme parâmetros.
  4. O cliente segue para pagamento.
  5. O sistema exibe somente as formas de pagamento habilitadas para Autoatendimento.
  6. A venda é finalizada no próprio terminal.

Requisitos

  • Master Key / Master Key PDV com módulo de Autoatendimento.
  • Terminal com tela touch (recomendado).
  • Balança serial instalada (quando houver venda de item pesável).
  • Permissão para alterar Parâmetros Específicos, Tipos de Pagamento e Cadastro de Produtos.

Configuração obrigatória

=1) Parâmetros Específicos (empresa)

No grupo de Autoatendimento, configurar:

1.1) Verificar peso Habilita ou desabilita a conferência de peso no fluxo do Autoatendimento.

1.2) Margem de peso Define a tolerância usada na validação do peso.

Observação: Essas configurações são por empresa (Parâmetros Específicos), e não por usuário.

=2) Tipos de Pagamento (marquinha)

No cadastro de tipos de pagamento, habilitar a marquinha de uso no Autoatendimento.

Regra:

  • Se não estiver marcado, o tipo de pagamento não aparece no fechamento do Autoatendimento.
  • Se estiver marcado, ele fica disponível para o cliente selecionar no terminal.

=3) Produto com peso variável (marquinha)

No cadastro do produto, habilitar a marquinha de peso variável para itens que dependem de balança.

Regra:

  • Produto com marquinha de peso variável entra no fluxo de conferência de peso.
  • Produto sem marquinha segue como item comum (sem conferência de peso da balança).

=4) Porta da balança (painel administrativo do Autoatendimento)

No painel administrativo interno do Autoatendimento:

  1. Abrir a configuração da balança.
  2. Selecionar a porta COM correta.
  3. Confirmar e testar leitura.

Observação: O seletor de porta foi otimizado para touch (janela, lista e botões com área maior de toque).

Fluxo funcional completo

Etapa 1 - Seleção de itens

  • Cliente navega por categorias/produtos.
  • Adiciona itens ao carrinho.
  • Total parcial é atualizado.

Etapa 2 - Regras de pesagem

Quando o item estiver marcado como peso variável:

  • o sistema obtém leitura da balança;
  • aplica validação conforme "Verificar peso" e "Margem de peso";
  • permite continuidade ou bloqueia/sinaliza divergência conforme regra.

Etapa 3 - Pagamento

  • O sistema mostra somente os tipos de pagamento com marquinha habilitada para Autoatendimento.
  • Cliente seleciona forma de pagamento.
  • Venda é concluída.

Checklist de implantação (suporte)

  1. Conferir se o módulo Autoatendimento está disponível no PDV.
  2. Configurar Parâmetros Específicos de peso (verificar + margem).
  3. Habilitar marquinha nos tipos de pagamento desejados.
  4. Habilitar marquinha de peso variável nos produtos pesáveis.
  5. Configurar porta COM da balança no painel administrativo.
  6. Executar teste de ponta a ponta.

Roteiro de testes (homologação)

Teste A - Item sem peso

  1. Incluir item comum.
  2. Confirmar que não entra em conferência de balança.
  3. Validar finalização.

Teste B - Item com peso variável

  1. Incluir item com marquinha de peso variável.
  2. Confirmar leitura da balança.
  3. Testar cenário dentro da margem.
  4. Testar cenário fora da margem.

Teste C - Formas de pagamento

  1. Ir ao fechamento.
  2. Confirmar que aparecem somente tipos com marquinha de Autoatendimento.
  3. Validar conclusão da venda.

Operação do suporte (diagnóstico rápido)

1) Item pesável não valida peso

Verificar nesta ordem:

  1. Produto está com marquinha de peso variável.
  2. Parâmetros de peso estão configurados.
  3. Porta COM da balança está correta.
  4. Balança está conectada/comunicando.

2) Forma de pagamento não aparece

  1. Confirmar marquinha do tipo de pagamento para Autoatendimento.
  2. Salvar cadastro e reabrir fluxo de fechamento.

3) Divergência frequente de peso

  1. Revisar margem de tolerância.
  2. Validar leitura real da balança.
  3. Repetir teste com item padrão de referência.

4) Não lê peso no terminal

  1. Testar outra COM.
  2. Validar cabo/alimentação da balança.
  3. Confirmar disponibilidade da porta serial no Windows.

Pesquisa de parâmetros (apoio ao suporte)

Na tela de Parâmetros Específicos existe pesquisa para localizar rapidamente configurações do Autoatendimento.

Como usar:

  1. Digitar termo (ex.: autoatend, peso, margem).
  2. Clicar em Consultar.
  3. Navegar entre resultados com próximo/anterior.
  4. Usar contador de ocorrência para validar todas as posições encontradas.

Resumo de regra de negócio

  • Parâmetro de peso: define comportamento global da empresa.
  • Marquinha de peso variável: define se o produto exige conferência de balança.
  • Marquinha de tipo de pagamento: define o que aparece para o cliente no fechamento.
  • Porta COM correta: condição obrigatória para leitura da balança.