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

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

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

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

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

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

{
    "id": "LM140101-123456",
    "orderNr": "140101-123456",
    "status": "confirmed",
    "paymentMethod": "COD",
    "paymentDate": "2025-12-01",
    "comment": "Позвонить перед доставкой",
    "createdAt": "2025-12-01",
    "updatedAt": "2025-12-01 11:26:52",
    "deliveryPrice": 299,
    "rejectPrice": 150,
    "fullSum": "5990.00",
    "currency": "rub",
    "itemQuantity": 2,
    "isEditable": true,
    "canBeCancelled": true,
    "isConfirmed": true,
    "hasDiscrepancyActs": false,
    "dates": {
        "shipped": null,
        "delivered": null
    },
    "items": [...]
}

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

Товары в заказе (items)

Массив items содержит информацию о каждой позиции:

{
    "id": "IX432-001",
    "sku": "RS-ND1920432",
    "description": "Кроссовки Nike Air Max",
    "size": "42",
    "status": "confirmed",
    "basePrice": "5990.00",
    "salePrice": "4990.00",
    "paidPrice": "4990.00",
    "couponDiscount": "0.00",
    "loyaltyDiscount": "500.00",
    "totalDiscount": "1000.00",
    "datamatrix": null,
    "datamatrixCode": null
}

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

Адрес доставки

GET /api/v1/orders/{orderNr}/shipping_address — адрес доставки заказа.

{
    "city": "Москва",
    "street": "ул. Тверская",
    "building": "1",
    "apartment": "10",
    "postalCode": "125009",
    "comment": "Домофон не работает"
}

Способ доставки

GET /api/v1/orders/{orderNr}/delivery_method — информация о методе доставки.

{
    "type": "courier",
    "name": "Курьерская доставка",
    "date": "2025-12-03",
    "timeFrom": "10:00",
    "timeTo": "18:00"
}

Данные покупателя

GET /api/v1/orders/{orderNr}/customer — информация о клиенте.

{
    "name": "Иван Иванов",
    "phone": "+7 (999) 123-45-67",
    "email": "customer@example.com"
}

История статусов

GET /api/v1/orders/{orderNr}/statuses — история изменения статусов заказа.

[
    {
        "status": "new",
        "date": "2025-12-01 10:00:00"
    },
    {
        "status": "confirmed",
        "date": "2025-12-01 10:30:00"
    }
]

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

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

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

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

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

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

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

Проверка отмен

1. GET /api/v1/orders?status=canceled — отменённые заказы
   или
2. Получение нотификации statusChanged с новым статусом canceled

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

Если в заказе 2 позиции и 1 не получится собрать:

• Отмените только недоступную позицию через POST /api/v1/orders/{orderNr}/events
• Остальные позиции продолжат обработку