Radar 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. oldPricenewPrice — 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.

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 competição do Anúncio na hora da decisão. Eventos com winning / sharing_first_place tendem a segurar o preço; competing registra um ajuste para igualar o price_to_win. 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.