Создать позицию каталога
trade.create_item
Создаёт новую позицию каталога: артикул, наименование, цену продажи и, при необходимости, категорию. В ответ возвращает идентификатор созданной позиции и время создания.
Входы
| Ключ | Тип | Описание |
|---|---|---|
| sku* | string | Артикул |
| name* | string | Наименование |
| sellPrice* | currency | Цена продажи |
| categoryId | uuid | Категория |
Выходы
| Ключ | Тип | Описание |
|---|---|---|
| itemId | uuid | Идентификатор позиции |
| createdAt | datetime | Создано |
Что делает
Нода заводит новую позицию в каталоге товаров модуля «Торговля». Достаточно указать артикул, наименование и цену продажи — позиция сразу появляется в каталоге и готова к продаже. При желании позицию можно отнести к категории, передав её идентификатор.
Когда применять
Основной сценарий — автоматическое пополнение каталога. Например, при получении прайс-листа от поставщика автоматизация перебирает строки и заводит новые товары, которых ещё нет в каталоге. Или пользователь просит ассистента «добавь новый товар — футболка, артикул TS-001, цена 990» — и позиция создаётся без ручного заполнения карточки. Категорию удобно подобрать заранее нодой поиска категорий и передать сюда её идентификатор.
Что на входе
Обязательны артикул, наименование и цена продажи. Категория необязательна: если её не передать, позиция создастся без привязки к категории, и отнести её к разделу каталога можно будет позже.
Что приходит в ответе
Идентификатор созданной позиции и время её создания. Идентификатор стоит сохранить — по нему дальше можно менять цену, запрашивать информацию о позиции или добавлять товар в продажу.