Pular para o conteúdo principal

Consultar promoções elegíveis

GET 
/seller/v1/promotions

Retorna uma lista paginada de promoções elegíveis para o seller.

Escopo da Operação​

Este endpoint permite consultar todas as promoções nas quais o seller pode participar ou já está inscrito, facilitando o acompanhamento de campanhas ativas e futuras.

Regras de Negócio Comerciais​

  • A elegibilidade das promoções é determinada com base na categoria de produtos do seller e no acordo comercial vigente.
  • Apenas promoções ativas ou planejadas são retornadas para consulta.

Filtros Temporais e Default de subscription_deadline​

ATENÇÃO: DEFAULT DE PRAZO DE ADESÃO

Quando nenhum filtro temporal é informado, a API aplica automaticamente a janela de subscription_deadline de hoje até 30 dias — ou seja, retorna apenas promoções nas quais o seller ainda pode se inscrever.

Para desativar esse default, informe um par gte/lte completo de qualquer campo temporal (ex.: subscription_deadline__gte + subscription_deadline__lte, ou start_at__gte + start_at__lte). Lembre-se de que filtros temporais devem ser informados em pares gte/lte do mesmo campo; um lado solto retorna 400 Bad Request.

Request​

Responses​

Sucesso