Номенклатура - API3 Объект — различия между версиями
(Новая страница: «===Объект=== * ИдИС * - идентификатор номенклатуры в ИС * Код - код номенклатуры * Название - на…») |
|||
(не показано 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"}, |
− | " | + | "ЕдИзм": { "ИдИС": "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 - | + | * Ключ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