# Obtener lista de lotes

Obtiene una lista de lotes para crear un catálogo.

AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta.  NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization.

Endpoint: GET /v2/project/{project_id}/items/bundle
Version: 2.0.0
Security: XsollaLoginUserJWT

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

## Query parameters:

  - `limit` (integer)
    Límite para el número de elementos presentes en la página.
    Example: 50

  - `offset` (integer)
    Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

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

  - `additional_fields[]` (array)
    La lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

  - `country` (string)
    Código de país de dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2. Consulte la documentación para obtener información detallada sobre los países admitidos por Xsolla y el proceso de determinación del país.
    Example: "US"

  - `promo_code` (string)
    Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números.
    Example: "WINTER2021"

  - `show_inactive_time_limited_items` (integer)
    Muestra los artículos de duración limitada que no están disponibles para el usuario. El periodo de validez de dichos artículos no ha comenzado o ya ha expirado.
    Example: 1

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Se utiliza como indicador de que hay más páginas.
    Example: true

  - `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.bundle_type` (string)
    Tipo de lote. Utilice standard para crear un lote con artículos y especifique los SKU de los artículos incluidos en el lote.
Utilice partner_side_content para crear un lote vacío y añadir artículos en su lado utilizando un [webhook](https://developers.xsolla.com/es/webhooks/operation/personalized-partner-catalog/). Este tipo solo se utiliza para la [Personalización del catálogo en el lado del socio](https://developers.xsolla.com/es/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side).
    Enum: "standard", "partner_side_content"

  - `items.can_be_bought` (boolean)
    Si es true, el usuario puede comprar un artículo.
    Example: true

  - `items.content` (array)
    Contenido del paquete del lote.
    Example: [{"attributes":[],"description":"Big Rocket - short description.","groups":[],"image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","is_free":false,"name":"Big Rocket","price":{"amount":"10.99","amount_without_discount":"10.99","currency":"USD"},"quantity":100,"sku":"com.xsolla.big_rocket_1","type":"virtual_currency"}]

  - `items.content.description` (string)
    Descripción del artículo.
    Example: "Big Rocket - description"

  - `items.content.groups` (array)
    Grupos a los que pertenece el artículo.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

  - `items.content.groups.external_id` (string)
    Example: "horror"

  - `items.content.groups.name` (object)
    Nombre del artículo. Debe contener pares clave/valor
en los cuales clave es una configuración regional con formato "^[a-z]{2}", valor es una cadena (string).
    Example: {"de":"Horror","en":"Horror"}

  - `items.content.image_url` (string)
    URL de la imagen.
    Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"

  - `items.content.is_free` (boolean)
    Si es true, el artículo es gratuito.

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

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

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

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

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

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

  - `items.content.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.content.limits.per_user.recurrent_schedule` (object)
    Periodo de actualización recurrente de los límites del artículo para un usuario.

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

  - `items.content.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.content.limits.per_user.total` (integer)
    Número máximo de artículos que un mismo usuario puede comprar.
    Example: 5

  - `items.content.name` (string)
    Nombre del artículo.
    Example: "Big Rocket"

  - `items.content.price` (object,null)
    Precios de artículos.

  - `items.content.price.amount` (string)
    Precio del artículo con descuento.
    Example: "100.99"

  - `items.content.price.amount_without_discount` (string)
    Precio del artículo.
    Example: "100.99"

  - `items.content.price.currency` (string)
    Divisa del precio del artículo. 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.content.quantity` (integer)
    Cantidad de artículos que contiene un paquete.
    Example: 250

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

  - `items.content.type` (string)
    Tipo de artículo: virtual_good/virtual_currency/bundle.
    Example: "virtual_currency"

  - `items.content.virtual_item_type` (string)
    Tipo de artículo virtual.
    Enum: "consumable", "non_consumable", "non_renewing_subscription"

  - `items.content.virtual_prices` (array)
    Precios virtuales.

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

  - `items.content.virtual_prices.description` (string)
    Descripción de la moneda virtual.
    Example: "Big Rocket - description"

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

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

  - `items.content.virtual_prices.name` (string)
    Nombre de la moneda virtual.
    Example: "SHOTGUN FOR TRUE RAIDERS"

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

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

  - `items.custom_attributes` (object)
    Un objeto JSON que contiene los atributos y valores del artículo.

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

  - `items.long_description` (object,null)
    Objeto con traducciones para la descripción larga del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de configuración regional de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `items.media_list` (array)
    Recursos adicionales del lote.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `items.media_list.type` (string)
    Tipo de soporte multimedia: image/video.
    Enum: "image", "video"

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

  - `items.order` (integer)
    Prioridad de orden del lote en la lista.
    Example: 1

  - `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.currency` (string, required)
    Divisa del precio del artículo. Código de tres letras según [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `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.promotions.name` (string)

  - `items.sku` (string)
    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: "bundle_1"

  - `items.total_content_price` (object,null)
    Suma de los precios del contenido del lote.

  - `items.total_content_price.amount` (string)
    Suma de los precios de los contenidos del lote con un descuento.
    Example: "100.99"

  - `items.total_content_price.amount_without_discount` (string)
    Suma de los precios del contenido del lote.
    Example: "100.99"

  - `items.type` (string)
    Tipo de artículo.
    Example: "bundle"

  - `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.is_clan` (boolean)
    Si el punto de valor se utiliza en las cadenas de recompensas de clanes.
    Example: true

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

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