Получить перемещения товаров

HTTP-сервис transfers, метод GetTransfers. Возвращает документы Перемещение товаров (Документ.ПеремещениеТоваров) из 1С УПП.

Endpoint

GET /main/hs/transfers/get

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

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

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

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

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

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

Если задан full=true без code, в errors добавляется сообщение «Параметр full требует указания code».

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

GET /main/hs/transfers/get
GET /main/hs/transfers/get?from=01.01.2025&to=31.01.2025
GET /main/hs/transfers/get?date=15.03.2025
GET /main/hs/transfers/get?code=ДК-00001008
GET /main/hs/transfers/get?sender=Северный&receiver=Южный
GET /main/hs/transfers/get?responsible=Сидоров
GET /main/hs/transfers/get?code=ДК-00001008&full=true

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

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

{
  "data": [
    {
      "Номер": "ДК-00001008",
      "Дата": "15.03.2025",
      "СкладОтправитель": "Склад «Северный»",
      "СкладПолучатель": "Склад «Южный»",
      "Ответственный": "Сидоров С.С.",
      "Комментарий": "Перемещение на демо-склад",
      "Материалы": "5 позиций"
    }
  ],
  "errors": []
}

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

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

Вместо сводки Материалы возвращается массив Товары:

{
  "data": [
    {
      "Номер": "ДК-00001008",
      "Дата": "15.03.2025",
      "СкладОтправитель": "Склад «Северный»",
      "СкладПолучатель": "Склад «Южный»",
      "Ответственный": "Сидоров С.С.",
      "Комментарий": "Перемещение на демо-склад",
      "Товары": [
        {
          "НомерСтроки": "1",
          "Номенклатура": "Смесь DEMO-M300",
          "ХарактеристикаНоменклатуры": "",
          "ЕдиницаИзмерения": "м3",
          "Количество": 12.5
        }
      ]
    }
  ],
  "errors": []
}

Поля ответа

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

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

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

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

HTTP-коды

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

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

Примечания

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