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

Материал из razgovorov.ru
Перейти к: навигация, поиск

Объект

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


Легенда:

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


  • Артикул — строка, артикул номенклатуры
  • ВнешниеКоды — массив, соответствие внешних идентификаторов номенклатуры интеграциям
  • Код — строка, идентификатор номенклатуры
  • Интеграция — строка, идентификатор интеграции
  • ЕдИзм — объект Единица измерения, основная единица изменения
  • Изображения — массив, вложенные изображения
  • ИмяФайла — строка, имя файла изображения
  • ДвоичныеДанные — строка, двоичные данные (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
Источник — «http://wiki.razgovorov.ru/index.php?title=Номенклатура_-_API3_Объект&oldid=7109»