Заказ поставщику
procurement.get_order
Возвращает карточку заказа поставщику вместе с его позициями (заказанное и фактически принятое количество). Заказ находится по идентификатору (orderId) либо по номеру (number, например «ЗК-12») — достаточно одного из значений. Используется, чтобы уточнить состав, статус, суммы и ход приёмки конкретного заказа. Только чтение.
Входы
| Ключ | Тип | Описание |
|---|---|---|
| orderId | string | Идентификатор заказа |
| number | string | Номер заказа |
Выходы
| Ключ | Тип | Описание |
|---|---|---|
| order | object | Заказ |
| items | array | Позиции |
| itemsCount | integer | Число позиций |
Что делает
Нода находит один заказ поставщику и возвращает его полную карточку вместе со всеми позициями. Найти заказ можно двумя способами: по идентификатору (orderId), если он уже известен из предыдущего шага, или по номеру (number, например «ЗК-12») — так, как его видит человек в списке заказов. Достаточно указать одно из значений; если заданы оба, приоритет у идентификатора.
Когда применять
Основной сценарий — быстро свериться по конкретному заказу, не открывая интерфейс. Например: менеджер спрашивает ассистента «что по заказу ЗК-12?», и тот возвращает поставщика, статус, сумму и ход приёмки. Другой типичный случай — шаг автоматизации: получить состав заказа перед тем, как оформить приёмку, сравнить заказанное с уже принятым или проверить, полностью ли закрыт заказ. Нода только читает данные и ничего в заказе не меняет.
Что подать на вход
Идентификатор заказа (orderId) или его номер (number) — достаточно одного. Номер удобен, когда работаем от лица пользователя и знаем только «человеческий» номер документа; идентификатор — когда заказ уже получен из другой ноды. Если не передать ничего, нода сообщит, что нужно указать идентификатор или номер.
Что приходит в ответе
Карточка заказа (order): номер, поставщик (идентификатор и имя), договор, статус, валюта, итоговая сумма, ожидаемая дата поставки, примечание, а также даты создания и последнего изменения. Список позиций (items): по каждой строке — номенклатура (идентификатор и наименование), заказанное количество, фактически принятое количество, цена за единицу и сумма строки. Отдельно приходит число позиций (itemsCount). Сопоставив заказанное и принятое количество, можно понять, что уже поставлено, а что ещё в пути.