Получить заказы покупателей

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

Endpoint

GET /main/hs/orders/get

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

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

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

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

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

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

Параметр	Тип	Описание
`contract`	string	Подстрока в представлении договора. Символ `/` передавайте как `_slash_`
`customer`	string	Контрагент: совпадение по наименованию или по ИНН
`inn`	string	Подстрока в ИНН контрагента
`org`	string	Подстрока в наименовании организации
`warehouse`	string	Подстрока в складе (`СкладГруппа`)
`responsible`	string	Подстрока в ответственном
`comment`	string	Подстрока в комментарии документа

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

Параметр	Тип	Описание
`full`	boolean	Добавляет табличную часть Товары с расчётом плановой себестоимости и спецификаций. Истина: `1`, `true`, `yes`, `да`

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

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

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

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

GET /main/hs/orders/get
GET /main/hs/orders/get?code=ДК-00001008
GET /main/hs/orders/get?from=01.01.2024&to=31.12.2024
GET /main/hs/orders/get?date=15.03.2025
GET /main/hs/orders/get?contract=02_slash_25%20DEMO%20obj
GET /main/hs/orders/get?customer=ООО%20ДемоКлиент&approved=true
GET /main/hs/orders/get?inn=7700&summ=1500000
GET /main/hs/orders/get?code=ДК-00001008&full=true

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

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

{
  "data": [
    {
      "Номер": "ДК-00001008",
      "Дата": "15.03.2025",
      "Контрагент": "ООО «ДемоКлиент»",
      "ИНН": "7700000001",
      "Организация": "ООО «ДемоСтрой Альфа»",
      "Ответственный": "Сидоров С.С.",
      "Договор": "ДГ-25/042",
      "ИспользоватьПлановуюСебестоимость": true,
      "ИтогПлановаяСебестоимость": 1250000,
      "Сумма": 1500000,
      "Склад": "Склад «Северный»",
      "Проведен": true,
      "Комментарий": "",
      "ДатаОплаты": "20.03.2025",
      "ДатаОтгрузки": "25.03.2025"
    }
  ],
  "errors": []
}

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

Дополнительно к полям шапки добавляется массив Товары:

{
  "data": [
    {
      "Номер": "ДК-00001008",
      "Дата": "15.03.2025",
      "Контрагент": "ООО «ДемоКлиент»",
      "Товары": [
        {
          "Номенклатура": "Комплект DEMO-K7",
          "ХарактеристикаНоменклатуры": "",
          "Количество": 1,
          "Цена": 1500000,
          "Сумма": 1500000,
          "ЕдиницаИзмерения": "компл",
          "КоличествоМест": 0,
          "Коэффициент": 1,
          "ПлановаяСебестоимость": 1250000,
          "СуммаНДС": 250000,
          "СтавкаНДС": "20%",
          "Спецификация": "СП-DEMO-07"
        }
      ]
    }
  ],
  "errors": []
}

Поля ответа

Шапка заказа

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

Табличная часть `Товары` (только при `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 — проблемы с отдельными документами (например, не удалось собрать Товары при full=true).

Примечания

Фильтры из разных групп можно комбинировать: сначала отбор в запросе к базе, затем пост-фильтры по строкам.
customer ищет подстроку и в наименовании контрагента, и в его ИНН.
ПлановаяСебестоимость в строке товара: сначала берётся из ТЧ заказа; если 0 — рассчитывается по спецификации из строки или по номенклатуре (рекурсивно по СпецификацииНоменклатуры).
Без параметров возвращаются все заказы покупателей (с учётом прав публикации 1С).
Ответ содержит заголовок Access-Control-Allow-Origin: *.