API atual/Referência completa/Regras de preço do seller

GETExecuções do repricer

Lista o histórico das decisões do repricer automático, com o preço anterior, o novo, a concorrência e o motivo.

Cada vez que o repricer avalia uma regra, ele grava uma linha: o que decidiu, o preço antes e depois e a oferta concorrente usada na comparação. É o seu registro de auditoria: use-o para entender por que um preço mudou (ou por que não mudou) e para testar uma regra nova antes de confiar nela. As execuções aparecem logo depois de salvar a regra e sempre que o preço de uma oferta irmã (do mesmo produto-mestre) muda.

Listar execuções

GET/api/v1/vendor/repricing/executionsSeller

Lista as decisões do repricer do seller

Devolve no máximo as 200 execuções mais recentes das regras do seller, da mais nova para a mais antiga. Não há paginação.

Parâmetros de consulta

product_iduuid

Só as execuções deste produto. Sem o parâmetro, vêm as de todos os produtos.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/repricing/executions?product_id=0e6c2f44-5d1a-4c8b-8f33-2a9b7c1d5e60" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Execuções do repricer

json

{
  "items": [
    {
      "id": "5f0d9a31-8c27-4b6e-a1d4-92e7c3b0f812",
      "rule_id": "e1a4b7c2-0d3f-4e58-9a61-3c2f8b7d1a90",
      "product_id": "0e6c2f44-5d1a-4c8b-8f33-2a9b7c1d5e60",
      "old_price_cents": 9990,
      "new_price_cents": 8490,
      "competitor_product_id": "c7b1e2d9-4a60-4f33-b5c8-0d1e6a2f9b44",
      "competitor_price_cents": 8491,
      "result": "applied",
      "created_at": "2026-10-11 14:02:10.482113+00"
    }
  ]
}

Campos da resposta

itemsarray

Execuções, da mais nova para a mais antiga. Lista vazia ([]) quando não há nenhuma.

iduuid

Identificador da execução.

rule_iduuid

Regra avaliada.

product_iduuid

Produto do seller.

old_price_centsinteger

Preço do produto antes, em centavos.

new_price_centsinteger

Preço-alvo calculado, em centavos. Só vira o preço do produto quando result é applied.

competitor_product_iduuid | omitted

Oferta concorrente mais barata usada na comparação.

competitor_price_centsinteger | omitted

Preço dessa oferta, em centavos.

resultstring

appliedfloor_hitskipped_cooldownskipped_chain_limitskipped_inactiveskipped_in_promotionskipped_no_mastererror

Resultado. Veja a tabela abaixo.

created_atstring

Quando a decisão foi gravada, em texto no formato do banco de dados (2026-10-11 14:02:10.482113+00). Não é RFC 3339.

Valores de `result`

`result`	O que significa	O preço muda?
`applied`	O repricer calculou o preço-alvo e o aplicou. Se o alvo é igual ao preço atual, é um registro sem mudança.	Sim, quando `new_price_cents` difere de `old_price_cents`
`floor_hit`	Bater a concorrência exigiria ir abaixo do seu piso. `new_price_cents` mostra o piso.	Não
`skipped_cooldown`	A regra já foi avaliada há menos de 10 minutos.	Não
`skipped_chain_limit`	Já houve 5 preços aplicados na última hora entre as ofertas do mesmo produto-mestre.	Não
`skipped_inactive`	O produto está inativo ou sem estoque, ou não há concorrente disponível.	Não
`skipped_in_promotion`	Reservado para "produto em promoção ativa". Hoje essa verificação não chega a rodar; não conte com ela.	Não
`skipped_no_master`	O produto não pertence a um produto-mestre, então não há com quem comparar.	Não
`error`	Falha na avaliação, por exemplo piso por margem sem custo cadastrado.	Não

Erros

Status	Quando	Corpo de exemplo
401	Token ausente ou inválido.	`{"error":"missing authorization header"}`
403	O token não é de um usuário seller, ou ele não está ligado a um seller.	`{"error":"no vendor account associated with this user"}`
500	Falha ao ler, ou `product_id` que não é UUID.	`{"error":"failed to list executions","detail":"..."}`

Veja também

GETExecuções do repricer

Lista o histórico das decisões do repricer automático, com o preço anterior, o novo, a concorrência e o motivo.

Listar execuções

GET/api/v1/vendor/repricing/executionsSeller

Lista as decisões do repricer do seller

Devolve no máximo as 200 execuções mais recentes das regras do seller, da mais nova para a mais antiga. Não há paginação.

Parâmetros de consulta

product_iduuid

Só as execuções deste produto. Sem o parâmetro, vêm as de todos os produtos.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/repricing/executions?product_id=0e6c2f44-5d1a-4c8b-8f33-2a9b7c1d5e60" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Execuções do repricer

json

{
  "items": [
    {
      "id": "5f0d9a31-8c27-4b6e-a1d4-92e7c3b0f812",
      "rule_id": "e1a4b7c2-0d3f-4e58-9a61-3c2f8b7d1a90",
      "product_id": "0e6c2f44-5d1a-4c8b-8f33-2a9b7c1d5e60",
      "old_price_cents": 9990,
      "new_price_cents": 8490,
      "competitor_product_id": "c7b1e2d9-4a60-4f33-b5c8-0d1e6a2f9b44",
      "competitor_price_cents": 8491,
      "result": "applied",
      "created_at": "2026-10-11 14:02:10.482113+00"
    }
  ]
}

Campos da resposta

itemsarray

Execuções, da mais nova para a mais antiga. Lista vazia ([]) quando não há nenhuma.

iduuid

Identificador da execução.

rule_iduuid

Regra avaliada.

product_iduuid

Produto do seller.

old_price_centsinteger

Preço do produto antes, em centavos.

new_price_centsinteger

Preço-alvo calculado, em centavos. Só vira o preço do produto quando result é applied.

competitor_product_iduuid | omitted

Oferta concorrente mais barata usada na comparação.

competitor_price_centsinteger | omitted

Preço dessa oferta, em centavos.

resultstring

appliedfloor_hitskipped_cooldownskipped_chain_limitskipped_inactiveskipped_in_promotionskipped_no_mastererror

Resultado. Veja a tabela abaixo.

created_atstring

Quando a decisão foi gravada, em texto no formato do banco de dados (2026-10-11 14:02:10.482113+00). Não é RFC 3339.

Valores de `result`

`result`	O que significa	O preço muda?
`applied`	O repricer calculou o preço-alvo e o aplicou. Se o alvo é igual ao preço atual, é um registro sem mudança.	Sim, quando `new_price_cents` difere de `old_price_cents`
`floor_hit`	Bater a concorrência exigiria ir abaixo do seu piso. `new_price_cents` mostra o piso.	Não
`skipped_cooldown`	A regra já foi avaliada há menos de 10 minutos.	Não
`skipped_chain_limit`	Já houve 5 preços aplicados na última hora entre as ofertas do mesmo produto-mestre.	Não
`skipped_inactive`	O produto está inativo ou sem estoque, ou não há concorrente disponível.	Não
`skipped_in_promotion`	Reservado para "produto em promoção ativa". Hoje essa verificação não chega a rodar; não conte com ela.	Não
`skipped_no_master`	O produto não pertence a um produto-mestre, então não há com quem comparar.	Não
`error`	Falha na avaliação, por exemplo piso por margem sem custo cadastrado.	Não

Erros

Status	Quando	Corpo de exemplo
401	Token ausente ou inválido.	`{"error":"missing authorization header"}`
403	O token não é de um usuário seller, ou ele não está ligado a um seller.	`{"error":"no vendor account associated with this user"}`
500	Falha ao ler, ou `product_id` que não é UUID.	`{"error":"failed to list executions","detail":"..."}`