Получить поступления товаров и услуг

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

Endpoint

GET /main/hs/receipts/get

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

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

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

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

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

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

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

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

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

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

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

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

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

GET /main/hs/receipts/get
GET /main/hs/receipts/get?from=01.01.2025&to=31.01.2025
GET /main/hs/receipts/get?code=ПТ-00001001
GET /main/hs/receipts/get?contractor=ООО&warehouse=Северный&approved=true
GET /main/hs/receipts/get?date=15.03.2025&summ=125000
GET /main/hs/receipts/get?code=ПТ-00001001&full=true

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

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

{
  "data": [
    {
      "Номер": "ПТ-00001001",
      "ДатаДокумента": "15.03.2025",
      "Дата": "15.03.2025",
      "Контрагент": "ООО «ПримерПоставка»",
      "Организация": "ООО «ДемоСтрой Альфа»",
      "Склад": "Склад «Северный»",
      "Ответственный": "Сидоров С.С.",
      "СуммаДокумента": 125000,
      "Комментарий": "Поступление по заказу поставщику",
      "Проведен": true,
      "Сделка": { "Есть": true, "Количество": 1 },
      "Вложения": { "Есть": true, "Количество": 2 }
    }
  ],
  "errors": []
}

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

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

{
  "data": [
    {
      "Номер": "ПТ-00001001",
      "ДатаДокумента": "15.03.2025",
      "Контрагент": "ООО «ПримерПоставка»",
      "СуммаДокумента": 125000,
      "Сделка": {
        "Тип": "ЗаказПоставщику",
        "Номер": "ЗК-00002015",
        "Дата": "10.03.2025",
        "НомерДата": "ЗК-00002015 от 10.03.2025"
      },
      "Товары": [
        {
          "НомерСтроки": "1",
          "Номенклатура": "Смесь DEMO-M300",
          "ХарактеристикаНоменклатуры": "",
          "ЕдиницаИзмерения": "мешок",
          "Количество": 50,
          "Цена": 2500,
          "Сумма": 125000,
          "СтавкаНДС": "НДС 20%",
          "СуммаНДС": 20833.33
        }
      ],
      "Услуги": [],
      "Вложения": [
        {
          "ИмяФайла": "invoice.pdf",
          "Данные": "JVBERi0xLjQK..."
        }
      ]
    }
  ],
  "errors": []
}

Поля ответа

Шапка поступления

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

Сделка и вложения

Без full — сводки { Есть, Количество }. При full=true — полные данные.

Поле	Тип	Описание
`data[].Сделка`	object	Документ-основание (заказ поставщику и т.д.)
`data[].Сделка.Тип`	string	Имя метаданных документа-основания (только при `full`)
`data[].Сделка.Номер`	string	Номер основания (только при `full`)
`data[].Сделка.Дата`	string	Дата основания (`ДД.ММ.ГГГГ`, только при `full`)
`data[].Сделка.НомерДата`	string	Представление «номер от дата» (только при `full`)
`data[].Вложения`	array / object	Без `full` — сводка; с `full` — массив `{ ИмяФайла, Данные }`

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

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

HTTP-коды

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

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

Примечания

Поле Склад в ответе соответствует реквизиту СкладОрдер в 1С.
Без full табличные части Товары и Услуги не возвращаются — только сводки по Сделка и Вложения.
При full=true вложения могут быть большими (Base64) — используйте осознанно.
Поступление попадает в data только если успешно сериализуется в JSON; иначе ошибка уходит в errors.
Без параметров возвращаются все поступления (с учётом прав публикации 1С).
При успешном ответе (200) возвращается заголовок Access-Control-Allow-Origin: *.