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

Объект

Тип: Справочник

Легенда:

• Реквизиты черного цвета поддерживаются синхронизацией в обоих направлениях
• Реквизиты зеленого цвета поддерживаются синхронизацией только в СБИС
• Реквизиты красного цвета поддерживаются синхронизацией только из СБИС

• Артикул — строка, артикул номенклатуры
• ВнешниеКоды — массив, соответствие внешних идентификаторов номенклатуры интеграциям

• Код — строка, идентификатор номенклатуры
• Интеграция — строка, идентификатор интеграции

• ЕдИзм* — объект Единица измерения, основная единица изменения
• Изображения — массив, вложенные изображения

• ИмяФайла — строка, имя файла изображения
• ДвоичныеДанные — строка, двоичные данные (base64)
• Основное — булево, признак основного изображения

• Код — строка, основной код номенклатуры
• Коды — массив, информвция о штрихкодах

• ТипКода — объект Тип кода, тип кода
• Код — строка, код номенклатуры
• ЕдИзм — объект Единица измерения, если не указан, то идентифицирует экземпляр в основных единицах измерения

• Комментарий — строка, текстовое описание номенклатуры
• Маркировка — число строкой (0 — табак, 1 — обувь, 2 — легкая промышленность, 3 — шины, 4 — лекарства, 5 — духи, 6 — фотокамеры, 7 — велосипеды, 8 — кресла-коляски, 9 — молочная продукция, 10 — вода)
• Модификаторы — массив, информация о модификаторах

• Минимум — число строкой, минимальное количество
• Максимум — число строкой, максимальное количество
• Количество — число строкой, количество по умолчанию
• Номенклатура* — объект Номенклатура
• ЭтоГруппа* — булево, признак группы
• Родитель — объект Номенклатура

• Название — строка, название номенклатуры
• НазваниеКраткое — строка, полное краткое номенклатуры
• НазваниеПолное — строка, полное название номенклатуры
• Опубликована — число строкой, 1 — продается, но не опубликована, 2 — не продается, 3 — опубликована
• Параметры — массив, именованные параметры ключ/значение

• Название — строка, название параметра
• Значение — строка, значение параметра

• ПараметрыЗапасов — массив, информация о параметрах запасов

• Организация — объект НашаОрганизация
• Склад — объект Склад
• ПериодДоставки — число строкой, срок доставки в днях
• ПериодЗакупки — число строкой, срок закупки в днях
• МинЗапас — число строкой, минимальный запас на складе
• МаксЗапас — число строкой, максимальный запас на складе
• СкоростьПродаж — число строкой, средний расход

• Родитель — объект Номенклатура, группа номенклатуры
• СоставНа — число строкой, количество номенклатуры на которую рассчитаны составы
• Составы — массив, наборы составов

• Название — строка, название состава номенклатуры
• ДатаНач — строка в формате "дд.мм.гггг", дата начала действия состава
• ДатаКнц — строка в формате "дд.мм.гггг",дата окончания действия состава
• Состав — массив, наборы ингредиентов/материалов

• Номенклатура* — объект Номенклатура
• Количество — число строкой, количество
• КоличествоНетто — число строкой, количество нетто
• КоличествоБрутто — число строкой, количество брутто
• КоличествоВыход — число строкой, количество выхода готовой продукции
• ЕдИзм* - объект Единица измерения

• СписокЕдИзм — массив, альтернативный способ описания доступных единиц измерения

• ЕдИзм* — объект Единица измерения
• Коэффициент — число строкой, коэффициент пересчета к основной ЕдИзм
• Ширина — число строкой, ширина
• Высота — число строкой, высота
• Длина — число строкой, длина
• Брутто — число строкой, вес брутто
• Нетто — число строкой, вес нетто
• Объем — число строкой, объем
• ПоУмолчанию — булево, признак основной единицы измерения
• ЕдИзмРазмера — объект Единица измерения, единица измерения размера
• ЕдИзмВеса — объект Единица измерения, единица измерения веса

• СтавкаНДС — объект СтавкаНДС, ставка НДС номенклатуры
• Страна — объект Страна, страна происхождения номенклатуры
• Тип* — объект Тип номенклатуры, тип номенклатуры
• Удалён — булево, признак перемещения объекта в удаленные
• Упаковки — массив, информация о упаковках

• Название — строка, название упаковки
• Количество — число строкой, количество базовых единиц в упаковке

• УчетныеХарактеристики - массив, информация о учетных характеристиках

• Идентификатор - строка
• Название - строка
• Список - строка
• Тип - строка

• Цены — массив, информация ценах номенклатуры
  • ВидЦены — объект Вид цены, при отсутствии пишем Базовую цену, иначе цену в Прайсе
  • Цена — число строкой, значение цены
  • Дата — строка в формате "дд.мм.гггг", дата c которой действует цена
• ЭтоГруппа — булево, признак группы

Пример:

{
   "ИдИС": "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"
         }
      }]
   }],
   "ПараметрыЗапасов": [{
      "Организация": {
         "ИдСБИС": "932"
      },
      "Склад": {
         "ИдСБИС": "332"
      },
      "ПериодДоставки": "15",
      "ПериодЗакупки": "30",
      "МинЗапас": "500",
      "МаксЗапас": "10000",
      "СкоростьПродаж": "25"
   }]
}

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

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

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

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

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

• ТипНоменклатуры
• ЕдиницаИзмерения
• ВидЦены
• НашаОрганизация
• Склад

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

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