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

De Office System
Ir para navegação Ir para pesquisar
 
(4 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
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===
+
==Visão funcional==
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.
+
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:
  
'''Campos novos em PARAMESP'''
+
*seleção de itens;
* AUTOATEND_VERIF_PESO
+
*conferência de peso (quando aplicável);
* AUTOATEND_MARGEM
+
*escolha de forma de pagamento;
 +
*finalização da venda.
  
'''Comportamento da atualização'''
+
Além do fluxo do cliente, existe o módulo administrativo interno chamado '''Área Restrita''' (do Autoatendimento), usado para ações de administração, como configuração de balança e liberações conforme permissã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'''
+
==Marquinhas e parâmetros obrigatórios==
* 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)==
+
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===
Foram feitos ajustes de usabilidade no painel administrativo para operação em tela touch.
+
'''Onde fica'''
  
'''O que mudou'''
+
Cadastro de Usuários > aba '''Autoatendimento'''
* 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'''
+
'''Campo'''
* 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===
+
*'''Utilizar PDV Autoatendimento''' (US_AUTOATEND)
O fluxo considera os parâmetros centralizados em PARAMESP.
 
  
'''Regras'''
+
'''Regra'''
* 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===
+
*Marcado = usuário entra no PDV em modo Autoatendimento.
No fechamento da compra no Autoatendimento, só devem aparecer formas de pagamento com a '''marquinha''' habilitada para esse uso.
+
*Desmarcado = usuário segue no PDV normal.
  
'''Importante para suporte'''
+
===2) Marquinha do Usuário para Balança===
* Se um tipo de pagamento "sumiu" no Autoatendimento, validar a marquinha do tipo de pagamento.
+
'''Onde fica'''
* 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)==
+
Cadastro de Usuários > aba '''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.
 
  
===B) Tipo de pagamento (marquinha)==
+
'''Campo'''
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)==
+
*'''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)
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===
+
'''Regra'''
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)==
+
*Marcado = Autoatendimento usa leitura da balança para conferência.
1. Testar item comum (sem peso variável): deve seguir sem conferência de peso.
+
*Desmarcado = fluxo sem conferência por balança.
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==
+
===3) Marquinha do Tipo de Pagamento===
===1) Não lê peso===
+
'''Onde fica'''
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===
+
Cadastro de Tipos de Pagamento > aba '''PDV'''
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===
+
'''Campo'''
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)==
+
*'''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)
Foi adicionada pesquisa na tela de Parâmetros Específicos para facilitar localizar configurações de Autoatendimento.
 
  
'''Como funciona'''
+
'''Regra'''
* 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'''
+
*Só aparece no Autoatendimento se esta marquinha estiver marcada.
* Pesquisar por termos como: "autoatend", "peso", "margem", "estoque", etc.
+
*Além disso, o tipo também precisa estar ativo e com atalho preenchido.
```
+
*Tipos sem atalho não entram na listagem do Autoatendimento.
  
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.
+
===4) Marquinha de Peso Variável (produto/subgrupo)===
 +
'''Onde fica'''
 +
 
 +
Cadastro de Subgrupos de Produtos
 +
 
 +
'''Campo'''
 +
 
 +
*'''Peso variável''' (SG_PESOVARIAVEL)
 +
 
 +
'''Regra'''
 +
 
 +
*Subgrupo marcado como peso variável entra na lógica de conferência de peso no Autoatendimento.
 +
*Subgrupo não marcado segue como item comum (sem conferência de peso variável).
 +
 
 +
===5) Parâmetros de Peso do Autoatendimento===
 +
'''Onde fica'''
 +
 
 +
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''
 +
 
 +
'''Campos'''
 +
 
 +
*'''Verificação''' (AUTOATEND_VERIF_PESO)
 +
**Item por Item (I)
 +
**Final (F)
 +
*'''Margem toler. (%)''' (AUTOATEND_MARGEM)
 +
 
 +
'''Regra'''
 +
 
 +
*Define como e quando o peso será validado.
 +
*A margem é percentual inteiro (ex.: 5 = 5%).
 +
 
 +
==Módulo administrativo do Autoatendimento==
 +
O nome do módulo administrativo é '''Acesso Área Restrita Autoatendimento'''.
 +
 
 +
'''Onde acessar'''
 +
 
 +
Dentro da tela do Autoatendimento, botão '''Área Restrita'''.
 +
 
 +
'''Para que serve'''
 +
 
 +
*Configurar porta COM da balança no próprio Autoatendimento;
 +
*Executar ações administrativas protegidas por permissão;
 +
*Permitir liberações operacionais quando o usuário tiver permissão.
 +
 
 +
==Fluxo de configuração==
 +
1. Atualizar sistema e banco.
 +
 
 +
2. Conferir usuário com marquinha '''Utilizar PDV Autoatendimento'''.
 +
 
 +
3. Se houver balança, marcar '''Utilizar balança para conferência de peso''' no usuário.
 +
 
 +
4. Em Subgrupos, marcar '''Peso variável''' nos subgrupos corretos.
 +
 
 +
5. Em Tipos de Pagamento, marcar '''Disponível no PDV de Autoatendimento''' nos tipos permitidos.
 +
 
 +
6. Em Parâmetros Específicos, ajustar:
 +
 
 +
*Verificação (Item por Item ou Final)
 +
*Margem toler. (%)
 +
 
 +
7. No módulo '''Área Restrita''' do Autoatendimento, configurar porta COM da balança.
 +
 
 +
8. Executar teste de ponta a ponta.
 +
 
 +
==Comportamentos importantes==
 +
 
 +
===Pagamentos não aparecem===
 +
Conferir, nesta ordem:
 +
 
 +
1. Marquinha TP_AUTOATEND no tipo de pagamento.
 +
 
 +
2. Tipo não está inativo.
 +
 
 +
3. Tipo possui atalho preenchido.
 +
 
 +
4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).
 +
 
 +
===Item não passa por conferência de peso===
 +
Conferir:
 +
 
 +
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).
 +
 
 +
2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).
 +
 
 +
3. Parâmetro de verificação e margem em Parâmetros Específicos.
 +
 
 +
4. Porta COM configurada corretamente no módulo '''Área Restrita'''.
 +
 
 +
===Não consegue acessar funções administrativas===
 +
Conferir:
 +
 
 +
1. Se o usuário tem permissão de '''Acesso Área Restrita Autoatendimento'''.
 +
 
 +
2. Se o usuário tem permissão para '''Permite divergência de peso no Autoatendimento''' (quando aplicável ao cenário).
 +
 
 +
==Atualização de banco (estrutura criada pela versão)==
 +
Na entrega do Autoatendimento, a atualização adiciona:
 +
 
 +
*US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;
 +
*TP_AUTOATEND em TIPOPGTO;
 +
*AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;
 +
*SG_PESOVARIAVEL em SUBGRUPOS;

Edição atual tal como às 20h00min de 30 de abril de 2026

PDV Autoatendimento

Visão funcional

No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:

  • seleção de itens;
  • conferência de peso (quando aplicável);
  • escolha de forma de pagamento;
  • finalização da venda.

Além do fluxo do cliente, existe o módulo administrativo interno chamado Área Restrita (do Autoatendimento), usado para ações de administração, como configuração de balança e liberações conforme permissão.

Marquinhas e parâmetros obrigatórios

1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)

Onde fica

Cadastro de Usuários > aba Autoatendimento

Campo

  • Utilizar PDV Autoatendimento (US_AUTOATEND)

Regra

  • Marcado = usuário entra no PDV em modo Autoatendimento.
  • Desmarcado = usuário segue no PDV normal.

2) Marquinha do Usuário para Balança

Onde fica

Cadastro de Usuários > aba Autoatendimento

Campo

  • Utilizar balança para conferência de peso (US_AUTOATEND_BALANCA)

Regra

  • Marcado = Autoatendimento usa leitura da balança para conferência.
  • Desmarcado = fluxo sem conferência por balança.

3) Marquinha do Tipo de Pagamento

Onde fica

Cadastro de Tipos de Pagamento > aba PDV

Campo

  • Disponível no PDV de Autoatendimento (TP_AUTOATEND)

Regra

  • Só aparece no Autoatendimento se esta marquinha estiver marcada.
  • Além disso, o tipo também precisa estar ativo e com atalho preenchido.
  • Tipos sem atalho não entram na listagem do Autoatendimento.

4) Marquinha de Peso Variável (produto/subgrupo)

Onde fica

Cadastro de Subgrupos de Produtos

Campo

  • Peso variável (SG_PESOVARIAVEL)

Regra

  • Subgrupo marcado como peso variável entra na lógica de conferência de peso no Autoatendimento.
  • Subgrupo não marcado segue como item comum (sem conferência de peso variável).

5) Parâmetros de Peso do Autoatendimento

Onde fica

Parâmetros Específicos > grupo Autoatendimento - Peso

Campos

  • Verificação (AUTOATEND_VERIF_PESO)
    • Item por Item (I)
    • Final (F)
  • Margem toler. (%) (AUTOATEND_MARGEM)

Regra

  • Define como e quando o peso será validado.
  • A margem é percentual inteiro (ex.: 5 = 5%).

Módulo administrativo do Autoatendimento

O nome do módulo administrativo é Acesso Área Restrita Autoatendimento.

Onde acessar

Dentro da tela do Autoatendimento, botão Área Restrita.

Para que serve

  • Configurar porta COM da balança no próprio Autoatendimento;
  • Executar ações administrativas protegidas por permissão;
  • Permitir liberações operacionais quando o usuário tiver permissão.

Fluxo de configuração

1. Atualizar sistema e banco.

2. Conferir usuário com marquinha Utilizar PDV Autoatendimento.

3. Se houver balança, marcar Utilizar balança para conferência de peso no usuário.

4. Em Subgrupos, marcar Peso variável nos subgrupos corretos.

5. Em Tipos de Pagamento, marcar Disponível no PDV de Autoatendimento nos tipos permitidos.

6. Em Parâmetros Específicos, ajustar:

  • Verificação (Item por Item ou Final)
  • Margem toler. (%)

7. No módulo Área Restrita do Autoatendimento, configurar porta COM da balança.

8. Executar teste de ponta a ponta.

Comportamentos importantes

Pagamentos não aparecem

Conferir, nesta ordem:

1. Marquinha TP_AUTOATEND no tipo de pagamento.

2. Tipo não está inativo.

3. Tipo possui atalho preenchido.

4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).

Item não passa por conferência de peso

Conferir:

1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).

2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).

3. Parâmetro de verificação e margem em Parâmetros Específicos.

4. Porta COM configurada corretamente no módulo Área Restrita.

Não consegue acessar funções administrativas

Conferir:

1. Se o usuário tem permissão de Acesso Área Restrita Autoatendimento.

2. Se o usuário tem permissão para Permite divergência de peso no Autoatendimento (quando aplicável ao cenário).

Atualização de banco (estrutura criada pela versão)

Na entrega do Autoatendimento, a atualização adiciona:

  • US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;
  • TP_AUTOATEND em TIPOPGTO;
  • AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;
  • SG_PESOVARIAVEL em SUBGRUPOS;