Resolver problemas relacionados à sub-API de promoções

Nesta página, descrevemos como solucionar problemas relacionados à sub-API Promotions.

Criar uma promoção

Ao usar a solicitação accounts.promotions.insert para inserir uma promoção, verifique se você incluiu todos os campos obrigatórios no corpo da solicitação. Os campos a seguir são obrigatórios:

  • promotion.promotionId
  • promotion.contentLanguage
  • promotion.redemptionChannel
  • promotion.targetCountry
  • promotion.attributes.longTitle
  • promotion.attributes.promotionEffectiveTimePeriod.startTime
  • promotion.attributes.promotionEffectiveTimePeriod.endTime
  • promotion.attributes.promotionDestinations
  • promotion.attributes.couponValueType
  • promotion.attributes.offerType
  • promotion.attributes.productApplicability
  • promotion.attributes.promotionUrl

Período de validade da promoção inválido

Se você fornecer datas de início e término inválidas na solicitação accounts.promotions.insert, a seguinte mensagem de erro vai aparecer:

Invalid value at 'promotion.attributes.promotion_effective_time_period.start_time'

Para resolver esse erro, verifique se o valor fornecido para o campo promotionDisplayTimePeriod.startTime é igual ou anterior ao valor fornecido para o campo promotionEffectiveTimePeriod.startTime. Além disso, verifique se o valor fornecido para o campo promotionDisplayTimePeriod.endTime é igual ou anterior ao valor fornecido para o campo promotionEffectiveTimePeriod.endTime.

Os valores dos campos startTime e endTime precisam estar no formato UTC RFC3339, ou seja, yyyy-mm-ddThh:mm:ssZ. Por exemplo, 2024-08-15T18:20:20Z.

Quantidade mínima de compra não especificada

Se o attributes.couponValueType for BUY_M_GET_N_PERCENT_OFF ou BUY_M_GET_N_MONEY_OFF, você precisará fornecer um valor para o campo attributes.minimumPurchaseQuantity na solicitação accounts.promotions.insert.

Se você não informar um valor para o campo attributes.minimumPurchaseQuantity na solicitação accounts.promotions.insert, a seguinte mensagem de erro vai aparecer:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Para resolver esse erro, verifique se você forneceu um valor para o campo minimumPurchaseQuantity na sua solicitação.

Valor do desconto não especificado

Se o valor do campo attributes.couponValueType for MONEY_OFF, você precisará fornecer um valor para o campo attributes.moneyOffAmount na solicitação accounts.promotions.insert.

Se você não informar um valor para o campo attributes.moneyOffAmount na sua solicitação accounts.promotions.insert, a seguinte mensagem de erro vai aparecer:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Para resolver esse erro, verifique se você forneceu um valor para o campo attributes.moneyOffAmount na sua solicitação. O valor precisa estar em micro.

Descrição do brinde não especificada

Se o valor do campo attributes.couponValueType for FREE_GIFT, você precisará fornecer um valor para o campo attributes.freeGiftDescription na solicitação accounts.promotions.insert.

Se você não fornecer um valor para o campo attributes.freeGiftDescription na solicitação accounts.promotions.insert, a seguinte mensagem de erro vai aparecer:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Para resolver esse erro, verifique se você forneceu um valor para o campo attributes.freeGiftDescription na sua solicitação.

Frete grátis não disponível para promoções locais

Se o valor do campo redemptionChannel for IN_STORE e o valor do campo attributes.couponValueType for FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT ou FREE_SHIPPING_TWO_DAY, a seguinte mensagem de erro vai aparecer:

[shippingServiceNames] Free shipping types are not supported for local promotions

Para resolver esse erro, verifique se o valor do campo redemptionChannel é ONLINE.

Canal de resgate não especificado

Se o valor do campo redemptionChannel não for especificado na solicitação accounts.promotions.insert, você vai receber a seguinte mensagem de erro:

[redemptionChannel] Required parameter: redemptionChannel

Para resolver esse erro, verifique se você forneceu um valor para o campo redemptionChannel na sua solicitação.

O campo contentLanguage da promoção e da fonte de dados não correspondem

Se o valor do campo contentLanguage não for o mesmo do campo contentLanguage da fonte de dados de promoções que você está usando na solicitação accounts.promotions.insert, a seguinte mensagem de erro vai aparecer:

[promotion] Could not find the proper data target for the provided feedLabel and contentLanguage

Para resolver esse erro, verifique se o valor do campo contentLanguage é igual ao valor do campo contentLanguage da fonte de dados de promoções que você está usando.

Esse erro também vai aparecer se o valor de targetCountry não for igual ao valor do campo targetCountry da fonte de dados de promoções que você está usando.

Saiba mais