Получить ведомость по денежным средствам

HTTP-сервис cashflows, метод GetCashFlows. Возвращает остатки и обороты денежных средств по регистру накопления ДенежныеСредства (РегистрНакопления.ДенежныеСредства.ОстаткиИОбороты) — аналог отчёта «Ведомость по денежным средствам» в 1С УПП.

Это фактические остатки и движения по счетам и кассам, а не плановые заявки (заявки на расходование).

Endpoint

GET /main/hs/cashflows/get

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

Период обязателен: либо пара from + to, либо один параметр date. Без периода в errors попадёт сообщение, data будет пустым, HTTP 200.

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

Период

Параметр	Тип	Описание
`from`	string	Начало периода. Работает только вместе с `to`
`to`	string	Конец периода (включительно, до конца дня). Работает только вместе с `from`
`date`	string	Один день вместо `from`/`to` (весь день)

Пост-фильтры (подстрока без учёта регистра)

Параметр	Тип	Описание
`org`	string	Подстрока в наименовании организации
`account`	string	Подстрока в представлении счёта / кассы
`cash`	string	Подстрока в представлении счёта / кассы (как `account`)
`bank`	string	Подстрока в наименовании банка

Прочие

Параметр	Тип	Описание
`mgmt`	boolean	Суммы в управленческом учёте (`СуммаУпр*`). Истина: `1`, `true`, `yes`, `да`
`totals`	boolean	Добавить строку Итог с суммированием по отфильтрованным строкам. Истина: `1`, `true`, `yes`, `да`

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

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

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

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

GET /main/hs/cashflows/get?from=01.02.2025&to=28.02.2025
GET /main/hs/cashflows/get?from=01.02.2025&to=28.02.2025&totals=true
GET /main/hs/cashflows/get?date=15.02.2025
GET /main/hs/cashflows/get?from=01.02.2025&to=28.02.2025&org=Авангард&bank=СБЕР
GET /main/hs/cashflows/get?from=01.02.2025&to=28.02.2025&mgmt=true&totals=true

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

{
  "data": [
    {
      "Итог": false,
      "ПериодС": "01.02.2025",
      "ПериодПо": "28.02.2025",
      "Организация": "ООО «ДемоСтрой Альфа»",
      "СчетКасса": "ООО «ДемоСтрой Альфа» Расчётный «Банк DEMO» (Расчетный)",
      "ВидДенежныхСредств": "Безналичные",
      "Банк": "ПАО «Банк DEMO»",
      "ВидСчета": "Расчетный",
      "Валюта": "руб.",
      "Закрыт": false,
      "НачальныйОстаток": 598.87,
      "Приход": 121000,
      "Расход": 121468.4,
      "КонечныйОстаток": 130.47,
      "УпрУчет": false
    },
    {
      "Итог": true,
      "ПериодС": "01.02.2025",
      "ПериодПо": "28.02.2025",
      "Организация": "",
      "СчетКасса": "Итог",
      "ВидДенежныхСредств": "",
      "Банк": "",
      "ВидСчета": "",
      "Валюта": "",
      "Закрыт": false,
      "НачальныйОстаток": 37633900.87,
      "Приход": 193332889.52,
      "Расход": 196590610.58,
      "КонечныйОстаток": 34376179.81,
      "УпрУчет": false
    }
  ],
  "errors": []
}

Строка с "Итог": true и "СчетКасса": "Итог" добавляется только при totals=true и если в data есть хотя бы одна обычная строка.

Поля ответа

Поле	Тип	Источник в 1С	Описание
`data`	array	—	Строки ведомости. Сортировка: организация, счёт/касса
`data[].Итог`	boolean	—	`true` для итоговой строки при `totals=true`
`data[].ПериодС`	string	параметры периода	Начало периода (`ДД.ММ.ГГГГ`)
`data[].ПериодПо`	string	параметры периода	Конец периода (`ДД.ММ.ГГГГ`)
`data[].Организация`	string	`Организация`	Организация
`data[].СчетКасса`	string	`БанковскийСчетКасса`	Банковский счёт или касса
`data[].ВидДенежныхСредств`	string	`ВидДенежныхСредств`	Наличные / безналичные
`data[].Банк`	string	`БанковскиеСчета.Банк`	Банк (для расчётного счёта)
`data[].ВидСчета`	string	`БанковскиеСчета.ВидСчета`	Вид счёта
`data[].Валюта`	string	валюта счёта / кассы	Валюта денежных средств
`data[].Закрыт`	boolean	`БанковскиеСчета.ДатаЗакрытия`	Счёт закрыт
`data[].НачальныйОстаток`	number	`Сумма*НачальныйОстаток`	Остаток на начало периода
`data[].Приход`	number	`Сумма*Приход`	Поступление за период
`data[].Расход`	number	`Сумма*Расход`	Списание за период
`data[].КонечныйОстаток`	number	`Сумма*КонечныйОстаток`	Остаток на конец периода
`data[].УпрУчет`	boolean	параметр `mgmt`	Суммы в упр. учёте
`errors`	array	—	Ошибки парсинга периода или сериализации отдельных строк

HTTP-коды

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

Примечания

Источник — виртуальная таблица ОстаткиИОбороты регистра ДенежныеСредства, не журнал документов движения ДС.
Без mgmt суммы в бухгалтерском учёте; с mgmt=true — поля СуммаУпр* регистра.
Итоговая строка суммирует уже отфильтрованные строки (после пост-фильтров org, account, cash, bank).
Параметр full не поддерживается.
При успешном ответе (200) возвращается заголовок Access-Control-Allow-Origin: *.