Заказы на выкуп с ОТХ
Получить список заказов для клиента
Возвращает выкупы клиента: идентификаторы, статусы, склады, товары и номера МХ-3 и УПД, если они уже появились.
Если на запрошенной странице нет записей, возвращается 404.
path Parameters
versionquery Parameters
pageНомер страницы
perPageКоличество элеметнов на странице
sort_byПоле и направление сортировки. Доступные значения зависят от endpoint, формат как в products <field>_asc или <field>_desc.
Headers
X-Client-IDERP ID клиента
Получить список заказов для клиента › Responses
Успешно
Создать заказ
Создаёт выкуп с хранения. Передайте ERP ID клиента в X-Client-ID, а storage_id и products — в теле; позиция содержит product_code и 31-символьный cis.
Ответ содержит order_id и начальный статус. Проверка товаров и подготовка документов асинхронные; результат проверяйте через GET. Если настроен вебхук, уведомления приходят при ошибках и получении документов, но не обязательно для каждого статуса.
Повтор CIS в обрабатываемых заказах может привести к отказу.
Одна позиция соответствует одному CIS; quantity в этом запросе не используется.
path Parameters
versionHeaders
X-Client-IDERP ID клиента
Создать заказ › Request Body
storage_idИдентификатор склада
client_idВаш идентификатор клиента
Создать заказ › Responses
Заказ успешно создан
order_idИдентификатор заказа
statusСтатус заказа
Получить заказ по идентификатору
Возвращает выкуп по числовому order_id: статус, склад, товары с их статусами и доступные номера МХ-3 и УПД.
Проверяйте заказ после создания, отмены или вебхука.
Статусы выкупа
| Статус | Значение |
|---|---|
in_processing | Заказ принят в обработку. |
validation_success | Проверка маркировок успешна; вся операция ещё не завершена. |
validation_failed | Проверка не пройдена; изучите статусы товаров. |
no_quantity_available | Не удалось подтвердить необходимый остаток. |
preparing_documents | Подготовка документов. |
documents_ready | Готовность документов; промежуточный статус может не попасть в ответ GET. |
order_completed | Выкуп завершён. |
Документы могут появляться не одновременно. Проверяйте products[].status и номера mx3 и upd.
path Parameters
versionorder_idИдентификатор заказа
Headers
X-Client-IDERP ID клиента
Получить заказ по идентификатору › Responses
Заказ найден
order_idИдентификатор заказа
statusСтатус заказа
storage_idИдентификатор склада
created_atДата создания заказа
Список товаров в заказе
mx3Номер документа Mx3
updНомер upd
Отменить заказ по идентификатору
Запускает отмену выкупа; запись остаётся в истории.
Ответ содержит order_id и статус cancellation_start — отмена начата.
Отмена асинхронная. Проверяйте результат через GET; начало отмены ещё не означает освобождение товара.
path Parameters
versionorder_idИдентификатор заказа
Headers
X-Client-IDERP ID клиента
Отменить заказ по идентификатору › Responses
Заказ успешно создан
order_idstatusСтатус заказа