Soluciona problemas relacionados con la sub-API de promociones

En esta página, se describe cómo solucionar problemas relacionados con la sub-API de Promotions.

Crear una promoción

Cuando uses la solicitud accounts.promotions.insert para insertar una promoción, asegúrate de haber incluido todos los campos obligatorios en el cuerpo de la solicitud. Los siguientes campos son obligatorios:

  • 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

El período de vigencia de la promoción no es válido

Si proporcionas fechas de vigencia de la promoción no válidas en tu solicitud de accounts.promotions.insert, verás el siguiente mensaje de error:

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

Para resolver este error, asegúrate de que el valor proporcionado para el campo promotionDisplayTimePeriod.startTime sea igual o anterior al valor proporcionado para el campo promotionEffectiveTimePeriod.startTime. También asegúrate de que el valor proporcionado para el campo promotionDisplayTimePeriod.endTime sea igual o anterior al valor proporcionado para el campo promotionEffectiveTimePeriod.endTime.

Los valores de los campos startTime y endTime deben estar en el formato RFC3339 UTC, es decir, yyyy-mm-ddThh:mm:ssZ. Por ejemplo, 2024-08-15T18:20:20Z.

No se especificó la cantidad mínima de compra

Si tu attributes.couponValueType es BUY_M_GET_N_PERCENT_OFF o BUY_M_GET_N_MONEY_OFF, debes proporcionar un valor para el campo attributes.minimumPurchaseQuantity en tu solicitud de accounts.promotions.insert.

Si no proporcionas un valor para el campo attributes.minimumPurchaseQuantity en tu solicitud de accounts.promotions.insert, verás el siguiente mensaje de error:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Para resolver este error, asegúrate de proporcionar un valor para el campo minimumPurchaseQuantity en tu solicitud.

No se especificó el importe de descuento

Si el valor de tu campo attributes.couponValueType es MONEY_OFF, debes proporcionar un valor para el campo attributes.moneyOffAmount en tu solicitud de accounts.promotions.insert.

Si no proporcionas un valor para el campo attributes.moneyOffAmount en tu solicitud de accounts.promotions.insert, verás el siguiente mensaje de error:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Para resolver este error, asegúrate de proporcionar un valor para el campo attributes.moneyOffAmount en tu solicitud. El importe debe estar en micro.

No se especificó la descripción del regalo de cortesía

Si el valor de tu campo attributes.couponValueType es FREE_GIFT, debes proporcionar un valor para el campo attributes.freeGiftDescription en tu solicitud de accounts.promotions.insert.

Si no proporcionas un valor para el campo attributes.freeGiftDescription en tu solicitud de accounts.promotions.insert, verás el siguiente mensaje de error:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Para resolver este error, asegúrate de proporcionar un valor para el campo attributes.freeGiftDescription en tu solicitud.

El envío gratuito no es compatible con las promociones locales

Si el valor del campo redemptionChannel es IN_STORE y el valor del campo attributes.couponValueType es FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT o FREE_SHIPPING_TWO_DAY, verás el siguiente mensaje de error:

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

Para resolver este error, asegúrate de que el valor del campo redemptionChannel sea ONLINE.

No se especificó el canal de canje

Si no se especifica el valor del campo redemptionChannel en la solicitud accounts.promotions.insert, verás el siguiente mensaje de error:

[redemptionChannel] Required parameter: redemptionChannel

Para resolver este error, asegúrate de proporcionar un valor para el campo redemptionChannel en tu solicitud.

El campo contentLanguage de la promoción y la fuente de datos no coinciden

Si el valor del campo contentLanguage no es el mismo que el valor del campo contentLanguage de la fuente de datos de promociones que usas en tu solicitud de accounts.promotions.insert, verás el siguiente mensaje de error:

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

Para resolver este error, asegúrate de que el valor del campo contentLanguage sea el mismo que el del campo contentLanguage de la fuente de datos de promociones que estás usando.

También verás este error si el valor de targetCountry no es el mismo que el valor del campo targetCountry de la fuente de datos de promociones que estás usando.

Más información