Получить номенклатуру

HTTP-сервис materials, метод GetMaterials. Возвращает элементы справочника Номенклатура (Справочник.Номенклатура) в виде дерева.

В выборку попадают только элементы (не группы), без пометки на удаление. Родительские группы в дереве создаются автоматически по цепочке Родитель.

Endpoint

GET /main/hs/materials/get

Параметры запроса

Все параметры опциональны. Читаются из query string (ПараметрыЗапроса) или из URL-шаблона (ПараметрыURL).

Параметр	Тип	Описание
`code`	string	Фильтр по коду. Поиск ПОДОБНО — подстрока в коде
`name`	string	Фильтр по наименованию. Поиск ПОДОБНО
`group`	string	Фильтр по наименованию непосредственного родителя (группы в каталоге). Поиск ПОДОБНО
`type`	string	Фильтр по виду номенклатуры. Поиск ПОДОБНО
`ngroup`	string	Фильтр по номенклатурной группе. Поиск ПОДОБНО
`article`	string	Фильтр по артикулу. Поиск ПОДОБНО
`supplier`	string	Фильтр по основному поставщику. Поиск ПОДОБНО
`service`	boolean	Фильтр по признаку «Услуга». Истина: `1`, `true`, `да`. Любое другое значение при заданном параметре — `false`

Фильтры можно комбинировать. Без параметров возвращается вся номенклатура (с учётом прав публикации 1С).

Примеры запросов

GET /main/hs/materials/get
GET /main/hs/materials/get?name=бетон
GET /main/hs/materials/get?group=Материалы&service=false
GET /main/hs/materials/get?type=Товар&article=BRK
GET /main/hs/materials/get?supplier=ООО&ngroup=Строй
GET /main/hs/materials/get?code=ДК-00001008

Формат ответа

data — массив корневых узлов дерева. Каждый узел — либо группа, либо элемент номенклатуры.

{
  "data": [
    {
      "Код": "SKU-0100",
      "Наименование": "Материалы",
      "ЭтоГруппа": true,
      "Дети": [
        {
          "Код": "ДК-00001008",
          "Наименование": "Смесь DEMO-M300",
          "Артикул": "BRK-M300",
          "ЭтоГруппа": false,
          "Услуга": false,
          "ЕдиницаИзмерения": "м3",
          "ВидНоменклатуры": "Товар",
          "НоменклатурнаяГруппа": "Стройматериалы",
          "ОсновнойПоставщик": "ООО «ПримерПоставка»"
        }
      ]
    }
  ],
  "errors": []
}

Поля узла дерева

Группа (`ЭтоГруппа: true`)

Поле	Тип	Описание
`Код`	string	Код группы
`Наименование`	string	Наименование группы
`ЭтоГруппа`	boolean	Всегда `true`
`Дети`	array	Вложенные группы и элементы

Элемент номенклатуры (`ЭтоГруппа: false`)

Поле	Тип	Источник в 1С	Описание
`Код`	string	`Код`	Код номенклатуры
`Наименование`	string	`Наименование`	Наименование
`Артикул`	string	`Артикул`	Артикул или пустая строка
`ЭтоГруппа`	boolean	—	Всегда `false`
`Услуга`	boolean	`Услуга`	Признак услуги
`ЕдиницаИзмерения`	string	`БазоваяЕдиницаИзмерения`	Единица измерения
`ВидНоменклатуры`	string	`ВидНоменклатуры`	Вид номенклатуры
`НоменклатурнаяГруппа`	string	`НоменклатурнаяГруппа`	Номенклатурная группа
`ОсновнойПоставщик`	string	`ОсновнойПоставщик`	Основной поставщик или пустая строка

HTTP-коды

Код	Когда	Тело
200	Запрос обработан	`{ "data": [...], "errors": [...] }`
500	Непредвиденная ошибка на стороне 1С	`{ "error": "текст ошибки" }`

Примечания

Ответ — дерево, а не плоский список. Обходите рекурсивно через поле Дети.
Группы в дереве — это родительские папки каталога, собранные по цепочке Родитель для найденных элементов.
Параметр group фильтрует по имени ближайшего родителя, а не по всей иерархии.
Элементы в запросе сортируются по наименованию.
Ответ содержит заголовок Access-Control-Allow-Origin: *.