# Artikelaktion aktualisieren

Aktualisiert die Werbeaktion.

HinweisNeue Daten ersetzen alte Daten. Auch wenn Sie nur einen Teil einer Werbeaktion aktualisieren möchten, sollten Sie alle erforderlichen Daten in der Anfrage übermitteln.

Werbeaktionen gewähren einen Rabatt (in %) auf Artikel.
Der Rabatt wird auf alle Preise der angegebenen Artikel angewendet.

Endpoint: PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
    Example: 44056

  - `promotion_id` (integer, required)
    Werbeaktions-ID. Eindeutige Werbeaktionskennung innerhalb des Projekts.
    Example: 111425

## Request fields (application/json):

  - `attribute_conditions` (array)
    Bedingungen für die Validierung von Nutzerattributen.
Steuert die Verfügbarkeit der Werbeaktion basierend darauf, ob die Nutzerattribute alle angegebenen Bedingungen erfüllen.

  - `discount` (object, required)

  - `discount.percent` (string, required)
    Prozentualer Rabatt.
Der Preis des Artikels wird um einen Wert verringert, der anhand dieses Prozentsatzes berechnet und dann auf zwei Dezimalstellen gerundet wird.
    Example: 10

  - `excluded_promotions` (array)
    Liste der IDs der Werbeaktionen, die bei der Anwendung dieser Werbeaktion ausgeschlossen werden sollen. Example: [12, 789]
    Example: [12,789]

  - `is_enabled` (boolean)
    Ob die Werbeaktion aktiviert ist oder nicht.
    Example: true

  - `items` (array, required)

  - `items.sku` (string, required)
    Artikel-SKU.

  - `limits` (object)
    Werbebeschränkungen.

  - `limits.per_user` (integer,null)
    Werbebeschränkungen für einen separaten Nutzer.

  - `limits.recurrent_schedule` (object,null)
    Aktualisierungszeitraum begrenzen.

  - `limits.recurrent_schedule.per_user` (object)
    Aktualisierungszeitraum für das Nutzerlimit.

  - `limits.recurrent_schedule.per_user.day_of_month` (integer,null)
    Tag im Monat, an dem die Limits aktualisiert werden. Hat der Monat weniger Tage als der ausgewählte Tag, erfolgt die Aktualisierung am letzten Tag des Monats. null ist bei Limitaktualisierungszeiträumen vom Typ monthly unzulässig.

  - `limits.recurrent_schedule.per_user.day_of_week` (integer,null)
    Wochentag, an dem die Limits aktualisiert werden. 1 seht für Montag, und 7 steht für Sonntag. null ist bei Limitaktualisierungszeiträumen vom Typ weekly unzulässig.

  - `limits.recurrent_schedule.per_user.displayable_reset_next_date` (string)
    Datum und Uhrzeit, zu der die Limits zurückgesetzt werden sollen (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `limits.recurrent_schedule.per_user.displayable_reset_start_date` (string)
    Datum und Uhrzeit der ersten Limitaktualisierung (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `limits.recurrent_schedule.per_user.interval_type` (string)
    Typ des wiederkehrenden Aktualisierungszeitraums.
    Enum: "daily", "weekly", "monthly"

  - `limits.recurrent_schedule.per_user.reset_next_date` (integer)
    Datum und Uhrzeit der Limitaktualisierung (Unix-Zeitstempel).
    Example: 1677553200

  - `limits.recurrent_schedule.per_user.time` (string)
    Zeitpunkt der Limitaktualisierung in der gewünschten Zeitzone (auf Stunden gerundet).
    Example: "11:00:00+03:00"

  - `name` (object, required)
    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.
    Example: {"en-US":"Promotion","ru-RU":"Акция"}

  - `price_conditions` (array,null)
    Objekt-Array mit Bedingungen für die Preisspanne, innerhalb der die Werbeaktion angewandt wird. Die Aktion wird nur auf Artikel angewandt, deren Preis alle in dem Array aufgelisteten Bedingungen erfüllt. Wenn Sie dieses Array übermitteln, müssen Sie den Wert des Objekts [items](/de/api/shop-builder/operation/create-item-promotion/#!path=items&t=request) auf null setzen.

  - `price_conditions.operator` (string, required)
    Vergleichsoperator zum Festlegen der Preisspanne für die Anwendung der Werbeaktion.
    Enum: "ge", "gt", "le", "lt", "eq", "ne"

  - `price_conditions.value` (string, required)
    Wert zur Bestimmung der Preisspanne für die Anwendung der Werbeaktion.

  - `promotion_periods` (array)
    Gültigkeitszeitraum der Werbeaktion. Wenn mehrere Zeiträume angegeben sind, sind sowohl date_from als auch date_until erforderlich.

  - `promotion_periods.date_from` (string, required)
    Startdatum für die angegebene Werbeaktion.
    Example: "2020-08-11T10:00:00+03:00"

  - `promotion_periods.date_until` (string,null)
    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.
    Example: "2020-08-11T20:00:00+03:00"

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401

## Response 404 fields (application/json):

  - `errorCode` (integer)
    Example: 9502

  - `errorMessage` (string)
    Example: "[0401-9502]: Can not find promotion with ID = 111425 in project 59080"

  - `statusCode` (integer)
    Example: 404

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Example: 1102

  - `errorMessage` (string)
    Example: "[0401-1102]:  Unprocessable Entity. The property `items` is required"

  - `statusCode` (integer)
    Example: 422

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"


## Response 204 fields