Risolvere i problemi relativi alla sottoAPI Promozioni

Questa pagina descrive come risolvere i problemi relativi alla sottoAPI Promozioni.

Crea una promozione

Quando utilizzi la richiesta accounts.promotions.insert per inserire una promozione, assicurati di aver incluso tutti i campi obbligatori nel corpo della richiesta. I seguenti campi sono obbligatori:

  • 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

Periodo di validità della promozione non valido

Se fornisci date di inizio non valide della promozione nella richiesta accounts.promotions.insert, viene visualizzato il seguente messaggio di errore:

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

Per risolvere questo errore, assicurati che il valore fornito per il campo promotionDisplayTimePeriod.startTime sia uguale o precedente al valore fornito per il campo promotionEffectiveTimePeriod.startTime. Inoltre, assicurati che il valore fornito per il campo promotionDisplayTimePeriod.endTime sia uguale o precedente a quello fornito per il campo promotionEffectiveTimePeriod.endTime.

I valori per i campi startTime e endTime devono essere nel formato UTC RFC3339, ovvero yyyy-mm-ddThh:mm:ssZ. Ad esempio, 2024-08-15T18:20:20Z.

Quantità minima di acquisto non specificata

Se attributes.couponValueType è BUY_M_GET_N_PERCENT_OFF o BUY_M_GET_N_MONEY_OFF, devi fornire un valore per il attributes.minimumPurchaseQuantity campo nella richiesta accounts.promotions.insert.

Se non fornisci un valore per il campo attributes.minimumPurchaseQuantity nella richiesta accounts.promotions.insert, viene visualizzato il seguente messaggio di errore:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Per risolvere questo errore, assicurati di fornire un valore per il minimumPurchaseQuantity campo nella richiesta.

Importo dello sconto non specificato

Se il valore del campo attributes.couponValueType è MONEY_OFF, devi fornire un valore per il campo attributes.moneyOffAmount nella richiesta accounts.promotions.insert.

Se non fornisci un valore per il campo attributes.moneyOffAmount nella richiesta accounts.promotions.insert, viene visualizzato il seguente messaggio di errore:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Per risolvere questo errore, assicurati di fornire un valore per il attributes.moneyOffAmount campo nella richiesta. L'importo deve essere in micro.

Descrizione del regalo non specificata

Se il valore del campo attributes.couponValueType è FREE_GIFT, devi fornire un valore per il campo attributes.freeGiftDescription nella richiesta accounts.promotions.insert.

Se non fornisci un valore per il campo attributes.freeGiftDescription nella richiesta accounts.promotions.insert, viene visualizzato il seguente messaggio di errore:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Per risolvere questo errore, assicurati di fornire un valore per il attributes.freeGiftDescription campo nella richiesta.

La spedizione gratuita non è supportata per le promozioni locali

Se il valore del campo redemptionChannel è IN_STORE e il valore del campo attributes.couponValueType è FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT o FREE_SHIPPING_TWO_DAY, viene visualizzato il seguente messaggio di errore:

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

Per risolvere questo errore, assicurati che il valore del campo redemptionChannel sia ONLINE.

Canale promozionale non specificato

Se il valore del campo redemptionChannel non è specificato nella richiesta accounts.promotions.insert, viene visualizzato il seguente messaggio di errore:

[redemptionChannel] Required parameter: redemptionChannel

Per risolvere questo errore, assicurati di fornire un valore per il redemptionChannel campo nella richiesta.

Il campo contentLanguage della promozione e dell'origine dati non corrispondono

Se il valore del campo contentLanguage non corrisponde al valore del contentLanguage campo dell'origine dati delle promozioni che utilizzi nella richiesta accounts.promotions.insert, verrà visualizzato il seguente messaggio di errore:

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

Per risolvere questo errore, assicurati che il valore del campo contentLanguage sia uguale al valore del campo contentLanguage dell'origine dati delle promozioni che stai utilizzando.

Questo errore viene visualizzato anche se il valore di targetCountry non corrisponde al valore del campo targetCountry dell'origine dati delle promozioni in uso.

Scopri di più