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

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

Договоры финансирования и кредитные линии

В базовом ответе, без full, приходит массив ДоговорыФинансирования - это договоры контрагентов, у которых реквизит ЗаказПокупателя ссылается на этот заказ.

Смысл связки: в рамках строительства по нашему договору с покупателем банк может выдать целевой кредит или открыть кредитную линию. Договор с банком при этом привязывается к конкретному заказу покупателя, поэтому по этому массиву видно, под какой наш договор доступно финансирование.

Признак Банк у элемента массива означает, что контрагент договора входит в иерархию группы справочника Контрагенты с наименованием Банки. Другого структурного признака банка в конфигурации нет, поэтому отнесение к группе - единственный критерий.

Если группа Банки не найдена, метод вернёт 200, признак Банк у всех элементов будет false, а предупреждение уйдёт в errors.

Endpoint

GET /main/hs/orders/get

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

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

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

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

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

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

Форматы дат (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
GET /main/hs/orders/get?bank=ДемоБанк
GET /main/hs/orders/get?bank=ДемоБанк&from=01.01.2025&to=31.12.2025

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

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

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

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

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

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

Поля ответа

Шапка заказа

Элемент ДоговорыФинансирования

Договоры с пометкой удаления не возвращаются. Сортировка: дата договора убыв., затем номер убыв.

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

HTTP-коды

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

Примечания

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