Cadeastro de regra de preco: mudanças entre as edições

De Merito Wiki
Ir para: navegação, pesquisa
(Criou página com ' === 1. Como cadastrar uma Regra de Preço Base === Objetivo: Sincronizar o preço atual praticado na bomba física do posto direto para a plataforma de pagamento (ex: TicketLog). # Cabeçalho: #* Preencha o Código e a Descrição da regra. #* Em Regra para Plataforma de Pgto, selecione a plataforma desejada (ex: ''TICKETLOG''). #* Marque a opção Ativa. #* Marque o checkbox "Preço Base". # Aba Unidades: #* Vincule a unidade (posto) onde essa regra deve rodar. # Aba...')
 
Sem resumo de edição
Linha 62: Linha 62:
|O preço diferenciado digitado na regra
|O preço diferenciado digitado na regra
|}
|}
=== buffer ===
No contexto do sistema, o buffer funciona como uma fila de espera temporária no banco de dados para o envio de preços:
# Como funciona: Quando você altera um preço ou regra, o sistema não envia o valor na mesma hora para a plataforma (TicketLog, etc.). Ele grava essa solicitação em uma tabela de controle (fila/buffer).
# O processamento: Um serviço em segundo plano (<code>AtualizarRegraPrecoService</code>) lê essa fila periodicamente, envia os preços para a plataforma e depois remove os registros do buffer.
# Se ocorrer um erro no envio (por exemplo, falha de comunicação ou cadastro inválido), o sistema não exclui o registro do buffer, ele atualiza o registro gravando a mensagem de erro (no banco) para que você consiga ver o que falhou (ex: ''"Regra não encontrada ou inativa"'', ''"Produto sem preço"'', etc.) o registro só é excluído do buffer se o envio for concluído com sucesso.

Edição das 19h10min de 19 de maio de 2026

1. Como cadastrar uma Regra de Preço Base

Objetivo: Sincronizar o preço atual praticado na bomba física do posto direto para a plataforma de pagamento (ex: TicketLog).

  1. Cabeçalho:
    • Preencha o Código e a Descrição da regra.
    • Em Regra para Plataforma de Pgto, selecione a plataforma desejada (ex: TICKETLOG).
    • Marque a opção Ativa.
    • Marque o checkbox "Preço Base".
  2. Aba Unidades:
    • Vincule a unidade (posto) onde essa regra deve rodar.
  3. Aba Produtos:
    • Adicione o combustível desejado (ex: Diesel S500).
    • No campo Valor Diferenciado (Venda R$), você pode deixar 0,00. O sistema vai ignorar esse campo e buscará automaticamente o preço de venda atual que está configurado na bomba daquela unidade.
  4. Salvar:
    • Clique em Alterar/Gravar para salvar a regra.


2. Como cadastrar uma Regra Normal (Sem Preço Base)

Objetivo: Enviar um preço diferenciado (com desconto ou acréscimo específico) para a plataforma de pagamento para determinados clientes.

  1. Cabeçalho:
    • Preencha o Código e a Descrição da regra.
    • Em Regra para Plataforma de Pgto, selecione a plataforma desejada.
    • Marque a opção Ativa.
    • Deixe o checkbox "Preço Base" DESMARCADO.
  2. Aba Unidades:
    • Vincule a unidade (posto) onde essa regra deve rodar.
  3. Aba Produtos:
    • Adicione o combustível desejado.
    • No campo Valor Diferenciado (Venda R$), insira o valor exato que você quer que a plataforma passe a cobrar (ex: se a bomba está 6,99 e você quer vender a 6,08, preencha 6,08).
  4. Aba Clientes / Grupo de Clientes:
    • Vincule quais clientes ou grupos de clientes específicos terão direito a este preço diferenciado.
  5. Salvar:
    • Clique em Alterar/Gravar para salvar a regra.

Resumo das Diferenças:

Característica Regra de Preço Base Regra Normal (Sem Preço Base)
Checkbox "Preço Base" ☑ Marcado ☐ Desmarcado
Valor Diferenciado no Produto Pode ser 0,00 (Ignorado) Deve ser o valor real da promoção/regra
Vinculação de Clientes Bloqueado (Não permite clientes) Permitido (Define quem tem direito ao preço)
O que envia à plataforma O preço atual da bomba no posto O preço diferenciado digitado na regra

buffer

No contexto do sistema, o buffer funciona como uma fila de espera temporária no banco de dados para o envio de preços:

  1. Como funciona: Quando você altera um preço ou regra, o sistema não envia o valor na mesma hora para a plataforma (TicketLog, etc.). Ele grava essa solicitação em uma tabela de controle (fila/buffer).
  2. O processamento: Um serviço em segundo plano (AtualizarRegraPrecoService) lê essa fila periodicamente, envia os preços para a plataforma e depois remove os registros do buffer.
  3. Se ocorrer um erro no envio (por exemplo, falha de comunicação ou cadastro inválido), o sistema não exclui o registro do buffer, ele atualiza o registro gravando a mensagem de erro (no banco) para que você consiga ver o que falhou (ex: "Regra não encontrada ou inativa", "Produto sem preço", etc.) o registro só é excluído do buffer se o envio for concluído com sucesso.