# Artikel in den Warenkorb legen

Legt Artikel in den aktuellen Warenkorb. Wenn der Warenkorb bereits einen Artikel mit derselben SKU enthält, wird der vorhandene Artikel durch den übergebenen Wert ersetzt.

Endpoint: PUT /v2/admin/project/{project_id}/cart/fill
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

## Query parameters:

  - `locale` (string)
    Antwortsprache. Sprachcode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1.

## Header parameters:

  - `x-user-for` (string)
    Die Benutzerkennung kann mithilfe des Xsolla-Login-Benutzer-JWT oder des Bezahlstation-Zugriffstokens übermittelt werden.
    Example: "ACCESS_TOKEN/LOGIN_JWT"

  - `x-user-id` (string)
    Sie können Ihre eigene Benutzer-ID verwenden, wenn Sie einen Warenkorb mit Spielen verkaufen.
    Example: "UNIQUE_ID"

## Request fields (application/json):

  - `country` (string)
    Zweistelliger Ländercode in Großbuchstaben gemäß [ISO 3166-1 Alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Weitere Informationen zu den [von Xsolla unterstützten Ländern](https://developers.xsolla.com/de/doc/shop-builder/references/supported-countries/) finden Sie in der Dokumentation.Beispiel: country=US
    Example: "US"

  - `currency` (string)
    Die im Warenkorb angezeigte Währung des Artikelpreises. Dreistelliger Code pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Detaillierte Informationen zu [Von Xsolla unterstützte Währungen](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `items` (array, required)

  - `items.quantity` (number, required)
    Artikelmenge.
    Example: 2

  - `items.sku` (string, required)
    Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "t-shirt"

## Response 200 fields (application/json):

  - `cart_id` (string)
    Warenkorb-ID. Übermitteln Sie die ID, um die Kaufseite oder Zahlungs-API-Endpunkte abzufragen.
    Example: "cart_id"

  - `is_free` (boolean)
    Ist true eingestellt, ist der Warenkorb kostenlos.

  - `items` (array)

  - `items.attributes` (array)
    Liste der Attribute und ihrer Werte, die dem Artikel zugeordnet sind. Kann für die Katalogfilterung verwendet werden.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

  - `items.attributes.external_id` (string)
    Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Name des Attributs.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Wert des Attributs.
    Example: "Strategy"

  - `items.can_be_bought` (boolean)
    Sofern true, kann der Nutzer einen Artikel kaufen.
    Example: true

  - `items.description` (string)

  - `items.groups` (array)

  - `items.groups.external_id` (string)

  - `items.groups.name` (string)

  - `items.image_url` (string)

  - `items.is_bonus` (boolean)

  - `items.is_free` (boolean)
    Ist true eingestellt, ist der Artikel kostenlos.

  - `items.limits` (object,null)
    Artikelbeschränkungen.

  - `items.limits.per_item` (object,null)
    Artikelbeschränkungen für einen Artikel.

  - `items.limits.per_item.available` (integer)
    Verbleibende Anzahl von Artikeln, die alle Nutzer kaufen können.
    Example: 3

  - `items.limits.per_item.total` (integer)
    Höchstzahl von Artikeln, die alle Nutzer kaufen können.
    Example: 5

  - `items.limits.per_user` (object,null)
    Artikelbeschränkungen für einen Nutzer.

  - `items.limits.per_user.available` (integer)
    Verbleibende Anzahl von Artikeln, die der aktuelle Nutzer kaufen kann.
    Example: 3

  - `items.limits.per_user.limit_exceeded_visibility` (string)
    Steuert die Sichtbarkeit des Artikels im Katalog nach Erreichen des Kauflimits, und zwar bis das Limit das nächste Mal zurückgesetzt wird.

Gilt für Artikel, bei denen im Array recurrent_schedule Limits konfiguriert sind, die regelmäßig zurückgesetzt werden.

Ist keine Zurücksetzung konfiguriert, wird der Artikel nach Erreichen des Kauflimits nicht im Katalog angezeigt, unabhängig vom Wert des Parameters limit_exceeded_visibility.
    Enum: "show", "hide"

  - `items.limits.per_user.recurrent_schedule` (object)
    Wiederkehrender Artikellimit-Aktualisierungszeitraums für einen Nutzer.

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

  - `items.limits.per_user.recurrent_schedule.reset_next_date` (integer)
    Datum und Uhrzeit, zu dem die Limits zurückgesetzt werden (Unix-Zeitstempel).
    Example: 1677553200

  - `items.limits.per_user.total` (integer)
    Höchstzahl von Artikeln, die ein einzelner Nutzer kaufen kann.
    Example: 5

  - `items.periods` (array,null)
    Artikelangebotszeitraum.

  - `items.periods.date_from` (string)
    Datum, an dem der angegebene Artikel zum Verkauf angeboten wird.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.periods.date_until` (string,null)
    Datum, an dem der angegebene Artikel nicht mehr zum Verkauf angeboten wird. Möglich ist: null.
    Example: "2020-08-11T20:00:00+03:00"

  - `items.price` (object,null)
    Artikelpreis.

  - `items.price.amount` (string)

  - `items.price.amount_without_discount` (string)

  - `items.price.currency` (string)

  - `items.promotions` (array)
    Auf bestimmte Artikel im Warenkorb angewandte Werbeaktionen. Das array wird in den folgenden Fällen zurückgegeben:

* Für einen bestimmten Artikel ist eine Rabattaktion konfiguriert.

* Ein Promocode mit der Einstellung Rabatt auf ausgewählte Artikel ist angewandt.

Werden keine Werbeaktionen auf Artikelebene angewandt, wird ein leeres Array zurückgegeben.

  - `items.promotions.bonus` (array)

  - `items.promotions.bonus.bundle_type` (string)
    Typ des im Bundle enthaltenen Bonusartikels. Nur verfügbar für Bonusartikel vom Typ bundle.
    Enum: "standard", "virtual_currency_package"

  - `items.promotions.bonus.image_url` (string)
    Bild-URL des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good.

  - `items.promotions.bonus.name` (string)
    Name des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good.

  - `items.promotions.bonus.quantity` (integer)

  - `items.promotions.bonus.sku` (string)

  - `items.promotions.bonus.type` (string)
    Typ des Bonusartikels.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `items.promotions.date_end` (string,null)

  - `items.promotions.date_start` (string,null)

  - `items.promotions.discount` (object,null)

  - `items.promotions.discount.percent` (string,null)

  - `items.promotions.discount.value` (string,null)

  - `items.promotions.limits` (object)

  - `items.promotions.limits.per_user` (object)

  - `items.promotions.limits.per_user.available` (integer)

  - `items.promotions.limits.per_user.total` (integer)

  - `items.type` (string)

  - `items.virtual_prices` (array)
    Virtuelle Preise.

  - `items.virtual_prices.amount` (integer)
    Rabattierter Artikelpreis in virtueller Währung.
    Example: 100

  - `items.virtual_prices.amount_without_discount` (integer)
    Artikelpreis in virtueller Währung.
    Example: 200

  - `items.virtual_prices.description` (string,null)
    Beschreibung der virtuellen Währung.
    Example: "Most popular gold"

  - `items.virtual_prices.image_url` (string,null)
    Bild der virtuellen Währung.
    Example: "http://image.png"

  - `items.virtual_prices.is_default` (boolean)
    Ob es sich bei dem Preis um einen Standardpreis für einen Artikel handelt.
    Example: true

  - `items.virtual_prices.name` (string)
    Name der virtuellen Währung.
    Example: "Gold"

  - `items.virtual_prices.sku` (string)
    Artikel-SKU der virtuellen Währung.
    Example: "gold"

  - `items.virtual_prices.type` (string)
    Art der virtuellen Währung.
    Example: "virtual_currency"

  - `items.vp_rewards` (array)
    Wertpunktartikel-Belohnung.

  - `items.vp_rewards.amount` (integer)
    Anzahl der Wertpunkte.

  - `items.vp_rewards.image_url` (string)
    Bild-URL.
    Example: "https://image.example.com"

  - `items.vp_rewards.is_clan` (boolean)
    Ob der Wertpunkt in Clan-Belohnungsketten verwendet wird.
    Example: true

  - `items.vp_rewards.item_id` (integer)
    Interne eindeutige Artikel-ID.
    Example: 1

  - `items.vp_rewards.name` (string)
    Wertpunktname.

  - `items.vp_rewards.sku` (string)
    Eindeutige ID des Wertpunkts.

  - `price` (object,null)
    Warenkorbpreis.

  - `promotions` (array)
    Auf den gesamten Warenkorb angewandte Werbeaktionen. Das Array wird in den folgenden Fällen zurückgegeben:

* Eine Werbeaktion wirkt sich auf den Warenkorb-Gesamtbetrag aus, z. B. ein Promocode mit der Einstellung Rabatt auf den Kauf.

* Im Rahmen einer Werbeaktion werden Bonusartikel in den Warenkorb gelegt.

Werden keine Werbeaktionen auf Bestellebene angewandt, wird ein leeres Array zurückgegeben.

  - `warnings` (array)

  - `warnings.errorCode` (integer)

  - `warnings.errorMessage` (string)

## 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: 5008

  - `errorMessage` (string)
    Example: "[0401-5008]: Could not find User"

  - `statusCode` (integer)
    Example: 404

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Example: 1401

  - `errorMessage` (string)
    Example: "[0401-1401]: Invalid cart"

  - `statusCode` (integer)
    Example: 422