Пятый фактор Обсудить задачу
Переносы сайтов и данных

Переход интеграции Lamoda с API v1 на Seller API v2

Lamoda Seller Partner API v2 — единый REST API для работы продавцов по схемам FBS и FBO. Он заменяет два прежних интерфейса: Seller Partner API v1 на JSON-RPC и B2B Platform Partner API v1 на REST. По официальному графику поддержка старых версий завершается 30 ноября 2026 года, а отключение прежних точек доступа запланировано на 1 января 2027 года.

Переход затрагивает больше, чем адрес сервера. В v2 используется OAuth 2.0, запросы идут к ресурсу public-api-seller.lamoda.ru, а sellerId становится явной частью рабочего контекста. Методы каталога, цен, остатков, заказов и логистики сгруппированы по новым REST-ресурсам. Для части операций меняются поля, статусы, правила пагинации и последовательность вызовов.

Мы составляем карту фактического обмена, переносим нужные сценарии и проверяем их на данных продавца. Отдельно отслеживаем операции, у которых в v2 изменена логика либо отсутствует прямой аналог: для них собираем результат из доступных ресурсов на стороне интеграции. Переключение проходит после контрольного прогона карточек, цен, остатков и выбранных операций с заказами.

Срок: 12 рабочих дней

Когда стоит обратиться

Обычно к нам обращаются в таких ситуациях:

  • Интеграция обращается к прежним адресам Seller Partner API v1 или B2B Platform Partner API v1.
  • В коде используются JSON-RPC методы Lamoda, прежние токены или старые структуры товаров и заказов.
  • Команда планирует продажи после 1 января 2027 года и хочет заранее проверить рабочий обмен через API v2.
  • ERP, PIM или WMS связывает карточки, остатки и заказы Lamoda собственными идентификаторами, которые важно сохранить при переходе.

Что именно мы сделаем

01

Собираем журнал вызовов API v1 и отмечаем процессы каталога, цен, остатков, заказов, возвратов и логистики.

02

Сопоставляем каждый используемый метод с ресурсами Seller API v2 по официальной матрице миграции Lamoda.

03

Подключаем OAuth 2.0, sellerId и единый REST API, затем обновляем форматы запросов, ответов и ошибок.

04

Переносим выбранные потоки FBS или FBO и проверяем их на контрольных товарах и заказах продавца.

05

Переключаем рабочий обмен, наблюдаем журнал и передаём таблицу соответствий с инструкцией сопровождения.

Что входит в стоимость

79 900 ₽ за всю работу

Разбираем текущие вызовы Lamoda API v1, сопоставляем их с ресурсами Seller API v2 и обновляем авторизацию, адреса, форматы запросов, идентификаторы, пагинацию и обработку ошибок. Переносим выбранные потоки каталога, цен, остатков и заказов, запускаем контрольный обмен и переключаем рабочий маршрут по выбранному плану.

Что будет готово

Материалы

Передадим вам

  • Рабочая интеграция с Lamoda Seller Partner API v2 для выбранных сценариев каталога, цен, остатков и заказов.
  • Таблица соответствия методов v1 и v2, полей, идентификаторов, статусов FBS или FBO и внутренних сущностей клиента.
  • OAuth-авторизация, журнал запросов и ответов, обработка пагинации, временных ошибок, повторов и пакетных операций.
  • Протокол контрольного обмена, план переключения и инструкция для владельца интеграции, ERP, PIM или WMS.
Проверка

Перед сдачей проверим

  • Интеграция получает OAuth-токен и выполняет выбранные запросы к Seller API v2 с правильным sellerId.
  • Контрольный товар проходит создание или обновление карточки, цены и остатка, а результат подтверждается ответом Lamoda и журналом обмена.
  • Контрольный заказ проходит выбранные этапы FBS или FBO, а статусы и идентификаторы одинаково читаются в Lamoda и внутренней системе.
  • Временная ошибка, истечение токена и повторная обработка проходят предсказуемо, журнал позволяет найти конкретный запрос и его результат.

Как это выглядит на практике

Схема перехода интеграции Lamoda с API v1 на Seller API v2

Каталог и FBS-заказы продолжают работать через Lamoda Seller API v2

  1. 01

    PIM отправляет обновлённую карточку и характеристики товара в новый REST-ресурс Lamoda с идентификатором продавца.

  2. 02

    ERP передаёт цену, а WMS публикует доступный остаток; интеграция сохраняет результат каждой операции в журнале.

  3. 03

    После появления FBS-заказа система связывает позиции Lamoda с внутренними SKU и создаёт задание на сборку.

  4. 04

    Сотрудник печатает выбранную этикетку, меняет статус отправления, а Lamoda и WMS показывают одну последовательность событий.

Что понадобится для работы

От вас

  • Доступ к коду или настройкам действующей интеграции, журналам API v1 и безопасному хранилищу параметров окружения.
  • Реквизиты доступа к Lamoda Seller Partner API v2 и возможность выполнить контрольные операции в кабинете продавца.
  • Перечень используемых схем FBS или FBO, методов, расписаний обмена, складов, внутренних статусов и ответственных сотрудников.
  • Контрольные SKU и заказы, по которым можно проверить карточку, цену, остаток, получение заказа и выбранный логистический этап.

Если у вас немного другая ситуация

Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.

Стоимость работ 79 900 ₽ полная стоимость известна заранее
  1. 3 000 ₽после подписания договора через Диадок
  2. 76 900 ₽после выполнения, демонстрации и приёмки результата

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

Часто спрашивают

Об этой услуге

Когда Lamoda отключит API v1?

Официальная документация Lamoda указывает завершение поддержки прежних версий 30 ноября 2026 года и запланированное отключение Seller Partner API v1 вместе с B2B Platform Partner API v1 с 1 января 2027 года. Рабочий переход стоит завершить заранее, чтобы оставить время на контроль товаров, заказов и логистических статусов.

Какие старые интерфейсы переводятся на Seller API v2?

Единый Seller Partner API v2 заменяет Seller Partner API v1 с протоколом JSON-RPC и B2B Platform Partner API v1 с REST-вызовами. Мы определяем фактический вариант по адресам, методам и журналам, затем собираем одну карту перехода для используемых процессов продавца.

Как меняется авторизация в Lamoda API v2?

Интеграция получает OAuth-токен через POST /v2/auth-token и обращается к единой точке public-api-seller.lamoda.ru. В запросах учитывается sellerId, а реквизиты и токены размещаются в безопасном хранилище. Проверка охватывает первичное получение токена, его обновление и корректную реакцию на ошибку доступа.

Можно перенести одновременно FBS и FBO?

Seller API v2 объединяет работу с обеими схемами. Состав страницы уточняем по реальному обмену продавца: каталог и коммерческие данные могут быть общими, а заказы, отправления, этикетки и возвраты проверяются по каждой используемой схеме. При большом объёме удобно принять перенос последовательными этапами с самостоятельным результатом.

Что происходит с методом v1, у которого изменена логика?

Сначала сверяем его с официальной матрицей миграции Lamoda. Если v2 предлагает несколько ресурсов вместо одного прежнего ответа, интеграция собирает итог на своей стороне и сохраняет понятную структуру для ERP, PIM или отчёта. Такой сценарий отдельно входит в контрольный набор и протокол приёмки.

Сохранятся ли внутренние SKU и связи заказов?

Внутренние идентификаторы остаются опорой обмена. Мы создаём таблицу соответствия SKU, идентификаторов Lamoda, складов, заказов и отправлений, затем проверяем повторные сообщения и обновления. Благодаря этому ERP, PIM и WMS продолжают находить прежние товары и связывать новые события с правильной записью.

Как проходит переключение с v1 на v2?

Сначала выполняется контрольный обмен в v2 на выбранных товарах и заказах. После сверки результатов выбранные задания переводятся на новый маршрут, а журнал наблюдается в рабочем окне. План включает точки проверки каталога, остатков, заказов, токена и временных ошибок, поэтому команда видит состояние перехода по конкретным операциям.

Что входит в фиксированную цену 79 900 рублей?

В стоимость входят аудит одного действующего контура, карта методов, OAuth 2.0, перенос выбранных операций, контрольные товары и заказы, обработка ошибок, переключение, журнал и инструкция. Договор для этой миграции подписываем через Диадок. Вносим 3 000 рублей перед началом, остальную сумму — после проверки Seller API v2 и приёмки. Небольшие связанные уточнения учитываем в цене.

Цена и изменения по ходу работы

Цена на странице окончательная?

Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.

Что означает резерв незапланированных работ?

Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.

Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.

Можно уточнять детали уже во время работы?

Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.

Начало работы и оплата

Как оформляются договор и оплата?

Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.

Когда начинается срок выполнения?

Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.

Как учитываются платные лицензии и внешние сервисы?

До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.

Проверка результата и гарантия

Как принимается готовая работа?

Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.

Какая гарантия действует после сдачи?

На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.

Следующий шаг

Опишите задачу

Опишите задачу и желаемый результат. Можно указать сайт, CMS, 1С, CRM, ERP или другую систему — разберёмся в ситуации и предложим подходящий следующий шаг.

Для безопасности не отправляйте в заявке пароли, коды доступа, токены, паспортные и медицинские данные.