Номенклатура - API3 Объект — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
Строка 9: Строка 9:
 
* ЕдИзм * - объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]] основная единица изменения
 
* ЕдИзм * - объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]] основная единица изменения
 
* Комментарий - текстовое описание Номенклатуры
 
* Комментарий - текстовое описание Номенклатуры
 +
<div class="mw-collapsible mw-collapsed">
 +
* <span style="color:#E70000">Пометки</span> — пометки по объекту
 +
<div class="mw-collapsible-content">
 +
:* <span style="color:#E70000">Удалён</span> — Признак перемещения объекта в удаленные, булево
 +
</div></div>
 
* СписокЕдИзм - массив объектов. Альтернативный способ описания доступных единиц измерения.
 
* СписокЕдИзм - массив объектов. Альтернативный способ описания доступных единиц измерения.
 
** ЕдИзм * - объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]]
 
** ЕдИзм * - объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]]
Строка 78: Строка 83:
 
       "Основное": true
 
       "Основное": true
 
   }],
 
   }],
 +
  "Пометки": {"Удален": true},
 
   "Цены": [{
 
   "Цены": [{
 
       "Цена": 2500,
 
       "Цена": 2500,

Версия 15:06, 2 августа 2024

Объект

  • ИдИС * - идентификатор номенклатуры в ИС
  • Код - код номенклатуры
  • Артикул - артикул номенклатуры
  • Название - название номенклатуры
  • НазваниеПолное - полное название номенклатуры
  • Тип * - объект Тип номенклатуры
  • Маркировка - число (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
  • Номенклатура.Создать
  • Номенклатура.Записать