Изменить заказ покупателя

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

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

Меняет только переданные поля заказа. Завершенный заказ изменению не подлежит.

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

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

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

Заголовки

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

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

Тело запроса

Формат — application/json.

currency строка необязателен может быть пустым
customer_id целое число необязателен может быть пустым
delivery_date дата и время необязателен может быть пустым
items массив объектов необязателен может быть пустым

Прислали items — набор строк заказа заменяется присланным целиком: строки, которых в нем нет, из заказа удаляются. Не прислали — строки не трогаются вовсе.
items.item_variant_id целое число обязателен
items.price десятичная дробь обязателен

Цена за единицу без НДС.
items.quantity десятичная дробь обязателен
items.storage_place_id целое число необязателен может быть пустым
items.tax_rate десятичная дробь необязателен может быть пустым

Ставка НДС в процентах; отсутствие поля и ноль означают «налога нет».
notes строка необязателен может быть пустым
priority целое число необязателен может быть пустым

Ответы

200 Заказ изменен
400 Некорректное тело либо ссылка на строку другого клиента
401 Ключ не передан, недействителен или отозван
403 У ключа нет права write:sales.order.update
404 В этом учете такого заказа нет
409 Заказ уже завершен (sales_order_not_editable) либо Idempotency-Key повторен с другим телом
422 Заказ отменен и не редактируется (sales_order_cancel_not_allowed) либо дата документа попадает в закрытый учетный период, а тело выходит за границу разрешенных в нем полей — delivery_date, priority и notes (inventory_period_closed)
429 Превышена частота обращений. Задержка до повтора — в заголовке Retry-After

curl --request PATCH \ --url 'https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21' \ --header 'Content-Type: application/json' \ --data '{ "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "priority": 1 }'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42", { method: "PATCH", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type": "application/json", }, body: JSON.stringify({ "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "priority": 1 }), }); const data = await response.json();

import requests response = requests.patch( "https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", }, json={ "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "priority": 1 }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/sales-orders/42'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'PATCH', 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' { "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "priority": 1 } 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": "Название" } ] }