POST https://mrp.zolotenkov.ru/api/external/v1/sales-returns/{id}/receive
Требуемое право ключа: write:sales.return.receive
Переводит возврат в RETURNED — то же, что кнопка «Возвращен». С ZOL-16553 склад не меняется: приход делает только restock. Обязателен Idempotency-Key. Тело запроса пустое — что и сколько принимать, ручка берет из строк самого документа.
Параметры пути
idцелое числообязателен
id возврата покупателя
Заголовки
Idempotency-Keyстрокаобязателен
Обязателен. Повтор с тем же ключом возвращает прежний ответ и товар второй раз не приходует. Ответ на повтор помечен заголовком Idempotency-Replayed: true — по коду ответа повтор от первичного вызова не отличается.
Ответы
200 Возврат принят, статус RETURNED, остаток не менялся
400 Тело запроса — не JSON-объект
401 Ключ не передан, недействителен или отозван
403 У ключа нет права write:sales.return.receive
404 В этом учете такого возврата нет
409 Idempotency-Key повторен с другим телом
422 Возврат уже принят, оприходован или отменен (sales_return_invalid_status); в документе нет строк (sales_return_receive_not_allowed)
429 Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений