Номенклатура - API3 Объект

Объект

• ИдИС * - идентификатор номенклатуры в ИС
• Код - код номенклатуры
• Артикул - артикул номенклатуры
• Название - название номенклатуры
• НазваниеПолное - полное название номенклатуры
• Тип * - объект Тип номенклатуры
• Маркировка - число (0-табак, 1-обувь, 2-легкая промышленность, 3-шины, 4-лекарства, 5-духи, 6-фотокамеры, 7-велосипеды, 8-кресла-коляски, 9-молочная продукция, 10-вода)
• ЕдИзм * - объект Единица измерения основная единица изменения
• Комментарий - текстовое описание Номенклатуры
• СписокЕдИзм - массив объектов. Альтернативный способ описания доступных единиц измерения.
  • ЕдИзм * - объект Единица измерения
  • Коэффициент - коэффициент пересчета к основной ЕдИзм
  • Ширина
  • Высота
  • Длина
  • Брутто
  • Нетто
  • Объем
  • ПоУмолчанию - булево - признак какая единица измерения является основной
  • ЕдИзмРазмера - объект Единица измерения размера
  • ЕдИзмВеса - объект Единица измерения веса
• СтавкаНДС* - объект СтавкаНДС
• ЭтоГруппа - признак группы
• Родитель * - объект Номенклатура
• Изображения - массив объектов
  • ИмяФайла - имя файла изображения
  • ДвоичныеДанные - строка с двоичными данными (base64)
  • Основное - булево, признак основного изображения
• Цены - массив объектов
  • ВидЦены* - объект Вид цены
  • Цена - значение цены
  • Дата - дата, c которой действует цена
• Коды - массив объектов
  • ТипКода - объект Тип кода
  • Код - код
  • ЕдИзм - объект Единица измерения если не указан, то идентифицирует экземпляр в основных единицах измерения
• Параметры - массив именованных параметров ключ / значение
  • Название
  • Значение
• СоставНа - количество номенклатуры на которую рассчитаны составы
• Составы - массив объектов (наборы составов)
  • Название - название состава номенклатуры
  • ДатаНач - дата начала действия состава (дд.мм.гггг), строка
  • ДатаКнц - дата окончания действия состава (дд.мм.гггг), строка
  • Состав - массив объектов (наборы ингредиентов/материалов)
    • Номенклатура * - объект Номенклатура
    • Количество - количество
    • КоличествоНетто - количество нетто
    • КоличествоБрутто - количество брутто
    • КоличествоВыход - количество выхода готовой продукции
    • ЕдИзм * - объект Единица измерения
• Модификаторы - массив объектов
  • Минимум - минимальное количество
  • Максимум - максимальное количество
  • Количество - количество по-умолчанию
  • Номенклатура - объект Номенклатура
• Опубликована - число, 1 - продается, но не опубликована, 2 - не продается, 3 - опубликована

Пример:

{
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "Код": "00000000008",
   "Артикул": "КР-8",
   "Название": "Креветка",
   "НазваниеПолное":"Креветка Атлантическая",
   "Тип": {"ИдИС": "34165sg-28c9-11e7-a6d9-2342"},
   "ЕдИзм": { "ИдИС": "23fge34-28c9-11e7-a6d9-23434"},
   "СтавкаНДС": "18",
   "ЭтоГруппа": false,
   "Родитель": {"ИдИС": "b905808c-e133-11d8-937c-000d884f5d5e"},
   "СтавкаНДС": {"ИдИС": "b905808c-e133-11d8-937c-000d884f5d5b"},
   "Изображения": [{
      "ИмяФайла": "foto.jpg", 
      "ДвоичныеДанные": "textbase64==",
      "Основное": true
   }],
   "Цены": [{
      "Цена": 2500,
      "ВидЦены": {"ИдИС": "38640fa5-e0a5-11d8-937b-000d884f5d5e"},
      "Дата": "28.10.2018"
   }],
   "Коды": [{
      "ТипКода": {"ИдИС": "38640fa5-e0a5-11d8-937b-000d884f5f5e"},
      "Код": "2000020647979"
   }],
   "Параметры": [{
      "Название": "Место производства",
      "Значение": "Россия"
      },{
      "Название": "accessory_type",
      "Значение": "чехол"
   }],
   "Составы": [{
      "Название": "Основной",
      "Состав": [{
         "Номенклатура": {
            "ИдСБИС": "1674"
         },
         "Количество": 1,
         "ЕдИзм": {
            "ИдСБИС": "796"
         }
      }]
   }]
}

Алгоритм поиска и обновлении номенклатуры

Сначала ищем по коду, если не находим ищем по полному совпадению названия среди номенклатуры с пустым кодом. Если не находим с пустым кодом, то создаем новую номенклатуру СБИС.

Естественные ключи

• Ключ1 - Код (вес = 3)
  • Ключ1_1 - Код
  • Ключ1_2 - не используется
  • Ключ1_3 - не используется
• Ключ2 - не используется
• Ключ3 - внешний идентификатор
• Название - ИСПОЛЬЗУЕТСЯ

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

• Тип номенклатуры
• Единица измерения
• Вид цены

Используемые методы БЛ

• Номенклатура.Прочитать
• Номенклатура.ПолучитьПоКоду
• Номенклатура.CustomizableList
• Номенклатура.Создать
• Номенклатура.Записать