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

De Office System
Ir para navegação Ir para pesquisar
Linha 1: Linha 1:
−
==O que é?==
+
==Escopo desta entrega (PDV Autoatendimento)==
−
É o módulo de PDV Autoatendimento do Master Key / Master Key PDV, criado para operação em terminal touch, permitindo que o cliente faça o próprio atendimento com seleção de produtos, pesagem (quando aplicável) e fechamento da compra.
+
Este conteúdo descreve exatamente o que foi implementado nesta sequência de ajustes, para suporte técnico e implantação.
  
−
==Como funciona?==
+
===1) Migração de configuração de peso para Parâmetros Específicos===
−
Ao abrir o Autoatendimento no PDV, o cliente navega pelas categorias, adiciona produtos ao carrinho e conclui a venda no próprio terminal.
+
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.
  
−
Para itens de pesagem, o sistema lê a balança e valida o peso conforme os parâmetros configurados (verificação de peso + margem de tolerância).
+
'''Campos novos em PARAMESP'''
 +
* AUTOATEND_VERIF_PESO
 +
* AUTOATEND_MARGEM
  
−
==O que foi implementado==
+
'''Comportamento da atualização'''
−
* Módulo de Autoatendimento com fluxo touch;
+
* A atualização de banco cria os campos em PARAMESP.
−
* Painel administrativo interno para ajustes rápidos;
+
* Os valores antigos são migrados para PARAMESP.
−
* Melhoria no seletor de porta da balança (tela maior e botões maiores para toque);
+
* O fluxo do Autoatendimento passa a ler esses campos em PARAMESP.
−
* Parâmetros de validação de peso no sistema;
 
−
* Controle por "marquinha" para habilitação de tipos de pagamento no Autoatendimento;
 
−
* Controle por "marquinha" para produtos com peso variável.
 
  
−
==Benefícios==
+
'''Importante para suporte'''
−
* Atendimento mais rápido no PDV;
+
* 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.
−
* Menor dependência do operador durante a venda;
+
* A configuração antiga por usuário não é mais a referência principal para peso no Autoatendimento.
−
* Melhor experiência de uso em tela touch;
 
−
* Mais segurança na venda de itens pesáveis;
 
−
* Configuração operacional simples para suporte e implantação.
 
  
−
==Requisitos==
+
===2) Ajustes no painel administrativo do Autoatendimento (touch)==
−
* Master Key / PDV atualizado com o recurso de Autoatendimento;
+
Foram feitos ajustes de usabilidade no painel administrativo para operação em tela touch.
−
* Terminal touch (recomendado);
 
−
* Balança instalada e ativa em porta serial (COM), quando houver pesagem;
 
−
* Permissão para alterar Parâmetros Específicos e cadastros relacionados.
 
  
−
==Como configurar==
+
'''O que mudou'''
−
===1) Parâmetros Específicos===
+
* Seleção da porta da balança com janela maior.
−
Configurar os parâmetros do Autoatendimento relacionados à pesagem:
+
* 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.
  
−
'''1.1) Verificação de peso''': habilitar quando a loja utiliza conferência de peso no Autoatendimento.
+
'''Importante para suporte'''
 +
* Em caso de erro de leitura de peso, sempre revisar primeiro a porta COM selecionada no painel administrativo do Autoatendimento.
  
−
'''1.2) Margem de tolerância''': informar a margem permitida para diferença de peso.
+
===3) Fluxo de pesagem no Autoatendimento===
 +
O fluxo considera os parâmetros centralizados em PARAMESP.
  
−
===2) Painel administrativo do Autoatendimento===
+
'''Regras'''
−
No próprio Autoatendimento:
+
* Se AUTOATEND_VERIF_PESO estiver habilitado, o sistema valida o peso.
 +
* 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.
  
−
'''2.1) Porta da balança''': selecionar a COM correta.
+
===4) Tipos de pagamento no Autoatendimento===
 +
No fechamento da compra no Autoatendimento, só devem aparecer formas de pagamento com a '''marquinha''' habilitada para esse uso.
  
−
'''2.2) Confirmar''': salvar e validar em teste prático de pesagem.
+
'''Importante para suporte'''
 +
* Se um tipo de pagamento "sumiu" no Autoatendimento, validar a marquinha do tipo de pagamento.
 +
* Se item de balança não está validando peso, validar a marquinha de peso variável no produto.
  
−
===3) Tipos de pagamento (marquinha)===
+
==Como configurar (passo a passo para suporte)==
−
No cadastro de tipos de pagamento, marcar os que poderão aparecer no Autoatendimento.
+
===A) Parâmetros Específicos===
 +
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.
  
−
'''Importante''': se não estiver marcado, o tipo de pagamento não será disponibilizado no fechamento da compra no terminal de Autoatendimento.
+
===B) Tipo de pagamento (marquinha)==
 +
1. Abrir cadastro de Tipos de Pagamento.
 +
2. Marcar os tipos permitidos no Autoatendimento.
 +
3. Salvar.
 +
4. Testar no fechamento da venda do Autoatendimento.
  
−
===4) Produto com peso variável (marquinha)===
+
===C) Produto com peso variável (marquinha)==
−
Nos produtos que devem ser tratados por pesagem, marcar a opção de peso variável.
+
1. Abrir cadastro do produto.
 +
2. Marcar como peso variável (quando aplicável).
 +
3. Salvar.
 +
4. Testar inclusão e conferência no Autoatendimento.
  
−
'''Importante''': sem essa marcação, o item não entra no fluxo de leitura/validação de peso da balança no Autoatendimento.
+
===D) Porta da balança no painel administrativo===
 +
1. Entrar no painel administrativo do Autoatendimento.
 +
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 operacional==
+
==Fluxo de teste obrigatório (suporte)==
−
# Cliente inicia atendimento no terminal.
+
1. Testar item comum (sem peso variável): deve seguir sem conferência de peso.
−
# Seleciona produtos e adiciona ao carrinho.
+
2. Testar item com peso variável:
−
# Se houver item com peso variável (marcado), o sistema lê e valida o peso.
+
* com peso dentro da margem: deve permitir continuidade;
−
# Cliente segue para pagamento.
+
* com peso fora da margem: deve aplicar regra de bloqueio/alerta do fluxo.
−
# No pagamento, o sistema exibe somente os tipos de pagamento marcados para Autoatendimento.
+
3. Ir para pagamento e confirmar se só aparecem os tipos com marquinha de Autoatendimento.
−
# Venda é concluída normalmente.
+
4. Concluir venda de ponta a ponta.
  
−
==Roteiro de validação (suporte)==
+
==Erros comuns e checagem rápida==
−
# Validar se o terminal abre o Autoatendimento corretamente.
+
===1) Não lê peso===
−
# Incluir item comum (sem peso) e validar fluxo.
+
Verificar nesta ordem:
−
# Incluir item com marquinha de peso variável e validar leitura da balança.
+
1. Porta COM no painel administrativo.
−
# Testar validação com peso dentro e fora da margem.
+
2. Comunicação física da balança.
−
# Ir ao fechamento e confirmar se aparecem somente os tipos de pagamento marcados.
+
3. Produto está com marquinha de peso variável.
−
# Concluir uma venda de teste ponta a ponta.
+
4. Parâmetros AUTOATEND_VERIF_PESO / AUTOATEND_MARGEM.
  
−
==Erros comuns==
+
===2) Tipo de pagamento não aparece===
−
1) Item pesável não pede leitura de peso.
+
1. Conferir marquinha do tipo de pagamento para Autoatendimento.
−
* Verificar se a marquinha de peso variável está habilitada no produto;
+
2. Reabrir fluxo de fechamento após salvar cadastro.
−
* Verificar parâmetros de verificação de peso;
 
−
* Verificar comunicação da balança (porta COM).
 
  
−
2) Tipo de pagamento não aparece no fechamento.
+
===3) Configuração de peso "sumiu" após atualização===
−
* Verificar se o tipo está com a marquinha habilitada para Autoatendimento;
+
1. Validar existência de AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP.
−
* Revisar permissões e sincronização de cadastro, se aplicável.
+
2. Validar se migração de dados foi aplicada no banco.
 +
3. Confirmar se o cliente não está consultando a configuração antiga por usuário.
  
−
3) Não lê peso.
+
==Ajuste adicional entregue na tela de Parâmetros (apoio ao suporte)==
−
* Porta COM incorreta;
+
Foi adicionada pesquisa na tela de Parâmetros Específicos para facilitar localizar configurações de Autoatendimento.
−
* Balança desconectada/cabo com falha;
 
−
* Problema de driver/comunicação serial no Windows.
 
  
−
4) Bloqueio frequente por diferença de peso.
+
'''Como funciona'''
−
* Margem de tolerância muito restrita para a operação da loja;
+
* Digita o termo e clica em '''Consultar'''.
−
* Ajustar margem e repetir testes controlados.
+
* 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.
  
−
==Boas práticas==
+
'''Uso prático'''
−
* Configurar e validar primeiro em homologação;
+
* Pesquisar por termos como: "autoatend", "peso", "margem", "estoque", etc.
−
* Registrar quais tipos de pagamento ficaram marcados por loja;
+
```
−
* Registrar quais produtos usam marquinha de peso variável;
 
−
* Treinar equipe local para ajuste rápido de porta COM e validação básica de pesagem.
 
  
−
==Resumo para suporte==
+
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.
−
Se houver problema no Autoatendimento, validar primeiro:
 
−
# Parâmetros de peso;
 
−
# Porta COM da balança;
 
−
# Marquinha de tipo de pagamento;
 
−
# Marquinha de peso variável no produto.
 
−
Na maioria dos casos, a causa está em uma dessas quatro configurações.
 
−
```
 

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

Escopo desta entrega (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

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.

Campos novos em PARAMESP

  • AUTOATEND_VERIF_PESO
  • AUTOATEND_MARGEM

Comportamento da atualização

  • A atualização de banco cria os campos em PARAMESP.
  • Os valores antigos são migrados para PARAMESP.
  • O fluxo do Autoatendimento passa a ler esses campos em PARAMESP.

Importante para suporte

  • 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.
  • A configuração antiga por usuário não é mais a referência principal para peso no Autoatendimento.

=2) Ajustes no painel administrativo do Autoatendimento (touch)

Foram feitos ajustes de usabilidade no painel administrativo para operação em tela touch.

O que mudou

  • Seleção da porta da balança com janela maior.
  • 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

  • Em caso de erro de leitura de peso, sempre revisar primeiro a porta COM selecionada no painel administrativo do Autoatendimento.

3) Fluxo de pesagem no Autoatendimento

O fluxo considera os parâmetros centralizados em PARAMESP.

Regras

  • Se AUTOATEND_VERIF_PESO estiver habilitado, o sistema valida o peso.
  • 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

No fechamento da compra no Autoatendimento, só devem aparecer formas de pagamento com a marquinha habilitada para esse uso.

Importante para suporte

  • Se um tipo de pagamento "sumiu" no Autoatendimento, validar a marquinha do tipo de pagamento.
  • Se item de balança não está validando peso, validar a marquinha de peso variável no produto.

Como configurar (passo a passo para suporte)

A) Parâmetros Específicos

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)

1. Abrir cadastro de Tipos de Pagamento. 2. Marcar os tipos permitidos no Autoatendimento. 3. Salvar. 4. Testar no fechamento da venda do Autoatendimento.

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

1. Abrir cadastro do produto. 2. Marcar como peso variável (quando aplicável). 3. Salvar. 4. Testar inclusão e conferência no Autoatendimento.

D) Porta da balança no painel administrativo

1. Entrar no painel administrativo do Autoatendimento. 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)

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

1) Não lê peso

Verificar nesta ordem: 1. Porta COM no painel administrativo. 2. Comunicação física da balança. 3. Produto está com marquinha de peso variável. 4. Parâmetros AUTOATEND_VERIF_PESO / AUTOATEND_MARGEM.

2) Tipo de pagamento não aparece

1. Conferir marquinha do tipo de pagamento para Autoatendimento. 2. Reabrir fluxo de fechamento após salvar cadastro.

3) Configuração de peso "sumiu" após atualização

1. Validar existência de AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP. 2. Validar se migração de dados foi aplicada no banco. 3. Confirmar se o cliente não está consultando a configuração antiga por usuário.

Ajuste adicional entregue na tela de Parâmetros (apoio ao suporte)

Foi adicionada pesquisa na tela de Parâmetros Específicos para facilitar localizar configurações de Autoatendimento.

Como funciona

  • Digita o termo e clica em Consultar.
  • 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

  • Pesquisar por termos como: "autoatend", "peso", "margem", "estoque", etc.

```

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.

Disponível em “https://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&oldid=2351”