Cadeastro de regra de preco: mudanças entre as edições
De Merito Wiki
(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 |
||
| (Uma revisão intermediária pelo mesmo usuário não está sendo mostrada) | |||
| 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. | |||
[[Arquivo:Image74523.png|nenhum|miniaturadaimagem|910x910px]] | |||
Edição atual tal como às 19h11min 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).
- 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.
