Получить заказы на производство
HTTP-сервис morders, метод GetMOrders. Возвращает документы Заказ на производство (Документ.ЗаказНаПроизводство) из 1С УПП.
Endpoint
GET /main/hs/morders/get
Параметры запроса
Все параметры опциональны. Читаются из query string (ПараметрыЗапроса) или из URL-шаблона (ПараметрыURL).
| Параметр | Тип | Описание |
|---|---|---|
code | string | Фильтр по номеру заказа. Поиск ПОДОБНО — подстрока в номере. Пример: 565 найдёт ЗП-00001042, ЗП-00001043 |
contract | string | Фильтр по комментарию/договору (поле Комментарий в 1С). Поиск ПОДОБНО. Символ / передавайте как _slash_ |
from | string | Начало периода по дате документа. Работает только вместе с to |
to | string | Конец периода по дате документа. Работает только вместе с from |
full | boolean | Расширенный ответ: ссылка 1С, табличные части Продукция и Материалы. Истина: 1, true, yes, да (без учёта регистра) |
Форматы дат (from, to)
ДД.ММ.ГГГГ— например01.01.2024ГГГГ-ММ-ДД— например2024-01-01ДД-ММ-ГГГГ— если первый сегмент не год из 4 цифр
При некорректном формате даты ошибка попадает в массив errors, HTTP-код остаётся 200.
Примеры запросов
GET /main/hs/morders/get
GET /main/hs/morders/get?code=565
GET /main/hs/morders/get?contract=DEMO%20obj
GET /main/hs/morders/get?contract=02_slash_25%20DEMO%20obj
GET /main/hs/morders/get?from=01.01.2024&to=31.12.2024
GET /main/hs/morders/get?code=565&full=true
Формат ответа
Базовый ответ (full не задан или false)
{
"data": [
{
"Номер": "ЗП-00001042",
"Дата": "12.12.2024",
"Договор": "Договор DEMO-001",
"Организация": "ООО «ДемоСтрой Альфа»",
"Ответственный": "Сидоров С.С."
}
],
"errors": []
}
Расширенный ответ (full=true)
Дополнительно к базовым полям:
{
"data": [
{
"Ссылка": "Заказ на производство ЗП-00001042 от 12.12.2024 0:00:00",
"Номер": "ЗП-00001042",
"Дата": "12.12.2024",
"Договор": "Договор DEMO-001",
"Организация": "ООО «ДемоСтрой Альфа»",
"Ответственный": "Сидоров С.С.",
"Продукция": [
{
"Номенклатура": "Изделие DEMO-A",
"Количество": 120,
"ЕдиницаИзмерения": "шт"
}
],
"Материалы": [
{
"Номенклатура": "Смесь DEMO-M300",
"Количество": 2.5,
"ЕдиницаИзмерения": "т"
}
]
}
],
"errors": []
}
Поля ответа
| Поле | Тип | Источник в 1С | Описание |
|---|---|---|---|
data | array | — | Массив заказов на производство, сортировка по дате по возрастанию |
data[].Номер | string | Номер | Номер документа. Если пусто — "Не указан" |
data[].Дата | string | Дата | Дата в формате ДД.ММ.ГГГГ. Если пусто — "Не указана" |
data[].Договор | string | Комментарий | Текст комментария/договора. Если пусто — "Не указан" |
data[].Организация | string | Организация.Наименование | Организация |
data[].Ответственный | string | Ответственный.Наименование | Ответственный |
data[].Ссылка | string | Ссылка | Только при full=true. Строковое представление ссылки 1С |
data[].Продукция | array | ТЧ Продукция | Только при full=true |
data[].Продукция[].Номенклатура | string | Номенклатура.Наименование | Наименование |
data[].Продукция[].Количество | number | Количество | Количество |
data[].Продукция[].ЕдиницаИзмерения | string | ЕдиницаИзмерения.Наименование | Единица измерения |
data[].Материалы | array | ТЧ Материалы | Только при full=true, структура аналогична Продукция |
errors | array | — | Ошибки парсинга параметров или загрузки табличных частей отдельных документов |
HTTP-коды
| Код | Когда | Тело |
|---|---|---|
| 200 | Запрос обработан | { "data": [...], "errors": [...] } |
| 500 | Непредвиденная ошибка на стороне 1С | { "error": "текст ошибки" } |
Массив errors при 200 не означает полный провал запроса: data может содержать найденные заказы, а в errors — проблемы с отдельными документами (например, не удалось прочитать табличные части при full=true).
Примечания
- Поле
Договорв JSON — это Комментарий документа в 1С, а не ссылка на справочник договоров. - Фильтры
codeиcontractможно комбинировать с периодомfrom/to. - Без параметров возвращаются все заказы на производство (с учётом прав доступа публикации 1С).
- Ответ содержит заголовок
Access-Control-Allow-Origin: *.