Item

Модель, описывающая номенклатуру

Название Тип данных Описание параметра
id Int64 id номенклатуры
group ItemGroup Группа номенклатуры
department Department Отдел, к которому принадлежит номенклатура
vat TaxVat Ставка НДС (%)
barcode_list string Список штрих-кодов номенклатуры, разделенных символом “,”
base_barcode string Штрих-код номенклатуры
unit Unit Единица измерения номенклатуры
unit2 Unit Единица измерения номенклатуры для КДТ
color Сolor Цвет номенклатуры
size SizeChart Размер номенклатуры
brand Brand Бренд номенклатуры
producer Producer Производитель номенклатуры
country Country Страна производства номенклатуры
compound bool Метка о том, что номенклатура составная
deleted_mark bool Метка на удаление
image_url string URL изображения номенклатуры
parent_id Int64 id родительской номенклатуры (используется для создания вариаций)
has_child bool Метка о наличии дочерних элементов (используется для создания вариаций)
last_update Int64 Дата последнего изменения записи в формате unixtime в секундах
type enum Тип номенклатуры: item (Товар), service(Услуга). По умолчанию: item
code Uint64 Код номенклатуры
name string Наименование номенклатуры
fullname string Полное наименование номенклатуры
description string Дополнительное описание номенклатуры
articul string Артикул номенклатуры
kdt int Количество номенклатуры для КДТ
min_quantity int Минимальное количество номенклатуры
icps string ИКПУ - идентификационный код продукции и услуг
assemblable bool Метка о том, что товар можно произвести
disassemblable bool Метка о том, что товар можно разобрать
is_labeled bool Метка о том, что товар подлежит маркировке
comission_tin string ИНН комиссионера
package_code string Код упаковки
origin enum Происхождение товара: NotSpecified = -1 (не задано), BuyingAndSelling = 0 (купля продажа), Produced = 1 (производство), Service = 2 (услуги)
partner_id int Id контрагента


Составная номенклатура

Составная номенклатура (compound = true) - это номенклатура, который состоит из нескольких отдельных позиций номенклатуры, объединённых в один продукт для продажи. Такая номенклатура может продаваться как единое целое, и покупатель приобретает её вместе, по общей цене.
Примеры составной номенклатуры:
Компьютерные комплекты: настольный компьютер, монитор, клавиатура и мышь, продаваемые как один комплект.
Подарочные наборы: корзина с виноградом, сыром и шоколадом, упакованные и продаваемые вместе.
Мебельные гарнитуры: стол, стулья и шкаф, продающиеся как единый набор.

Для добавления номенклатуры в состав составного товара используется метод Item/AddToCompound.

Свойства составного товара:

  • Только товар (type = item);
  • Составной товар не может быть в составе составного товара;
  • Не может быть в составе товаров на производство;
  • Не сборный/разборный (assemblable, disassemblable = false);
  • Участвует только в документах продажи и установки цен;
  • Составной(виртуальный) товар по складу не числится - числится как: отдельно контейнер и содержимое.

Метка "закрыть чек при недостаточном количестве номенклатуры" игнорируется при продаже через REGOS: POS.

Документы списания/занесения создаются автоматически при агрегации розничных продаж, в дальнейшем документы невозможно редактировать.

Вариационная номенклатура (parent_id и has_child)

Вариации используются для компановки однотипной номенклатуры с отличающимися характеристиками. В основе вариации лежит родительская номенклатура, которая может иметь дочерние вариации has_child, Дочерняя номенклатура привязывается к родительской вариационной номенклатуре при помощи параметра parent_id и становится её вариацией. Вариацией называется номенклатура с таким же типом как родительская с дополнительными или отличающимися характеристиками, например: родительская номенклатура - футболка, вариация - футболка синяя М.

Свойства родительской номенклатуры:

  • Тип родительской номенклатуры и вариации должны совпадать;
  • Можно установить цену;
  • Не может быть: сборным, разборным, составным, в составе;
  • Не участвует в документах продажи или возврата;
  • Не участвует в складских операциях;
  • Если по товару совершались операции то его нельзя сделать родительским;
  • Если операции с товаром на кассе не были синхронизированы, то номенклатуру можно сделать родительской, но после синхронизации будет невозможно добавить новые вариации.