# Créer un lot

Crée un lot.

Endpoint: POST /v2/project/{project_id}/admin/items/bundle
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
    Example: 44056

## Request fields (application/json):

  - `attributes` (array)
    Liste des attributs.
Attention. La création de plus de 20 attributs pour un objet n'est pas autorisée. Toute tentative de dépassement entraîne une erreur.

  - `attributes.external_id` (string, required)
    ID unique de l'attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des tirets et des traits bas.
    Example: "attribute_1"

  - `attributes.name` (object)
    Objet contenant des versions localisées du nom de l'attribut. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"de":"Genre","en":"Genre"}

  - `attributes.values` (array, required)
    Attention. La création de plus de 6 valeurs pour un attribut n'est pas autorisée. Toute tentative de dépassement entraînera une erreur.
    Example: [{"external_id":"strategy","value":{"de":"Strategie","en":"Strategy"}},{"external_id":"action","value":{"de":"Aktion","en":"Action"}}]

  - `attributes.values.external_id` (string, required)
    ID unique de la valeur d'un attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules, des tirets et des tirets bas.
    Example: "attribute_value"

  - `attributes.values.value` (object, required)
    Objet contenant des versions localisées du nom de la valeur. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"de":"Strategie","en":"Strategy"}

  - `bundle_type` (string)
    Type de lot. Utilisez standard pour créer un lot contenant des objets et spécifiez les UGS des objet inclus.
Utilisez partner_side_content pour créer un lot vide auquel vous ajouterez des objets de votre côté via un [webhook](https://developers.xsolla.com/fr/webhooks/operation/personalized-partner-catalog/). Ce type est réservé à la [Personnalisation du catalogue côté partenaire](https://developers.xsolla.com/fr/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side).
    Enum: "standard", "partner_side_content"

  - `content` (array)
    Example: [{"quantity":1,"sku":"com.xsolla.kg_1"}]

  - `content.quantity` (integer)
    Quantité des objets sélectionnés dans le lot.
    Example: 1

  - `content.sku` (string, required)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "bundle_1"

  - `custom_attributes` (object)
    Un JSON contenant les attributs de l'objet et leurs valeurs. Les attributs permettent d'ajouter des informations supplémentaires aux objets, telles que le niveau requis du joueur pour utiliser l'objet. Les attributs enrichissent la logique interne de votre jeu et sont accessibles via des méthodes GET et des webhooks spécifiques.

  - `description` (object,null, required)
    Conteneur objet contenant les localisations de la description de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `groups` (array)
    Groupes auxquels l'objet appartient.
Note. La valeur de la chaîne correspond à l'external_id du groupe.
    Example: ["honor"]

  - `image_url` (string,null)
    URL de l'image.
    Example: "https://image.example.com"

  - `is_enabled` (boolean)
    Si ce paramètre est désactivé, l'objet ne peut pas être trouvé ni acheté.
    Example: true

  - `is_free` (boolean)
    Si ce paramètre est défini sur true, l'objet est gratuit.

  - `is_show_in_store` (boolean)
    L'objet est disponible à l'achat.
    Example: true

  - `limits` (object)
    Limites d'objets.

  - `limits.per_item` (integer,null)
    Limites globales d'objets.
    Example: 10

  - `limits.per_user` (any)
    Limites d'objets pour un utilisateur spécifique.

  - `limits.recurrent_schedule` (object,null)
    Délai d'actualisation des limites.

  - `limits.recurrent_schedule.per_user` (any)
    Réinitialisation des limites d'achat effectuée selon l'intervalle de temps spécifié, en heures.

  - `long_description` (object,null)
    Conteneur objet contenant les localisations de la description complète de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `media_list` (array,null)
    Ressources supplémentaires du lot.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `media_list.type` (string)
    Type de média : image/video.
    Enum: "image", "video"

  - `media_list.url` (string)
    Fichier de ressources.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `name` (object,null, required)
    Conteneur objet contenant les localisations du nom de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `order` (integer)
    Ordre de priorité des lots dans la liste.
    Example: 1

  - `periods` (array,null)
    Période de vente d'objets.

  - `periods.date_from` (string)
    Date de mise en vente de l'objet spécifié.
    Example: "2020-08-11T10:00:00+03:00"

  - `periods.date_until` (string,null)
    Date de retrait de la vente de l'objet spécifié. Peut prendre la valeur null.
    Example: "2020-08-11T20:00:00+03:00"

  - `prices` (array)
    Prix en devises réelles.

  - `prices.amount` (string, required)
    Prix de l'objet.
    Example: "100.99"

  - `prices.country_iso` (string,null)
    Pays où ce prix est disponible. Code à deux lettres selon la norme [ISO 3166-1 alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `prices.currency` (string, required)
    Devise du prix de l'article. Code à trois lettres selon [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `prices.is_default` (boolean, required)
    Le prix par défaut est utilisé pour constituer le catalogue si aucun prix n'est spécifié dans la devise de l'utilisateur.

  - `prices.is_enabled` (boolean, required)
    Le prix est activé.

  - `regions` (array)

  - `regions.id` (integer)
    Example: 1

  - `vc_prices` (array,null)

  - `vc_prices.amount` (integer, required)

  - `vc_prices.is_default` (boolean, required)

  - `vc_prices.is_enabled` (boolean, required)

## Response 201 fields (application/json):

  - `sku` (string)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "bundle_1"

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Example: 1102

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

  - `errorMessageExtended` (array)

  - `statusCode` (integer)
    Example: 422

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