Admin API · Promoções

Atualizar promoção

Substitui todos os dados da promoção pelo conteúdo enviado. Condições, descontos, regras adicionais, selos, textos de divulgação e parceiros que não estiverem no corpo são removidos (uma lista omitida vale como []). A única exceção é accumulationLinks com escopo 1 ou 2: omitido ou null, os vínculos atuais são mantidos.

Para alterar um único campo, leia a promoção, altere o campo e reenvie tudo. Grupos de condições, condições e descontos são recriados a cada atualização, então seus IDs mudam.

Permissão: Cadastro de promoções — visualização e edição.

put/api/promotions/{promotionId}

Request

  • Base URL
    https://sualoja.commerce-wake.tech
  • URL
    https://sualoja.commerce-wake.tech/api/promotions/{promotionId}
  • Auth
    HTTP bearer

Path parameters

promotionIdinteger required

ID da promoção.

Headers

x-api-version'2.0' required

Versão da API. Obrigatório: sem ele a resposta é 400 (API_VERSION_REQUIRED).

Request body

partnersinteger[] nullable

IDs de parceiros. Substitui os atuais: omitido ou [] remove a restrição.

accumulationLinksinteger[] nullable

Ids das promos citadas na lista de acúmulo, conforme GeneralInformation.AccumulationScope. O vínculo é direcional.

Response

Promoção atualizada.

messagestring nullable

Mensagem de confirmação.

successboolean

Legado: true quando a promoção foi atualizada.

Changes

No recorded changes to this operation across all 1 revision of this API.