Получение списка заказов

Новость на модерации

Обновлено

18.12.2025

Содержание статьи

<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a> 
 
Метод возвращает список заказов с возможностью фильтрации по статусу, дате и другим параметрам. 
 
<h2>Базовый запрос</h2> 
 
<pre><code>curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/orders?limit=100">https://api-b2b.lamoda.ru/api/v1/orders?limit=100</a>" \ 
-H "Authorization: Bearer YOUR_TOKEN"</code></pre> 
 
<h2>Параметры запроса</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Параметр</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Обязательный</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>limit</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Количество записей (по умолчанию 20, максимум 100)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>offset</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Смещение для пагинации</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>status</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Фильтр по статусу заказа</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>createdAt[from]</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">date</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Дата создания от (формат: YYYY-MM-DD)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>createdAt[to]</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">date</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Дата создания до</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>updatedAt[from]</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">datetime</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Дата обновления от (формат: YYYY-MM-DD HH:MM:SS)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>updatedAt[to]</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">datetime</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Дата обновления до</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Примеры запросов</h2> 
 
<h3>Получить заказы, готовые к сборке</h3> 
 
<pre><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a>?status=confirmed&limit=100</code></pre> 
 
<h3>Получить заказы за период</h3> 
 
<pre><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a>?createdAt[from]=2025-12-01&createdAt[to]=2025-12-02</code></pre> 
 
<h3>Получить обновлённые заказы (для синхронизации)</h3> 
 
<pre><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a>?updatedAt[from]=2025-12-01 10:00:00&limit=100</code></pre> 
 
 Рекомендация для синхронизации 
Для регулярной синхронизации используйте фильтр <code>updatedAt</code> — он вернёт заказы, у которых изменился статус с последнего запроса. 
<h2>Пример ответа</h2> 
 
<pre><code>{ 
 "orders": [ 
 { 
 "id": "CZ123456789", 
 "status": "Confirmed", 
 "paymentMethod": "COD", 
 "fullSum": "5990.00", 
 "deliveryPrice": "0.00", 
 "createdAt": "2025-12-01", 
 "updatedAt": "2025-12-01 14:30:25", 
 "currency": "rub", 
 "items": [ 
 { 
 "id": 12345, 
 "sku": "SELLER-SKU-001", 
 "description": "Кроссовки Nike Air Max", 
 "paidPrice": 5990, 
 "status": "Confirmed", 
 "size": "42", 
 "datamatrix": null 
 } 
 ], 
 "shippingAddress": { 
 "city": "Москва", 
 "street": "Тверская", 
 "houseNum": "1", 
 "apartment": "10", 
 "zipcode": "125009" 
 }, 
 "deliveryMethod": { 
 "deliveryDate": "2025-12-03", 
 "deliveryIntervalFrom": "10:00", 
 "deliveryIntervalTo": "14:00", 
 "shippingMethodName": "Курьерская доставка Lamoda Express", 
 "shippingMethodCode": "lamoda", 
 "cutOff": "2025-12-07 03:00:00" 
 }, 
 "customer": { 
 "firstName": "Иван", 
 "lastName": "Петров", 
 "phone": "+79001234567" 
 } 
 } 
 ], 
 "total": 150, 
 "limit": 100, 
 "offset": 0 
}</code></pre> 
 
<h2>Структура заказа</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Поле</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>id</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Номер заказа (orderNr) — используется во всех методах</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>status</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Текущий статус заказа</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>paymentMethod</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Способ оплаты (COD — наложенный платёж, prepaid — предоплата)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>fullSum</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Сумма заказа</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>items</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">array</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Товары в заказе</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>shippingAddress</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">object</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Адрес доставки</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>deliveryMethod</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">object</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Информация о доставке</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>customer</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">object</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Данные покупателя</td> 
</tr> 
</tbody> 
</table> 
 
<h3>Поле cutOff</h3> 
 
 Важно: cutOff — дедлайн отгрузки! 
Поле <code>deliveryMethod.cutOff</code> показывает крайний срок, до которого нужно передать заказ в доставку. После этого времени заказ может быть отменён. 
Разница между датой заказа и датой отгрузки должна быть не более 6 дней. 
<h2>Структура товара (item)</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Поле</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>id</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">ID товара в заказе (itemNr)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Ваш артикул (seller_sku)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>description</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Название товара</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>paidPrice</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">number</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Цена товара</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>status</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Статус товара</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>size</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Размер</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>datamatrix</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string|null</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Код маркировки (если применимо)</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Получение одного заказа</h2> 
 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_order_by_order_nr">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_order_by_order_nr</a>" target="_blank">GET /api/v1/orders/{orderNr}</a> 
 
<pre><code>curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/orders/CZ123456789">https://api-b2b.lamoda.ru/api/v1/orders/CZ123456789</a>" \ 
-H "Authorization: Bearer YOUR_TOKEN"</code></pre> 
 
<h2>Polling vs Webhooks</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Подход</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Когда использовать</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Polling</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Периодически запрашивать <code>GET /orders</code> с фильтром по <code>updatedAt</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Для начала интеграции, простая реализация</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Webhooks</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Lamoda отправляет нотификации на ваш URL при изменении статуса</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Для production, real-time обновления</td> 
</tr> 
</tbody> 
</table> 
 
 Рекомендуемый интервал polling 
Для FBS рекомендуется опрашивать API каждые 5-10 минут. Более частые запросы не нужны — статусы меняются не мгновенно. 
<h2>Пагинация</h2> 
 
Для обработки большого количества заказов используйте параметры <code>limit</code> и <code>offset</code>: 
 
<pre><code># Первая страница 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a>?limit=100&offset=0 
 
# Вторая страница 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a>?limit=100&offset=100 
 
# Третья страница 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a>?limit=100&offset=200</code></pre> 
 
<h2>Частые ошибки</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Ошибка</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Причина</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Решение</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>401 Unauthorized</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Токен истёк (TTL 15 мин)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Запросить новый токен</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Пустой список заказов</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет заказов с указанным статусом</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Проверить фильтры или убрать их</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>400 Bad Request</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Неверный формат даты</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Использовать формат YYYY-MM-DD</td> 
</tr> 
</tbody> 
</table> 
 
<h2>См. также</h2> 
 
<ul> 
<li><a href="6_4_order_statuses.html">Статусы заказов</a></li> 
<li><a href="7_2_create_shipment.html">Создание отгрузки</a></li> 
<li><a href="10_1_webhook_setup.html">Настройка вебхуков</a></li> 
</ul>

Помогла эта информация?

Да Нет

Спасибо за отзыв

Отправить

Статусы заказов

Получение списка товаров