Команда addInventItem

Команда addInventItem добавляет товар в справочник товаров. Атрибуты товара задаются обязательным параметром invent.  

Свойства параметра invent

Свойство

Тип данных

Описание

Примечания

inventcode

строковый(20)

Код товара


inventgroup

строковый(100)

Код родительской группы товаров


name

строковый(200)

Наименование товара


barcode

строковый(100)

Основной штрих-код

Если поле не заполнено или отсутствует, то запись в БД Dictionaries в таблицу Barcodes не производится.

Свойство barcode не загружает данные в поле bcode в БД Dictionaries в таблицу Tmc . Для этого используется свойство inventcode.

barcodes

массив объектов

Массив дополнительных штрих-кодов


price

вещественный(13,2)

Цена

Используется, если не задана цена в справочниках: переоценки и штрих-коды.

minprice

вещественный(13,2)

Минимальная цена

Используется, если не задана цена в справочниках: переоценки и штрих-коды.
additionalprices

массив объектов

Массив дополнительных цен


options

объект

Опции товара


sellrestrictperiods

массив объектов

Массив ограничений продаж по времени


extendetoptions

текст

Строка дополнительных опций

При перечислении атрибуты, которые задаются для условий скидок/бонусов, следует разделять запятыми.

discautoscheme

числовой(11)

Код схемы автоматических скидок


deptcode

числовой(11)

Код отдела


taxgroupcode

числовой(11)

Код группы налогов

Если поле заполнено и его значение больше 0, то поля vatcode1, vatcode2, vatcode3, vatcode4, vatcode5 в БД Dictionaries в таблице Tmc примут значение, полученное по формуле: " taxgroupcode  * 100 + номер налога (1, 2, 3, 4 или 5)".

measurecode

числовой(11)

Код единицы измерения


remain

вещественный(13,3)

Остаток


remaindate

дата и время

Дата и время остатков


articul

строковый(200)

Артикул


defaultquantity

вещественный(13,3)

Количество по умолчанию


taramode

числовой(11)

Режим использования тары:


taracapacity

вещественный(13,3)

Емкость тары


taraflag

числовой(11)

Код каталога, который содержит товары, являющиеся упаковкой

Значение параметра должно быть больше 0

Используется на КСО для весовых товаров с выбором упаковки (taramode=7)

aspectschemecode

числовой(11)

Код схемы разреза


aspectvaluesetcode

числовой(11)

Не используется


aspectusecase

числовой(11)

Не используется


aspectselectionrule

числовой(11)

Не используется


age

числовой(11)

Возраст
alcoholpercent вещественный(4,2)Процент алкоголя товара

cquant

вещественный(13,3)

Количество в учетных единицах


innстроковый(20)ИНН производителя безакцизной алкогольной продукции
kppстроковый(20)КПП производителя безакцизной алкогольной продукции
alctypecodeчисловой(11)Код вида алкогольной продукцииПараметр является обязательным для алкогольной продукции без акцизной марки.
paymentobjectчисловой(11)Признак предмета расчета

manufacturercountrycode

числовой(11)Код страны производителя товара
opmodeчисловой(11)

Свойства товара (битовая маска):

  • 1 – запретить продажу товара,
  • 2 – запретить возврат товара,
  • 4 – не показывать товар в списках,
  • 16 – товар требует визуального контроля,
  • 32 – товар ограничен в продаже по возрасту,
  • 64 – товар ограничен в продаже по времени,
  • 128 – алкогольный товар с акцизной маркой, требующий проверки в ЕГАИС,
  • 256 – товар с установленным признаком "расфасованный", на такой товар не применяется скидка на набор,
  • 512 – алкогольный товар без акцизной марки, не требующий проверки в ЕГАИС,
  • 1024 – алкогольный набор,
  • 2048 – товар по свободной цене,
  • 4096 – меховое изделие,
  • 8192 – товар без контроля веса,
  • 131072 – товар с неточным контрольным весом,
  • 16384 – легкий товар,
  • 32768 – табачная продукция,
  • 65536 – обувь,
  • 262144 – игнорирование признака маркировки,
  • 524288 – необходимо проверить на сервисе уценки.

Используется, если не заданы опции товара (свойство inventitemoptions). Если в массиве inventitemoptions задана хотя бы одна опция, то значение поля opmode игнорируется.

loyaltymodeчисловой(11)

Параметры использования воздействий лояльности (битовая маска):

  • 0 – нет запрета применения скидок,
  • 1 – запрет применения внутренних скидок, включая скидку на мелочь,
  • 2 – запрет применения внешних скидок (требуется проверка с каждой внешней системой лояльности),
  • 4 – запрет применения списания бонусов Artix.

minretailpriceвещественный(13,2)Минимальная розничная цена (МРЦ)Цена товара не может быть ниже МРЦ при любых бонусных воздействиях, взаимодействии с дисконтом, скидке на мелочь, оплате сертификатом как скидкой, применении модификатора цены.
packagecodeстроковый(255)Код упаковки
ownertypeчисловой(11)Тип владельца продукта/услуги:
  • 0 – перепродажа,
  • 1 – товар собственного производства,
  • 2 – услуга.

Свойства объекта массива barcodes

Свойство

Тип данных

Описание

Примечания
additionalprices

массив объектов

Массив дополнительных цен


aspectvaluesetcode

числовой(11)

Код значения разреза


barcode

строковый(100)

Штрих-код товара


cquant

вещественный(13,3)

Количество учетного товара


measurecodeчисловой(11)Код единицы измерения
minpriceвещественный(13,2)Минимальная ценаИспользуется, если не задана цена в справочнике переоценки.

name

строковый(200)

Наименование товара


packingmeasureчисловой(11)Единица измерения расфасовки
packingpriceвещественный(15,2)Цена расфасовки

price

вещественный(15,2)

Цена товара

Используется, если не задана цена в справочнике переоценки.
quantdefaultвещественный(13,3)Количество товара по умолчанию
minretailpriceвещественный(13,2)Минимальная розничная цена (МРЦ)Цена товара не может быть ниже МРЦ при любых бонусных воздействиях, взаимодействии с дисконтом, скидке на мелочь, оплате сертификатом как скидкой, применении модификатора цены.
customsdeclarationnumber

строковый(32)

Номер таможенной декларации

tmctype

 числовой(11) Тип товара:
  • 0 – обычный товар,
  • 1 – алкогольная продукция,
  • 2 – алкогольный набор,
  • 3 – табачная продукция,
  • 4 – обувной товар,
  • 5 – лекарственный препарат,
  • 6 – индивидуальное средство защиты,
  • 7 – маркированный товар,
  • 8 – разливное пиво.

ntinстроковый(255)Код национального классификатора товаров
packagecodeстроковый(255)Код упаковки

Свойства объекта массива additionalprices

Свойство

Тип данных

Описание

pricecode

числовой(11)

Код цены

price

вещественный(13,2)

Дополнительная цена

name

строковый(40)

Название дополнительной цены

Свойства объекта sellrestrictperiods

Свойство

Тип данных

Описание

dateend

дата

Конечная дата

datestart

дата

Начальная дата

dayend

числовой(11)

Последний день

daystart

числовой(11)

Начальный день

timeend

время

Конечное время

timestart

время

Начальное время

Свойства объекта options

Свойство

Тип данных

Описание

inventitemoptions

объект

Опции товара

priceoptions

объект

Опции цены

quantityoptions

объект

Опции количества

Свойства объекта quantityoptions

Свойство

Тип данных

Описание

Примечания

enabledefaultquantity

числовой(1)

Использовать количество по умолчанию из товара:

  • 0 – не использовать количество по умолчанию из товара,
  • 1 – использовать количество по умолчанию из товара.
По умолчанию 1

enablequantitylimit

числовой(1)

Включить ограничение количества товара:

  • 0 – выключить ограничение количества товара,
  • 1 – включить ограничение количества товара.

По умолчанию 0

quantitylimit

вещественный(13,3)

Максимальное количество товара при продаже одной позиции


enablequantityscales

числовой(1)

Разрешить ввод количества с весов:

  • 0 – запретить ввод количества с весов,
  • 1 – разрешить ввод количества с весов.
По умолчанию 1

enablequantitybarcode

числовой(1)

Разрешить установку количества из штрих-кода:

  • 0 – запретить установку количества из штрих-кода,
  • 1 – разрешить установку количества из штрих-кода.
По умолчанию 1

enablequantitymanual

числовой(1)

Разрешить ввод количества вручную:

  • 0 – запретить ввод количества вручную,
  • 1 – разрешить ввод количества вручную.
По умолчанию 1

requirequantitymanual

числовой(1)

Требовать ввод количества:

  • 0 – не требовать ввод количества,
  • 1 – требовать ввод количества.
По умолчанию 0

requirequantitybarcode

числовой(1)

Требовать ввод количества из штрих-кода:

  • 0 – не требовать ввод количества из штрих-кода,
  • 1 – требовать ввод количества из штрих-кода.
По умолчанию 0

requirequantityscales

числовой(1)

Требовать ввод количества с весов:

  • 0 – не требовать ввод количества с весов,
  • 1 – требовать ввод количества с весов.
По умолчанию 0

enabledocumentquantitylimit

числовой(1)

Разрешить ограничение количества товара в чеке:

  • 0 – количество товара в чеке не ограничено,
  • 1 – разрешить ограничивать количество товара в чеке по коду,
  • 2 – разрешить ограничивать количество товара в чеке по штрих-коду.
По умолчанию 0
autogetquantityfromscalesчисловой(1)

Получать количество с весов автоматически:

  • 0 – при добавлении товара его вес не запрашивается с весов автоматически,

  • 1 – при добавлении товара его вес будет получен автоматически с весов.
    Если он не был получен из штрих-кода или из ранее установленного модификатора, полученного с весов.

По умолчанию 0

documentquantlimit

вещественный(13,3)

Максимальное количество товара при продаже в чеке


Свойства объекта priceoptions

Свойство

Тип данных

Описание

Примечания

enablepricemanual

числовой(1)

Разрешить ввод цены вручную:

  • 0 – запретить ввод цены вручную,
  • 1 – разрешить ввод цены вручную.
По умолчанию 1
requirepricemanualчисловой(1)

Требовать ввод цены вручную:

  • 0 – не требовать ввод цены вручную,
  • 1 – требовать ввод цены вручную.
По умолчанию 0

requireselectprice

числовой(1)

Требовать выбор цены из массива цен:

  • 0 – не требовать выбор цены из массива цен,
  • 1 – требовать выбор цены из массива цен.
По умолчанию 0

requiredeferredprice

числовой(1)

Использовать отложенную цену:

  • 0 – не использовать отложенную цену,
  • 1 – использовать отложенную цену.
По умолчанию 0
enableexcisemarkpriceчисловой(1)

Использовать цену табачной продукции из кода маркировки:

  • 0 – не использовать цену табачной продукции из кода маркировки,
  • 1 – использовать цену табачной продукции из кода маркировки.
По умолчанию 0

Свойства объекта inventitemoptions

Свойство

Тип данных

Описание

Примечания

disablebackinsale

числовой(1)

Запретить возврат товара в чеке продажи:

  • 0 – разрешить возврат товара в чеке продажи,
  • 1 – запретить возврат товара в чеке продажи.
По умолчанию 0

disableinventshow

числовой(1)

Не показывать товар в списках:

  • 0 – показывать товар в списках,
  • 1 – не показывать товар в списках.
По умолчанию 0

disableinventsale

числовой(1)

Запретить продажу товара:

  • 0 – разрешить продажу товара,
  • 1 – запретить продажу товара.
По умолчанию 0

disableinventback

числовой(1)

Запретить возврат товара:

  • 0 – разрешить возврат товара,
  • 1 – запретить возврат товара.
По умолчанию 0

requiredepartmentmanual

числовой(1)

Требовать указание отдела вручную:

  • 0 – не требовать указание отдела вручную,
  • 1 – требовать указание отдела вручную.
По умолчанию 0

enabledepartmentmanual

числовой(1)

Разрешить ввод отдела вручную:

  • 0 – запретить ввод отдела вручную,
  • 1 – разрешить ввод отдела вручную.
По умолчанию 1

enablebarcodemanual

числовой(1)

Разрешить ввод штрих-кода вручную:

  • 0 – запретить ввод штрих-кода вручную,
  • 1 – разрешить ввод штрих-кода вручную.
По умолчанию 1

enablebarcodescanner

числовой(1)

Разрешить ввод штрих-кода сканером:

  • 0 – запретить ввод штрих-кода сканером,
  • 1 – разрешить ввод штрих-кода сканером.
По умолчанию 1
visualverifyчисловой(1)

Визуальный контроль товара:

  • 0 – не нужен визуальный контроль товара,
  • 1 – нужен визуальный контроль товара.
По умолчанию 0
ageverifyчисловой(1)

Контроль возраста покупателя:

  • 0 – не нужен контроль возраста покупателя,
  • 1 – нужен контроль возраста покупателя.
По умолчанию 0
requiresalerestrictчисловой(1)

Проверять ограничения продаж для товара:

  • 0 – не проверять ограничения продаж для товара,
  • 1 – проверять ограничения продаж для товара.
По умолчанию 0
egaisverifyчисловой(1)

Проверять алкогольный товар с акцизной маркой в ЕГАИС:

  • 0 – не проверять алкогольный товар с акцизной маркой в ЕГАИС,
  • 1 – проверять алкогольный товар с акцизной маркой в ЕГАИС.

Параметр является обязательным для алкогольной продукции с акцизной маркой.

По умолчанию 0

prepackagedчисловой(1)

Является ли товар расфасованным:

  • 0 – товар не является расфасованным,
  • 1 – товар является расфасованным.
По умолчанию 0
nopdfegaisverifyчисловой(1)

Проверять алкогольный товар без акцизной марки в ЕГАИС:  

  • 0 – не проверять алкогольный товар без акцизной марки в ЕГАИС,
  • 1 – проверять алкогольный товар без акцизной марки в ЕГАИС.

Параметр является обязательным для алкогольной продукции без акцизной марки. 

По умолчанию 0.

alcoset

числовой(1)

Является ли товар алкогольным набором:

  • 0 – товар не является алкогольным набором,
  • 1 – товар является алкогольным набором.
По умолчанию 0

freesale

числовой(1)

Является ли товар товаром по свободной цене:

  • 0 – товар не является товаром по свободной цене,
  • 1 – товар является товаром по свободной цене.
По умолчанию 0
rfidverifyчисловой(1)

Является ли товар меховым изделием:

  • 0 – товар не является меховым изделием,
  • 1 – товар является меховым изделием.
По умолчанию 0
lowweightчисловой(1)

Является ли товар легким товаром:

  • 0 – товар не является легким товаром,
  • 1 – товар является легким товаром.
По умолчанию 0
weightcontrolbypassчисловой(1)

Является ли товар товаром без контроля веса:

  • 0 – товар не является товаром без контроля веса,
  • 1 – товар является товаром без контроля веса.
По умолчанию 0
tobaccoчисловой(1)

Является ли товар табачной продукцией:

  • 0 – товар не является табачной продукцией,
  • 1 – товар является табачной продукцией.
По умолчанию 0
shoesчисловой(1)

Является ли товар обувью:

  • 0 – товар не является обувью,
  • 1 – товар является обувью.
По умолчанию 0
fuzzyweightчисловой(1)

Товар с неточным контрольным весом:

  • 0 – запрещено значительное отклонение от контрольного веса,
  • 1 – разрешено значительное отклонение от контрольного веса.
По умолчанию 0
ignoremarkingчисловой(1)

Игнорирование признака маркировки:

  • 0 – признак маркировки не игнорируется,
  • 1 – признак маркировки игнорируется.
По умолчанию 0
markdownverifyчисловой(1)

Является ли товар уцененным:

  • 0 – товар не является уцененным,
  • 1 – товар является уцененным.
По умолчанию 0
Пример
{
  "command": "addInventItem",
  "invent": {
    "inventcode": "7473",
    "deptcode": 1,
	"price": 68.5,
    "minretailprice": 65.5,
	"remain": 0.0,
    "remaindate":"2011-08-08T15:45:10",
    "barcode": "2400000074731",
    "discautoscheme": "",
    "articul": "0",
    "age": 16,
    "alcoholpercent": 10,
    "inventgroup": "7957",
    "taxgroupcode": 0,
    "measurecode": 2,
    "alctypecode": 520,
    "paymentobject": 2,
    "opmode": 0,
    "sellrestrictperiods":[
        {
            "dateend": "2015-01-01",
            "datestart": "2014-01-01",
            "dayend" : "7",
            "daystart": "1",
            "timeend": "01:00:00",
            "timestart": "22:00:00"
        },
        {
            "dateend": "2015-01-01",
            "datestart": "2014-01-01",
            "dayend" : "7",
            "daystart": "1",
            "timeend": "09:00:00",
            "timestart": "02:00:00"
        }
    ],
    "barcodes": [
      {
        "price": 68.5,
        "minprice": 60.5,
        "barcode": "0000000000006",
        "additionalprices": [],
        "cquant": 1.0,
        "name": "Автошампунь \"Люкс\"",
        "measurecode": 1,
        "customsdeclarationnumber": "10226010/090617/0003344",
        "tmctype": 5,
        "ntin": "00809002001012007",
		"packagecode": "1234567890"       
	  },
      {
        "price": 685.0,
        "barcode": "0000000000007",
        "additionalprices": [
          {
            "pricecode": 4,
            "price": 1.75,
            "name": ""
          }
        ],
        "cquant": 10.0,
        "name": "Автошампунь \"Люкс\":уп.",
        "measurecode": 1
      }
    ],
    "name": "Автошампунь \"Люкс\"",
	"minprice": 68.5,
	"additionalprices": [
      {
        "pricecode": 1,
        "price": 65.4800033569336,
        "name": ""
       },
      {
        "pricecode": 2,
        "price": 64.12999725341797,
        "name": ""
      },
      {
        "pricecode": 3,
        "price": 62.779998779296875,
        "name": ""
      },
      {
        "pricecode": 4,
        "price": 60.75,
        "name": ""
      }
    ],
    "options": {
            "quantityoptions" : {
            "enabledefaultquantity" : "",
            "enablequantitylimit" : "",
            "quantitylimit" : "",
            "enablequantityscales" : "",
            "enablequantitybarcode" : "",
            "enablequantitymanual" : "",
            "requirequantitymanual" : "",
            "requirequantitybarcode" : "",
            "requirequantityscales" : "",
			"autogetquantityfromscales" : ""
             "documentquantlimit : ""
	    },
          "priceoptions" : {
          "requireselectprice": 1,
          "requirepricemanual" : 0,
          "enablepricemanual" : 0,
          "requiredeferredprice" : 0,
          "enableexcisemarkprice": 0
        },
        "inventitemoptions" : {
           "enabledepartmentmanual": "",
           "requiredepartmentmanual": "",
           "disablebackinsale": 1,
           "disableinventsale": "",
           "disableinventback": "",
           "disableinventshow": "",
           "enablebarcodescanner": "",
           "enablebarcodemanual": "",
           "visualverify": 1,
           "ageverify": 1,
           "requiresalerestrict": 1,
           "rfidverify": 1,
           "lowweight": 0,
           "weightcontrolbypass": 0,
           "tobacco": 0,
           "shoes": 0,
		   "fuzzyweight": 0,
           "ignoremarking": 0,
		   "markdownverify": 0
        }}}}
---
  • No labels