# Llenar la cesta con artículos por el ID de la cesta

Rellena la cesta con artículos por ID de la cesta. Si la cesta ya tiene un artículo con el mismo SKU, el artículo existente se sustituirá por el valor transmitido.

Endpoint: PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
    Example: 44056

  - `cart_id` (string, required)
    ID de la cesta.
    Example: "custom_id"

## Query parameters:

  - `locale` (string)
    Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1.

## Header parameters:

  - `x-user-for` (string)
    El identificador de usuario puede transferirse utilizando el JWT de usuario de Xsolla Login o el token de acceso a Pay Station.
    Example: "ACCESS_TOKEN/LOGIN_JWT"

  - `x-user-id` (string)
    Puede utilizar su propio ID de usuario para vender una cesta con juegos.
    Example: "UNIQUE_ID"

## Request fields (application/json):

  - `country` (string)
    Código de país de dos letras mayúsculas de conformidad con la norma [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Consulte la documentación para obtener información detallada sobre los [países admitidos por Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/). Ejemplo: country=US
    Example: "US"

  - `currency` (string)
    La moneda del precio del artículo que aparece en la cesta. Código de tres letras según [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consulte la documentación para obtener información detallada sobre [monedas soportadas por Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `items` (array, required)

  - `items.quantity` (number, required)
    Cantidad del artículo.
    Example: 2

  - `items.sku` (string, required)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "t-shirt"

## Response 200 fields (application/json):

  - `cart_id` (string)
    ID de cesta. Transmítalo a la consulta de la página de compra o a los puntos finales de la API de pago.
    Example: "cart_id"

  - `is_free` (boolean)
    Si true, la cesta es gratuita.

  - `items` (array)

  - `items.attributes` (array)
    Lista de atributos y sus valores correspondientes al artículo. Puede utilizarse para filtrar el catálogo.
    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)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Nombre del atributo.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Valor del atributo.
    Example: "Strategy"

  - `items.can_be_bought` (boolean)
    Si es true, el usuario puede comprar un artículo.
    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)
    Si es true, el artículo es gratuito.

  - `items.limits` (object,null)
    Límites del artículo.

  - `items.limits.per_item` (object,null)
    Límites de artículos para un artículo.

  - `items.limits.per_item.available` (integer)
    Número restante de artículos que todos los usuarios pueden comprar.
    Example: 3

  - `items.limits.per_item.total` (integer)
    Número máximo de artículos que pueden comprar todos los usuarios.
    Example: 5

  - `items.limits.per_user` (object,null)
    Límites de artículos para un usuario.

  - `items.limits.per_user.available` (integer)
    Número restante de artículos que el usuario actual puede comprar.
    Example: 3

  - `items.limits.per_user.limit_exceeded_visibility` (string)
    Determina la visibilidad del artículo en el catálogo tras alcanzar el límite de compra, hasta el siguiente restablecimiento del límite.

Se aplica a los artículos para los que se han configurado restablecimientos periódicos del límite en la matriz recurrent_schedule.

Si no se han configurado restablecimientos de límite, el artículo no aparecerá en el catálogo una vez alcanzado el límite de compra, independientemente del valor de limit_exceeded_visibility.
    Enum: "show", "hide"

  - `items.limits.per_user.recurrent_schedule` (object)
    Periodo de actualización recurrente de los límites del artículo para un usuario.

  - `items.limits.per_user.recurrent_schedule.interval_type` (string)
    Tipo de periodo de actualización recurrente.
    Enum: "daily", "weekly", "monthly", "hourly"

  - `items.limits.per_user.recurrent_schedule.reset_next_date` (integer)
    Fecha y hora en que se restablecen los límites (Marca de tiempo Unix).
    Example: 1677553200

  - `items.limits.per_user.total` (integer)
    Número máximo de artículos que un mismo usuario puede comprar.
    Example: 5

  - `items.periods` (array,null)
    Periodo de venta del artículo.

  - `items.periods.date_from` (string)
    Fecha en la que el artículo especificado estará disponible para la venta.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.periods.date_until` (string,null)
    Fecha en la que el artículo especificado dejará de estar disponible para la venta. Puede ser null.
    Example: "2020-08-11T20:00:00+03:00"

  - `items.price` (object,null)
    Precio del artículo.

  - `items.price.amount` (string)

  - `items.price.amount_without_discount` (string)

  - `items.price.currency` (string)

  - `items.promotions` (array)
    Promociones aplicadas para artículos específicos de la cesta. La matriz se devuelve en los siguientes casos:

* Se configura un descuento promocional para un artículo específico.

* Se aplica un código promocional con el parámetro Descuento en artículos seleccionados.

Si no se aplican promociones a nivel de artículo, se devuelve una matriz vacía.

  - `items.promotions.bonus` (array)

  - `items.promotions.bonus.bundle_type` (string)
    Tipo de artículo del lote de bonificación. Disponible solo para el tipo de artículo de bonificación bundle.
    Enum: "standard", "virtual_currency_package"

  - `items.promotions.bonus.image_url` (string)
    URL de la imagen del artículo de bonificación. No disponible para el tipo de artículo de bonificación physical_good.

  - `items.promotions.bonus.name` (string)
    Nombre del artículo de bonificación. No disponible para el tipo de artículo de bonificación physical_good.

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

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

  - `items.promotions.bonus.type` (string)
    Tipo de artículo de bonificación.
    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)
    Precios virtuales.

  - `items.virtual_prices.amount` (integer)
    Precio del artículo en moneda virtual con un descuento.
    Example: 100

  - `items.virtual_prices.amount_without_discount` (integer)
    Precio del artículo en moneda virtual.
    Example: 200

  - `items.virtual_prices.description` (string,null)
    Descripción de la moneda virtual.
    Example: "Most popular gold"

  - `items.virtual_prices.image_url` (string,null)
    Imagen de la moneda virtual.
    Example: "http://image.png"

  - `items.virtual_prices.is_default` (boolean)
    Si el precio está predeterminado para un artículo.
    Example: true

  - `items.virtual_prices.name` (string)
    Nombre de la moneda virtual.
    Example: "Gold"

  - `items.virtual_prices.sku` (string)
    SKU del artículo de la moneda virtual.
    Example: "gold"

  - `items.virtual_prices.type` (string)
    Tipo de moneda virtual.
    Example: "virtual_currency"

  - `items.vp_rewards` (array)
    Recompensa de artículo del punto de valor.

  - `items.vp_rewards.amount` (integer)
    Cantidad de puntos de valor.

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

  - `items.vp_rewards.is_clan` (boolean)
    Si el punto de valor se utiliza en las cadenas de recompensas de clanes.
    Example: true

  - `items.vp_rewards.item_id` (integer)
    ID único interno del artículo.
    Example: 1

  - `items.vp_rewards.name` (string)
    Nombre del punto de valor.

  - `items.vp_rewards.sku` (string)
    ID único del punto de valor.

  - `price` (object,null)
    Precio de la cesta.

  - `promotions` (array)
    Promociones aplicadas a toda la cesta. La matriz se devuelve en los siguientes casos:

* Una promoción afecta al importe total de la cesta, como un código promocional con el parámetro Descuento en la compra.

* Una promoción añade artículos de bonificación a la cesta.

 Si no se aplican promociones a nivel de pedido, se devuelve una matriz vacía.

  - `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