Получить заявки на расходование средств

HTTP-сервис payments, метод GetPayments. Возвращает документы Заявка на расходование средств (Документ.ЗаявкаНаРасходованиеСредств) из 1С УПП.

Endpoint

GET /main/hs/payments/get

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

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

Фильтры в запросе к базе

Период и дата фильтруют по полю ДатаРасхода, не по дате документа.

Параметр	Тип	Описание
`from`	string	Начало периода по дате расхода. Работает только вместе с `to`
`to`	string	Конец периода по дате расхода. Работает только вместе с `from`
`date`	string	Фильтр по одной дате расхода (весь день)
`code`	string	Фильтр по номеру заявки. Поиск ПОДОБНО — подстрока в номере
`summ`	number	Точное совпадение суммы документа (`СуммаДокумента`)
`approved`	boolean	Фильтр по проведённости. Истина: `1`, `true`, `yes`, `да`

Пост-фильтры (после выборки из базы)

Поиск подстроки без учёта регистра (ВРег), если параметр задан.

Параметр	Тип	Описание
`responsible`	string	Подстрока в ответственном
`recipient`	string	Подстрока в получателе
`contractor`	string	Подстрока в контрагенте
`cash`	string	Подстрока в кассе / банковском счёте (`БанковскийСчетКасса`)
`comment`	string	Подстрока в комментарии
`status`	string	Подстрока в статусе (`Состояние`)

Расширенный ответ

Параметр	Тип	Описание
`full`	boolean	Полные СвязанныеДокументы и Вложения (с base64). Истина: `1`, `true`, `yes`, `да`

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

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

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

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

GET /main/hs/payments/get
GET /main/hs/payments/get?from=01.01.2025&to=31.01.2025
GET /main/hs/payments/get?code=ЗР-00003001
GET /main/hs/payments/get?responsible=Сидоров&status=соглас
GET /main/hs/payments/get?contractor=ООО&cash=DEMO&approved=true
GET /main/hs/payments/get?code=ЗР-00003001&full=true

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

Базовый ответ

{
  "data": [
    {
      "Номер": "ЗР-00003001",
      "ДатаДокумента": "05.03.2025",
      "ДатаРасхода": "10.03.2025",
      "Ответственный": "Сидоров С.С.",
      "Получатель": "ООО «ДемоПодряд»",
      "Организация": "ООО «ДемоСтрой Альфа»",
      "Касса": "Расчётный счёт «Банк DEMO»",
      "СуммаДокумента": 150000,
      "Статус": "Утверждена",
      "Комментарий": "Оплата по договору DEMO-001",
      "Проведен": true,
      "КтоИзменилСтатус": "Сидоров С.С.",
      "ДатаСменыСтатуса": "06.03.2025",
      "СвязанныеДокументы": {
        "ДокументОснование": { "Есть": true, "Количество": 1 },
        "ДокументыРасчетовСКонтрагентом": { "Есть": true, "Количество": 2 }
      },
      "Вложения": { "Есть": true, "Количество": 1 }
    }
  ],
  "errors": []
}

Расширенный ответ (`full=true`)

{
  "data": [
    {
      "Номер": "ЗР-00003001",
      "ДатаРасхода": "10.03.2025",
      "Получатель": "ООО «ДемоПодряд»",
      "СуммаДокумента": 150000,
      "СвязанныеДокументы": {
        "ДокументОснование": {
          "Тип": "ЗаказПоставщику",
          "Номер": "ЗК-00002015",
          "Дата": "05.03.2025",
          "НомерДата": "ЗК-00002015 от 05.03.2025"
        },
        "ДокументыРасчетовСКонтрагентом": [
          {
            "Тип": "ПлатежноеПоручениеИсходящее",
            "Номер": "СЧ-00004001",
            "Дата": "10.03.2025",
            "НомерДата": "СЧ-00004001 от 10.03.2025"
          }
        ]
      },
      "Вложения": [
        {
          "ИмяФайла": "demo-invoice.pdf",
          "Данные": "JVBERi0xLjQK..."
        }
      ]
    }
  ],
  "errors": []
}

Поля ответа

Шапка заявки

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

Связанные документы

Без full — сводки { Есть, Количество }. При full=true — полные данные.

Поле	Тип	Описание
`СвязанныеДокументы.ДокументОснование`	object	Документ-основание заявки
`СвязанныеДокументы.ДокументыРасчетовСКонтрагентом`	object / array	Платежи из регистра `ЗаявкиНаРасходованиеСредств`
`ДокументОснование.Тип`	string	Имя метаданных документа (только при `full=true`)
`ДокументОснование.Номер`	string	Номер основания
`ДокументОснование.Дата`	string	Дата основания
`ДокументОснование.НомерДата`	string	`Номер от Дата`
`ДокументыРасчетовСКонтрагентом[].Тип`	string	Тип платёжного документа
`ДокументыРасчетовСКонтрагентом[].Номер`	string	Номер
`ДокументыРасчетовСКонтрагентом[].Дата`	string	Дата
`ДокументыРасчетовСКонтрагентом[].НомерДата`	string	`Номер от Дата`

Вложения

Поле	Тип	Описание
`Вложения`	object / array	Без `full` — `{ Есть, Количество }`. При `full=true` — массив
`Вложения[].ИмяФайла`	string	Имя файла из `ХранилищеДополнительнойИнформации`
`Вложения[].Данные`	string	Содержимое файла в Base64 (только при `full=true`)
`errors`	array	—

HTTP-коды

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

Массив errors при 200 не означает полный провал: data может содержать найденные заявки, а в errors — проблемы с отдельными документами.

Примечания

Фильтры from/to и date работают по дате расхода, а не по дате документа.
Контрагент отдельным полем в ответ не выводится — используется как запасной источник для Получатель.
При full=true вложения могут быть большими (Base64) — используйте осознанно.
Заявка попадает в data только если успешно сериализуется в JSON; иначе ошибка уходит в errors.
Без параметров возвращаются все заявки (с учётом прав публикации 1С).
При успешном ответе (200) возвращается заголовок Access-Control-Allow-Origin: *.