Risolvere i problemi relativi alla sottoAPI Promozioni

Questa pagina descrive come risolvere i problemi relativi alla sotto-API Promozioni.

Crea una promozione

Quando utilizzi la richiesta accounts.promotions.insert per inserire una promozione, assicurati di aver incluso tutti i campi obbligatori in your request body. 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 tempo di validità della promozione non valido

Se fornisci date di validità della promozione non valide nella accounts.promotions.insert richiesta, visualizzerai 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. Assicurati inoltre che il valore fornito per il campo promotionDisplayTimePeriod.endTime sia uguale o precedente al valore fornito per il campo promotionEffectiveTimePeriod.endTime.

I valori dei campi startTime e endTime devono essere nel RFC3339 UTC, 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 campo attributes.minimumPurchaseQuantity nella richiesta accounts.promotions.insert.

Se non fornisci un valore per il campo attributes.minimumPurchaseQuantity nella richiesta accounts.promotions.insert, visualizzerai 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 campo minimumPurchaseQuantity 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, visualizzerai 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 campo attributes.moneyOffAmount 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, visualizzerai 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 campo attributes.freeGiftDescription nella richiesta.

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, visualizzerai 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 di conversione non specificato

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

[redemptionChannel] Required parameter: redemptionChannel

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

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

Se il valore del campo contentLanguage non è uguale al valore del campo contentLanguage dell'origine dati delle promozioni che stai utilizzando nella richiesta accounts.promotions.insert, visualizzerai 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.

Visualizzerai questo errore anche se il valore di targetCountry non è uguale al valore del campo targetCountry dell'origine dati delle promozioni che stai utilizzando.

Scopri di più