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

Lamoda предоставляет несколько способов доставки заказов клиентам. Партнёры могут получить информацию о доступных методах и интервалах через API. Для курьерской доставки и Почты России используется метод GET /api/v1/delivery_methods, для ПВЗ — метод GET /api/v1/pickup_points/{id} (см. Пункты выдачи).

Типы доставки (shippingMethodTypeCode)

Уровни сервиса (serviceLevelTypeCode)

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

GET /api/v1/delivery_methods

Возвращает доступные интервалы доставки (FlatInterval) для курьерской службы или Почты России. Можно вызвать по адресу (через address_object_id) или по заказу (через order_id).

Вариант 1: Получение по адресу

* Несовместим с order_id. Используйте либо address_object_id, либо order_id.

Вариант 2: Получение по заказу

* Несовместим с address_object_id и другими адресными параметрами (partner_id, latitude, longitude, item_count, cart_amount, country, weight).

Пример запроса (по адресу)

curl -X GET "https://api-b2b.lamoda.ru/api/v1/delivery_methods?address_object_id=770000000001707000001&item_count=3&cart_amount=5000" \
-H "Authorization: Bearer YOUR_TOKEN"

Пример запроса (по заказу)

curl -X GET "https://api-b2b.lamoda.ru/api/v1/delivery_methods?order_id=MP-123456" \
-H "Authorization: Bearer YOUR_TOKEN"

Пример ответа (FlatInterval)

[
  {
    "intervalId": 514877540,
    "dayDate": "2025-12-03",
    "intervalStart": "2025-12-03 10:00:00",
    "intervalEnd": "2025-12-03 14:00:00",
    "checkoutMethodDeliveryPrice": "250.00",
    "methodTypeCode": "lamoda",
    "methodTypeName": "Курьерская доставка Lamoda Express",
    "serviceLevelTypeCode": "plus",
    "serviceLevelTypeName": "С примеркой"
  },
  {
    "intervalId": 514877541,
    "dayDate": "2025-12-03",
    "intervalStart": "2025-12-03 14:00:00",
    "intervalEnd": "2025-12-03 18:00:00",
    "checkoutMethodDeliveryPrice": "250.00",
    "methodTypeCode": "lamoda",
    "methodTypeName": "Курьерская доставка Lamoda Express",
    "serviceLevelTypeCode": "plus",
    "serviceLevelTypeName": "С примеркой"
  },
  {
    "intervalId": 514877542,
    "dayDate": "2025-12-04",
    "intervalStart": "2025-12-04 10:00:00",
    "intervalEnd": "2025-12-04 22:00:00",
    "checkoutMethodDeliveryPrice": "0.00",
    "methodTypeCode": "lamoda",
    "methodTypeName": "Курьерская доставка Lamoda Express",
    "serviceLevelTypeCode": "economy_b2b",
    "serviceLevelTypeName": "Без примерки"
  }
]

Поля ответа FlatInterval

Маппинг: FlatInterval → deliveryMethod в заказе

Поля FlatInterval из GET /delivery_methods имеют другие имена, чем поля deliveryMethod в ответе заказа (GET /orders/{orderNr}). Ниже — таблица соответствия:

GET /api/v1/orders/{orderNr}/delivery_methods

Альтернативный способ получить доступные интервалы доставки — по номеру заказа. Формат ответа идентичен GET /api/v1/delivery_methods (массив FlatInterval[]).

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

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

Информация о доставке в заказе

GET /api/v1/orders/{orderNr}/delivery_method

Получение текущего назначенного метода доставки для заказа.

Пример ответа (через Lamoda Seller Platform API)

{
  "deliveryPrice": "0.00",
  "deliveryDate": "2025-01-25",
  "deliveryIntervalFrom": "10:00",
  "deliveryIntervalTo": "14:00",
  "deliveryIntervalId": 512111123,
  "deliveryDateMin": 1,
  "deliveryDateMax": 3,
  "hasIntervals": true,
  "shippingMethodName": "Курьерская доставка Lamoda Express",
  "shippingMethodCode": "lamoda",
  "serviceLevelTypeCode": "plus",
  "serviceLevelTypeName": "С примеркой",
  "shippingMethodTypeCode": "delivery_service",
  "storageDays": null,
  "cutOff": "2025-01-22 03:00:00",
  "standardDeliveryPrice": "0",
  "isDeliveryPriceCustom": false,
  "isEditable": true
}

Полный список полей deliveryMethod

Различия между Lamoda Seller Platform API и Lamoda B2B Platform Partner API

POST GET /api/v1/orders/{orderNr}/delivery_method

Назначение или изменение метода доставки для заказа.

Тело запроса

* Обязателен, если hasIntervals = true. При hasIntervals = false — не передаётся.

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

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/MP-123456/delivery_method" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "deliveryIntervalId": 514877540
}'

Коды ошибок

Статусы доставки

Прямое товародвижение (до клиента)

Обратное товародвижение (возвраты)

Проблемы доставки

Click & Collect (доставка в магазин)

Для партнёров с розничной сетью доступна доставка в собственные магазины. Особенности услуги, регистрация магазинов через API и требуемые данные для подключения описаны в статье Пункты выдачи.

Примерка

При доставке с примеркой (serviceLevelTypeCode plus или economy) клиент может:

• Примерить товары перед оплатой
• Выкупить часть товаров
• Отказаться от части или всех товаров

Важно: При частичном выкупе статус заказа будет Delivered, а статусы товаров — Delivered (выкуплен) или Not bought (не выкуплен).

Рекомендации

1. Учитывайте CutOff — отправляйте заказы до дедлайна, указанного в поле cutOff
2. Отслеживайте статусы — подпишитесь на нотификации statusChanged (см. Типы нотификаций)
3. Обрабатывайте incidence — реагируйте на статусы Delivery incidence, Postponed
4. Планируйте возвраты — забирайте невыкупленные товары минимум раз в неделю
5. Проверяйте hasIntervals — если false, не передавайте deliveryIntervalId, используйте диапазон deliveryDateMin–deliveryDateMax
6. Используйте правильные коды — delivery_service (не courier), plus/economy/economy_b2b (не standard)

См. также

• Адреса и способы доставки
• ПВЗ и магазины партнёра
• Статусы заказов
• Типы нотификаций