Команда addInventItem

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

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

Свойство

Тип данных

Описание

Примечания

inventcode

строковый

Код товара


inventgroup

строковый

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


name

строковый

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


barcode

строковый

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

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

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

barcodes

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

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


price

вещественный

Цена

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

minprice

вещественный

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

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

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

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


options

объект

Опции товара


sellrestrictperiods

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

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


extendetoptions

текст

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

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

discautoscheme

числовой

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


deptcode

числовой

Код отдела


lvatcode

массив целых чисел

Коды налогов

Задает значения полей vatcode1, vatcode2, vatcode3, vatcode4, vatcode5 в БД Dictionaries в таблице Tmc

Пример добавления объекта содержащего коды налогов
{
  "command": "addInventItem",
  "invent": {
    ...
    "lvatcode": [301],
    ...
  }
}
---

taxgroupcode

числовой

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

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

Переопределяет значение поля lvatcode

measurecode

числовой

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


remain

вещественный

Остаток


remaindate

дата и время

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


articul

строковый

Артикул


defaultquantity

вещественный

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


taramode

числовой

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


taracapacity

вещественный

Емкость тары


taraflag

числовой

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

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

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

aspectschemecode

числовой

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


aspectvaluesetcode

числовой

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


aspectusecase

числовой

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


aspectselectionrule

числовой

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


age

числовой

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

cquant

вещественный

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


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

manufacturercountrycode

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

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

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

Используется, если не заданы опции товара (свойство inventitemoptions).

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

loyaltymodeчисловой

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

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

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

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

Свойство

Тип данных

Описание

Примечания
additionalprices

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

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


aspectvaluesetcode

числовой

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


barcode

строковый

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


cquant

вещественный

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


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

name

строковый

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


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

price

вещественный

Цена товара

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

строковый

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

tmctype

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

ntinстроковыйКод национального классификатора товаров
packagecodeстроковыйКод упаковки
trucodeстроковыйКод ТРУ

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

Свойство

Тип данных

Описание

pricecode

числовой

Код цены

price

вещественный

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

name

строковый

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

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

Свойство

Тип данных

Описание

dateend

дата

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

datestart

дата

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

dayend

числовой

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

daystart

числовой

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

timeend

время

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

timestart

время

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

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

Свойство

Тип данных

Описание

inventitemoptions

объект

Опции товара

priceoptions

объект

Опции цены

quantityoptions

объект

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

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

Свойство

Тип данных

Описание

Примечания

enabledefaultquantity

числовой

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

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

enablequantitylimit

числовой

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

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

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

quantitylimit

вещественный

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


enablequantityscales

числовой

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

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

enablequantitybarcode

числовой

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

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

enablequantitymanual

числовой

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

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

requirequantitymanual

числовой

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

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

requirequantitybarcode

числовой

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

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

requirequantityscales

числовой

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

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

enabledocumentquantitylimit

числовой

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

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

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

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

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

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

documentquantlimit

вещественный

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


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

Свойство

Тип данных

Описание

Примечания

enablepricemanual

числовой

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

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

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

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

requireselectprice

числовой

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

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

requiredeferredprice

числовой

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

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

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

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

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

Свойство

Тип данных

Описание

Примечания

disablebackinsale

числовой

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

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

disableinventshow

числовой

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

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

disableinventsale

числовой

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

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

disableinventback

числовой

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

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

requiredepartmentmanual

числовой

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

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

enabledepartmentmanual

числовой

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

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

enablebarcodemanual

числовой

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

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

enablebarcodescanner

числовой

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

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

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

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

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

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

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

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

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

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

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

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

prepackagedчисловой

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

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

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

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

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

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

alcoset

числовой

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

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

freesale

числовой

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Блокировать проверку в рамках разрешительного режима:

  • 0 – нет,
  • 1 – да.
По умолчанию 0
doublemarkedчисловой

Товар маркирован дважды (унифицированным контрольным знаком и средством идентификации):

  • 0 – товар не маркирован дважды,
  • 1 – товар маркирован дважды.
По умолчанию 0
ukzчисловой

Товар маркирован только унифицированным контрольным знаком

  • 0 – товар не маркирован УКЗ,
  • 1 – товар маркирован только УКЗ.
По умолчанию 0
dispensebyprescriptionчисловой

Продажа товара по рецепту или требованию:

  • 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,
           "ignorecrptverify": 0,
           "doublemarked": 0,
           "ukz": 1,
           "dispensebyprescription": 1
       }
     }
   }
}
---
  • No labels