Товары в заказе

B2B Platform API FBS FBO

Каждый заказ в Lamoda содержит массив товаров (items), каждый из которых имеет собственный идентификатор, статус и набор атрибутов. В этом разделе описаны методы для получения информации о товарах и управления их статусами.

Структура товара в заказе

Товар в заказе содержит следующие ключевые поля:

Получение товаров из заказа

GET /api/v1/orders/{id}

Детальная информация о заказе включает массив items со всеми товарами.

curl -X GET "https://api-b2b.lamoda.ru/api/v1/orders/RU220426-12345" \
-H "Authorization: Bearer YOUR_TOKEN"

Пример ответа (фрагмент)

{
  "orderNr": "RU220426-12345",
  "status": "Confirmed",
  "items": [
    {
      "id": "RU220426-12345-001",
      "sku": "BRAND-SHIRT-001-M",
      "description": "Рубашка хлопковая синяя",
      "size": "M",
      "status": "Confirmed",
      "basePrice": "3990.00",
      "salePrice": "2990.00",
      "paidPrice": "2990.00",
      "couponDiscount": "0.00",
      "loyaltyDiscount": "0.00",
      "totalDiscount": "1000.00",
      "datamatrix": null
    },
    {
      "id": "RU220426-12345-002",
      "sku": "BRAND-JEANS-042-32",
      "description": "Джинсы slim fit",
      "size": "32",
      "status": "Confirmed",
      "basePrice": "5990.00",
      "salePrice": "5990.00",
      "paidPrice": "5990.00",
      "couponDiscount": "0.00",
      "loyaltyDiscount": "0.00",
      "totalDiscount": "0.00",
      "datamatrix": "010460043993125621JgXJ5.w93Rpfr"
    }
  ]
}

Добавление товара в заказ (FBO)

POST /api/v1/orders/{orderNr}/items

Метод позволяет добавить новый товар в существующий заказ. Доступен только для модели FBO.

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

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/RU220426-12345/items" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "BRAND-TSHIRT-007-L",
    "description": "Футболка белая",
    "price": 1990.00,
    "cogsPrice": 800.00,
    "paidPrice": 1990.00,
    "totalDiscount": 0.00
}'

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

{
  "id": "RU220426-12345-003",
  "sku": "BRAND-TSHIRT-007-L",
  "description": "Футболка белая",
  "basePrice": "1990.00",
  "salePrice": "1990.00",
  "paidPrice": "1990.00",
  "status": "Confirmed",
  "datamatrix": null,
  "datamatrixCode": null
}

Изменение статуса отдельного товара

POST /api/v1/orders/{orderNr}/items/{itemNr}/change_status_request

Метод позволяет изменить статус конкретного товара в заказе, не затрагивая остальные товары.

Допустимые статусы для FBS

Пример: отмена одного товара

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/RU220426-12345/items/RU220426-12345-002/change_status_request" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "canceled",
    "reason": "Товар больше не нужен"
}'

Пример: подтверждение возврата товара

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/RU220426-12345/items/RU220426-12345-001/change_status_request" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "returned"
}'

Изменение статуса всех товаров в заказе

POST /api/v1/orders/{orderNr}/change_status_request

Метод изменяет статус сразу всех товаров в заказе.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/RU220426-12345/change_status_request?status=returned" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
-d '{}'

Когда использовать: Используйте массовое изменение статуса для полной отмены заказа

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

GET /api/v1/orders/{orderNr}/customer

Метод возвращает информацию о клиенте, оформившем заказ.

curl -X GET "https://api-b2b.lamoda.ru/api/v1/orders/RU220426-12345/customer" \
-H "Authorization: Bearer YOUR_TOKEN"

Частичный выкуп

Если клиент выкупает не все товары из заказа, каждый товар получает свой статус:

• Выкупленные товары → Delivered
• Отказанные товары → Not bought → Returned
• Возвращённые товары → Claimed → Claimed ok / Claimed defective

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

Ошибки