Возвраты
Получить список заявок на возврат
Возвращает заявки на возврат. Если заявок нет, items пуст.
path Parameters
versionquery Parameters
pageНомер страницы
perPageКоличество заявок на странице
sort_byПоле и направление сортировки. Доступные значения зависят от endpoint, формат как в products <field>_asc или <field>_desc.
Headers
X-Client-IDERP ID клиента
Получить список заявок на возврат › Responses
Список заявок на возврат
Создать заявку на возврат товара с хранения
Создаёт вашу заявку на возврат. Передайте storage_id и products.
Позиции задаются по CIS и артикулу (quantity — 1 или отсутствует) либо по артикулу и количеству без CIS. Во втором случае количество разворачивается в отдельные позиции. Метод принимает JSON, не файл; name не сохраняется.
Ответ содержит return_order_id и статус under_review; окончательное решение по заявке приходит после обработки.
Для позиции без CIS отсутствие quantity означает 1. price необязателен.
path Parameters
versionHeaders
X-Client-IDERP ID клиента
Создать заявку на возврат товара с хранения › Request Body
storage_idИдентификатор склада
Создать заявку на возврат товара с хранения › Responses
Заявка на возврат успешно создана
return_order_idИдентификатор заявки на возврат
statusСтатус заявки
Подтвердить заявку на возврат
Принимает storage_id и полный products, заменяет состав возврата и отправляет его на обработку. Отсутствующие позиции удаляются; склад остаётся прежним.
Для CIS количество — 1 или отсутствует; без CIS передайте артикул и количество.
Ответ содержит under_review, не окончательный confirmed. Результат подтверждения проверяйте через GET.
path Parameters
versionreturn_order_idHeaders
X-Client-IDERP ID клиента
Подтвердить заявку на возврат › Responses
Состав заявки принят и отправлен на обработку; возвращается текущий статус
return_order_idstatusОтменить заявку на возврат
Отменяет возврат и возвращает return_order_id и cancelled. Для подтверждённых позиций восстанавливает предыдущие статусы CIS.
Возврат в returned отменить нельзя. Повторная отмена возвращает текущее состояние, но может повторно отправить заявку во внешнюю обработку.
path Parameters
versionreturn_order_idHeaders
X-Client-IDERP ID клиента
Отменить заявку на возврат › Responses
Заявка отменена
return_order_idstatusВыкупить заявку на возврат
Выкупает подтверждённые позиции возврата в статусе confirmed.
Без тела, без items или с items: [] выполняется полный выкуп. Для частичного передайте непустой items с артикулом и положительным quantity. При нехватке подтверждённых единиц возвращается ошибка; после частичного выкупа заявка получает under_review.
После таймаута сначала получите заявку через GET: повтор может выкупить следующие доступные позиции.
path Parameters
versionreturn_order_idHeaders
X-Client-IDERP ID клиента
Выкупить заявку на возврат › Request Body optional
Позиции для частичного выкупа. Если items не передан или пустой, выкупается вся заявка.
Выкупить заявку на возврат › Responses
Изменения выкупа сохранены и отправлены на обработку; возвращается текущий статус заявки
return_order_idstatusПолучить детальную информацию по заявке на возврат
Возвращает возврат по строковому return_order_id, например R123: номер, склад, статус, товары и суммы.
Проверяйте общий статус и статусы позиций после изменений.
Статусы возврата
| Статус заявки | Значение |
|---|---|
in_processing | Начальная обработка. |
under_review | Заявка находится на рассмотрении. |
confirmed | Заявка подтверждена. |
rejected | Заявка отклонена; изучите позиции. |
cancelled | Заявка отменена. |
returned | Возврат выполнен. |
Статусы позиции
| Статус позиции | Значение |
|---|---|
pending_confirmation | Ожидает подтверждения. |
confirmed | Подтверждена. |
rejected | Отклонена. |
error | Ошибка обработки. |
cancelled | Отменена. |
returned | Возвращена. |
Успешно завершен | Выкуплена. Значение передаётся именно в таком написании. |
error_message содержит причину отклонения или null. Статусы заявки и её позиций проверяйте раздельно.
При создании по количеству сервис разворачивает одну входную строку в отдельные единицы товара. Поэтому длина products ответа не обязана совпадать с числом строк исходного запроса. total_quantity отражает количество единиц, total_amount рассчитывается по сохранённым ценам.
number может оставаться пустым до присвоения номера.
path Parameters
versionreturn_order_idHeaders
X-Client-IDERP ID клиента
Получить детальную информацию по заявке на возврат › Responses
Детальная информация по заявке на возврат
return_order_idИдентификатор заявки на возврат
numberНомер заявки на возврат. Может быть пустой строкой, если номер еще не присвоен.
statusСтатус заявки на возврат
storage_idИдентификатор склада
created_atДата создания заявки
total_quantityОбщее количество товаров в заявке
total_amountОбщая сумма товаров в заявке
Изменить заявку на возврат
Заменяет состав возврата и отправляет его на повторную обработку. Передайте storage_id и полный products: отсутствующие позиции удаляются. Склад остаётся прежним; заявки в cancelled и returned изменять нельзя.
Для CIS количество — 1 или отсутствует; без CIS передайте артикул и количество. name не сохраняется.
Ответ содержит under_review. Результат обработки проверяйте через GET.
path Parameters
versionreturn_order_idHeaders
X-Client-IDERP ID клиента
Изменить заявку на возврат › Responses
Заявка на возврат успешно обновлена
return_order_idstatus