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

Статья на модерации

Обновлено

20.03.2026

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

Метод возвращает список заказов с возможностью фильтрации по статусу, дате и другим параметрам.

Базовый запрос

curl -X GET "https://api-b2b.lamoda.ru/api/v1/orders?limit=100" \
-H "Authorization: Bearer YOUR_TOKEN"

Параметры запроса

Параметр	Тип	Обязательный	Описание
`limit`	integer	Нет	Количество записей (по умолчанию 20, максимум 100)
`offset`	integer	Нет	Смещение для пагинации
`status`	string	Нет	Фильтр по статусу заказа
`createdAt[from]`	date	Нет	Дата создания от (формат: YYYY-MM-DD)
`createdAt[to]`	date	Нет	Дата создания до
`updatedAt[from]`	datetime	Нет	Дата обновления от (формат: YYYY-MM-DD HH:MM:SS)
`updatedAt[to]`	datetime	Нет	Дата обновления до

Примеры запросов

Получить заказы, готовые к сборке

GET /api/v1/orders?status=confirmed&limit=100

Получить заказы за период

GET /api/v1/orders?createdAt[from]=2025-12-01&createdAt[to]=2025-12-02

Получить обновлённые заказы (для синхронизации)

GET /api/v1/orders?updatedAt[from]=2025-12-01 10:00:00&limit=100

Рекомендация для синхронизации

Для регулярной синхронизации используйте фильтр updatedAt — он вернёт заказы, у которых изменился статус с последнего запроса.

Пример ответа

{
  "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
}

Структура заказа

Поле	Тип	Описание
`id`	string	Номер заказа (orderNr) — используется во всех методах
`status`	string	Текущий статус заказа
`paymentMethod`	string	Способ оплаты (COD — наложенный платёж, prepaid — предоплата)
`fullSum`	string	Сумма заказа
`items`	array	Товары в заказе
`shippingAddress`	object	Адрес доставки
`deliveryMethod`	object	Информация о доставке
`customer`	object	Данные покупателя

Поле cutOff

Важно: cutOff — дедлайн отгрузки!

Поле deliveryMethod.cutOff показывает крайний срок, до которого нужно передать заказ в доставку. После этого времени заказ может быть отменен.

Разница между датой заказа и датой отгрузки должна быть не более 6 дней.

Структура товара (item)

Поле	Тип	Описание
`id`	integer	ID товара в заказе (itemNr)
`sku`	string	Ваш артикул (seller_sku)
`description`	string	Название товара
`paidPrice`	number	Цена товара
`status`	string	Статус товара
`size`	string	Размер
`datamatrix`	string\|null	Код маркировки (если применимо)

Получение одного заказа

GET /api/v1/orders/{orderNr}

curl -X GET "https://api-b2b.lamoda.ru/api/v1/orders/CZ123456789" \
-H "Authorization: Bearer YOUR_TOKEN"

Polling vs Webhooks

Подход	Описание	Когда использовать
Polling	Периодически запрашивать `GET /orders` с фильтром по `updatedAt`	Для начала интеграции, простая реализация
Webhooks	Lamoda отправляет нотификации на ваш URL при изменении статуса	Для production, real-time обновления

Рекомендуемый интервал polling

Для FBS рекомендуется опрашивать API каждые 5-10 минут. Более частые запросы не нужны — статусы меняются не мгновенно.

Пагинация

Для обработки большого количества заказов используйте параметры limit и offset:

# Первая страница
GET /api/v1/orders?limit=100&offset=0

# Вторая страница
GET /api/v1/orders?limit=100&offset=100

# Третья страница
GET /api/v1/orders?limit=100&offset=200

Частые ошибки

Ошибка	Причина	Решение
`401 Unauthorized`	Токен истёк (TTL 15 мин)	Запросить новый токен
Пустой список заказов	Нет заказов с указанным статусом	Проверить фильтры или убрать их
`400 Bad Request`	Неверный формат даты	Использовать формат YYYY-MM-DD

См. также

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

Да Нет

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

0/1000 Отправить