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

De Office System
Ir para navegação Ir para pesquisar
Linha 1: Linha 1:
==PDV Autoatendimento==
+
==PDV Autoatendimento (Guia completo para Suporte)==
  
==O que é?==
+
==Objetivo==
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.
+
Documentar a configuração completa do PDV Autoatendimento para implantação, conferência e atendimento de chamados, incluindo onde fica cada marquinha obrigatória.
  
Neste modo, o cliente:
+
==Visão funcional==
* seleciona os produtos;
+
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:
* visualiza carrinho e total;
+
* seleção de itens;
* passa pela validação de peso (quando aplicável);
+
* conferência de peso (quando aplicável);
* escolhe forma de pagamento disponível;
+
* escolha de forma de pagamento;
* finaliza a compra.
+
* finalização da venda.
  
==Como funciona (visão geral)==
+
==Marquinhas e parâmetros obrigatórios==
# O cliente inicia o atendimento no terminal.
 
# Seleciona produtos e adiciona ao carrinho.
 
# 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.
 
  
==Requisitos==
+
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===
* Master Key / Master Key PDV com módulo de Autoatendimento.
+
'''Onde fica'''
* Terminal com tela touch (recomendado).
+
Cadastro de Usuários > aba '''Autoatendimento'''
* 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==
+
'''Campo'''
 +
* '''Utilizar PDV Autoatendimento''' (US_AUTOATEND)
  
===1) Parâmetros Específicos (empresa)==
+
'''Regra'''
No grupo de Autoatendimento, configurar:
+
* Marcado = usuário entra no PDV em modo Autoatendimento.
 +
* Desmarcado = usuário segue no PDV normal.
  
'''1.1) Verificar peso'''
+
===2) Marquinha do Usuário para Balança===
Habilita ou desabilita a conferência de peso no fluxo do Autoatendimento.
+
'''Onde fica'''
 +
Cadastro de Usuários > aba '''Autoatendimento'''
  
'''1.2) Margem de peso'''
+
'''Campo'''
Define a tolerância usada na validação do peso.
+
* '''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)
  
Observação:
+
'''Regra'''
Essas configurações são por empresa (Parâmetros Específicos), e não por usuário.
+
* Marcado = Autoatendimento usa leitura da balança para conferência.
 +
* Desmarcado = fluxo sem conferência por balança.
  
===2) Tipos de Pagamento (marquinha)==
+
===3) Marquinha do Tipo de Pagamento===
No cadastro de tipos de pagamento, habilitar a '''marquinha''' de uso no Autoatendimento.
+
'''Onde fica'''
 +
Cadastro de Tipos de Pagamento > aba '''PDV'''
  
Regra:
+
'''Campo'''
* Se não estiver marcado, o tipo de pagamento não aparece no fechamento do Autoatendimento.
+
* '''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)
* Se estiver marcado, ele fica disponível para o cliente selecionar no terminal.
 
  
===3) Produto com peso variável (marquinha)==
+
'''Regra'''
No cadastro do produto, habilitar a '''marquinha de peso variável''' para itens que dependem de balança.
+
* 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.
  
Regra:
+
===4) Marquinha de Peso Variável (produto/subgrupo)===
* Produto com marquinha de peso variável entra no fluxo de conferência de peso.
+
'''Onde fica'''
* Produto sem marquinha segue como item comum (sem conferência de peso da balança).
+
Cadastro de Subgrupos de Produtos
  
===4) Porta da balança (painel administrativo do Autoatendimento)==
+
'''Campo'''
No painel administrativo interno do Autoatendimento:
+
* '''Peso variável''' (SG_PESOVARIAVEL)
# Abrir a configuração da balança.
 
# Selecionar a porta COM correta.
 
# Confirmar e testar leitura.
 
  
Observação:
+
'''Regra'''
O seletor de porta foi otimizado para touch (janela, lista e botões com área maior de toque).
+
* 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).
  
==Fluxo funcional completo==
+
===5) Parâmetros de Peso do Autoatendimento===
 +
'''Onde fica'''
 +
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''
  
===Etapa 1 - Seleção de itens===
+
'''Campos'''
* Cliente navega por categorias/produtos.
+
* '''Verificação''' (AUTOATEND_VERIF_PESO)
* Adiciona itens ao carrinho.
+
** Item por Item (I)
* Total parcial é atualizado.
+
** Final (F)
 +
* '''Margem toler. (%)''' (AUTOATEND_MARGEM)
  
===Etapa 2 - Regras de pesagem===
+
'''Regra'''
Quando o item estiver marcado como peso variável:
+
* Define como e quando o peso será validado.
* o sistema obtém leitura da balança;
+
* A margem é percentual inteiro (ex.: 5 = 5%).
* aplica validação conforme "Verificar peso" e "Margem de peso";
 
* permite continuidade ou bloqueia/sinaliza divergência conforme regra.
 
  
===Etapa 3 - Pagamento===
+
==Fluxo de configuração recomendado (ordem para implantação)==
* O sistema mostra somente os tipos de pagamento com marquinha habilitada para Autoatendimento.
+
1. Atualizar sistema e banco.
* Cliente seleciona forma de pagamento.
+
2. Conferir usuário com marquinha '''Utilizar PDV Autoatendimento'''.
* Venda é concluída.
+
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 painel administrativo do Autoatendimento, configurar porta COM da balança.
 +
8. Executar teste de ponta a ponta.
  
==Checklist de implantação (suporte)==
+
==Comportamentos importantes para 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)==
+
===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).
  
===Teste A - Item sem peso===
+
===Item não passa por conferência de peso===
# Incluir item comum.
+
Conferir:
# Confirmar que não entra em conferência de balança.
+
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).
# Validar finalização.
+
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 painel administrativo.
  
===Teste B - Item com peso variável===
+
===Usuário não entra no Autoatendimento===
# Incluir item com marquinha de peso variável.
+
Conferir:
# Confirmar leitura da balança.
+
1. Marquinha '''Utilizar PDV Autoatendimento''' no usuário (US_AUTOATEND).
# Testar cenário dentro da margem.
+
2. Login realizado com o usuário correto.
# Testar cenário fora da margem.
 
  
===Teste C - Formas de pagamento===
+
==Permissões administrativas (Área Restrita)==
# Ir ao fechamento.
+
O módulo possui controle de permissões para ações administrativas no Autoatendimento, incluindo:
# Confirmar que aparecem somente tipos com marquinha de Autoatendimento.
+
* permissão para divergência de peso;
# Validar conclusão da venda.
+
* acesso à área restrita do Autoatendimento.
  
==Operação do suporte (diagnóstico rápido)==
+
Em chamados de bloqueio de ação administrativa, validar as permissões do usuário/perfil antes de tratar como erro técnico.
  
===1) Item pesável não valida peso===
+
==Atualização de banco (estrutura criada pela versão)==
Verificar nesta ordem:
+
Na entrega do Autoatendimento, a atualização adiciona:
# Produto está com marquinha de peso variável.
+
* US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;
# Parâmetros de peso estão configurados.
+
* TP_AUTOATEND em TIPOPGTO;
# Porta COM da balança está correta.
+
* AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;
# Balança está conectada/comunicando.
+
* SG_PESOVARIAVEL em SUBGRUPOS;
 +
com defaults e atualização de nulos para evitar inconsistência inicial.
  
===2) Forma de pagamento não aparece===
+
==Roteiro de teste de homologação (obrigatório)==
# Confirmar marquinha do tipo de pagamento para Autoatendimento.
+
1. Logar com usuário marcado para Autoatendimento.
# Salvar cadastro e reabrir fluxo de fechamento.
+
2. Confirmar abertura do PDV em modo Autoatendimento.
 +
3. Inserir item comum (sem peso variável) e validar fluxo normal.
 +
4. Inserir item de subgrupo com peso variável e validar conferência.
 +
5. Testar cenário dentro da margem e fora da margem.
 +
6. Ir para pagamento e confirmar que só aparecem tipos com marquinha TP_AUTOATEND.
 +
7. Concluir venda.
 +
8. Repetir com usuário sem marquinha US_AUTOATEND e validar PDV normal.
  
===3) Divergência frequente de peso===
+
==Pesquisa na tela de Parâmetros (apoio ao suporte)==
# Revisar margem de tolerância.
+
A tela de Parâmetros Específicos possui pesquisa por termo com botão '''Consultar''', navegação por próximo/anterior e contador de ocorrências, para localizar rapidamente os itens do Autoatendimento (ex.: "autoatend", "peso", "margem").
# Validar leitura real da balança.
 
# Repetir teste com item padrão de referência.
 
 
 
===4) Não lê peso no terminal===
 
# Testar outra COM.
 
# Validar cabo/alimentação da balança.
 
# 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:
 
# 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.
 
 
 
==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 19h49min de 30 de abril de 2026

PDV Autoatendimento (Guia completo para Suporte)

Objetivo

Documentar a configuração completa do PDV Autoatendimento para implantação, conferência e atendimento de chamados, incluindo onde fica cada marquinha obrigatória.

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.

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%).

Fluxo de configuração recomendado (ordem para implantaçã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 painel administrativo do Autoatendimento, configurar porta COM da balança. 8. Executar teste de ponta a ponta.

Comportamentos importantes para suporte

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 painel administrativo.

Usuário não entra no Autoatendimento

Conferir: 1. Marquinha Utilizar PDV Autoatendimento no usuário (US_AUTOATEND). 2. Login realizado com o usuário correto.

Permissões administrativas (Área Restrita)

O módulo possui controle de permissões para ações administrativas no Autoatendimento, incluindo:

  • permissão para divergência de peso;
  • acesso à área restrita do Autoatendimento.

Em chamados de bloqueio de ação administrativa, validar as permissões do usuário/perfil antes de tratar como erro técnico.

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;

com defaults e atualização de nulos para evitar inconsistência inicial.

Roteiro de teste de homologação (obrigatório)

1. Logar com usuário marcado para Autoatendimento. 2. Confirmar abertura do PDV em modo Autoatendimento. 3. Inserir item comum (sem peso variável) e validar fluxo normal. 4. Inserir item de subgrupo com peso variável e validar conferência. 5. Testar cenário dentro da margem e fora da margem. 6. Ir para pagamento e confirmar que só aparecem tipos com marquinha TP_AUTOATEND. 7. Concluir venda. 8. Repetir com usuário sem marquinha US_AUTOATEND e validar PDV normal.

Pesquisa na tela de Parâmetros (apoio ao suporte)

A tela de Parâmetros Específicos possui pesquisa por termo com botão Consultar, navegação por próximo/anterior e contador de ocorrências, para localizar rapidamente os itens do Autoatendimento (ex.: "autoatend", "peso", "margem").