Номенклатура - 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
   }],
   "Пометки": {"Удален": 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
• Номенклатура.Создать
• Номенклатура.Записать