Xsolla-logoXsolla Developers
o
A Cuenta del editor

Crear loteServer-sideAdmin

post/v2/project/{project_id}/admin/items/bundle

Crea un lote.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.

Example: 44056
Request Body schema: application/json

Objeto con datos del lote.

sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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.

required
(two-letter (object or null)) or (five-letter (object or null))

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.

One of:

Códigos lingüísticos de dos letras minúsculas.

ar
string or null

Árabe

bg
string or null

Búlgaro

cn
string or null

Chino (simplificado)

cs
string or null

Checo

de
string or null

Alemán

en
string or null

Inglés

es
string or null

Español (España)

fr
string or null

Francés

he
string or null

Hebreo

id
string or null

Indonesio

it
string or null

Italiano

ja
string or null

Japonés

km
string or null

Jemer

ko
string or null

Coreano

lo
string or null

Lao

my
string or null

Birmano

ne
string or null

Nepalí

ph
string or null

Filipino

pl
string or null

Polaco

pt
string or null

Portugués

ro
string or null

Rumano

ru
string or null

Ruso

th
string or null

Tailandés

tr
string or null

Turco

tw
string or null

Chino (tradicional)

vi
string or null

Vietnamita

required
(two-letter (object or null)) or (five-letter (object or null))

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.

One of:

Códigos lingüísticos de dos letras minúsculas.

ar
string or null

Árabe

bg
string or null

Búlgaro

cn
string or null

Chino (simplificado)

cs
string or null

Checo

de
string or null

Alemán

en
string or null

Inglés

es
string or null

Español (España)

fr
string or null

Francés

he
string or null

Hebreo

id
string or null

Indonesio

it
string or null

Italiano

ja
string or null

Japonés

km
string or null

Jemer

ko
string or null

Coreano

lo
string or null

Lao

my
string or null

Birmano

ne
string or null

Nepalí

ph
string or null

Filipino

pl
string or null

Polaco

pt
string or null

Portugués

ro
string or null

Rumano

ru
string or null

Ruso

th
string or null

Tailandés

tr
string or null

Turco

tw
string or null

Chino (tradicional)

vi
string or null

Vietnamita

Array of objects <= 20 items

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.
Array (<= 20 items)
external_id
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.

required
Array of objects
Atención. No puede crear más de 6 valores para cada atributo. Cualquier intento de exceder el límite resultará en un error.
Array
required
object
Default: {"de":"Strategie","en":"Strategy"}

Objeto con traducciones del nombre del valor. Las claves se especifican en la norma ISO 3166-1.

property name*
additional property
string
external_id
required
string [ 1 .. 255 ] characters ^[-_.\d\w]+$

ID del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.

object
Default: {"de":"Genre","en":"Genre"}

Objeto con traducciones para el nombre del atributo. Las claves se especifican en la norma ISO 3166-1.

property name*
additional property
string
Array of objects non-empty
Array (non-empty)
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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.

quantity
integer >= 1
Default: 1

Cantidad de los artículos seleccionados en el lote.

custom_attributes
object <json> <= 500 characters

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.

groups
Array of strings
Default: []

Grupos a los que pertenece el artículo.

Nota. El valor de la cadena (string) se refiere al grupo `external_id`.
image_url
string or null

URL de la imagen.

is_enabled
boolean
Default: true

Si está deshabilitado, el artículo no se puede encontrar ni comprar.

is_free
boolean
Default: false

Si es true, el artículo es gratuito.

is_show_in_store
boolean
Default: false

El artículo está disponible para la compra.

object

Límites del artículo.

per_item
integer or null

Limitación global de artículos.

per_user
integer or null

Limitación de artículos para un usuario independiente.

object or null

Periodo de actualización del límite.

interval_type = daily (object) or interval_type = semanal (object) or interval_type = mensual (object)
One of:

Tipo diario de actualización del límite del usuario.

interval_type
required
string

Periodo de actualización recurrente.

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

Hora de actualización del límite en la zona horaria deseada (redondeo a horas).

(two-letter (object or null)) or (five-letter (object or 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.

Any of:

Códigos lingüísticos de dos letras minúsculas.

ar
string or null

Árabe

bg
string or null

Búlgaro

cn
string or null

Chino (simplificado)

cs
string or null

Checo

de
string or null

Alemán

en
string or null

Inglés

es
string or null

Español (España)

fr
string or null

Francés

he
string or null

Hebreo

id
string or null

Indonesio

it
string or null

Italiano

ja
string or null

Japonés

km
string or null

Jemer

ko
string or null

Coreano

lo
string or null

Lao

my
string or null

Birmano

ne
string or null

Nepalí

ph
string or null

Filipino

pl
string or null

Polaco

pt
string or null

Portugués

ro
string or null

Rumano

ru
string or null

Ruso

th
string or null

Tailandés

tr
string or null

Turco

tw
string or null

Chino (tradicional)

vi
string or null

Vietnamita

Array of objects or null

Recursos adicionales del lote.

Array
type
string

Tipo de soporte multimedia: image/video.

Enum: "image" "video"
url
string

Archivo de recurso.

order
integer
Default: 1

Prioridad de orden del lote en la lista.

Array of objects or null

Periodo de venta del artículo.

Array
date_from
string <date-time>

Fecha en la que el artículo especificado estará disponible para la venta.

date_until
string or null <date-time>

Fecha en la que el artículo especificado dejará de estar disponible para la venta. Puede ser null.

Array of objects

Precios en monedas reales.

Array
amount
required
string^\d*\.?\d*$

Precio del artículo.

currency
required
string

Divisa del precio del artículo. Código de tres letras según ISO 4217.

is_default
required
boolean

El precio por defecto se usa para crear un catálogo si no se especifica un precio en la moneda del usuario.

is_enabled
required
boolean

El precio está habilitado.

country_iso
string or null

País en el que está disponible este precio. Código de dos letras según la norma ISO 3166-1 alfa 2.

Array of objects
Array
id
integer >= 1
Array of objects or null
Array
amount
required
integer
is_default
required
boolean
is_enabled
required
boolean
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.

Responses
201

El lote se creó correctamente.

401

Autenticación básica no superada o errónea. Asegúrese de haber utilizado la autenticación básica o las credenciales correctas.

422

Solicitud no válida.

Request samples
application/json
{
  • "attributes": [
    ],
  • "content": [
    ],
  • "custom_attributes": {
    },
  • "description": {
    },
  • "groups": [
    ],
  • "is_enabled": true,
  • "is_free": true,
  • "limits": {
    },
  • "long_description": {
    },
  • "media_list": [],
  • "name": {
    },
  • "order": 1,
  • "periods": [
    ],
  • "prices": [
    ],
  • "sku": "com.xsolla.armour_chest_1",
  • "vc_prices": [ ]
}
Response samples
application/json
{
  • "sku": "com.xsolla.kg_1"
}