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

Lamoda B2B Platform Partner API Lamoda поддерживает курьерскую доставку, ПВЗ и доставку в магазины партнёров. Здесь описано, как работать с адресами и получать доступные способы доставки.

Типы доставки

Как определить тип доставки в заказе

// Курьерская доставка
{
  "shippingAddress": {
    "city": "Москва",
    "street": "Летниковская",
    "houseNum": "д.2 с1",
    "pickupPointId": null  // ← null = курьер
  },
  "deliveryMethod": {
    "shippingMethodTypeCode": "delivery_service"
  }
}

// Доставка в ПВЗ
{
  "shippingAddress": {
    "city": "Москва",
    "pickupPointId": "1068467"  // ← есть ID = ПВЗ
  },
  "deliveryMethod": {
    "shippingMethodTypeCode": "pickup"
  }
}

Получение доступных способов доставки

Шаг 1: Получить ID города

Query-параметры:

GET /api/v1/addresses/city?name=Москва

// Ответ
{
  "data": [
    {
      "id": 7700000000000,
      "name": "Москва",
      "name_clean": "москва",
      "level": 4,
      "coordinates": {
        "lat": 55.7558,
        "lon": 37.6173
      },
      "city_clean": "москва",
      "region": "Московская область",
      "region_clean": "московская область",
      "street_clean": null,
      "type": "city",
      "parent_id": 678,
      "parents": [...]
    }
  ]
}

Поля ответа (ObjectResult):

Дополнительные эндпоинты адресов

Контроллер AddressController также обрабатывает маршруты для получения улиц и домов:

Все три эндпоинта возвращают одинаковую структуру ObjectResult (см. таблицу выше), отличаясь значением поля type.

Шаг 2: Получить доступные способы доставки

GET /api/v1/delivery_info?aoid=7700000000000

// Ответ — массив MethodType[] (без обёртки "data")
[
  {
    "code": "lamoda",
    "name": "Курьерская доставка Lamoda Express",
    "serviceLevelTypes": [
      {
        "code": "plus",
        "name": "С примеркой",
        "isTryonAllowed": true,
        "isRejectionAllowed": true,
        "deliveryPriceFrom": "0.00",
        "deliveryPriceTo": "299.00",
        "dayMin": 1,
        "dayMax": 3,
        "isBankcardAccepted": true,
        "paymentType": "online",
        "freeDeliveryNetThresholdFrom": "2000.00",
        "freeDeliveryNetThresholdTo": null,
        "freeDeliveryGrossThresholdFrom": "3000.00",
        "freeDeliveryGrossThresholdTo": null
      },
      {
        "code": "economy_b2b",
        "name": "Без примерки",
        "isTryonAllowed": false,
        "isRejectionAllowed": false,
        "deliveryPriceFrom": "0.00",
        "deliveryPriceTo": "199.00",
        "dayMin": 1,
        "dayMax": 5,
        "isBankcardAccepted": true,
        "paymentType": "online",
        "freeDeliveryNetThresholdFrom": "1500.00",
        "freeDeliveryNetThresholdTo": null,
        "freeDeliveryGrossThresholdFrom": "2500.00",
        "freeDeliveryGrossThresholdTo": null
      }
    ]
  },
  {
    "code": "cdek_branch_tryon",
    "name": "СДЭК ПВЗ с примеркой",
    "serviceLevelTypes": [
      {
        "code": "economy",
        "name": "С примеркой (эконом)",
        "isTryonAllowed": true,
        "isRejectionAllowed": true,
        "deliveryPriceFrom": "0.00",
        "deliveryPriceTo": "0.00",
        "dayMin": 2,
        "dayMax": 5,
        "isBankcardAccepted": true,
        "paymentType": "online",
        "freeDeliveryNetThresholdFrom": null,
        "freeDeliveryNetThresholdTo": null,
        "freeDeliveryGrossThresholdFrom": null,
        "freeDeliveryGrossThresholdTo": null
      }
    ]
  },
  {
    "code": "post_russia",
    "name": "Почта России",
    "serviceLevelTypes": [
      {
        "code": "economy_b2b",
        "name": "Без примерки",
        "isTryonAllowed": false,
        "isRejectionAllowed": false,
        "deliveryPriceFrom": "0.00",
        "deliveryPriceTo": "350.00",
        "dayMin": 5,
        "dayMax": 14,
        "isBankcardAccepted": false,
        "paymentType": "online",
        "freeDeliveryNetThresholdFrom": null,
        "freeDeliveryNetThresholdTo": null,
        "freeDeliveryGrossThresholdFrom": null,
        "freeDeliveryGrossThresholdTo": null
      }
    ]
  }
]

Структура MethodType:

Структура ServiceLevelType:

Шаг 3a: Получить интервалы курьерской доставки

GET /api/v1/delivery_methods?address_object_id=770000000001707000001

// Ответ — массив FlatInterval (без обёртки "data")
[
  {
    "intervalId": 514877540,
    "dayDate": "2025-12-03",
    "intervalStart": "10:00",
    "intervalEnd": "14:00",
    "checkoutMethodDeliveryPrice": "250.00",
    "methodTypeCode": "lamoda",
    "methodTypeName": "Курьерская доставка Lamoda Express",
    "serviceLevelTypeCode": "plus"
  },
  {
    "intervalId": 514877541,
    "dayDate": "2025-12-03",
    "intervalStart": "14:00",
    "intervalEnd": "18:00",
    "checkoutMethodDeliveryPrice": "250.00",
    "methodTypeCode": "lamoda",
    "methodTypeName": "Курьерская доставка Lamoda Express",
    "serviceLevelTypeCode": "plus"
  }
]

Подробная документация: Способы доставки

Шаг 3b: Получить список ПВЗ

// Параметры aoid, item_count и cart_amount — ОБЯЗАТЕЛЬНЫЕ
GET /api/v1/pickup_points?aoid=7700000000000&item_count=3&cart_amount=5000.00

// Фильтрация по типу:
GET /api/v1/pickup_points?aoid=7700000000000&item_count=3&cart_amount=5000.00&method_type_codes[]=pickup
GET /api/v1/pickup_points?aoid=7700000000000&item_count=3&cart_amount=5000.00&method_type_codes[]=store

// Ответ — массив (без обёртки "data")
[
  {
    "id": 1068467,
    "name": "СДЭК Москва-Центр",
    "city": "Москва",
    "street": "ул. Тверская",
    "house": "10",
    "latitude": 55.7558,
    "longitude": 37.6173,
    "isBankcardAccepted": true,
    "is24hours": false,
    "storageLife": 7,
    "serviceLevels": ["plus", "economy"],
    "workTime": [
      {"day": 1, "time_from": "09:00", "time_to": "21:00"},
      {"day": 2, "time_from": "09:00", "time_to": "21:00"},
      {"day": 7, "time_from": "10:00", "time_to": "18:00"}
    ]
  }
]

Подробная документация: Пункты выдачи

Структура shippingAddress

Пример заказа с курьерской доставкой

{
  "id": "CZ117391950",
  "status": "Confirmed",
  "shippingAddress": {
    "zipcode": "115114",
    "region": "Москва",
    "city": "Москва",
    "street": "Летниковская",
    "houseNum": "д.2 с1",
    "apartment": "909",
    "cityId": "7700000000000",
    "pickupPointId": null
  },
  "deliveryMethod": {
    "deliveryPrice": "250.00",
    "standardDeliveryPrice": "350.00",
    "isDeliveryPriceCustom": false,
    "isEditable": true,
    "deliveryDate": "2025-12-03",
    "deliveryIntervalId": 514877541,
    "deliveryIntervalFrom": "15:00",
    "deliveryIntervalTo": "18:00",
    "deliveryDateMin": null,
    "deliveryDateMax": null,
    "hasIntervals": true,
    "shippingMethodName": "Курьерская доставка Lamoda Express",
    "shippingMethodCode": "lamoda",
    "shippingMethodTypeCode": "delivery_service",
    "serviceLevelTypeCode": "economy_b2b",
    "serviceLevelTypeName": "Без примерки",
    "storageDays": null,
    "cutOff": "2025-12-02 03:00:00"
  }
}

Пример заказа с доставкой в ПВЗ

{
  "id": "CZ20018856",
  "status": "Confirmed",
  "shippingAddress": {
    "city": "Москва",
    "pickupPointId": "1068467"
  },
  "deliveryMethod": {
    "deliveryPrice": "0.00",
    "standardDeliveryPrice": "0.00",
    "isDeliveryPriceCustom": false,
    "isEditable": false,
    "deliveryDate": null,
    "deliveryIntervalId": null,
    "deliveryIntervalFrom": null,
    "deliveryIntervalTo": null,
    "deliveryDateMin": "2025-12-04",
    "deliveryDateMax": "2025-12-07",
    "hasIntervals": false,
    "shippingMethodName": "СДЭК ПВЗ с примеркой",
    "shippingMethodCode": "cdek_branch_tryon",
    "shippingMethodTypeCode": "pickup",
    "serviceLevelTypeCode": "economy",
    "serviceLevelTypeName": "С примеркой (эконом)",
    "storageDays": 7,
    "cutOff": "2025-12-03 03:00:00"
  }
}

См. также

• Получение заказов
• Статусы заказов
• Создание отгрузки FBS
• Пункты выдачи
• Способы доставки