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

POST https://mrp.zolotenkov.ru/api/external/v1/sales-orders/{id}/ship

Требуемое право ключа: write:sales.order.ship

Отгружает или собирает перечисленные строки заказа. DELIVERED списывает товар со склада, PACKED только резервирует. Когда отгружены все строки, заказ закрывается сам — отдельного вызова закрытия для этого не нужно.

Параметры пути

id целое число обязателен

id заказа покупателя

Заголовки

Idempotency-Key строка обязателен

Обязателен. Повтор с тем же ключом возвращает прежний ответ и второй раз товар не списывает. Ответ на повтор помечен заголовком Idempotency-Replayed: true — по коду ответа повтор от первичного вызова не отличается.

Тело запроса

Формат — application/json.

event_type строка необязателен

DELIVERED — товар ушел, остаток уменьшается. PACKED — позиция собрана и зарезервирована, склад не трогается. Не прислали — DELIVERED: наружу эта ручка нужна прежде всего затем, чтобы продажа уменьшала остаток.
items массив объектов обязателен

Хотя бы одна строка.
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 повторен с другим телом
422 Заказ уже закрыт (sales_order_invalid_status); количество больше неотгруженного остатка, строка не из этого заказа, не хватает товара на складе либо для серийной строки не переданы номера (sales_order_shipment_not_allowed); день отгрузки попадает в закрытый учетный период (inventory_period_closed)
429 Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений

curl --request POST \ --url 'https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42/ship' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21' \ --header 'Content-Type: application/json' \ --data '{ "event_type": "DELIVERED", "items": [ { "quantity": 3, "sales_order_item_id": 42 } ], "serial_assignments": [ { "sales_order_item_id": 42, "serial_ids": [ 1 ] } ], "storage_place_id": 42 }'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42/ship", { method: "POST", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type": "application/json", }, body: JSON.stringify({ "event_type": "DELIVERED", "items": [ { "quantity": 3, "sales_order_item_id": 42 } ], "serial_assignments": [ { "sales_order_item_id": 42, "serial_ids": [ 1 ] } ], "storage_place_id": 42 }), }); const data = await response.json();

import requests response = requests.post( "https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42/ship", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", }, json={ "event_type": "DELIVERED", "items": [ { "quantity": 3, "sales_order_item_id": 42 } ], "serial_assignments": [ { "sales_order_item_id": 42, "serial_ids": [ 1 ] } ], "storage_place_id": 42 }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42/ship'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ", "Accept: application/json", "Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type: application/json", ], CURLOPT_POSTFIELDS => <<<'JSON' { "event_type": "DELIVERED", "items": [ { "quantity": 3, "sales_order_item_id": 42 } ], "serial_assignments": [ { "sales_order_item_id": 42, "serial_ids": [ 1 ] } ], "storage_place_id": 42 } JSON, ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "cancel_reason": "Покупатель отказался от остатка", "cancelled_at": "2026-08-01T09:00:00Z", "cancelled_by_user_id": "42", "cancelled_by_user_name": "Анна Петрова", "created_date": "2026-08-01T09:00:00Z", "currency": "RUB", "customer": { "country_code": "RU", "id": "42", "title": "Название" }, "delivery_date": "2026-08-01T09:00:00Z", "delivery_status": "NOT_SHIPPED", "id": "42", "notes": "Комментарий", "number": "0001", "priority": 1, "shipped_at": "2026-08-01T09:00:00Z", "status": "OPEN", "tax_amount": 2400, "total_amount": 12000, "total_amount_with_tax": 14400, "items": [ { "id": "42", "item_id": "42", "item_variant_id": "42", "line_amount": 12000, "line_amount_with_tax": 14400, "line_tax_amount": 2400, "price": 1200, "quantity": 10, "sku": "ART-001", "storage_place_id": "42", "tax_rate": 20, "title": "Название" } ] }

{ "error": "document_quota_exceeded", "message": "Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.", "request_id": "req_cyX5W3UaT8KsYDN7GUEkdW" }