`set.products.create` — Створення: Товари

  1. Головна
  2. Довідники: зміни
  3. `set.products.create` — Створення: Товари

set.products.create — Створення: Товари

Призначення

Створює новий запис у довіднику Товари.

Авторизація

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

Важливо

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

Параметри params

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

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

| descriptions | array[string] | ні | Описи товару (записуються у Main_desc). |

| extra_fields | array або object | ні | Додаткові поля (таблиця Extra_fields). Формат: [{Nf,Val}] або { "1":"..." }. |

| with_details | bool | ні | Якщо true, API поверне створений товар з details. |

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

Для товарів (Main) підтримуються поля:

Code, Nt, Ss, Nac, Price, Ei, Quant, Dateadded, Sh, Post, Crit, Cat, Noskid, C2, Incloud, Dopinf

Примітки

  • Обов’язково: data.Code (унікальний) і бажано data.Nt (назва).

  • Якщо data.Dateadded не передано, API поставить поточну дату/час.

  • extra_fields можна передавати або списком {Nf,Val}, або як об’єкт { "1": "...", "2": "..." }.

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

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

{
  "auth": {
    "login": "<LOGIN>",
    "password": "<PASSWORD>"
  },
  "method": "set.products.create",
  "params": {
    "data": {
      "Code": "12345",
      "Nt": "Молоко 2.5%",
      "Price": 42.5,
      "Ei": 1,
      "Cat": 0,
      "Post": 0,
      "Quant": 0
    },
    "descriptions": [
      "Додатковий опис 1",
      "Додатковий опис 2"
    ],
    "extra_fields": [
      {
        "Nf": 1,
        "Val": "значення"
      }
    ],
    "with_details": true
  },
  "meta": {
    "user_card": "<USER_CARD>",
    "client_name": "MyIntegration",
    "client_version": "1.0.0"
  },
  "id": "products-create-001"
}

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

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

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

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

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

  • ALREADY_EXISTS — запис з таким PK вже існує.

На цій сторінці