Получить склады
HTTP-сервис warehouses, метод GetWarehouses. Возвращает элементы справочника Склады (Справочник.Склады) — плоский список (группы и элементы).
Endpoint
GET /main/hs/warehouses/get
Параметры запроса
Все параметры опциональны. Читаются из query string (ПараметрыЗапроса) или из URL-шаблона (ПараметрыURL).
| Параметр | Тип | Описание |
|---|---|---|
code | string | Фильтр по коду склада. Поиск ПОДОБНО — подстрока в Код |
name | string | Фильтр по наименованию. Поиск ПОДОБНО — подстрока в Наименование |
group | boolean | Фильтр по признаку группы. 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С | Описание |
|---|---|---|---|
data | array | — | Массив складов. Сортировка: наименование по возрастанию |
data[].Код | string | Код | Код склада |
data[].Наименование | string | Наименование | Наименование |
data[].ЭтоГруппа | boolean | ЭтоГруппа | true — группа каталога, false — элемент (склад) |
errors | array | — | Ошибки обработки запроса |
HTTP-коды
| Код | Когда | Тело |
|---|---|---|
| 200 | Запрос обработан | { "data": [...], "errors": [...] } |
| 500 | Непредвиденная ошибка на стороне 1С | { "error": "текст ошибки" } |
Примечания
- Ответ — плоский список, не дерево. Иерархию по родителям метод не возвращает.
- В запросе нет фильтра по пометке на удаление — в выборку могут попадать и помеченные на удаление записи.
- Параметр
groupпозволяет отделить папки каталога (true) от конечных складов (false). - Ответ содержит заголовок
Access-Control-Allow-Origin: *.