3. Создание нового товара

Создание нового товара используется, когда на витрине Halyk Market еще нет карточки, соответствующей вашему продукту. В этом случае вы формируете новую карточку товара с нуля и отправляете ее на модерацию. Перед началом важно убедиться, что такого товара действительно нет в каталоге. Для этого нужно воспользоваться методом поиска по названию или артикулу. Если товар найден — выполняется привязка по ссылке к уже существующей карточке через соответствующий метод.

Если нет — можно переходить к созданию нового.

Процесс создания включает несколько последовательных шагов:

1. Поиск ID категории 3-го уровня, к которой относится ваш товар.

2. Поиск ID бренда, соответствующего производителю.

3. Получение формы характеристик, необходимых для заполнения карточки товара.

4. Загрузка фотографий в систему.

5. Отправка заполненной формы с характеристиками и изображениями на модерацию.

6. Получение статуса модерации — подтверждение, что товар одобрен и размещён на витрине.

После успешного прохождения модерации карточка вашего товара становится доступной покупателям на Halyk Market.

GET-запрос:

curl -X 'GET' \
'https://halykmarket.kz/gw/merchant/public/skus/search?q=iPhone&page=1&size=20' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ваш токен'

Атрибуты запроса:

Наименование	Тип	Описание
q	string	Поисковый запрос — название или артикул искомого товара
page	integer	Пагинация: номер страницы с результатами ответа. Минимальное значение — 1
size	integer	Пагинация: количество результатов на странице. Минимальное значение — 1

Для обращения на тестовый сервер используйте URL: https://test2.halykmarket.com/gw/merchant/public/skus/search

Шаблон ответа:

{
    "content": [
        {
            "skuId": 1111111111,
            "name": "Смартфон Apple iPhone 15 Pro 256Gb Black Titanium",
            "imageUrl": "/cmsstatic/1208168055/1208168055-blk1.jpg",
            "category": {
                "id": 11111,
                "name": "Смартфоны",
                "level": 3
            },
            "marketUrl": "/category/smartfoni/smartfon-apple-iphone-15-pro?sku=256gb_black-titanium"
        },
        {
            "skuId": 1111111111,
            "name": "Смартфон Apple iPhone 15 Pro 256Gb Black Titanium +Адаптер Apple Double USB-C 35W +Чехол +Защитное стекло",
            "imageUrl": "/cmsstatic/product/1207743464/product-1207743464-blc.jpg",
            "category": {
                "id": 11111,
                "name": "Акция 1+1 Электроника",
                "level": 3
            },
            "marketUrl": "/category/akcija-11/smartfon-apple-iphone-15-pro-256gb-black-titanium--adapter-apple-double-usb-c-35w--chehol--zashhitnoe-steklo"
        }
    ],
    "pageable": {
        "pageNumber": 0,
        "pageSize": 20,
        "sort": {
            "empty": true,
            "sorted": false,
            "unsorted": true
        },
        "offset": 0,
        "unpaged": false,
        "paged": true
    },
    "last": true,
    "totalPages": 1,
    "totalElements": 2,
    "size": 20,
    "number": 0,
    "sort": {
        "empty": true,
        "sorted": false,
        "unsorted": true
    },
    "first": true,
    "numberOfElements": 2,
    "empty": false
}

Атрибуты ответа:

Наименование	Тип	Описание
skuId	integer	Уникальный идентификатор товара, который будет необходим на следующем шаге
name	string	Наименование товара
imageUrl	string	Ссылка на изображение товара
category.id	integer	Идентификатор категории 3-го уровня
category.name	string	Наименование категории 3-го уровня
category.level	integer	Уровень категории, всегда равен 3
category.marketUrl	string	Ссылка на товар на маркете
pageNumber	integer	Номер текущей страницы
pageSize	integer	Размер страницы, указанный в запросе
totalPages	integer	Количество страниц с результатами
totalElements	integer	Количество товаров согласно запросу
—	—	Прочие поля несут технический характер

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