Устранение неполадок, связанных с Promotions sub-API

На этой странице рассказывается, как устранять неполадки, связанные с Promotions sub-API.

Рекламная акция

При использовании запроса accounts.promotions.insert для добавления промоакции убедитесь, что в теле запроса указаны все обязательные поля. Следующие поля обязательные:

  • 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

Недопустимый период действия промоакции.

Если в запросе accounts.promotions.insert указаны недействительные даты вступления в силу промоакции, вы увидите следующее сообщение об ошибке:

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

Чтобы устранить эту ошибку, убедитесь, что значение в поле promotionDisplayTimePeriod.startTime совпадает со значением в поле promotionEffectiveTimePeriod.startTime или предшествует ему. Также убедитесь, что значение в поле promotionDisplayTimePeriod.endTime совпадает со значением в поле promotionEffectiveTimePeriod.endTime или предшествует ему.

Значения полей startTime и endTime должны быть указаны в формате UTC RFC3339, то есть yyyy-mm-ddThh:mm:ssZ. например 2024-08-15T18:20:20Z.

Не указано минимальное количество товаров в заказе.

Если в поле attributes.couponValueType указано значение BUY_M_GET_N_PERCENT_OFF или BUY_M_GET_N_MONEY_OFF, то в запросе accounts.promotions.insert необходимо указать значение поля attributes.minimumPurchaseQuantity.

Если вы не укажете значение в поле attributes.minimumPurchaseQuantity в запросе accounts.promotions.insert, то увидите следующее сообщение об ошибке:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Чтобы устранить эту ошибку, укажите значение для поля minimumPurchaseQuantity в запросе.

Не указана сумма скидки.

Если значение поля attributes.couponValueType – MONEY_OFF, необходимо указать значение поля attributes.moneyOffAmount в запросе accounts.promotions.insert.

Если вы не укажете значение в поле attributes.moneyOffAmount в запросе accounts.promotions.insert, то увидите следующее сообщение об ошибке:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Чтобы устранить эту ошибку, укажите значение для поля attributes.moneyOffAmount в запросе. Сумма должна быть указана в микроединицах.

Не указано описание подарка.

Если значение поля attributes.couponValueType – FREE_GIFT, необходимо указать значение поля attributes.freeGiftDescription в запросе accounts.promotions.insert.

Если вы не укажете значение в поле attributes.freeGiftDescription в запросе accounts.promotions.insert, то увидите следующее сообщение об ошибке:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Чтобы устранить эту ошибку, укажите значение для поля attributes.freeGiftDescription в запросе.

Бесплатная доставка не поддерживается для местных промоакций

Если в поле redemptionChannel указано значение IN_STORE, а в поле attributes.couponValueType – FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT или FREE_SHIPPING_TWO_DAY, вы увидите следующее сообщение об ошибке:

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

Чтобы устранить эту ошибку, убедитесь, что в поле redemptionChannel указано значение ONLINE.

Не указан канал специального предложения

Если значение поля redemptionChannel не указано в запросе accounts.promotions.insert, вы увидите следующее сообщение об ошибке:

[redemptionChannel] Required parameter: redemptionChannel

Чтобы устранить эту ошибку, укажите значение для поля redemptionChannel в запросе.

Значения поля contentLanguage в промоакции и источнике данных не совпадают.

Если значение поля contentLanguage не совпадает со значением поля contentLanguage источника данных для промоакций, который вы используете в запросе accounts.promotions.insert, вы увидите следующее сообщение об ошибке:

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

Чтобы устранить эту ошибку, убедитесь, что значение поля contentLanguage совпадает со значением поля contentLanguage в источнике данных для промоакций, который вы используете.

Эта ошибка также возникает, если значение атрибута targetCountry не совпадает со значением поля targetCountry в источнике данных для промоакций.

Подробнее…

Назад
Overview