Детали заказа

После получения списка заказов через GET /api/v1/orders вы можете запросить детальную информацию по конкретному заказу, включая товары, адрес доставки, способ оплаты и историю статусов.

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

GET /api/v1/orders/{orderNr} — получить полную информацию о заказе.

GET /api/v1/orders/RU251201-123456
Authorization: Bearer {access_token}

Внимание: Регистр статусов!

Статусы заказов возвращаются в разном регистре в зависимости от статуса:

confirmed, new, cancelled, delivered — lowercase
Ready for shipment, Shipped, Not delivered — PascalCase

Используйте регистронезависимое сравнение при обработке статусов!

Структура ответа

{
  "id": "RU251201-123456",
  "orderNr": "251201-123456",
  "status": "confirmed",
  "shippingType": "crossdocking",
  "paymentMethod": "COD",
  "paymentDate": "2025-12-01",
  "comment": "Позвонить перед доставкой",
  "createdAt": "2025-12-01",
  "updatedAt": "2025-12-01 11:26:52",
  "deliveryPrice": "299.00",
  "rejectPrice": "150.00",
  "fullSum": "5990.00",
  "currency": "rub",
  "itemQuantity": 2,
  "isEditable": true,
  "canBeCancelled": true,
  "isConfirmed": true,
  "hasDiscrepancyActs": false,
  "deprecatedId": 12345678,
  "externalOrderNumber": null,
  "externalTrackingNumber": {
    "PACK123456": "TN123456789"
  },
  "packNumbers": ["PACK123456", "PACK123457"],
  "options": {
    "autoconfirm": false,
    "hasLiquid": false
  },
  "dates": {
    "shipped": null,
    "delivered": null
  },
  "items": [...],
  "shippingAddress": {...},
  "deliveryMethod": {...},
  "customer": {...},
  "tracking": {...}
}

Основные поля заказа

Поле	Тип	Описание
`id`	string	Полный ID заказа (с префиксом страны)
`orderNr`	string	Номер заказа партнёра
`status`	string	Текущий статус заказа (см. Статусы заказов)
`shippingType`	string	Тип отгрузки: `crossdocking` (FBS) или `fulfilment` (FBO)
`paymentMethod`	string	Способ оплаты: `COD` (наложенный платёж), `PREPAID` (предоплата)
`paymentDate`	date	Дата оплаты (для предоплаченных заказов)
`deliveryPrice`	string	Стоимость доставки для клиента
`rejectPrice`	string	Стоимость возврата (если клиент откажется)
`fullSum`	string	Итоговая сумма заказа
`currency`	string	Валюта: `rub`, `kzt`, `byn`
`itemQuantity`	integer	Количество товаров в заказе
`isEditable`	boolean	Можно ли редактировать заказ
`canBeCancelled`	boolean	Можно ли отменить заказ
`isConfirmed`	boolean	Заказ подтверждён
`hasDiscrepancyActs`	boolean	Есть акты расхождений
`packNumbers`	array	Массив pack numbers для заказа
`externalTrackingNumber`	object	Внешние трек-номера (ключ: pack number, значение: трек-номер)
`confirmationFailedCode`	string	Код причины неподтверждения (если заказ не был подтверждён)
`confirmationFailedReason`	string	Текст причины неподтверждения
`options`	object	Опции заказа: `autoconfirm`, `hasLiquid`
`dates`	object	Даты событий: `shipped`, `delivered`

Поля для BY/KZ (рублёвые эквиваленты)

Для заказов из Беларуси и Казахстана возвращаются дополнительные поля с рублёвыми эквивалентами:

Поле	Описание
`exchangeRate`	Курс обмена на момент создания заказа
`deliveryPriceRub`	Стоимость доставки в рублях
`fullSumRub`	Итоговая сумма в рублях
`basePriceRub`, `salePriceRub`, `paidPriceRub`	Цены товаров в рублях

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

Поле	Описание
`id`	ID позиции
`itemNr`	Номер позиции в формате `{orderNr}-{seq}`
`sku`	Артикул товара (lamoda_sku)
`description`	Название товара
`size`	Размер
`status`	Статус позиции (может отличаться от статуса заказа)
`finalERPStatus`	Финальный ERP-статус: `sold`, `rejected`, `claimed_ok`
`basePrice`	Базовая цена
`salePrice`	Цена со скидкой
`paidPrice`	Оплаченная цена
`datamatrix`	Код DataMatrix (для маркированных товаров)
`statusChangeReason`	Причина изменения статуса

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

Важно: статус заказа и статусы товаров в заказе — это разные сущности.

Статус заказа (order.status) — общий статус всего заказа
Статус товара (item.status) — статус конкретной позиции

Товары могут иметь разные статусы внутри одного заказа. Например, один товар может быть отменён (canceled), а остальные — в процессе доставки.

Дополнительные методы

Типичные сценарии

Получение заказов для сборки

1. GET /api/v1/orders?filter=status=confirmed — список подтверждённых заказов
2. GET /api/v1/orders/{orderNr} — детали каждого заказа
3. GET /api/v1/orders/{orderNr}/shipping_address — адрес доставки заказа

Частичная отмена

Если в заказе 2 позиции и 1 не получится собрать — отмените только недоступную позицию через GET /api/v1/orders/{orderNr}/events. Остальные позиции продолжат обработку.

См. также

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

Да Нет

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

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

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

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

Детали заказа в API