Produtos e Ofertas
Gerenciar Oferta
Edita uma oferta (inclusive reescreve a régua de preços), arquiva e restaura. Reescrever a régua nunca reprecifica quem já assina.
PUT
Depois de criada, a oferta é gerenciada por
id. Você edita o nome, o valor (única) ou a régua inteira (recorrente), e liga/desliga a oferta com arquivar/restaurar.
O
id (uuid) da oferta.Editar
PUT /v1/product-offers/{id}
Novo nome. Máximo: 80 caracteres.
Novo valor em centavos (ofertas
one_time). Mínimo 100.Nova cadência (ofertas
recurring): monthly, quarterly, half-yearly, yearly.Dias de teste (
1 a 365).A régua nova, inteira (ofertas
recurring). Segue as mesmas regras da criação: começa no ciclo 1, contígua, só a última aberta.Reescrever a régua é seguro: a régua congela na assinatura de cada cliente no momento em que ele assinou. Editar a oferta muda apenas quem assinar dali para frente. Ninguém é reprecificado.
Arquivar e restaurar
Arquivar desliga a oferta: ocheckout_url dela para de aceitar novas compras, mas as ofertas irmãs do produto seguem vivas, e quem já assinou não é afetado.
Resposta
As três rotas devolvem a oferta atualizada, no mesmo formato de Criar Oferta (comcycles e checkout_url).
Posse por construção: uma oferta de outro lojista não resolve (devolve
404), mesmo com um id válido.