Cadeastro de regra de preco
De Merito Wiki
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 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.
- 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.
- 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.
- Aba Unidades:
- Vincule a unidade (posto) onde essa regra deve rodar.
- 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,99e você quer vender a6,08, preencha6,08).
- Aba Clientes / Grupo de Clientes:
- Vincule quais clientes ou grupos de clientes específicos terão direito a este preço diferenciado.
- 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:
- 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 (
AtualizarRegraPrecoService) 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.