Soluciona problemas relacionados con la API de Merchant Promotions

En esta página, se describe cómo solucionar problemas relacionados con la API de Merchant 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 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 el mismo o anterior al valor proporcionado para el campo promotionEffectiveTimePeriod.startTime. Además, asegúrate de que el valor proporcionado para el campo promotionDisplayTimePeriod.endTime sea el mismo o anterior al valor proporcionado para el campo promotionEffectiveTimePeriod.endTime.

Los valores de los campos startTime y endTime deben estar en el formato UTC RFC3339, 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 accounts.promotions.insert.

Si no proporcionas un valor para el campo attributes.minimumPurchaseQuantity en tu solicitud 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 del descuento

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

Si no proporcionas un valor para el campo attributes.moneyOffAmount en tu solicitud 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 expresarse en micros.

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 accounts.promotions.insert.

Si no proporcionas un valor para el campo attributes.freeGiftDescription en tu solicitud 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 gratis 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 tu 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 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 valor del campo contentLanguage de la fuente de datos de promociones que usas.

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 usas.

Más información