Получить склады

HTTP-сервис warehouses, метод GetWarehouses. Возвращает элементы справочника Склады (Справочник.Склады) — плоский список (группы и элементы).

Endpoint

GET /main/hs/warehouses/get

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

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

ПараметрТипОписание
codestringФильтр по коду склада. Поиск ПОДОБНО — подстрока в Код
namestringФильтр по наименованию. Поиск ПОДОБНО — подстрока в Наименование
groupbooleanФильтр по признаку группы. true / 1 / да — только группы; любое другое значение при заданном параметре — только элементы (не группы)

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

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

GET /main/hs/warehouses/get
GET /main/hs/warehouses/get?name=Северный
GET /main/hs/warehouses/get?code=SKU-0100
GET /main/hs/warehouses/get?group=false
GET /main/hs/warehouses/get?group=true&name=Объект

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

{
  "data": [
    {
      "Код": "SKU-0100",
      "Наименование": "Склад «Северный»",
      "ЭтоГруппа": false
    },
    {
      "Код": "00002",
      "Наименование": "Склады объектов",
      "ЭтоГруппа": true
    }
  ],
  "errors": []
}

Поля ответа

ПолеТипИсточник в 1СОписание
dataarrayМассив складов. Сортировка: наименование по возрастанию
data[].КодstringКодКод склада
data[].НаименованиеstringНаименованиеНаименование
data[].ЭтоГруппаbooleanЭтоГруппаtrue — группа каталога, false — элемент (склад)
errorsarrayОшибки обработки запроса

HTTP-коды

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

Примечания

  • Ответ — плоский список, не дерево. Иерархию по родителям метод не возвращает.
  • В запросе нет фильтра по пометке на удаление — в выборку могут попадать и помеченные на удаление записи.
  • Параметр group позволяет отделить папки каталога (true) от конечных складов (false).
  • Ответ содержит заголовок Access-Control-Allow-Origin: *.