Katalogsonderangebot aktualisieren

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056
external_id required	integer Externe ID der Werbeaktion. Eindeutige Werbeaktionskennung innerhalb des Projekts. Example: coupon_44056_1

Request Body schema: application/json

required

object

Default: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

Name der Werbeaktion. Sollte Schlüssel-Wert-Paare enthalten, wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}-[A–Z]{2}$" und der Wert ein String ist.

property name*

additional property

string

items

Array of strings

Eine Liste der Artikel-SKU, die nach Inanspruchnahme des Katalogsonderangebots verfügbar sind.

Array of objects

Gültigkeitszeitraum der Werbeaktion. Wenn mehrere Zeiträume angegeben sind, sind sowohl date_from als auch date_until erforderlich.

Array

date_from required	string <date-time> Startdatum für die angegebene Werbeaktion.
date_until	string or null <date-time> Enddatum für die angegebene Werbeaktion. Wenn `null` festgelegt ist, läuft die Werbeaktion unbefristet. Kann nur `null` sein, wenn ein einzelner Gültigkeitszeitraum angegeben ist.

redeem_code_limit

integer or null

Default: 10

Anzahl der Einlösungen pro Code.

redeem_total_limit

integer or null

Default: 10

Begrenzt die Gesamtzahl der Gutscheine.

redeem_user_limit

integer or null

Default: 10

Begrenzt, wie oft ein einzelner Nutzer Gutscheine einlösen darf.

Responses

204

Das Katalogsonderangebot wurde erfolgreich aktualisiert.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

404

Gutschein nicht gefunden. Prüfen Sie, ob die external_id korrekt ist.

422

Ungültige Anfrage.

Request samples

application/json

{"items": ["elven_sword",
"elven_boots"
],
"name": {"de-DE": "Neujahrsangebot",
"en-US": "New Year Offer"
},
"promotion_periods": [{"date_from": "2020-04-15T18:16:00+05:00",
"date_until": "2020-04-25T18:16:00+05:00"
}
],
"redeem_code_limit": 1,
"redeem_total_limit": 100,
"redeem_user_limit": 1
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}