Создать продажу
trade.create_sale
Оформляет продажу со списанием товара с указанного склада. На вход принимает склад и список позиций, в ответ возвращает идентификатор продажи, номер чека и итоговую сумму.
Входы
| Ключ | Тип | Описание |
|---|---|---|
| warehouseId* | uuid | Склад |
| items* | array | Позиции |
Выходы
| Ключ | Тип | Описание |
|---|---|---|
| saleId | uuid | Идентификатор продажи |
| receiptNumber | string | Номер чека |
| totalAmount | currency | Итоговая сумма |
Что делает
Нода оформляет продажу: фиксирует, какие позиции и в каком количестве проданы, и списывает их с указанного склада. Сумма продажи считается автоматически по ценам позиций, продаже присваивается номер чека.
Когда применять
Это ключевая нода сценариев продаж. Пример: заявка приходит из внешнего канала (сайт, мессенджер), автоматизация собирает список позиций и оформляет продажу — товар сразу списывается со склада, а номер чека и сумма уходят обратно клиенту. После создания продажи обычно идёт нода обработки платежа. Если позиций несколько, их передают списком в поле «позиции».
Что на входе
Обязательны склад, с которого уходит товар, и список позиций — каждая с товаром и количеством. Склад важен: остатки уменьшатся именно на нём, поэтому для продажи выбирают тот склад, где товар физически есть.
Что приходит в ответе
Идентификатор продажи, номер чека и итоговая сумма. Идентификатор понадобится дальше — чтобы провести платёж по этой продаже или оформить возврат. Номер чека и сумму можно показать покупателю или записать в уведомление.