Automações

Uma automação é uma regra que o Tromso ERP aplica sozinho quando algo muda no cadastro. Nesta versão do módulo, a regra cobre o caso do preço de varejo automático: sempre que o preço principal (preço de venda) de um produto é definido ou alterado, o sistema recalcula um preço adicional escolhido — por exemplo, Varejo — multiplicando o preço principal por um fator e arredondando em duas casas decimais.

A tela Automações, em Configurações, é onde você cria, ativa, desativa e acompanha essas regras. Cada execução fica registrada no log de execuções, com status Sucesso, Erro ou Ignorada, para você conferir o que o motor fez (ou por que não fez).

Para que serve

O preço principal do produto é o valor-base da tabela do sistema e o ponto de partida de várias rotinas de venda. Em muitas empresas, o preço de varejo (ou outro preço paralelo) precisa acompanhar esse valor-base com uma margem fixa — por exemplo, 1,2 para +20%, 1,4 para +40%. Fazer isso à mão em cada alteração é frágil: um ajuste em lote, uma importação por Excel ou a restauração de uma versão antiga da tabela facilmente deixa o preço adicional defasado.

A automação fecha esse ciclo. Você configura uma vez:

1. Quando o preço principal de um produto é definido ou alterado.
2. Para quais produtos (por grupos, ou para todos).
3. Qual preço adicional recalcular e por qual fator.

A partir daí, qualquer caminho que grava o preço principal — edição do produto, ajuste na tabela de preços do sistema, ajuste em lote, importação por Excel, restauração de versão ou auto-cadastro a partir de uma nota recebida — dispara a regra e atualiza o preço adicional. O motor grava o resultado no log.

Os preços adicionais em si (os rótulos Varejo, À vista, Por pacote…) são cadastrados na seção Preços adicionais da empresa. Sem pelo menos um preço adicional configurado, a automação não tem alvo para escrever.

Como acessar

No menu lateral, abra Configurações › Automações. Se o item não aparecer, seu perfil de acesso ainda não tem a permissão Automações — peça ao administrador para liberar ao menos Visualizar no módulo. Perfis customizados não recebem o módulo novo automaticamente (privilégio mínimo): o administrador concede em Perfis de acesso quando for o caso.

A lista de automações

Ao abrir a tela, você vê as automações já cadastradas. Por padrão, a tabela mostra:

• Descrição da automação — o nome que você deu à regra (é o que identifica a automação na lista e no log).
• Resumo — uma frase legível montada a partir da configuração: para quais grupos a regra vale, e por qual fator o preço adicional é multiplicado. Ex.: Quando o preço principal de um produto de 3 grupos selecionados for definido ou alterado, atualizar o preço adicional multiplicando por 1,2 (+20%).
• Ativa — checkbox que liga ou desliga a automação na hora, sem abrir o formulário. Desativada, a regra não roda mesmo que o preço principal mude.
• Última execução — data e hora da execução mais recente daquela automação. Enquanto não houver nenhuma, a coluna fica em travessão.

Pelo controle de colunas você também exibe Criado em e Atualizado em. A barra de ferramentas segue o padrão de todas as listas do sistema — busca rápida, filtros avançados em chips, controle de colunas e paginação. Se ainda não conhece esse padrão, leia Trabalhando com listas.

Buscar, filtrar e ordenar

• Busca rápida — digite parte da Descrição da automação.
• Filtros avançados — refine por Descrição da automação, por Ativa, por Criado em e por Atualizado em.
• Ordenação — clique no título de uma coluna para ordenar por ela (descrição, situação ativa, datas).

Menu de ações da linha

No início de cada linha, o menu de ações oferece:

• Editar — abre o formulário da automação (exige permissão de editar).
• Ver execuções — abre o log de execuções daquela automação.
• Excluir — remove a automação após confirmação (exige permissão de excluir). O histórico de execuções deixa de ficar acessível pela tela.

O checkbox Ativa na própria linha alterna a situação sem passar pelo formulário. Quem não tem permissão de editar vê o controle desabilitado.

Cadastrar uma automação

Clique em Nova automação, no canto superior direito. O formulário se divide em quatro seções — Identificação, Gatilho, Condições e Ações. Na criação, todas vêm abertas.

Identificação

• Descrição da automação (obrigatório) — o nome da regra, com até 255 caracteres. Escolha algo que diga o que a automação faz, não só o módulo onde vive. Ex.: Atualizar preço de varejo (+20%) ou Varejo Zeus 1,4.
• Ativa (obrigatório) — Sim ou Não. Automação nasce ativa por padrão. Enquanto estiver Não, o motor ignora a regra por completo.
• Observações (opcional) — texto livre de apoio, com até 500 caracteres. Serve para anotar a origem da regra, a política comercial que ela reflete ou qualquer detalhe útil para quem for manter a automação depois.

Gatilho

O gatilho desta versão é único e fixo — não há seletor:

Quando o preço principal (preço de venda) de um produto for definido ou alterado.

Isso cobre qualquer caminho que grava o preço principal de verdade:

• edição do cadastro do produto;
• gravação de preço na tabela do sistema (incluindo o ajuste em lote e a importação por Excel nessa tabela);
• restauração de uma versão da tabela do sistema;
• auto-cadastro de produto a partir de uma nota recebida.

Regravar o mesmo valor de preço principal não dispara a automação — só definição ou alteração real. Produto sem preço principal definido registra a execução como Ignorada (veja Log de execuções).

Condições

• Grupos de produto — multisseletor com busca. Escolha um ou mais grupos para restringir a automação. O texto do campo vazio é Todos os grupos: sem nenhum grupo selecionado, a regra vale para produtos de qualquer grupo.

Grupo criado depois não entra sozinho

Quando a automação tem grupos selecionados, um grupo criado depois da configuração não é coberto automaticamente. Se a política comercial também vale para esse grupo novo, edite a automação e inclua-o na condição.

Ações

A ação desta versão também é única:

• Preço adicional (obrigatório) — o rótulo alvo da atualização (ex.: Varejo). A lista vem dos preços adicionais da empresa. Sem nenhum cadastrado, o seletor fica vazio e a automação não tem o que escrever.
• Fator multiplicador (obrigatório) — número maior que zero. O preço adicional vira preço principal × fator, arredondado em duas casas decimais. Exemplos:
  • fator 1,2 → +20% sobre o preço principal;
  • fator 1,4 → +40%;
  • fator 1,0 → o preço adicional fica igual ao principal (sem alteração percentual);
  • fator 0,9 → −10%.

O resumo da lista traduz o fator em percentual para leitura rápida (+20%, −10% ou sem alteração).

O que acontece ao salvar

Ao salvar, a automação passa a valer nas próximas mudanças de preço principal que casarem com a condição. Ela não recalcula, sozinha, o catálogo inteiro no momento da criação — o motor reage a eventos futuros. Se você precisa alinhar preços já existentes, altere o preço principal (ou rode um ajuste/importação na tabela do sistema) nos produtos cobertos; cada alteração real dispara a regra.

Editar e ativar ou desativar

Editar reabre o mesmo formulário da criação. As quatro seções continuam disponíveis; o gatilho permanece fixo. Alterar o fator, o preço adicional ou os grupos muda a regra viva a partir daquele momento — inclusive para restaurações de versão futuras da tabela de preços (veja Semântica importante).

Para ligar ou desligar sem editar o resto, use o checkbox Ativa na linha da lista. Desativar é o freio de emergência: a regra para de rodar na hora e volta a rodar quando você reativar.

Excluir

Excluir pede confirmação e mostra a descrição e a situação (Ativa / Inativa) da automação. Ao confirmar, a automação some da lista e o histórico de execuções deixa de ficar acessível por esta tela. Não há “lixeira” na interface: se a intenção é só pausar a regra, prefira desativá-la.

Log de execuções

No menu de ações da linha, Ver execuções abre o log daquela automação — somente leitura, com as execuções mais recentes primeiro. Cada card mostra:

• o status como etiqueta — Sucesso, Erro ou Ignorada;
• a data e hora da execução;
• os detalhes relevantes:
  • Preço de venda — o preço principal que disparou a regra;
  • Preço adicional — valor anterior → valor novo;
  • Fator — o fator aplicado;
  • Motivo — quando a execução foi Ignorada (ex.: Produto sem preço principal definido);
  • Erro — mensagem quando a execução falhou.

O que cada status significa

Status	Significado
Sucesso	A ação rodou e o preço adicional foi atualizado.
Erro	A ação falhou ao avaliar ou aplicar. O detalhe traz a mensagem.
Ignorada	A ação não se aplicava naquele caso (ex.: produto sem preço principal). O valor do preço adicional não é alterado — permanece como estava.

O log é a prova do que o motor fez. Use-o depois de um ajuste em lote, de uma importação ou de uma restauração de versão para confirmar que o varejo (ou outro preço adicional) acompanhou o preço principal nos produtos esperados.

Semântica importante para o operador

Estes pontos evitam a maior parte das surpresas no dia a dia:

• Preço adicional gerenciado pela automação. Nos produtos cobertos pela condição, o valor daquele preço adicional passa a ser derivado pela regra. Se alguém editar o valor manualmente na grade de preços, a próxima mudança do preço principal sobrescreve essa edição com o cálculo preço principal × fator.
• Restaurar versão re-deriva pela regra atual. Ao reverter uma versão da tabela de preços do sistema, o motor não “volta no tempo” o preço adicional para o valor histórico: ele recalcula com a automação que está valendo agora. A automação é a regra viva.
• Grupo novo não entra sozinho. Automação com grupos selecionados só cobre esses grupos. Grupo criado depois exige edição da automação para ser incluído.
• Sem grupos = todos os produtos. Condição vazia casa qualquer produto (com ou sem grupo). Use isso de propósito, não por omissão acidental.
• Produto sem preço principal. A execução é registrada como Ignorada, com motivo, e o preço adicional permanece intocado.
• Regravar o mesmo preço não dispara. Só definição ou alteração real do valor. Isso evita ruído no log quando uma rotina reescreve o mesmo número.
• Várias automações no mesmo alvo. Se mais de uma automação ativa escrever no mesmo preço adicional do mesmo produto, a ordem de execução decide e a última escrita vence. Prefira condições de grupo disjuntas para o mesmo rótulo.

Permissões

O módulo Automações vive sob Configurações e controla, separadamente, as ações de Visualizar, Criar, Editar e Excluir. Quem não tem ao menos Visualizar nem vê o item no menu.

Perfis customizados não herdam o módulo automaticamente quando ele nasce no sistema — é o desenho de privilégio mínimo. Depois de liberar o módulo em Perfis de acesso, os usuários daquele perfil passam a ver a tela. O quadro geral de como o menu reage a permissão está em Navegação, menu e permissões.

Dúvidas frequentes

Não encontro Automações no menu de Configurações.

A tela exige a permissão do módulo Automações. Perfis customizados não recebem módulos novos sozinhos: o administrador precisa marcar ao menos Visualizar em Configurações › Perfis de acesso. Depois disso, o item aparece no menu de quem tem o perfil.

O seletor de Preço adicional está vazio. O que falta?

Os alvos da ação vêm dos preços adicionais cadastrados na empresa (seção Preços adicionais). Cadastre ao menos um rótulo — por exemplo, Varejo — e ele passa a aparecer no seletor da automação e como coluna na tabela de preços.

Alterei o preço principal e o varejo não mudou.

Confira, nesta ordem: (1) a automação está Ativa? (2) o produto pertence a um dos grupos da condição — ou a condição está vazia (todos os grupos)? (3) o Preço adicional da ação é o rótulo que você está olhando na grade? (4) o preço principal mudou de verdade, ou foi regravado o mesmo valor? (5) o produto tem preço principal definido? Se a execução foi Ignorada ou nem existe, o log de execuções mostra o motivo.

Editei o preço de varejo na grade e ele voltou sozinho. Por quê?

Porque a automação gerencia aquele preço adicional nos produtos cobertos. A edição manual vale até a próxima mudança do preço principal; aí o motor recalcula preço principal × fator e sobrescreve. Se a política comercial mudou, edite a automação (fator ou condição), não o valor solto na grade.

Restaurei uma versão antiga da tabela e o varejo não voltou ao valor da época.

Isso é o comportamento esperado. A restauração regrava o preço principal e o motor re-deriva o preço adicional com a regra atual da automação — não com o valor histórico daquela versão. A automação é a regra viva. Se a política da época era outra, ajuste o fator da automação antes (ou depois) de restaurar.

Criei um grupo novo e os produtos dele não entram na automação.

Quando a automação tem grupos selecionados, a lista é fixa. Grupo criado depois não é incluído sozinho. Edite a automação, acrescente o grupo em Condições e salve. Se a intenção era cobrir o catálogo inteiro, deixe Grupos de produto vazio (Todos os grupos).

A automação recalcula o catálogo inteiro ao salvar?

Não. Salvar a automação apenas passa a valer para as próximas mudanças de preço principal. Para alinhar preços já existentes, provoque uma alteração real do preço principal nos produtos cobertos (edição, ajuste em lote ou importação na tabela do sistema) — cada alteração dispara a regra e aparece no log.

Qual a diferença entre desativar e excluir uma automação?

Desativar (checkbox Ativa desmarcado, ou Ativa = Não no formulário) mantém a regra cadastrada e apenas impede que ela rode — reativar devolve o comportamento na hora. Excluir remove a automação da lista e o histórico de execuções deixa de ficar acessível por esta tela. Se a dúvida é só “pausar a regra”, desative.

Regravei o mesmo preço principal e nada apareceu no log. Está quebrado?

Não. Regravar o mesmo valor não é alteração — o motor só emite o evento quando o preço principal muda de verdade. Isso evita encher o log com ruído de rotinas que reescrevem o número idêntico.