Получить стоимость остатков по складам

HTTP-сервис stockbalances, метод GetStockBalances. Возвращает суммарную стоимость остатков по складам по регистру накопления ПартииТоваровНаСкладах (РегистрНакопления.ПартииТоваровНаСкладах.Остатки) на указанную дату среза.

В публикации 1С значение Корневой URL должно быть ровно stockbalances. Если в публикации указан stockbalaces, запрос к /hs/stockbalances/get вернёт IIS 404, потому что опубликован другой URL.

Endpoint

GET /<публикация>/hs/stockbalances/get

Например для тестовой публикации module.team:

GET /module.team/hs/stockbalances/get?date=01.07.2026

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

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

Параметр	Тип	Описание
`code`	string	Опциональный фильтр по коду номенклатуры перед суммированием. Поиск ПОДОБНО — подстрока в `Код`
`name`	string	Опциональный фильтр по наименованию номенклатуры перед суммированием. Поиск ПОДОБНО. Символ `/` передавайте как `_slash_`
`warehouse`	string	Фильтр по наименованию склада в остатках. Подстрока без учёта регистра
`date`	string	Дата среза остатков. Если не указан — конец текущего дня сеанса 1С

Форматы даты (`date`)

ДД.ММ.ГГГГ — например 15.03.2025
ГГГГ-ММ-ДД — например 2025-03-15
ДД-ММ-ГГГГ — если первый сегмент не год из 4 цифр

При некорректном формате ошибка попадает в массив errors, HTTP-код остаётся 200.

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

GET /<публикация>/hs/stockbalances/get
GET /<публикация>/hs/stockbalances/get?name=бетон
GET /<публикация>/hs/stockbalances/get?code=ДК-00001008
GET /<публикация>/hs/stockbalances/get?warehouse=Северный
GET /<публикация>/hs/stockbalances/get?date=15.03.2025
GET /<публикация>/hs/stockbalances/get?date=2025-03-15&warehouse=Объект
GET /<публикация>/hs/stockbalances/get?name=кирпич

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

{
  "data": [
    {
      "Склад": "Склад «Северный»",
      "ДатаСреза": "15.03.2025",
      "Стоимость": 496500
    }
  ],
  "errors": []
}

В регистре остатки читаются из виртуальной таблицы ПартииТоваровНаСкладах.Остатки и группируются по складу. Номенклатура в ответ не выводится.

Поля ответа

Поле	Тип	Источник в 1С	Описание
`data`	array	—	Массив складов. Сортировка: склад по возрастанию
`data[].Склад`	string	`Склад`	Наименование склада
`data[].ДатаСреза`	string	параметр `date` / сеанс	Дата среза в формате `ДД.ММ.ГГГГ`
`data[].Стоимость`	number	сумма `СтоимостьОстаток`	Суммарная стоимость остатков на складе
`errors`	array	—	Ошибки парсинга `date` или запроса остатков

HTTP-коды

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

Примечания

В ответ попадают только склады, по которым суммарная стоимость остатков не равна нулю.
Фильтр warehouse ограничивает склады перед суммированием.
Фильтры code и name ограничивают номенклатуру перед суммированием; в ответ сама номенклатура не выводится.
При ошибке чтения регистра метод вернёт HTTP 500 с { "error": "..." }.
Ответ содержит заголовок Access-Control-Allow-Origin: *.