Вивантаження категорій товарів

URI: /api/v1/marketplace/goods/categories/import

Метод використовується для вивантаження довідника категорій товарів.

Запит виконується методом POST з тілом запиту у json форматі.

⚠️ Запит повинен містити заголовок Accept: application/json

Параметри запиту

Ім'я	Тип	Обов'язковий	Опис
id	string	Так	Ідентифікатор категорії
name_ru	string	Так	Назва категорії російською мовою
name_uk	string	Так	Назва категорії українською мовою
parent_id	string | null	Ні	Ідентифікатор батьківської категорії 🛈 Необов'язкове лише для кореневих категорій
parent_name_ru	string | null	Ні	Назва батьківської категорії російською мовою
parent_name_uk	string | null	Ні	Назва батьківської категорії українською мовою

інформація

Якщо вказано параметр parent_id, поля parent_name_ru та parent_name_uk є обов'язковими.

Приклад запиту

Запит: /api/v1/marketplace/goods/categories/import

[
    {
        "id": "779d5b48-6d69-11e9-bb00-9c8e991df3cb",
        "name_ru": "ЛЕКАРСТВЕННЫЕ СРЕДСТВА",
        "name_uk": "ЛІКАРСЬКІ ЗАСОБИ",
        "parent_id": null,
        "parent_name_ru": null,
        "parent_name_uk": null
    },
    {
        "id": "c2220000-9000-11e9-bb00-9c8e991df3cb",
        "name_ru": "АНТИБИОТИКИ",
        "name_uk": "АНТИБІОТИКИ",
        "parent_id": "779d5b48-6d69-11e9-bb00-9c8e991df3cb",
        "parent_name_ru": "ЛЕКАРСТВЕННЫЕ СРЕДСТВА",
        "parent_name_uk": "ЛІКАРСЬКІ ЗАСОБИ"
    },
    {
        "id": "c2251111-9000-11e9-bb00-9c8e991df3cb",
        "name_ru": "ПЕНИЦИЛЛИНЫ",
        "name_uk": "ПЕНІЦИЛІНИ",
        "parent_id": "c2220000-9000-11e9-bb00-9c8e991df3cb",
        "parent_name_ru": "АНТИБИОТИКИ",
        "parent_name_uk": "АНТИБІОТИКИ"
    },
    {
        "id": "c2282222-9000-11e9-bb00-9c8e991df3cb",
        "name_ru": "Амоксициллин",
        "name_uk": "Амоксицилін",
        "parent_id": "c2251111-9000-11e9-bb00-9c8e991df3cb",
        "parent_name_ru": "ПЕНИЦИЛЛИНЫ",
        "parent_name_uk": "ПЕНІЦИЛІНИ"
    },
    {
        "id": "c22b3333-9000-11e9-bb00-9c8e991df3cb",
        "name_ru": "Ампициллин",
        "name_uk": "Ампіцилін",
        "parent_id": "c2251111-9000-11e9-bb00-9c8e991df3cb",
        "parent_name_ru": "ПЕНИЦИЛЛИНЫ",
        "parent_name_uk": "ПЕНІЦИЛІНИ"
    },
    {
        "id": "c22e4444-9000-11e9-bb00-9c8e991df3cb",
        "name_ru": "ЦЕФАЛОСПОРИНЫ",
        "name_uk": "ЦЕФАЛОСПОРИНИ",
        "parent_id": "c2220000-9000-11e9-bb00-9c8e991df3cb",
        "parent_name_ru": "АНТИБИОТИКИ",
        "parent_name_uk": "АНТИБІОТИКИ"
    },
    {
        "id": "c2315555-9000-11e9-bb00-9c8e991df3cb",
        "name_ru": "Цефазолин",
        "name_uk": "Цефазолін",
        "parent_id": "c22e4444-9000-11e9-bb00-9c8e991df3cb",
        "parent_name_ru": "ЦЕФАЛОСПОРИНЫ",
        "parent_name_uk": "ЦЕФАЛОСПОРИНИ"
    },
    {
        "id": "c2346666-9000-11e9-bb00-9c8e991df3cb",
        "name_ru": "Цефтриаксон",
        "name_uk": "Цефтріаксон",
        "parent_id": "c22e4444-9000-11e9-bb00-9c8e991df3cb",
        "parent_name_ru": "ЦЕФАЛОСПОРИНЫ",
        "parent_name_uk": "ЦЕФАЛОСПОРИНИ"
    }
]

Параметри відповіді

Ім'я	Тип	Опис
data	object	Інформація про імпорт
data.id	integer	Ідентифікатор імпорту
data.status	string	Статус імпорту: NEW - пакет даних прийнято AWAIT - пакет даних в черзі на обробку PROCESSING - пакет даних оброблюється ERROR - пакет даних оброблено з помилкою DUPLICATE - пакет даних повністю дублює попередній SUCCESS - пакет даних оброблено вдало
data.marketplace_id	integer	Ідентифікатор маркетплейсу
data.created_at	string	Дата та час створення запису
data.updated_at	string	Дата та час оновлення запису

Приклад успішної відповіді

200 OK

Відповідь: /api/v1/marketplace/goods/categories/import

{
    "data": {
        "marketplace_id": 17,
        "status": "new",
        "updated_at": "2026-06-10T13:55:28.000000Z",
        "created_at": "2026-06-10T13:55:28.000000Z",
        "id": 1
    }
}