Получить требования-накладные

HTTP-сервис demands, метод GetDemands. Возвращает документы Требование-накладная (Документ.ТребованиеНакладная) из 1С УПП.

Endpoint

GET /main/hs/demands/get

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

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

Параметр	Тип	Описание
`code`	string	Фильтр по номеру документа. Поиск ПОДОБНО — подстрока в номере
`from`	string	Начало периода по дате документа. Работает только вместе с `to`
`to`	string	Конец периода по дате документа. Работает только вместе с `from`
`warehouse`	string	Фильтр по наименованию склада. Поиск ПОДОБНО
`responsible`	string	Фильтр по наименованию ответственного. Поиск ПОДОБНО
`full`	boolean	Расширенный ответ: табличная часть Материалы. Истина: `1`, `true`, `yes`, `да`

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

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

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

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

GET /main/hs/demands/get
GET /main/hs/demands/get?from=01.01.2025&to=31.01.2025
GET /main/hs/demands/get?code=ДК-00001008
GET /main/hs/demands/get?warehouse=Северный&responsible=Сидоров
GET /main/hs/demands/get?code=ДК-00001008&full=true
GET /main/hs/demands/get?from=01.03.2025&to=31.03.2025&full=true

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

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

{
  "data": [
    {
      "Номер": "ДК-00001008",
      "Дата": "15.03.2025",
      "Склад": "Склад «Северный»",
      "Ответственный": "Сидоров С.С.",
      "Комментарий": "Выдача на демо-объект",
      "Материалы": "8 позиций"
    }
  ],
  "errors": []
}

Поле Материалы — текстовая сводка по количеству строк ТЧ Материалы (N позиция, N позиции, N позиций).

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

Вместо сводки Материалы возвращается массив строк табличной части:

{
  "data": [
    {
      "Номер": "ДК-00001008",
      "Дата": "15.03.2025",
      "Склад": "Склад «Северный»",
      "Ответственный": "Сидоров С.С.",
      "Комментарий": "Выдача на демо-объект",
      "Материалы": [
        {
          "НомерСтроки": "1",
          "Номенклатура": "Пример номенклатуры А",
          "Количество": 5000,
          "ЕдиницаИзмерения": "шт"
        }
      ]
    }
  ],
  "errors": []
}

Поля ответа

Шапка документа

Поле	Тип	Источник в 1С	Описание
`data`	array	—	Массив требований-накладных. Сортировка: дата по возрастанию
`data[].Номер`	string	`Номер`	Номер документа
`data[].Дата`	string	`Дата`	Дата в формате `ДД.ММ.ГГГГ` или пустая строка
`data[].Склад`	string	`Склад`	Склад
`data[].Ответственный`	string	`Ответственный`	Ответственный
`data[].Комментарий`	string	`Комментарий`	Комментарий
`data[].Материалы`	string / array	ТЧ Материалы	Сводка «N позиций» или массив строк (при `full=true`)
`errors`	array	—	Ошибки парсинга параметров или загрузки ТЧ отдельных документов

Табличная часть `Материалы` (только при `full=true`)

Поле	Тип	Источник в 1С	Описание
`Материалы[].НомерСтроки`	string	`НомерСтроки`	Номер строки
`Материалы[].Номенклатура`	string	`Номенклатура.Наименование`	Наименование
`Материалы[].Количество`	number	`Количество`	Количество
`Материалы[].ЕдиницаИзмерения`	string	`ЕдиницаИзмерения`	Единица измерения

HTTP-коды

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

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

Примечания

Фильтры from/to работают по дате документа.
Параметр full не требует code — полная ТЧ возвращается для всех документов в выборке.
При ошибке чтения ТЧ при full=true документ остаётся в data, а Материалы подставляется как сводка «N позиций».
Без параметров возвращаются все требования-накладные (с учётом прав публикации 1С).
Ответ содержит заголовок Access-Control-Allow-Origin: *.