Содержание статьи
Lamoda выпустила вторую версию Seller API: она заменит собой первые версии REST и JSON-RPC API. Это дает единую точку интеграции с актуальными API Lamoda: каталог, цены, остатки, заказы, возвраты, акции и сертификаты.
Авторизация, пагинация, ошибки и форматы данных единые во всех методах API, поэтому интеграцию проще сопровождать и расширять.
Методы v1 будут объявлены deprecated и позже выключены. Интеграции, которые останутся на v1, перестанут работать после отключения старых методов.
Это руководство поможет вам перейти на новую версию API.
Что меняется
| Было | Стало в Seller API v2 |
|---|---|
| B2B REST v1 и Seller JSON-RPC v1 покрывали разные части интеграции. | Один REST API с ресурсами /api/v2/... и новыми разделами, которых не было в v1: возвраты FBS, акции, расширенные FBS/FBO-остатки и отдельные методы этикеток. |
JSON-RPC envelope: method, params, общий URL. | Обычные HTTP-методы, параметры в path/query и теле запроса, ресурсные методы. |
| Часть методов принимала access token в query или по старому auth-контракту. | Единый OAuth client credentials flow и заголовок Authorization: Bearer <token>. |
| Справочники и атрибуты часто использовались как глобальные списки. | Категории, атрибуты и соответствия словарей нужно получать в связке с категорией товара. |
| Общие методы стока и логистики смешивали FBS/FBO. | FBS и FBO разделены по ресурсам и бизнес-сценариям. |
| Методы customer, shipping address, delivery methods и webhooks resend. | Эти методы v1 станут deprecated и позже будут выключены. |
С чего начать
| Если ваша интеграция сейчас использует | Начните с |
|---|---|
| Seller JSON-RPC: товары, атрибуты, цены, изображения (вопросы покупателей — см. «FBO, возвраты, вопросы, акции и сертификаты»). | Каталог, цены и остатки и общие изменения контракта. |
| B2B REST v1: заказы, FBS-отгрузки, этикетки, доставка. | Заказы, FBS и этикетки и затем справочник соответствия по своим методам. |
| B2B REST v1: FBO-поставки, FBO-остатки, сертификаты. | FBO, возвраты, вопросы, акции и сертификаты. |
| Большое количество методов API v2. | Используйте полный справочник соответствия методов. |
Структура руководства
- Общие изменения контракта — авторизация,
sellerId, идентификаторы, ошибки, даты, деньги и переход с JSON-RPC на REST. - Каталог, цены и остатки — карточки, категории, атрибуты, изображения, цены, FBS/FBO-остатки.
- Заказы, FBS и этикетки — список и детали заказов, статусы, сборка, паковые коды, этикетки, FBS-отгрузки.
- FBO, возвраты, вопросы, акции и сертификаты — FBO-поставки и остатки, возвраты, вопросы покупателей, акции, подарочные сертификаты.
- Справочник соответствия методов — сводная таблица методов v1 и целевых методов v2.
Методы v1, которые станут deprecated
Эти методы v1 станут deprecated и позже будут выключены:
- создание/изменения заказа;
- чтение/изменение customer отдельным методом;
- чтение/изменение shipping address отдельным методом;
- подбор и установка методов доставки;
- адресные справочники city/street/building и pickup points;
- управление вебхуками;
- подтверждение FBS-отгрузки через shipment events;
- управление партнерскими ПВЗ;
- получение фото актов несоответствия;
- brand packing;
- отдельный список FBO warehouses.
Полный список изменений описан в справочнике соответствия методов.
Источники
- Academy: API-интеграция
- Lamoda B2B Platform API
- Lamoda Seller Partner API JSON-RPC
- Lamoda Seller REST API
См. также
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить