Criar promoção como o canal
Visão geral
Estes endpoints permitem criar, no ambiente de sandbox, promoções como o canal — ou seja, impersonando o canal para possibilitar criar promoções que você, como Seller, não seria normalmente capaz de criar em produção.
Isso dá a possibilidade de testar cenários impossíveis pelas rotas comuns, por exemplo:
- Promoção subsidiada pelo canal: simular uma promoção em que o investimento vem do canal (
investment.channel), algo que o fluxo de autosserviço do seller não permite. - Desconto absoluto (De/Por) com investimento do canal, que em produção só pode ser criado pelo canal. Para conferir quais mecânicas o seller consegue criar em autosserviço, veja Tipos de Promoções Disponíveis.
Em produção, o Seller cria promoções com o seu próprio perfil. Já nestes endpoints, a requisição age em nome do canal (e não do seller), simulando a ação que o time interno do canal realizaria. Por isso eles usam a rota /samples/v1/promotions, separada das rotas de produção (/seller/v1/promotions), e exigem o channel.id específico de sandbox.
Introdução
O ambiente de sandbox para o módulo de Promoções permite simular a criação de promoções como o canal e a inclusão de SKUs em uma promoção existente, sem impactar dados reais.
Verifique, no entanto, se a sua aplicação já está configurada para acessar o ambiente de sandbox e já possui os escopos necessários para a API de Promoções. Veja a seguir quais são:
Escopos necessários
Para a utilização das APIs os seguintes escopos poderão ser necessários:
| Valor | Descrição |
|---|---|
open:promotion-promotions-seller:write | Criação de promoções como o canal |
open:promotion-skus-seller:write | Inclusão de SKUs em uma promoção criada como o canal |
Canal
Todas as chamadas devem utilizar o canal de sandbox: fc8488e0-4545-431b-a9dc-2bfa1c1ba1d5. O envio de um channel.id diferente do canal de sandbox resulta em erro 422.
Fluxo sugerido
- Criar uma promoção como o canal (
POST /samples/v1/promotions) informandochannel.idcomo o canal de sandbox. - Adicionar um SKU à promoção utilizando o
idda promoção retornado no passo anterior.