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

Объект

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

Легенда:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:

{
    "Артикул": "1234567890",
    "ВнешниеКоды": [
        {
            "Код": "c874808c-e133-11d8-937c-000d884f4859",
            "Интеграция": "b905808c-e133-11d8-937c-000d884f5d5e"
        }
    ],
    "ЕдИзм": {"ИдСБИС": "796"},
    "Изображения": [
        {
            "ИмяФайла": "product.jpg",
            "ДвоичныеДанные": "iVBORw0KGgoAAAANSUhEUgAAAQQAAAC0CAIAAAD918WcAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAARASURBVHhe7d2hUhtfH4DhSGRnaiK5hEokshKJrKzsHSCRlUguARmJRCIrkZGVlf3vsC+ZZPio+eBkxfMo9qRlmbO/d1gggdVf4JkYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYIGKAiAEiBogYstlsTk9PV+9tep+Xl5c3Nze/fv3aP9Hk9vZ2XmEhxJBpOpvfD7Ner6cwPn/+PB+enJx0bpZBDLm+vp5ndKTzPd+/f786NH0Oud/z8PDQx8rHEMPHenx8/Pnz58XFxadPnyrgqNye/YMYxtmF0WAeiduzt4jhCJrK1aoboGdTJ90evej+6cWXL1/6b/+f6X6sj4NDYjiCpnJl85fF9TiCUhDDwrgeR1AKYlgY1+MISkEMC+N6jPb09DSXcHp62hLLIIbRHh4e5hjOzs5aYhnEMNrd3d0cw8XFRUssgxhGu729nWPw/f6lEcNoV1dXcwzTGy2xDGIYbfqEMMfgOUJLI4bRds9N2mw2LbEMYhjt7OxsjuHx8bEllkEMo+1eRbTdbltiGcQw2i6GjlkMl2S03at8OmYxXJLR5hImHbMYLslopTAwht3v47i5uWmJ/0UMo5XCwBjW63WnXK2ur69b5RUxjNZUjophu912vmdeAP0PYhitqRwVw48fPzrfix7gFVszWiM5aij375FmPcArtma0RnLUUHayPT3AK7ZmtEZyyFDuniG7r8d4xdaM1kh+8FD+/v17/6uFy8vL3hLD22zNaI3kRw7lZrPZ/22WX79+/fPnz8nJyXz49PTUv+OQGEabJ3LS8Xvbbre7uZ/MJUzr5+fn84rXUbxFDKPNEznp+F3NP2ye3/96vd6f+93XD9++fWuJQ2IYbZ7IScfvav8bqXd3d60+u7+/n9enWlrikBhGmydy0vG72t0gTXdHLb2YbpbmhyYtcci+jNY8fsxEzn9y5a3fuzGfd9Ixh+zLaM3jMSayE4vhDfZltOZRDMtjX0ZrHsWwPPZltOZRDMtjX0ZrHsWwPPZltOZRDMtjX0ZrHsWwPPZltN3Pxca/HHl36o45ZF9G2z2zehrNlkb594/kEMNonhaxWK7HEbhdWSbX4wjcriyTGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBIgaIGCBigIgBnv39+x/o4MxkiZxdcAAAAABJRU5ErkJggg==",
            "Основное": True,
        },
        {
            "ИмяФайла": "bird.jpg",
            "ДвоичныеДанные": "iVBORw0KGgoAAAANSUhEUgAAAQQAAAC0CAIAAAD918WcAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAU7SURBVHhe7d0xUxNpAMfheBV0dmIXu3RqR6d2lLR22sVOO1NFK+jUCjr1E0CHMxbCJyB2lHRo4WgHXe6d7H92cgxw3pgsy/E8RXx3E8AJ++PdDdnlxng87gCdzl/5F649MUCIAUIMEGKAEAOEGCDEACEGCDFAiAFCDBBigBADhBggxAAhBggxQIgBQgwQYoAQA4QYIMQAIQYIMUCIAUIMEGKAEAOEGCDEACEGCDFAiAFCDBBigBADhBggxAAhBggxQIgBQgwQYoAQA4QYIMQAIQYIMUCIAUIMEGKAEAOEGCDEACGG+PTp0507d27MWvmcjx8/3tzcPDg4mP5CxYcPH6o1tMSN8Xic4fVWts7Dw8MszMfS0tLDhw8/f/7848ePsriwsHB8fFzdRRuIIdbX1weDQRaaUtrIqNPp9Xq3bt3KwsTy8nIJJguTeMqaLDAHYpiv0Wi0u7u7t7dXbn/9+pW1l6fb7Q6HwydPnmSZKWJoTh3G9vZ2Vl0Gu2fnEcMlKAfW1eDLly/VoCipnJo6SjYZTZR7y2Oy8Af6/f7GxkYWmCKGS1DH4MlvFS+tQogBQgwQYmha/au9brdbDWgJMTTt27dv1WBpaaka0BJiaJoYWksMTat/mSCGthFD0+pjhlPvROLSiaFp379/rwYOoNtGDE1zzNBaYmiaGFpLDE0TQ2uJ4dKIoW3E0LQ2nOLDmcTQtCZjGI1GL168ePTo0WAwODk5yVrO4XyGpjVwMkPp7e3btx8/fpy+xEGv13v//r2zqC8ghqbNNYYqg3fv3p03/6ytrb18+TILnFK+JTQpz/usn/mfP38Oh8ObN2/ms0+UY/R+v//mzZvp9eVh+Rj+SQxNyyY5uxjOzKDb7ZadojxiPD46Opq+LI0eziSGpmV7nFEMOzs7F2dQOz4+XllZyYP0cBYxNC0b4yxiKD/vp68ydl4GtVM97O/v5w4mxNC0bImziKEcD1SfqhwbXJxBrfRQ7y+trq5mLRNeTWrarF5N2tzcfPbsWTXe2toqW3Y1/lej0ej+/fvV2Hd/mhiaNqsYbt++Xb3Nqez5lCOHauVvcuGmM/kN9FVVv+Hv4ODA1e1nwszQtFn9VF5cXKzfYfFfL59qZjiTmeGqGg6HGXU6rqo9E2aGprXhp7KZ4UxmBggxQIgBQgwQYoAQw7Uzk7+F9b8khuvl5OTk6dOn1Xj6DAcKMVwvr1+/rmaGhYUFf+bwFDE0rT4DYX19vRo05tWrV/UXHQ6HvV6vGhNjmvX8+fPqmS9VZNX87ezsTF/neGVlJXcwxdsxmlb22hcXF6txY09+/X7vopSwtbU1fYrctLITdXh4WG6/fv1ajXPHOUpjy8vLDx48KEcgV36qmSRBo+oNMcvzdGpOuMCpc6n/UPmiZQ48OjrK/+MqEMMlWFtbK5tLv9/P8jz9ZglzUrK/QknYTfqfK0fMg8EgC7/h3r17pZ+7d+9Wg3KbO85RdqV2d3f39vbK7XlXLitJbGxstP995mJgLra3t+uXcSvt39K8tMpcrK6u7u/vlyP1am75/esVXCIzA4SZAUIMEGKAEAOEGCDEACEGCDFAiAFCDBBigBADhBggxAAhBggxQIgBQgwQYoAQA4QYIMQAIQYIMUCIAUIMEGKAEAOEGCDEACEGCDFAiAFCDBBigBADhBggxAAhBggxQIgBQgwQYoAQA4QYIMQAIQYIMUCIAUIMEGKAEAOEGCDEACEGCDFAiAFCDBBigBADhBggxAAhBggxQIgBQgwQYoAQA4QYIMQAIQaY6HT+BmyCuxy/03rhAAAAAElFTkSuQmCC",
            "Основное": False,
        }
    ],
    "Код": "0000-000001",
    "Коды": [
        {
            "ТипКода": "13",
            "Код": "4612345678912",
            "ЕдИзм": {"ИдСБИС": "796"}
        }
    ],
    "Комментарий": "Сценарий full_case",
    "Маркировка": "10",
    "Модификаторы": [
        {
            "Минимум": "10",
            "Максимум": "30",
            "Количество": "20",
            "Номенклатура": {"ИдСБИС": "6"},
            "ЭтоГруппа": False,
            "Родитель ": {"ИдСБИС": "7"}
        }
    ],
    "Название": "Кейс full_case, вер. 1",
    "НазваниеКраткое": "full_case, v.1",
    "НазваниеПолное": "Кейс full_case, версия 1",
    "Параметры": [ ХЗ где их взять
        {
            "Название": "accessory_type",
            "Значение": "чехол"
        }
    ],
    "ПараметрыЗапасов": [
        {
            "Организация": {"ИдСБИС": "258"},
            "Склад": {"ИдСБИС": "260"},
            "ПериодДоставки": "3",
            "ПериодЗакупки": "2",
            "МинЗапас": "10",
            "МаксЗапас": "100",
            "СкоростьПродаж": "2"
        }
    ],
    "Родитель": {"ИдСБИС": "9"},
    "СоставНа": "5",
    "Составы": [
        {
            "Название": "Тестовый состав, версия 1",
            "ДатаНач": "01.01.2025",
            "ДатаКнц": "31.12.2050",
            "Состав": [
                {
                    "Номенклатура": {"ИдСБИС": ""},
                    "Количество": "20",
                    "КоличествоНетто": "20",
                    "КоличествоБрутто": "40",
                    "КоличествоВыход": "1",
                    "ЕдИзм": {"ИдСБИС": "796"}
                }
            ]
        }
    ],
    "СтавкаНДС": {"ИдСБИС": "1"},
    "Тип": {"ИдСБИС": "1"},
    "Упаковки": [
        {
            "Название": "Упаковка тестового товара",
            "Количество": "50",
        }
    ],
    "Цены": [
        {
            "ВидЦены": {"ИдСБИС": "7"},
            "Цена": "20.00",
            "Дата": "01.01.2025"
        }
    ],
    "ЭтоГруппа": False
}

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

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

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

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

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

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

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

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