Откатить оприходование возврата покупателя

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

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

Переводит возврат из RESTOCKED обратно в RETURNED и сторнирует приход — то же, что «Откатить» в карточке возврата. Повтор по возврату в RETURNED отвечает 200 без изменений. Обязателен Idempotency-Key. Тело пустое.

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

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

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

Заголовки

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

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

Ответы

200 Оприходование откачено, статус RETURNED; либо возврат уже был в RETURNED
400 Тело запроса — не JSON-объект
401 Ключ не передан, недействителен или отозван
403 У ключа нет права write:sales.return.receive
404 В этом учете такого возврата нет
409 Idempotency-Key повторен с другим телом
422 Возврат не принят или отменен (sales_return_invalid_status); учетный период закрыт
429 Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений

curl --request POST \ --url 'https://mrp.zolotenkov.ru/api/external/v1/sales-returns/42/unrestock' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21' \ --header 'Content-Type: application/json' \ --data '{}'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/sales-returns/42/unrestock", { method: "POST", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type": "application/json", }, body: JSON.stringify({}), }); const data = await response.json();

import requests response = requests.post( "https://mrp.zolotenkov.ru/api/external/v1/sales-returns/42/unrestock", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", }, json={}, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/sales-returns/42/unrestock'); 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' {} JSON, ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "items": [ { "batch_id": "42", "id": "42", "item_variant_id": "42", "quantity": 2, "quarantine": false, "reason": "Брак или повреждение", "reason_id": 2, "reason_note": "на корпусе скол, упаковка вскрыта", "sales_order_item_id": "42", "sku": "ITM-4155", "storage_place_id": "42", "title": "Демо: ткань лен", "unit_price": 120 } ], "sales_return": { "cancellation_reason": "Покупатель товар не привез", "created_date": "2026-08-01T09:00:00Z", "customer_id": "42", "external_return_ref": "OZON-RET-88213", "id": "42", "notes": "Возврат по заявке покупателя", "number": "В-4", "refund_amount": 432, "return_date": "2026-08-01T09:00:00Z", "sales_order_id": "42", "sales_order_number": "ЗК-1", "source_type": "SALES_ORDER", "status": "NOT_RETURNED", "storage_place_id": "42", "tracking_info": "Трек СДЭК 1234567890" }, "warnings": [ { "code": "sales_return_quarantine_ignored", "message": "Поле 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" }