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

Новость на модерации

Обновлено

18.12.2025

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

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

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

Тип	Код	Признак в JSON
Курьерская доставка	`delivery_service`	`pickupPointId: null`
Пункт выдачи (ПВЗ)	`pickup`	`pickupPointId: "123456"`
Магазин партнёра	`store`	`pickupPointId: "789012"`
Почта России	`post`	`pickupPointId: null`

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

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

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

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

1. Получить ID города → GET /api/v1/addresses/city ↓ 2. Получить способы доставки → GET /api/v1/delivery_info?aoid={cityId} ↓ 3a. Курьер: получить интервалы → GET /api/v1/delivery_methods 3b. ПВЗ: получить список точек → GET /api/v1/pickup_points

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

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

// Ответ
{
  "data": [
    {
      "id": "7700000000000",
      "name": "Москва",
      "region": "Москва"
    }
  ]
}

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

GET /api/v1/delivery_info?aoid=7700000000000

// Ответ
{
  "data": [
    {
      "code": "lamoda",
      "name": "Курьерская доставка Lamoda Express",
      "type": "delivery_service"
    },
    {
      "code": "cdek_branch_tryon",
      "name": "СДЭК ПВЗ с примеркой",
      "type": "pickup"
    },
    {
      "code": "post_russia",
      "name": "Почта России",
      "type": "post"
    }
  ]
}

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

GET /api/v1/delivery_methods?address_object_id=770000000001707000001

// Ответ
{
  "data": [
    {
      "deliveryIntervalId": 514877540,
      "deliveryDate": "2025-12-03",
      "deliveryIntervalFrom": "10:00",
      "deliveryIntervalTo": "14:00",
      "deliveryPrice": "250.00",
      "shippingMethodCode": "lamoda",
      "serviceLevelTypeCode": "plus"
    },
    {
      "deliveryIntervalId": 514877541,
      "deliveryDate": "2025-12-03",
      "deliveryIntervalFrom": "14:00",
      "deliveryIntervalTo": "18:00",
      "deliveryPrice": "250.00"
    }
  ]
}

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

GET /api/v1/pickup_points?aoid=7700000000000

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

// Ответ
{
  "data": [
    {
      "id": "1068467",
      "name": "СДЭК Москва-Центр",
      "address": "ул. Тверская, 10",
      "workingHours": "09:00-21:00",
      "latitude": 55.7558,
      "longitude": 37.6173,
      "methodCode": "cdek_branch_tryon"
    }
  ]
}

Структура shippingAddress

Поле	Описание	Пример
`zipcode`	Почтовый индекс	"115114"
`region`	Регион	"Москва"
`city`	Город	"Москва"
`street`	Улица	"Летниковская"
`houseNum`	Номер дома	"д.2 с1"
`apartment`	Квартира	"909"
`cityId`	КЛАДР города	"7700000000000"
`streetId`	КЛАДР улицы	"77000000000170700"
`buildingId`	КЛАДР дома	"770000000001707000001"
`pickupPointId`	ID ПВЗ (null для курьера)	"1068467" или null

Структура deliveryMethod

Поле	Описание
`deliveryDate`	Дата доставки (для курьера)
`deliveryIntervalFrom`	Начало интервала
`deliveryIntervalTo`	Конец интервала
`deliveryIntervalId`	ID интервала
`deliveryDateMin`	Мин. дата (для ПВЗ)
`deliveryDateMax`	Макс. дата (для ПВЗ)
`deliveryPrice`	Стоимость доставки
`shippingMethodName`	Название способа
`shippingMethodCode`	Код способа (lamoda, cdek_branch и т.д.)
`shippingMethodTypeCode`	Тип: delivery_service, pickup, post
`serviceLevelTypeCode`	Уровень сервиса: plus, economy, economy_b2b
`serviceLevelTypeName`	Название: "С примеркой", "Без примерки"
`storageDays`	Срок хранения в ПВЗ (дни)
`cutOff`	Дедлайн отгрузки
`hasIntervals`	Есть ли интервалы доставки

Уровни сервиса

Код	Название	Описание
`plus`	С примеркой	Клиент может примерить и отказаться
`economy`	С примеркой (эконом)	Примерка, но дешевле
`economy_b2b`	Без примерки	Для B2B-партнёров

Доставка в магазин

Для доставки в магазин используется уровень economy (без примерки), так как товар доставляется в магазин, а не клиенту напрямую.

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

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

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

{
  "id": "CZ20018856",
  "status": "Confirmed",
  "shippingAddress": {
    "city": "Москва",
    "pickupPointId": "1068467"
  },
  "deliveryMethod": {
    "deliveryPrice": "0.00",
    "deliveryDate": null,
    "deliveryDateMin": "2025-12-04",
    "deliveryDateMax": "2025-12-07",
    "hasIntervals": false,
    "shippingMethodName": "СДЭК ПВЗ с примеркой",
    "shippingMethodCode": "cdek_branch_tryon",
    "shippingMethodTypeCode": "pickup",
    "serviceLevelTypeCode": "economy",
    "storageDays": 7
  }
}

См. также

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

Да Нет

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

Отправить

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

Примеры уведомлений в API