Золотенков

Отгрузить позиции заказа покупателя

POST 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) либо частота обращений