Пункты выдачи в API

B2B Platform API FBO

Lamoda предоставляет возможность доставки заказов в ПВЗ Lamoda (пункты выдачи заказов) и в магазины партнёра (Click & Collect). Для работы с точками самовывоза используются два набора методов: один для получения списка ПВЗ Lamoda, другой — для управления собственными точками партнёра.

Типы точек самовывоза

Получение ПВЗ Lamoda

GET /api/v1/pickup_points

Метод возвращает список всех ПВЗ Lamoda, доступных для указанного адреса доставки.

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

curl -X GET "https://api-b2b.lamoda.ru/api/v1/pickup_points?aoid=7700000000000&method_type_codes[]=pickup" \
-H "Authorization: Bearer YOUR_TOKEN"

Пример ответа

[
  {
    "id": "3619025932",
    "isTryonAllowed": "1",
    "isRejectionAllowed": "1",
    "isBankcardAccepted": "1",
    "is24hours": "0",
    "hasHorizon": "1",
    "groupId": "3",
    "name": "Новокузнецкая",
    "latitude": "55.738176",
    "longitude": "37.631595",
    "city": "Москва",
    "street": "Новокузнецкая",
    "house": "11"
  }
]

GET /api/v1/pickup_points/{id}

Получение детальной информации о конкретном ПВЗ, включая доступные интервалы доставки.

curl -X GET "https://api-b2b.lamoda.ru/api/v1/pickup_points/3619025932?aoid=7700000000000" \
-H "Authorization: Bearer YOUR_TOKEN"

Интервалы доставки: Метод возвращает доступные даты и временные слоты,

Управление магазинами партнёра

Для услуги Click & Collect (доставка в магазин партнёра) необходимо зарегистрировать магазины в системе Lamoda. Это можно сделать через API или передав Excel-файл вашему KAM.

Особенности доставки в магазины:

• Доставка только курьерской службой LME
• Уровень сервиса — «эконом (без примерки)»
• Lamoda не оповещает клиентов SMS/email о доставке
• Если клиент не выкупил заказ, товары переходят в остатки магазина (не возвращаются на склад Lamoda)

GET /api/v1/partner-pickups

Получение списка всех зарегистрированных магазинов партнёра.

curl -X GET "https://api-b2b.lamoda.ru/api/v1/partner-pickups" \
-H "Authorization: Bearer YOUR_TOKEN"

Пример ответа

[
  {
    "id": 12345,
    "method_code": "brand_store_moscow_tverskaya",
    "name": "Магазин Бренда X ТЦ Европейский",
    "external_id": "STORE_001",
    "group_code": "3",
    "is_active": true,
    "latitude": 55.738176,
    "longitude": 37.631595,
    "is_bankcard_accepted": true,
    "is_24hours": false,
    "storage_life": 7,
    "city": "Москва",
    "street": "Тверская",
    "house": "15",
    "work_time": [
      {"day": 1, "time_from": "10:00", "time_to": "22:00"},
      {"day": 2, "time_from": "10:00", "time_to": "22:00"},
      {"day": 3, "time_from": "10:00", "time_to": "22:00"},
      {"day": 4, "time_from": "10:00", "time_to": "22:00"},
      {"day": 5, "time_from": "10:00", "time_to": "22:00"},
      {"day": 6, "time_from": "10:00", "time_to": "21:00"},
      {"day": 7, "time_from": "10:00", "time_to": "21:00"}
    ]
  }
]

POST /api/v1/partner-pickups

Добавление нового магазина партнёра.

Обязательные поля

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

curl -X POST "https://api-b2b.lamoda.ru/api/v1/partner-pickups" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method_code": "brand_store_spb_nevsky",
    "name": "Магазин Бренда X Невский проспект",
    "external_id": "STORE_SPB_001",
    "latitude": 59.932,
    "longitude": 30.314,
    "storage_life": 7,
    "work_time": [
      {"day": 1, "time_from": "10:00", "time_to": "21:00"},
      {"day": 2, "time_from": "10:00", "time_to": "21:00"},
      {"day": 3, "time_from": "10:00", "time_to": "21:00"},
      {"day": 4, "time_from": "10:00", "time_to": "21:00"},
      {"day": 5, "time_from": "10:00", "time_to": "21:00"},
      {"day": 6, "time_from": "10:00", "time_to": "20:00"},
      {"day": 7, "time_from": "11:00", "time_to": "20:00"}
    ]
}'

PATCH /api/v1/partner-pickups

Обновление информации о магазинах партнёра. Позволяет массово обновить несколько магазинов за один запрос.

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

curl -X PATCH "https://api-b2b.lamoda.ru/api/v1/partner-pickups" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method_code": "brand_store_spb_nevsky",
    "pickups": [
      {
        "id": 12345,
        "name": "Новое название магазина",
        "is_active": true,
        "is_bankcard_accepted": true,
        "is_24hours": false,
        "storage_life": 10,
        "work_time": [
          {"day": 1, "time_from": "09:00", "time_to": "22:00"}
        ]
      }
    ]
}'

Деактивация магазина: Чтобы временно отключить магазин от приёма заказов,

Расписание работы (work_time)

Флоу создания заказа с доставкой в ПВЗ/магазин

1. GET /api/v1/addresses/{type} — получить идентификатор города
2. GET /api/v1/delivery_info — проверить доступные способы доставки
3. GET /api/v1/pickup_points — получить список ПВЗ/магазинов (используйте фильтр method_type_codes[])
4. GET /api/v1/pickup_points/{id} — получить интервалы доставки для выбранной точки
5. POST /api/v1/orders — создать заказ с указанием pickupPointId и выбранного интервала

Статусы заказов с доставкой в магазин

Возвраты при доставке в магазин:

• Обработка возвратов полностью на стороне партнёра
• Вывод из оборота DataMatrix — ответственность партнёра
• Возвращённые товары могут быть отправлены на склад Lamoda как новая поставка
• Конечный статус в системе Lamoda остаётся Delivered to store

Ошибки