Золотенков

Принять возврат покупателя

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