# Actualizar lote

Actualiza un lote. Esta llamada sustituye por completo el lote: transmita todos los campos obligatorios en el cuerpo de la solicitud, no solo los campos que quiera cambiar. Para obtener más información, consulte la sección Lotes.

AvisoTodos los artículos de la matriz content deben estar creados previamente en su proyecto. El sistema devuelve un error si el SKU indicado no existe.

Endpoint: PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}
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 y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `sku` (string, required)
    SKU del lote.
    Example: "kg_1"

## Request fields (application/json):

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

  - `name` (object,null, required)
    Objeto con traducciones para la descripción 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 idioma 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/).

  - `groups` (array)
    Grupos a los que pertenece el artículo.

Nota. El valor de la cadena (string) se refiere al grupo external_id.

  - `attributes` (array)
    Lista de atributos.

Atención. No puede especificar más de 20 atributos para el artículo. Cualquier intento de superar el límite provocará un error.

  - `attributes.external_id` (string, required)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.

  - `attributes.name` (object)
    Objeto con traducciones para el nombre del atributo. Las claves se especifican en la norma ISO 3166-1.

  - `attributes.values` (array, required)
    Atención. No puede crear más de 6 valores para cada atributo. Cualquier intento de exceder el límite resultará en un error.
    Example: [{"external_id":"strategy","value":{"en":"Strategy","de":"Strategie"}},{"external_id":"action","value":{"en":"Action","de":"Aktion"}}]

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

  - `attributes.values.value` (object, required)
    Objeto con traducciones del nombre del valor. Las claves se especifican en la norma ISO 3166-1.

  - `description` (object,null, required)
    Objeto con traducciones para la descripción del artículo. Acepta valores en uno de 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/).

  - `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/).

  - `image_url` (string,null)
    URL de la imagen. Para que la imagen se visualice correctamente y se cargue con rapidez en la interfaz de pago, consulte nuestras directrices sobre imágenes y URL:Formatos compatibles: WebP (recomendado), PNG y JPG.Tamaño del archivo: ≤ 50 KB (para WebP) o ≤ 150 KB (para PNG y JPG).Tamaño de la imagen: 280 x 280 píxeles.Espacio de color: sRGB.Protocolo: HTTPS con almacenamiento en caché de larga duración para las URL versionadas.

  - `prices` (array)
    Precios en monedas reales.

  - `prices.amount` (string, required)
    Precio del artículo.

  - `prices.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).

  - `prices.is_default` (boolean, required)
    El precio por defecto se usa para crear un catálogo si no se especifica un precio en la moneda del usuario.

  - `prices.is_enabled` (boolean, required)
    El precio está habilitado.

  - `prices.country_iso` (string,null)
    País en el que está disponible este precio. Código de dos letras según la norma [ISO 3166-1 alfa 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `vc_prices` (any)

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

  - `content` (array)
    Matriz de artículos incluidos en el lote. Cada entrada especifica el SKU y la cantidad del artículo. Todos los artículos deben haberse creado previamente en su proyecto. El sistema devuelve un error si el SKU especificado no existe.
    Example: [{"sku":"com.xsolla.kg_1","quantity":1}]

  - `content.sku` (string, required)
    SKU de un artículo que se va a incluir en el lote. El artículo debe haberse creado previamente en su proyecto. El sistema devuelve un error si el SKU especificado no existe. Caracteres permitidos: a–z, A–Z, 0–9, punto (.), guión (-), guión bajo (_).
    Example: "com.xsolla.kg_1"

  - `content.quantity` (integer)
    Cantidad de los artículos seleccionados en el lote.
    Example: 1

  - `is_free` (boolean)
    Si el artículo es gratuito.

  - `is_paid_randomized_reward` (boolean)
    Si el artículo es o no una recompensa de pago aleatoria, p. ej., una caja de botín.

  - `is_enabled` (boolean)
    Si está deshabilitado, el artículo no se puede encontrar ni comprar.

  - `is_show_in_store` (boolean)
    El artículo está disponible para la compra.

  - `media_list` (any)

  - `order` (integer)
    Prioridad de orden del lote en la lista.

  - `regions` (array)

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

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

  - `limits.per_user` (any)
    Limitación de artículos para un usuario independiente.

  - `limits.per_item` (integer,null)
    Limitación global de artículos.

  - `limits.recurrent_schedule` (object,null)
    Periodo de actualización del límite.

  - `limits.recurrent_schedule.per_user` (any)
    Reinicio del límite de compra en el intervalo especificado en horas.

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

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

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

  - `custom_attributes` (object)
    Un objeto JSON que contiene atributos y valores de artículos. Los artículos le permiten añadir más información a los artículos, tal como el nivel requerido del jugador para usar el artículo. Los atributos enriquecen la lógica interna del juego y son accesibles a través de métodos GET y webhooks específicos.

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

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

## Response 422 fields (application/json):

  - `statusCode` (integer)
    Example: 422

  - `errorCode` (integer)
    Example: 1102

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

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

  - `errorMessageExtended` (array)


## Response 204 fields
