Импорт каталога товаров из JSON-файла

Вы можете создать, обновить или отключить товары с помощью импорта из JSON-файла.

Вы можете создать, обновить или отключить товары, используя методы API или вручную в Личном кабинете. При этом для каждого товара потребуется выполнять отдельный запрос или действие. С помощью импорта вы можете выполнить указанные действия для множества товаров одновременно, указав их в одном JSON-файле.

С помощью этого инструмента вы можете:

Возможности:

Поддержка следующих типов товаров:
- виртуальных предметов;
- виртуальной валюты;
- пакетов виртуальной валюты;
- бандлов.
Валидация загружаемых данных. Если структура файла или формат данных не соответствуют требованиям, вы увидите список ошибок при импорте.

Ограничения:

Импорт недоступен для игровых ключей, акций и системы вознаграждений.
Размер загружаемого JSON-файла не должен превышать 7 МБ.
Формат параметров в JSON-файле должен соответствовать формату, указанному в соответствующем методе создания товара:

Для предварительно созданных товаров вы можете импортировать региональные цены из CSV-файла.

Импорт каталога товаров

Чтобы импортировать каталог товаров из файла:

Откройте проект в Личном кабинете.
В боковом меню нажмите Store и перейдите в раздел Виртуальная валюта, Виртуальные предметы или Бандлы.
Нажмите Импортировать товары.

Выберите нужное действие:
- Добавить новые товары — будут добавлены только товары с новыми артикулами.
- Добавить новые товары и обновить существующие — будут добавлены товары с новыми артикулами и обновлены данные существующих товаров.
- Добавить новые, обновить существующие и отключить недостающие товары — товары с артикулами из файла будут добавлены/обновлены. Если товар есть в каталоге, но товара с таким артикулом нет в файле, статус товара в Личном кабинете будет изменен на Частично доступен. Такой товар нельзя приобрести отдельно, но он доступен в составе бандла или в качестве бонуса.

Заполните файл для импорта:
- Скачайте шаблон файла в окне загрузки и заполните его по примеру ниже.
- Сделайте экспорт товаров и используйте экспортированный файл как шаблон.
- Создайте свой JSON-файл и заполните его по примеру ниже.

Пример заполненного JSON-файла:

Copy

Full screen

Small screen


{
    "virtual_currency": [
        {
            "sku": "Gem_test_import",
            "name": {
                "en": "Gem_test_import"
            },
            "type": "virtual_currency",
            "description": {
                "en": "my test imported currency"
            },
            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
            "description": {
                "en": "my test imported currency",
                "de": "meine importierte Testwährung"
            },
            "attributes": [],
            "is_free": false,
            "order": 1,
            "groups": [],
            "regional_prices": [],
            "prices": [
                {
                    "amount": 2,
                    "currency": "USD",
                    "is_default": true,
                    "is_enabled": true
                }
            ],
            "media_list": [],
            "vc_prices": [],
            "is_enabled": true,
            "is_show_in_store": true,
            "regions": [],
            "limits": {
                "per_user": null,
                "per_item": null,
                "recurrent_schedule": null
            },
            "periods": [],
            "inventory_options": {
                "consumable": true,
                "expiration_period": null
            },
            "is_hard": false
        }
    ],
    "virtual_items": [
        {
            "sku": "event_access_test_import",
            "name": {
                "en": "Special Event Access_test_import"
            },
            "type": "virtual_good",
            "description": {
                "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
            },
            "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
            "long_description": null,
            "attributes": [],
            "is_free": false,
            "order": 1,
            "groups": [
                "my_test_group"
            ],
            "regional_prices": [],
            "prices": [
                {
                    "amount": 35,
                    "currency": "USD",
                    "is_default": true,
                    "is_enabled": true
                }
            ],
            "media_list": [],
            "vc_prices": [],
            "is_enabled": true,
            "is_show_in_store": true,
            "regions": [],
            "limits": {
                "per_user": null,
                "per_item": null,
                "recurrent_schedule": null
            },
            "periods": [],
            "inventory_options": {
                "consumable": true,
                "expiration_period": null
            }
        }
    ],
    "virtual_currency_packages": [
        {
            "item_id": 441982,
            "sku": "small_gold_pack_test_import",
            "type": "bundle",
            "name": {
                "en": "Small gold pack"
            },
            "bundle_type": "virtual_currency_package",
            "description": {
                "en": "Gold x100"
            },
            "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
            "vc_prices": [],
            "regional_prices": [],
            "prices": [
                {
                    "amount": 5,
                    "currency": "USD",
                    "is_default": true,
                    "is_enabled": true
                }
            ],
            "is_enabled": true,
            "is_show_in_store": true,
            "regions": [],
            "limits": {
                "per_user": null,
                "per_item": null,
                "recurrent_schedule": null
            },
            "periods": [],
            "attributes": [],
            "long_description": null,
            "media_list": [],
            "order": 100000000,
            "is_free": false,
            "groups": [],
            "content": [
                {
                    "sku": "Gem_test_import",
                    "quantity": 100
                }
            ]
        }
    ],
    "bundles": [
        {
            "item_id": 684024,
            "sku": "start_pack_test_import_test_import",
            "type": "bundle",
            "name": {
                "en": "Legendary Start Pack"
            },
            "bundle_type": "standard",
            "description": {
                "en": "Crystal x 1\nGem x 1"
            },
            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
            "regional_prices": [],
            "prices": [
                {
                    "amount": 20,
                    "currency": "USD",
                    "is_default": true,
                    "is_enabled": true
                }
            ],
            "virtual_prices": [],
            "is_enabled": true,
            "is_show_in_store": true,
            "regions": [],
            "limits": {
                "per_user": null,
                "per_item": null,
                "recurrent_schedule": null
            },
            "periods": [],
            "attributes": [],
            "long_description": null,
            "media_list": [],
            "order": 5,
            "is_free": false,
            "groups": [
                "my_test_group"
            ],
            "content": [
                {
                    "sku": "Gem_test_import",
                    "quantity": 1
                },
                {
                    "sku": "event_access_test_import",
                    "quantity": 1
                }
            ]
        }
    ]
}

Загрузите заполненный файл в соответствующее поле в окне импорта.
Если при импорте возникнут ошибки, в окне импорта отобразится список этих ошибок и рекомендаций по исправлению. Внесите необходимые изменения в файл и загрузите его снова.

После успешной загрузки товары с указанными артикулами будут созданы, обновлены или отключены.

Вы можете импортировать товары с помощью метода API Импорт товаров из JSON-файла.
Чтобы избежать ошибок при импорте, следуйте приведенным выше рекомендациям по заполнению файла.

Экспорт каталога товаров

Чтобы экспортировать товар или каталог товаров в JSON-файл:

Откройте проект в Личном кабинете.
В боковом меню нажмите Store и перейдите в раздел Виртуальная валюта, Виртуальные предметы или Бандлы.
Нажмите Экспортировать товары.

Выберите нужное действие:
- Экспортировать все товары — будет выгружен весь каталог всех типов товаров данного проекта. Например, если вы перешли в раздел Виртуальная валюта и экспортируете все товары, в JSON-файл будут выгружены виртуальные валюты, пакеты виртуальной валюты, виртуальные предметы, пакеты игровых ключей вашего проекта.
- Экспортировать только выбранные товары — в открывшемся окне выберите товары, которые должны быть экспортированы.

Нажмите Экспортировать.

Загрузка JSON-файла начнется автоматически.

Спасибо за обратную связь!

Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.

Последнее обновление: 31 мая 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Your browser is not supported. Please try a different browser

Популярные статьи

Или выберите из частых вопросов:

Ответ сформирован на основе следующих источников:

Оставьте нам отзыв (опционально)

Оставьте нам отзыв (опционально)

Web Shop

Импорт каталога товаров из JSON-файла

Импорт каталога товаров

Экспорт каталога товаров