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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(Новая страница: «===Объект=== * ИдИС * - идентификатор номенклатуры в ИС * Код - код номенклатуры * Название - на…»)
 
 
(не показано 68 промежуточных версий 8 участников)
Строка 1: Строка 1:
 
===Объект===
 
===Объект===
* ИдИС * - идентификатор номенклатуры в ИС
+
* ИдИС* идентификатор номенклатуры в ИС
* Код - код номенклатуры
+
* Код код номенклатуры
* Название - название номенклатуры
+
* Артикул — артикул номенклатуры
* НазваниеПолное - полное название номенклатуры
+
* Название название номенклатуры
* ТипНоменклатуры_ИдИС - идентификатор типа номенклатуры в ИС
+
* НазваниеПолное - полное название номенклатуры
* ЕдиницаИзмерения_ИдИС - идентификатор единицы измерения в ИС
+
* Тип* — объект [[ТипНоменклатуры_-_API3_Объект|Тип номенклатуры]]
* СтавкаНДС - ставка ндс
+
* Маркировка — число (0 — табак, 1 — обувь, 2 — легкая промышленность, 3 — шины, 4 — лекарства, 5 — духи, 6 — фотокамеры, 7 — велосипеды, 8 — кресла-коляски, 9 — молочная продукция, 10 — вода)
 
+
* ЕдИзм* — объект [[ЕдиницаИзмерения_-_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_Объект|Единица измерения]] размера
 +
** ЕдИзмВеса — объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]] веса
 +
* СтавкаНДС* — объект [[!СтавкаНДС_-_API3_Объект|СтавкаНДС]]
 +
* ЭтоГруппа — признак группы
 +
* Родитель* — объект [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
* Изображения — массив объектов
 +
** ИмяФайла — имя файла изображения
 +
** ДвоичныеДанные — строка с двоичными данными (base64)
 +
** Основное — булево, признак основного изображения
 +
* Цены — массив объектов
 +
** ВидЦены* — объект [[ВидЦены_-_API3_Объект|Вид цены]]
 +
** Цена — значение цены
 +
** Дата — дата, c которой действует цена
 +
* Коды — массив объектов
 +
** ТипКода — объект [[ТипКода_-_API3_Объект|Тип кода]]
 +
** Код — код
 +
** ЕдИзм — объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]] если не указан, то идентифицирует экземпляр в основных единицах измерения
 +
* Параметры — массив именованных параметров ключ / значение
 +
** Название
 +
** Значение
 +
* СоставНа — количество номенклатуры на которую рассчитаны составы
 +
* Составы — массив объектов (наборы составов)
 +
** Название — название состава номенклатуры
 +
** ДатаНач — дата начала действия состава (дд.мм.гггг), строка
 +
** ДатаКнц — дата окончания действия состава (дд.мм.гггг), строка
 +
** Состав — массив объектов (наборы ингредиентов/материалов)
 +
*** Номенклатура* — объект [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
*** Количество — количество
 +
*** КоличествоНетто — количество нетто
 +
*** КоличествоБрутто — количество брутто
 +
*** КоличествоВыход — количество выхода готовой продукции
 +
*** ЕдИзм* - объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]]
 +
* Модификаторы — массив объектов
 +
** Минимум — минимальное количество
 +
** Максимум — максимальное количество
 +
** Количество — количество по-умолчанию
 +
** Номенклатура* — объект [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
** ЭтоГруппа* — признак группы, булево
 +
** Родитель — объект [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
* Упаковки — массив объектов
 +
** Название — название упаковки, строка
 +
** Количество — количество базовых единиц в упаковке, число
 +
* Опубликована — число, 1 — продается, но не опубликована, 2 — не продается, 3 — опубликована
 +
* ПараметрыЗапасов — массив объектов
 +
** Организация — объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
 +
** Склад — объект [[Склад_-_API3_Объект|Склад]]
 +
** ПериодДоставки — срок доставки в днях, число
 +
** ПериодЗакупки — срок закупки в днях, число
 +
** МинЗапас — минимальный запас на складе, число
 +
** МаксЗапас — максимальный запас на складе, число
 +
** СкоростьПродаж — средний расход, число
  
 
'''Пример:'''
 
'''Пример:'''
Строка 14: Строка 81:
 
{
 
{
 
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
 
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "Код": "00000000008"
+
   "Код": "00000000008",
 +
  "Артикул": "КР-8",
 
   "Название": "Креветка",
 
   "Название": "Креветка",
 
   "НазваниеПолное":"Креветка Атлантическая",
 
   "НазваниеПолное":"Креветка Атлантическая",
   "ТипНоменклатуры_ИдИС": "34165sg-28c9-11e7-a6d9-2342",
+
   "Тип": {"ИдИС": "34165sg-28c9-11e7-a6d9-2342"},
   "ЕдиницаИзмерения_ИдИС": "23fge34-28c9-11e7-a6d9-23434",
+
   "ЕдИзм": { "ИдИС": "23fge34-28c9-11e7-a6d9-23434"},
 
   "СтавкаНДС": "18",
 
   "СтавкаНДС": "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"
 +
  }]
 
}
 
}
 
</source>
 
</source>
  
 +
===Алгоритм поиска и обновлении номенклатуры===
 +
Сначала ищем по коду, если не находим ищем по полному совпадению названия среди номенклатуры с пустым кодом.
 +
Если не находим с пустым кодом, то создаем новую номенклатуру СБИС.
  
 
===Естественные ключи===
 
===Естественные ключи===
* Ключ1 - не используется(вес = 3)
+
* Ключ1 - Код (вес = 3)
** Ключ1_1 - не используется
+
** Ключ1_1 — Код
** Ключ1_2 - не используется
+
** Ключ1_2 не используется
** Ключ1_3 - не используется
+
** Ключ1_3 не используется
* Ключ2 - не используется
+
* Ключ2 не используется
* Ключ3 - не используется
+
* Ключ3 — внешний идентификатор
 +
* Название — ИСПОЛЬЗУЕТСЯ
  
 
===Зависит от объектов===
 
===Зависит от объектов===
 +
* [[ТипНоменклатуры_-_API3_Объект|ТипНоменклатуры]]
 +
* [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 +
* [[ВидЦены_-_API3_Объект|ВидЦены]]
 +
* [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
 +
* [[Склад_-_API3_Объект|Склад]]
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===
 +
* Номенклатура.Прочитать
 +
* Номенклатура.ПолучитьПоКоду
 +
* Номенклатура.CustomizableList
 +
* Номенклатура.Создать
 +
* Номенклатура.Записать
 +
* Warehouse.GetTechnicalWarehouseList
 +
* MinMaxStocksTable.BatchUpsert
  
 
[[Категория:SBIS API3 Объект]]
 
[[Категория:SBIS API3 Объект]]

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

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

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

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

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

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

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

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