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 (Guia completo para Suporte)==
+
==PDV Autoatendimento==
 
 
==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==
 
==Visão funcional==
 
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:
 
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:
* seleção de itens;
+
 
* conferência de peso (quando aplicável);
+
*seleção de itens;
* escolha de forma de pagamento;
+
*conferência de peso (quando aplicável);
* finalização da venda.
+
*escolha de forma de pagamento;
 +
*finalização da venda.
  
 
==Marquinhas e parâmetros obrigatórios==
 
==Marquinhas e parâmetros obrigatórios==
Linha 15: Linha 13:
 
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===
 
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===
 
'''Onde fica'''
 
'''Onde fica'''
 +
 
Cadastro de Usuários > aba '''Autoatendimento'''
 
Cadastro de Usuários > aba '''Autoatendimento'''
  
 
'''Campo'''
 
'''Campo'''
* '''Utilizar PDV Autoatendimento''' (US_AUTOATEND)
+
 
 +
*'''Utilizar PDV Autoatendimento''' (US_AUTOATEND)
  
 
'''Regra'''
 
'''Regra'''
* Marcado = usuário entra no PDV em modo Autoatendimento.
+
 
* Desmarcado = usuário segue no PDV normal.
+
*Marcado = usuário entra no PDV em modo Autoatendimento.
 +
*Desmarcado = usuário segue no PDV normal.
  
 
===2) Marquinha do Usuário para Balança===
 
===2) Marquinha do Usuário para Balança===
 
'''Onde fica'''
 
'''Onde fica'''
 +
 
Cadastro de Usuários > aba '''Autoatendimento'''
 
Cadastro de Usuários > aba '''Autoatendimento'''
  
 
'''Campo'''
 
'''Campo'''
* '''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)
+
 
 +
*'''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)
  
 
'''Regra'''
 
'''Regra'''
* Marcado = Autoatendimento usa leitura da balança para conferência.
+
 
* Desmarcado = fluxo sem conferência por balança.
+
*Marcado = Autoatendimento usa leitura da balança para conferência.
 +
*Desmarcado = fluxo sem conferência por balança.
  
 
===3) Marquinha do Tipo de Pagamento===
 
===3) Marquinha do Tipo de Pagamento===
 
'''Onde fica'''
 
'''Onde fica'''
 +
 
Cadastro de Tipos de Pagamento > aba '''PDV'''
 
Cadastro de Tipos de Pagamento > aba '''PDV'''
  
 
'''Campo'''
 
'''Campo'''
* '''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)
+
 
 +
*'''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)
  
 
'''Regra'''
 
'''Regra'''
* Só aparece no Autoatendimento se esta marquinha estiver marcada.
+
 
* Além disso, o tipo também precisa estar ativo e com atalho preenchido.
+
*Só aparece no Autoatendimento se esta marquinha estiver marcada.
* Tipos sem atalho não entram na listagem do Autoatendimento.
+
*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)===
 
===4) Marquinha de Peso Variável (produto/subgrupo)===
 
'''Onde fica'''
 
'''Onde fica'''
 +
 
Cadastro de Subgrupos de Produtos
 
Cadastro de Subgrupos de Produtos
  
 
'''Campo'''
 
'''Campo'''
* '''Peso variável''' (SG_PESOVARIAVEL)
+
 
 +
*'''Peso variável''' (SG_PESOVARIAVEL)
  
 
'''Regra'''
 
'''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).
+
*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===
 
===5) Parâmetros de Peso do Autoatendimento===
 
'''Onde fica'''
 
'''Onde fica'''
 +
 
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''
 
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''
  
 
'''Campos'''
 
'''Campos'''
* '''Verificação''' (AUTOATEND_VERIF_PESO)
+
 
** Item por Item (I)
+
*'''Verificação''' (AUTOATEND_VERIF_PESO)
** Final (F)
+
**Item por Item (I)
* '''Margem toler. (%)''' (AUTOATEND_MARGEM)
+
**Final (F)
 +
*'''Margem toler. (%)''' (AUTOATEND_MARGEM)
  
 
'''Regra'''
 
'''Regra'''
* Define como e quando o peso será validado.
+
 
* A margem é percentual inteiro (ex.: 5 = 5%).
+
*Define como e quando o peso será validado.
 +
*A margem é percentual inteiro (ex.: 5 = 5%).
  
 
==Fluxo de configuração recomendado (ordem para implantação)==
 
==Fluxo de configuração recomendado (ordem para implantação)==
 
1. Atualizar sistema e banco.
 
1. Atualizar sistema e banco.
 +
 
2. Conferir usuário com marquinha '''Utilizar PDV Autoatendimento'''.
 
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.
 
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.
 
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.
 
5. Em Tipos de Pagamento, marcar '''Disponível no PDV de Autoatendimento''' nos tipos permitidos.
 +
 
6. Em Parâmetros Específicos, ajustar:
 
6. Em Parâmetros Específicos, ajustar:
* Verificação (Item por Item ou Final)
+
 
* Margem toler. (%)
+
*Verificação (Item por Item ou Final)
 +
*Margem toler. (%)
 +
 
 
7. No painel administrativo do Autoatendimento, configurar porta COM da balança.
 
7. No painel administrativo do Autoatendimento, configurar porta COM da balança.
 
8. Executar teste de ponta a ponta.
 
8. Executar teste de ponta a ponta.
Linha 88: Linha 108:
 
===Pagamentos não aparecem===
 
===Pagamentos não aparecem===
 
Conferir, nesta ordem:
 
Conferir, nesta ordem:
 +
 
1. Marquinha TP_AUTOATEND no tipo de pagamento.
 
1. Marquinha TP_AUTOATEND no tipo de pagamento.
 +
 
2. Tipo não está inativo.
 
2. Tipo não está inativo.
 +
 
3. Tipo possui atalho preenchido.
 
3. Tipo possui atalho preenchido.
 +
 
4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).
 
4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).
  
 
===Item não passa por conferência de peso===
 
===Item não passa por conferência de peso===
 
Conferir:
 
Conferir:
 +
 
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).
 
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).
 +
 
2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).
 
2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).
 +
 
3. Parâmetro de verificação e margem em Parâmetros Específicos.
 
3. Parâmetro de verificação e margem em Parâmetros Específicos.
 +
 
4. Porta COM configurada corretamente no painel administrativo.
 
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)==
 
==Permissões administrativas (Área Restrita)==
 
O módulo possui controle de permissões para ações administrativas no Autoatendimento, incluindo:
 
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.
+
*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.
 
Em chamados de bloqueio de ação administrativa, validar as permissões do usuário/perfil antes de tratar como erro técnico.
Linha 114: Linha 138:
 
==Atualização de banco (estrutura criada pela versão)==
 
==Atualização de banco (estrutura criada pela versão)==
 
Na entrega do Autoatendimento, a atualização adiciona:
 
Na entrega do Autoatendimento, a atualização adiciona:
* US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;
+
 
* TP_AUTOATEND em TIPOPGTO;
+
*US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;
* AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;
+
*TP_AUTOATEND em TIPOPGTO;
* SG_PESOVARIAVEL em SUBGRUPOS;
+
*AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;
 +
*SG_PESOVARIAVEL em SUBGRUPOS;
 +
 
 
com defaults e atualização de nulos para evitar inconsistência inicial.
 
com defaults e atualização de nulos para evitar inconsistência inicial.
  
 
==Roteiro de teste de homologação (obrigatório)==
 
==Roteiro de teste de homologação (obrigatório)==
 
1. Logar com usuário marcado para Autoatendimento.
 
1. Logar com usuário marcado para Autoatendimento.
 +
 
2. Confirmar abertura do PDV em modo Autoatendimento.
 
2. Confirmar abertura do PDV em modo Autoatendimento.
 +
 
3. Inserir item comum (sem peso variável) e validar fluxo normal.
 
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.
 
4. Inserir item de subgrupo com peso variável e validar conferência.
 +
 
5. Testar cenário dentro da margem e fora da margem.
 
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.
 
6. Ir para pagamento e confirmar que só aparecem tipos com marquinha TP_AUTOATEND.
 +
 
7. Concluir venda.
 
7. Concluir venda.
 +
 
8. Repetir com usuário sem marquinha US_AUTOATEND e validar PDV normal.
 
8. Repetir com usuário sem marquinha US_AUTOATEND e validar PDV normal.
  
 
==Pesquisa na tela de Parâmetros (apoio ao suporte)==
 
==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").
 
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").

Edição das 19h53min 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.

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.

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