Probleme im Zusammenhang mit der Promotions-Unter-API beheben

Auf dieser Seite wird beschrieben, wie Sie Probleme im Zusammenhang mit der Unter-API „Angebote“ beheben.

Angebot erstellen

Wenn Sie mit der accounts.promotions.insert Anfrage ein Angebot einfügen, müssen Sie alle erforderlichen Felder in Ihren Anfragetext aufnehmen. Die folgenden Felder sind erforderlich:

  • 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

Ungültiger Zeitraum für das Angebot

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage ungültige Gültigkeitsdaten für das Angebot angeben, wird die folgende Fehlermeldung angezeigt:

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

Achten Sie darauf, dass der Wert für das Feld promotionDisplayTimePeriod.startTime mit dem Wert für das Feld promotionEffectiveTimePeriod.startTime übereinstimmt oder davor liegt, um diesen Fehler zu beheben. Achten Sie außerdem darauf, dass der Wert für das Feld promotionDisplayTimePeriod.endTime mit dem Wert für das Feld promotionEffectiveTimePeriod.endTime übereinstimmt oder davor liegt.

Die Werte für die startTime und endTime Felder müssen im RFC3339 UTC-Format angegeben werden, also yyyy-mm-ddThh:mm:ssZ. Beispiel: 2024-08-15T18:20:20Z.

Mindestbestellmenge nicht angegeben

Wenn attributes.couponValueType den Wert BUY_M_GET_N_PERCENT_OFF oder BUY_M_GET_N_MONEY_OFF hat, müssen Sie in Ihrer accounts.promotions.insert-Anfrage einen Wert für das Feld attributes.minimumPurchaseQuantity angeben.

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage keinen Wert für das Feld attributes.minimumPurchaseQuantity angeben, wird die folgende Fehlermeldung angezeigt:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Geben Sie in Ihrer Anfrage einen Wert für das Feld minimumPurchaseQuantity an, um diesen Fehler zu beheben.

Rabattbetrag nicht angegeben

Wenn der Wert des Felds attributes.couponValueType MONEY_OFF ist, müssen Sie in Ihrer accounts.promotions.insert-Anfrage einen Wert für das Feld attributes.moneyOffAmount angeben.

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage keinen Wert für das Feld attributes.moneyOffAmount angeben, wird die folgende Fehlermeldung angezeigt:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Geben Sie in Ihrer Anfrage einen Wert für das Feld attributes.moneyOffAmount an, um diesen Fehler zu beheben. Der Betrag muss in Mikroeinheiten angegeben werden.

Beschreibung des Geschenks nicht angegeben

Wenn der Wert des Felds attributes.couponValueType FREE_GIFT ist, müssen Sie in Ihrer accounts.promotions.insert-Anfrage einen Wert für das Feld attributes.freeGiftDescription angeben.

Wenn Sie in Ihrer accounts.promotions.insert-Anfrage keinen Wert für das Feld attributes.freeGiftDescription angeben, wird die folgende Fehlermeldung angezeigt:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Geben Sie in Ihrer Anfrage einen Wert für das Feld attributes.freeGiftDescription an, um diesen Fehler zu beheben.

Kostenloser Versand wird für lokale Angebote nicht unterstützt

Wenn der Wert des Felds redemptionChannel IN_STORE und der Wert des Felds attributes.couponValueType FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT oder FREE_SHIPPING_TWO_DAY ist, wird die folgende Fehlermeldung angezeigt:

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

Achten Sie darauf, dass der Wert des Felds redemptionChannel ONLINE ist, um diesen Fehler zu beheben.

Einlösungs-Channel nicht angegeben

Wenn der Wert des Felds redemptionChannel in Ihrer accounts.promotions.insert-Anfrage nicht angegeben ist, wird die folgende Fehlermeldung angezeigt:

[redemptionChannel] Required parameter: redemptionChannel

Geben Sie in Ihrer Anfrage einen Wert für das Feld redemptionChannel an, um diesen Fehler zu beheben.

Das Feld contentLanguage des Angebots und der Datenquelle stimmen nicht überein

Wenn der Wert des Felds contentLanguage nicht mit dem Wert des Felds contentLanguage der Angebotsdaten quelle übereinstimmt, die Sie in Ihrer accounts.promotions.insert-Anfrage verwenden, wird die folgende Fehlermeldung angezeigt:

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

Achten Sie darauf, dass der Wert des Felds contentLanguage mit dem Wert des Felds contentLanguage der Angebotsdatenquelle übereinstimmt, die Sie verwenden, um diesen Fehler zu beheben.

Dieser Fehler wird auch angezeigt, wenn der Wert von targetCountry nicht mit dem Wert des Felds targetCountry der Angebotsdatenquelle übereinstimmt, die Sie verwenden.

Weitere Informationen