Содержание статьи
Часть руководства «Переход на Lamoda Seller API v2».
Эта страница помогает проверить конкретные методы старой интеграции. Таблица показывает, какие методы v1 переходят на Seller API v2, какие требуют изменения сценария, а какие станут deprecated и позже будут выключены.
Хосты и base path
| API | Host и base path |
|---|---|
| B2B Platform REST v1 | https://api-b2b.lamoda.ru |
| Seller Partner JSON-RPC v1 | https://public-api-seller.lamoda.ru/jsonrpc |
| Seller API v2 | https://public-api-seller.lamoda.ru/api |
В таблицах ниже старые методы указаны относительно host/base path своего старого API. Методы v2 указаны относительно https://public-api-seller.lamoda.ru/api, то есть GET /v2/orders вызывается как GET https://public-api-seller.lamoda.ru/api/v2/orders.
| Статус | Что означает |
|---|---|
| Переходит в v2 | Есть прямой или практически прямой метод v2. |
| Изменился сценарий | В v2 есть часть сценария, но поменялась последовательность действий или нет готовой агрегированной операции. |
| Не входит в v2 | Метод v1 станет deprecated и позже будет выключен. |
B2B Platform REST v1
| Сценарий | Старый метод | Статус | Куда переходить | Комментарий |
|---|---|---|---|---|
| Auth | GET /auth/token | Переходит в v2 | POST /v2/auth-token | Использовать только POST; бизнес-запросы отправлять с Authorization: Bearer <token>. |
| Auth | POST /auth/token | Переходит в v2 | POST /v2/auth-token | Использовать только POST; бизнес-запросы отправлять с Authorization: Bearer <token>. |
| FBO поставки | GET /api/v1/shipments/fulfilment/{code} | Переходит в v2 | GET /v2/fbo/shipments/{shipmentId} | code -> shipmentId; sellerId обязателен в query. |
| FBO поставки | GET /api/v1/shipments/fulfilment | Переходит в v2 | GET /v2/fbo/shipments | Список FBO-поставок; проверить фильтры, page/limit и обязательный sellerId. |
| FBO поставки | POST /api/v1/shipments/fulfilment | Переходит в v2 | POST /v2/fbo/shipments | При создании нужны sellerId, externalShipmentId, warehouseCode, plannedDate, items. |
| FBO поставки | GET /api/v1/shipments/fulfilment/{code}/items | Переходит в v2 | GET /v2/fbo/shipments/{shipmentId}/items | Добавлены page/limit/search; sellerId обязателен. |
| FBO поставки | GET /api/v1/shipments/fulfilment/{code}/statuses | Переходит в v2 | GET /v2/fbo/shipments/{shipmentId}/status-history | Проверить новый enum статусов FBO и includeLinked. |
| Заказы | GET /api/v1/orders | Переходит в v2 | GET /v2/orders | Фильтры стали явными query-параметрами; sellerId обязателен. |
| Заказы | POST /api/v1/orders | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Заказы | GET /api/v1/orders/{orderNr} | Переходит в v2 | GET /v2/orders/{orderId} | orderNr -> orderId; детали включают items и deliveryMethod. |
| Заказы | PATCH /api/v1/orders/{orderNr} | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Заказы | GET /api/v1/orders/count-by-statuses | Изменился сценарий | GET /v2/orders | Готового count-by-statuses нет; агрегировать на стороне интеграции. |
| Заказы | POST /api/v1/orders/{orderNr}/change_status_request | Переходит в v2 | POST /v2/orders/{orderId}/status | Допустимые статусы зависят от сценария обработки заказа; reason обязателен для CANCELED и NOT_DELIVERED. |
| Заказы | POST /api/v1/orders/{orderNr}/items/{itemNr}/change_status_request | Переходит в v2 | POST /v2/orders/{orderId}/items/{itemId}/status | Допустимые статусы зависят от сценария обработки заказа; itemNr -> itemId. |
| Заказы | POST /api/v1/orders/{orderNr}/items | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Заказы | GET /api/v1/orders/{orderNr}/customer | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Заказы | POST /api/v1/orders/{orderNr}/customer | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Доставка заказа | GET /api/v1/orders/{orderNr}/shipping_address | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Доставка заказа | POST /api/v1/orders/{orderNr}/shipping_address | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Заказы | POST /api/v1/orders/{orderNr}/events | Изменился сценарий | POST /v2/orders/{orderId}/status; POST /v2/orders/{orderId}/assembly | Отмена маппится на status CANCELED; подтверждение и сборка стали отдельными шагами. |
| Заказы | GET /api/v1/orders/{orderNr}/statuses | Переходит в v2 | GET /v2/orders/{orderId}/status-history | Для позиций использовать GET /v2/orders/{orderId}/item-statuses. |
| Доставка заказа | GET /api/v1/orders/{orderNr}/delivery_method | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Доставка заказа | POST /api/v1/orders/{orderNr}/delivery_method | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| FBS сборка | POST /api/v1/orders/{sellerOrderNr}/pack-numbers | Переходит в v2 | POST /v2/orders/{orderId}/packs | Новый метод генерирует count паковых кодов. |
| FBS сборка | POST /api/v1/orders/collect | Переходит в v2 | POST /v2/orders/{orderId}/assembly | Сборка стала операцией конкретного заказа. |
| FBS отгрузки | GET /api/v1/shipments | Переходит в v2 | GET /v2/fbs/shipments | Использовать sellerId, status, from, to, search, page/limit. |
| FBS отгрузки | POST /api/v1/shipments/out | Переходит в v2 | POST /v2/fbs/shipments; POST /v2/fbs/prepared-shipments | Выбрать обычную или подготовленную отгрузку; тело запроса строится вокруг паллет, паков и позиций. |
| FBS отгрузки | GET /api/v1/shipments/count-by-statuses | Изменился сценарий | GET /v2/fbs/shipments | Готового метода count-by-statuses нет; агрегировать статусы на стороне интеграции. |
| FBS отгрузки | GET /api/v1/shipments/{shipmentId} | Переходит в v2 | GET /v2/fbs/shipments/{shipmentId} | sellerId обязателен в query. |
| FBS отгрузки | POST /api/v1/shipments/out/{code}/events | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | GET /api/v1/addresses/city | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | GET /api/v1/addresses/building | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | GET /api/v1/addresses/street | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | GET /api/v1/delivery_methods | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | GET /api/v1/delivery_info | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | POST /api/v1/delivery_info/{orderNr} | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Этикетки | GET /api/v1/reports/label/stream | Переходит в v2 | POST /v2/labels/order-items; POST /v2/labels/order-packs; POST /v2/labels/pallets; GET /v2/orders/{orderId}/packs/{packNumber}/label | Старый stream заменить целевыми методами этикеток. |
| FBS отгрузки | GET /api/v1/goods | Переходит в v2 | GET /v2/fbs/shipments/{shipmentId}/items | Для штрихкода пака или паллеты использовать containerBarcode; для FBO-поставки использовать метод товаров FBO-поставки. |
| FBS отгрузки | GET /api/v1/container/{barcode} | Переходит в v2 | GET /v2/fbs/order-containers/{containerBarcode} | Barcode определяется как pack или pallet автоматически. |
| Каталог | GET /api/v1/nomenclatures/metadata/count-by-statuses | Изменился сценарий | GET /v2/nomenclatures | Готового count-by-statuses нет; агрегировать status на стороне интеграции. |
| Каталог | GET /api/v1/nomenclatures/metadata/get-axapta-categories | Переходит в v2 | GET /v2/nomenclature-categories | Термин Axapta category заменить на v2 nomenclature category / ERP category id. |
| Каталог | GET /api/v1/nomenclatures/metadata/get-brands | Изменился сценарий | GET /v2/nomenclature-categories/{categoryId}/attributes-mappings | Глобального метода брендов нет; бренды доступны в соответствиях конкретной категории. |
| Каталог | GET /api/v1/nomenclatures | Переходит в v2 | GET /v2/nomenclatures; POST /v2/nomenclatures-search | Для точного списка использовать GET; для сложных фильтров search. |
| Каталог | POST /api/v1/nomenclatures | Переходит в v2 | POST /v2/nomenclatures | Создание через nomenclature.requestType=CREATE. |
| Каталог | PATCH /api/v1/nomenclatures/{supplierSku} | Переходит в v2 | POST /v2/nomenclatures | Обновление через nomenclature.requestType=UPDATE. |
| Цены | PUT /api/v1/nomenclature/{supplierSku}/country/{country}/price | Переходит в v2 | POST /v2/nomenclature-price | Идентификатор в v2 — parentSku; суммы в минорных единицах валюты. |
| Цены | GET /api/v1/nomenclature/sell-values | Переходит в v2 | GET /v2/nomenclatures-sell-values | Сверить поля priceStatus/priceInfo. |
| Цены | POST /api/v1/nomenclature/country/{country}/prices | Переходит в v2 | POST /v2/nomenclatures-prices | Массовое обновление по prices[].parentSku; country теперь в теле запроса. |
| Остатки | GET /api/v1/stock/goods | Переходит в v2 | GET /v2/fbs/stocks; GET /v2/fbo/stocks | Разделить по модели FBS/FBO. Неликвидные FBO-остатки читать через GET /v2/fbo/stocks/illiquid. |
| Остатки | POST /api/v1/stock/goods | Изменился сценарий | POST /v2/fbs/stocks | В v2 обновление остатков описано для FBS; FBO-остатки доступны только для чтения. |
| Нотификации | POST /api/v1/notifications/resend | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Нотификации | POST /url to receive the request | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Нотификации | POST /url to receive the request (direct transfer of ownership) | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Нотификации | POST /url to receive the request (reverse transfer of ownership) | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | GET /api/v1/pickup_points | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Адреса и доставка | GET /api/v1/pickup_points/{id} | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Подарочные сертификаты | GET /api/v1/gift-certificates | Переходит в v2 | GET /v2/gift-certificates | sellerId обязателен; создание использует country/currency/certificates. |
| Подарочные сертификаты | POST /api/v1/gift-certificates | Переходит в v2 | POST /v2/gift-certificates | sellerId обязателен; создание использует country/currency/certificates. |
| Подарочные сертификаты | GET /api/v1/gift-certificates/balance | Переходит в v2 | GET /v2/gift-certificates/balance | sellerId обязателен. |
| Подарочные сертификаты | POST /api/v1/gift-certificates/payments | Переходит в v2 | POST /v2/gift-certificates/mark-paid | Название операции изменилось; тело запроса содержит certificateIds. |
| Упаковочные материалы | POST /api/v1/brand-packing/pack-nomenclature | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Упаковочные материалы | POST /api/v1/brand-packing/pack-shipment | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Цены | GET /api/v1/minimal_prices | Переходит в v2 | GET /v2/minimal-prices | Фильтры categoryId/subcategoryId/brandId, page/limit; sellerId обязателен. |
| Акты несоответствия/расхождений | GET /api/v1/item/{itemNr}/discrepancy_act/photo/{fileUuid} | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Акты несоответствия/расхождений | GET /api/v1/item/{itemNr}/discrepancy_act/photo | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Партнерские ПВЗ | GET /api/v1/partner-pickups | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Партнерские ПВЗ | POST /api/v1/partner-pickups | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Партнерские ПВЗ | PATCH /api/v1/partner-pickups | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Этикетки | GET /api/v2/reports/label/stream | Переходит в v2 | POST /v2/labels/order-items; POST /v2/labels/order-packs; POST /v2/labels/pallets | Старый reports-метод с /api/v2-префиксом; это не контракт Seller API v2 для labels. Заменить целевыми методами этикеток. |
| Этикетки | POST /api/v1/label/items | Переходит в v2 | POST /v2/labels/order-items | До 100 itemId из деталей заказа v2; не использовать старый itemNr без явного маппинга. Ответ содержит fileUrl и excludedItems. |
| Этикетки | POST /api/v1/label/packs | Переходит в v2 | POST /v2/labels/order-packs | До 100 packNumber за запрос; ответ fileUrl и excludedPacks. |
| Этикетки | POST /api/v1/label/pallets | Переходит в v2 | POST /v2/labels/pallets | До 100 palletBarcodes за запрос; ответ fileUrl и excludedPallets. |
Seller Partner JSON-RPC v1
| Сценарий | Старый метод | Статус | Куда переходить | Комментарий |
|---|---|---|---|---|
| Auth | POST /v1/tokens.create | Переходит в v2 | POST /v2/auth-token | Убрать JSON-RPC envelope; токен использовать как Bearer. |
| Справочники | POST /v1/dictionaries.get | Изменился сценарий | GET /v2/dictionaries; GET /v2/dictionaries/attributes | Разделить общие справочники и атрибутные словари; часть значений зависит от категории. |
| Каталог | POST /v1/nomenclatures.list | Переходит в v2 | GET /v2/nomenclatures; POST /v2/nomenclatures-search | Фильтры перенести из JSON-RPC params в query или тело запроса поиска. |
| Каталог | POST /v1/nomenclatures-metadata.get-axapta-categories | Переходит в v2 | GET /v2/nomenclature-categories | Перейти на v2 category id / ERP category id. |
| Каталог | POST /v1/nomenclatures-metadata.get-brands | Изменился сценарий | GET /v2/nomenclature-categories/{categoryId}/attributes-mappings | Глобального метода брендов нет; использовать соответствия брендов по категории. |
| Каталог | POST /v1/nomenclatures.update-activation | Переходит в v2 | POST /v2/nomenclatures-activation-status | Тело запроса: sellerId, status, country и один из наборов SKU identifiers. |
| Цены | POST /v1/nomenclatures.set-prices | Переходит в v2 | POST /v2/nomenclatures-prices | Массовое обновление; country и prices[] передаются в теле запроса. |
| Цены | POST /v1/nomenclature.update-price | Переходит в v2 | POST /v2/nomenclature-price | Единый метод установки цены; проверить parentSku, saleStart/saleEnd, force. |
| Цены | POST /v1/nomenclature.set-price | Переходит в v2 | POST /v2/nomenclature-price | Единый метод установки цены; проверить parentSku, saleStart/saleEnd, force. |
| Справочники | POST /v1/attributes.list | Переходит в v2 | GET /v2/nomenclature-categories/{categoryId}/attributes | sellerId обязателен; page/limit. |
| Справочники | POST /v1/attributes.sku.list | Переходит в v2 | GET /v2/nomenclatures/{sku}/attributes | sku — Lamoda SKU; sellerId обязателен. |
| Справочники | POST /v1/attribute-dictionaries.list | Переходит в v2 | GET /v2/dictionaries/attributes | Передавать attributeNames; для значений, зависящих от категории, использовать соответствия категории. |
| Каталог | POST /v1/nomenclatures.store | Переходит в v2 | POST /v2/nomenclatures | Создание/обновление через requestType=CREATE/UPDATE. |
| Справочники | POST /v1/attributes-dictionaries-mappings.get | Переходит в v2 | GET /v2/nomenclature-categories/{categoryId}/attributes-mappings | Использовать categoryId и sellerId. |
| Заказы | POST /v1/order-item-statuses.list | Переходит в v2 | GET /v2/orders/{orderId}/item-statuses | Нужен orderId; если старая интеграция искала по item, сначала получить заказ/позиции. |
| Каталог | POST /v1/erp-categories.list | Переходит в v2 | GET /v2/nomenclature-categories | Новый раздел Categories. |
| FBO | POST /v1/fbo/warehouse.list | Не входит в v2 | — | Метод v1 станет deprecated и позже будет выключен. |
| Остатки | POST /v1/stock.list | Переходит в v2 | GET /v2/fbs/stocks; GET /v2/fbo/stocks | Разделить по модели продаж: FBS и FBO. |
| Каталог | POST /v1/nomenclature-images.update | Переходит в v2 | POST /v2/nomenclatures/{sku}/images | До 8 изображений; file base64 или imageId существующего изображения. |
| Заказы/FBS | POST /v1/order.ship | Изменился сценарий | POST /v2/orders/{orderId}/status; POST /v2/orders/{orderId}/assembly | Для FBS KZ статус SHIPPED доступен через status; для сборки использовать assembly. |
| Заказы | POST /v1/order/delivery-note.download | Переходит в v2 | GET /v2/orders/{orderId}/invoice | Возвращает ссылку на накладную заказа. |
| Каталог | POST /v1/nomenclature.list | Переходит в v2 | GET /v2/nomenclatures | Использовать query-фильтры sku/externalSku/parentSku/externalParentSku/country. |
| Вопросы покупателей | POST /v1/questions.list | Переходит в v2 | GET /v2/feedback/questions | Вопросы покупателей переезжают с JSON-RPC на REST; использовать общий host, Bearer auth и sellerId. |
| Вопросы покупателей | POST /v1/questions.answer | Переходит в v2 | POST /v2/feedback/questions/{questionId}/answer | Тело запроса: sellerId, text; текст до 1000 символов. |
Новое в v2 — без аналога в v1
В v2 появились блоки, которых не было в v1 и которых нет в таблицах выше: возвраты FBS, акции, заявки на вывоз (pickup-requests), подарочные сертификаты. Их миграционные сценарии и методы описаны в статье «FBO, возвраты, вопросы, акции и сертификаты» и в профильных статьях раздела «API-интеграция».
См. также
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить