Получить заказы поставщикам

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

Endpoint

GET /main/hs/sorders/get

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

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

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

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

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

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

Параметр	Тип	Описание
`supplier`	string	Подстрока в наименовании контрагента (поставщика)
`org`	string	Подстрока в наименовании организации
`warehouse`	string	Подстрока в складе
`responsible`	string	Подстрока в ответственном
`comment`	string	Подстрока в комментарии документа

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

Параметр	Тип	Описание
`full`	boolean	Добавляет табличную часть Товары и список Вложения из хранилища. Истина: `1`, `true`, `yes`, `да`, `full` (без учёта регистра)

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

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

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

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

GET /main/hs/sorders/get
GET /main/hs/sorders/get?code=ЗК-00002015
GET /main/hs/sorders/get?from=01.01.2024&to=31.12.2024
GET /main/hs/sorders/get?supplier=Пример&approved=true
GET /main/hs/sorders/get?warehouse=Северный&summ=250000
GET /main/hs/sorders/get?code=ЗК-00002015&full=true

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

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

{
  "data": [
    {
      "Номер": "ЗК-00002015",
      "Дата": "10.04.2025",
      "Контрагент": "ООО «ПримерПоставка»",
      "Организация": "ООО «ДемоСтрой Альфа»",
      "Ответственный": "Сидоров С.С.",
      "СуммаДокумента": 250000,
      "Склад": "Склад «Северный»",
      "Проведен": true,
      "Комментарий": "Поставка на демо-объект",
      "ДатаОплаты": "15.04.2025",
      "ДатаПоступления": "20.04.2025",
      "СвязанныеДокументы": {
        "Поступления": { "Есть": false, "Количество": 0 },
        "ЗакрытияЗаказов": { "Есть": false, "Количество": 0 },
        "ЗаявкаНаРасходованиеСредств": { "Есть": false, "Количество": 0 }
      },
      "Вложения": { "Есть": false, "Количество": 0 }
    }
  ],
  "errors": []
}

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

Дополнительно к полям шапки:

{
  "data": [
    {
      "Номер": "ЗК-00002015",
      "Дата": "10.04.2025",
      "Контрагент": "ООО «ПримерПоставка»",
      "Товары": [
        {
          "Номенклатура": "Смесь DEMO-M300",
          "ХарактеристикаНоменклатуры": "",
          "Количество": 50,
          "Цена": 5000,
          "Сумма": 250000,
          "ЕдиницаИзмерения": "м3",
          "КоличествоМест": 0,
          "Коэффициент": 1,
          "ПлановаяСебестоимость": 0,
          "СуммаНДС": 41666.67,
          "СтавкаНДС": "20%",
          "Спецификация": ""
        }
      ],
      "Вложения": [
        {
          "ЕстьВложение": true,
          "ИмяФайла": "demo-invoice.pdf",
          "ИдентификаторХранилища": "a1b2c3d4-e5f6-7890-abcd-ef0000000190"
        }
      ]
    }
  ],
  "errors": []
}

Поля ответа

Шапка заказа

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

Вложения (при `full=true`)

Поле	Тип	Описание
`Вложения[].ЕстьВложение`	boolean	Всегда `true` для элемента массива
`Вложения[].ИмяФайла`	string	Имя файла
`Вложения[].ИдентификаторХранилища`	string	UUID записи в `Справочник.ХранилищеДополнительнойИнформации`

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

Поле	Тип	Источник в 1С	Описание
`Товары[].Номенклатура`	string	`Номенклатура.Наименование`	Наименование
`Товары[].ХарактеристикаНоменклатуры`	string	`ХарактеристикаНоменклатуры`	Характеристика
`Товары[].Количество`	number	`Количество`	Количество
`Товары[].Цена`	number	`Цена`	Цена
`Товары[].Сумма`	number	`Сумма`	Сумма строки
`Товары[].ЕдиницаИзмерения`	string	`ЕдиницаИзмерения`	Единица измерения
`Товары[].КоличествоМест`	number	`КоличествоМест`	Количество мест
`Товары[].Коэффициент`	number	`Коэффициент`	Коэффициент
`Товары[].ПлановаяСебестоимость`	number	`ПлановаяСебестоимость`	Значение из строки ТЧ
`Товары[].СуммаНДС`	number	`СуммаНДС`	Сумма НДС
`Товары[].СтавкаНДС`	string	`СтавкаНДС`	Ставка НДС
`Товары[].Спецификация`	string	`Спецификация`	Спецификация
`errors`	array	—	Ошибки парсинга параметров, загрузки товаров или вложений

HTTP-коды

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

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

Примечания

В отличие от заказов покупателей, фильтр контрагента называется supplier, а не customer.
Нет фильтров по договору и ИНН — только supplier по наименованию.
СвязанныеДокументы всегда возвращается со структурой-заготовкой (Есть: false, Количество: 0).
Без full вложения — сводка { Есть, Количество }; с full=true — массив файлов из хранилища доп. информации.
Без параметров возвращаются все заказы поставщикам (с учётом прав публикации 1С).
При успешном ответе (200) возвращается заголовок Access-Control-Allow-Origin: *.