Информация о заказах в кабинете
POST/v1/businesses/:businessId/orders
Возвращает информацию о заказах в кабинете. Запрос можно использовать для отслеживания заказов и их статусов.
{% note tip "Вы также можете настроить API-уведомления" %}
Маркет отправит вам запрос, когда появится новый заказ или изменится его статус. А полную информацию можно получить с помощью этого метода.
{% endnote %}
Доступна фильтрация по параметрам:
-
дата оформления заказа;
-
дата и время обновления заказа;
-
дата отгрузки;
-
статусы заказов (
statuses); -
этапы обработки или причины отмены (
substatuses); -
идентификаторы кампаний;
-
идентификаторы заказов;
-
внешние идентификаторы заказов;
-
тип заказа (настоящий или тестовый);
-
модели размещения;
-
наличие запросов от покупателей на отмену заказа.
Максимальный диапазон дат за один запрос — 30 дней (передается в параметрах fromDate и toDate). Если их не передать, возвращается информация за последние 30 дней.
Результаты возвращаются постранично. Для навигации используйте параметры pageToken и limit.
Получить более подробную информацию о покупателе и его номере телефона можно с помощью запроса GET v2/campaigns/{campaignId}/orders/{orderId}/buyer.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 420
- 500
Список заказов в кабинете.
Запрос содержит неправильные данные. Подробнее об ошибках при работе с заказами
В запросе не указаны данные для авторизации. Подробнее об ошибке
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Запрашиваемый ресурс не найден. Подробнее об ошибке
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Внутренняя ошибка Маркета. Подробнее об ошибке