Отгрузить позиции заказа покупателя
https://mrp.zolotenkov.ru/api/external/v1/sales-orders/{id}/ship
Требуемое право ключа: write:sales.order.ship
Упаковывает или отгружает строки заказа. PACKED создает упаковку и сразу списывает товар со склада. DELIVERED с fulfillment_id отгружает эту упаковку без нового списания; без fulfillment_id отгружает еще не исполненное количество строк и списывает его. Если строки запроса уже упакованы и запрос не совпадает ровно с одной упаковкой по строкам и количеству, ответ 409 sales_order_fulfillment_ambiguous с перечнем упаковок в details. Когда отгружены все строки, заказ закрывается сам.
Параметры пути
-
idцелое число обязателенid заказа покупателя
Заголовки
-
Idempotency-Keyстрока обязателенОбязателен. Повтор с тем же ключом возвращает прежний ответ и второй раз товар не списывает. Ответ на повтор помечен заголовком
Idempotency-Replayed: true— по коду ответа повтор от первичного вызова не отличается.
Тело запроса
Формат — application/json.
-
event_typeстрока необязателенPACKED— позиции упакованы: создается исполнение, и товар сразу списывается со склада (как в Katana).DELIVERED— отгрузка: сfulfillment_idотгружается эта упаковка целиком без нового списания; без него отгружается еще не исполненное количество строк, и товар списывается в момент отгрузки. Не прислали —DELIVERED. -
fulfillment_idцелое число необязателен может быть пустымУпаковка, которую нужно отгрузить (
fulfillments[].idиз карточки заказа). Только сevent_type = DELIVERED;itemsиserial_assignmentsтогда не передаются — строки, партии, ячейки и номера берутся из самой упаковки. -
itemsмассив объектов необязателенХотя бы одна строка, если не передан
fulfillment_id. -
items.quantityдесятичная дробь обязателенСколько отгружается этим событием. Не больше неотгруженного остатка строки — иначе
422. -
items.sales_order_item_idцелое число обязателен -
serial_assignmentsмассив объектов необязателен -
serial_assignments.sales_order_item_idцелое число обязателен -
serial_assignments.serial_idsмассив целых чисел необязателен -
storage_place_idцелое число необязателен может быть пустымСклад, с которого уходит товар. Не прислали — берется склад строки, а при пустой строке — склад по умолчанию, как в интерфейсе.
Ответы
- 200 Событие отгрузки записано; в ответе — заказ с новым
delivery_status - 400 Некорректное тело запроса
- 401 Ключ не передан, недействителен или отозван
- 403 У ключа нет права
write:sales.order.ship - 404 В этом учете такого заказа нет
- 409 Idempotency-Key повторен с другим телом; отгрузка без
fulfillment_idпопала на упакованное и не совпала ровно с одной упаковкой, вdetailsперечень упаковок (sales_order_fulfillment_ambiguous); упаковку уже отгрузила или сняла другая команда (sales_order_fulfillment_state_changed) - 422 Заказ уже закрыт (sales_order_invalid_status); количество больше неотгруженного остатка, строка не из этого заказа, не хватает товара на складе либо для серийной строки не переданы номера (sales_order_shipment_not_allowed); день отгрузки попадает в закрытый учетный период (inventory_period_closed)
- 429 Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений