set.categories.create — Створення: Категорії

Призначення

Створює новий запис у довіднику Категорії.

Авторизація

• Логін/пароль: так.
• meta.user_card: обов’язково (для журналів).

Важливо

• Цей метод змінює базу, тому використовуйте тільки коли реально потрібно.
• Дія буде записана у журнали (User_log / Query_log), тому передавайте коректну meta.user_card.

Параметри params

Поле	Тип	Обовʼязково	Опис

| data | object | так | Поля запису, які потрібно створити. Дозволені поля залежать від довідника. |

| data.parent_uin | int | ні | Зручний псевдонім для Puin (батьківська категорія). |

Дозволені поля data

Найчастіше створювати має сенс такі поля:

Cat1, Level, Puin

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

Мокап: mockups/dictionaries/categories/set.create/request.json

{
  "auth": {
    "login": "<LOGIN>",
    "password": "<PASSWORD>"
  },
  "method": "set.categories.create",
  "params": {
    "data": {
      "Cat1": "Напої",
      "parent_uin": 0
    }
  },
  "meta": {
    "user_card": "<USER_CARD>",
    "client_name": "MyIntegration",
    "client_version": "1.0.0"
  },
  "id": "categories-create-001"
}

Приклад відповіді (успіх)

Мокап: mockups/dictionaries/categories/set.create/response.ok.json

{
  "ok": true,
  "result": {
    "item": {
      "...": "..."
    }
  },
  "meta": {
    "api_version": "0.1.0",
    "ts": "2026-01-26T12:00:00+00:00"
  },
  "id": "categories-create-001"
}

Типові помилки

• MISSING_DATA / EMPTY_DATA — не передали data або передали порожні/недозволені поля.