docs

Atividade

O histórico completo do Repricer — toda decisão de preço, registrada e explicável.

Disponível emAmazonMercado Livre

A Atividade é a linha do tempo do Repricer: cada evento relevante de uma Oferta/Anúncio fica registrado, para que você possa entender exatamente o que aconteceu e por quê.

Eventos registrados

Cada Atividade (evento) cai em uma destas categorias:

  • Mudança de preço — o Repricer ajustou o preço de uma listagem.
  • Atualização de configuração — uma Automação, Estratégia ou limite (Preço Mínimo/Máximo) foi alterado.
  • Sincronização (sync) — dados da listagem ou da concorrência foram sincronizados com o marketplace.
  • Erro — algo impediu uma ação (incluindo o marcador de Modo Seguro, descrito abaixo).

O que o PriceChangeHistory registra

Cada mudança de preço é gravada em PriceChangeHistory, com os campos:

  • oldPrice — o preço antes do ajuste.
  • newPrice — o preço depois do ajuste.
  • reason — o motivo da decisão (qual regra da Estratégia foi aplicada).
  • trigger — o que disparou a reprecificação (uma mudança na concorrência, uma sincronização, uma ação agendada ou manual).

Como interpretar por que um preço mudou

Para entender uma mudança, leia o evento de trás para frente:

  1. trigger — o que provocou a reavaliação (ex.: um concorrente mudou de preço).
  2. reason — qual regra respondeu (a Ação de Preço aplicada, ou a regra de manutenção quando você já vencia).
  3. oldPrice → newPrice — o resultado, já travado pelos limites de Preço Mínimo e Máximo.

Se um preço parou exatamente no piso ou no teto, foi o clamp dos limites agindo — não a Ação de Preço crua.

Última Decisão do Repricer

Além do histórico de mudanças, o Repricer persiste a última decisão de cada Oferta — inclusive quando decidiu não alterar o preço. Clique no card Preço Atual no detalhe da Oferta para abrir o drawer de última decisão, que mostra:

  • O resultado — se o Repricer reprificou, segurou o preço, cedeu o passo (ex.: Automação de Preços do ML ativa) ou encontrou um erro.
  • O motivo — a explicação em linguagem clara do porquê. Para decisões tomadas pelo Scout AI, a explicação é escrita pelo próprio agente e exibida sem modificação.
  • O momento — o timestamp da última decisão.

Isso complementa a linha do tempo da Atividade: o histórico mostra toda mudança de preço efetiva; o drawer de Última Decisão mostra a palavra final do Repricer, mesmo quando o preço ficou igual.

Mudanças em Modo Seguro

As decisões tomadas em Modo Seguro também aparecem na Atividade, mas são marcadas com errorStatus: "safe_mode". Elas mostram o preço que teria sido publicado, sem que o preço real tenha mudado. Use essa marcação para separar simulações de reprecificações reais ao revisar o histórico.

Mercado Livre

No Mercado Livre, a Atividade também reflete o status de catálogo do Anúncio na hora da decisão. O comportamento registrado depende da estratégia escolhida: eventos com winning / sharing_first_place podem segurar o preço (estratégias Preço para Vencer e Preço Sugerido) ou registrar uma subida ao próximo concorrente no placar (estratégia Concorrente); competing registra um ajuste em direção ao preço vencedor ou ao preço bruto do ganhador. Anúncios onde a Automação de Preços do ML (nativa) está ativa registram que o Repricer cedeu o passo, em vez de uma mudança de preço.