Распространенные проблемы при работе с API

Собрали топ проблем, с которыми сталкиваются партнёры при интеграции. Проверьте этот список перед обращением в поддержку.

Критические проблемы

1. "Партнер не найден" (код 50400) CRITICAL

Симптом:

{"jsonrpc":"2.0","error":{"code":50400,"message":"Партнер не найден."}}

Причины:

• Используете update-price для FBS вместо set-price (или наоборот)
• Токен получен от другого API (Seller vs B2B)
• Неверный partnerId
• Партнёр не активирован в системе

Решение:

• FBS: используйте v1.nomenclature.set-price
• FBO: используйте v1.nomenclature.update-price
• Проверьте, что токен получен с правильного endpoint
• Получите partnerId из ответа GET /api/v1/nomenclatures

2. Запрос "зависает" без ответа CRITICAL

Симптом: POST-запрос на создание отгрузки не возвращает ответ, timeout

Причина: Не указан обязательный параметр warehouseCode

Решение:

POST /api/v1/shipments/out
{
  "shipmentId": "SHIP-001",
  "warehouseCode": "your_warehouse",  // ← ОБЯЗАТЕЛЬНО!
  ...
}

Код склада получите у KAM или через POST v1.fbo/warehouse.list

3. Токен истекает слишком быстро CRITICAL

Симптом: 401 Unauthorized через 15 минут после получения токена

Причина: С 01.09.2025 TTL токена сокращён до 15 минут (было 24 часа)

Решение: Реализуйте автообновление токена:

def get_token():
    global token, token_expires_at
    
    # Обновляем за 60 секунд до истечения
    if token_expires_at - time.time() < 60:
        response = requests.post(TOKEN_URL, data={
            "grant_type": "client_credentials",
            "client_id": CLIENT_ID,
            "client_secret": CLIENT_SECRET
        })
        token = response.json()["access_token"]
        token_expires_at = time.time() + 900  # 15 минут
    
return token

Частые ошибки

4. "Указанный материал не найден" HIGH

Симптом: Ошибка при создании товара с атрибутом material_filling

Причины:

• Неправильный разделитель между материалами
• Лишний пробел или спецсимвол перед тире
• Интерпункт (·) вместо обычного пробела

Правильный формат:

//  Правильно (пробел-тире-пробел между материалом и процентом):
"Полиэстер - 100%"

//  Правильно (точка с запятой между материалами):
"Материал 1: Полиэстер - 55%, Хлопок - 45%; Материал 2: Нейлон - 100%"

//  Неправильно (интерпункт вместо пробела):
"Полиэстер·- 100%"

//  Неправильно (запятая вместо точки с запятой):
"Материал 1: Полиэстер - 100%, Материал 2: Хлопок - 100%"

5. Цена не обновляется / карантин HIGH

Симптом: Цена принята, но не отображается на сайте

Причины:

• Цена попала в карантин (снижение более 70%)
• Цена не кратна 10 рублям
• Скидка вне диапазона 5-80%

Решение:

• Проверьте статус цены в ЛК или через API
• При снижении >70% — подтвердите в ЛК или передайте "force": true
• Цена должна быть кратна 10: 1990 , 1995

6. Этикетки: "Partner doesn't have a base warehouse" HIGH

Симптом:

{"message": "Partner doesn't have a base warehouse."}

Причина: Склад не настроен или неактивен для партнера

Решение: Обратитесь к KAM для проверки настроек склада в системе

7. Не удается получить вторую этикетку MEDIUM

Симптом: Нужно разделить заказ на 2 посылки, но этикетка уже сгенерирована Решение: Повторно вызовите pack-numbers с нужным количеством:

POST /api/v1/orders/{orderNr}/pack-numbers
{"packQuantity": 2}  // Получите 2 pack numbers

Нюансы интеграции

8. Какой SKU использовать? MEDIUM

Идентификатор	Где использовать	Пример
seller_sku	Ваш артикул, для цен и остатков	ABC-123-XL
lamoda_sku	Артикул Lamoda, для изображений	MP002XM0ABCD01
lamoda_parent_sku	Родительский артикул (без размера)	MP002XM0ABCD
barcode	EAN/GTIN, для идентификации на складе	4607123456789

Рекомендация: Используйте seller_sku везде, где это возможно — это ваш идентификатор.

9. Разница в 6 дней при создании отгрузки MEDIUM

Симптом: Ошибка при создании отгрузки для старого заказа

Правило: Разница между датой создания заказа и датой отгрузки — не более 6 дней

Решение:

• Отгружайте заказы вовремя
• Если cutOff = null — отгружайте в ближайшей поставке
• Просроченные заказы нужно отменять

10. Статусы товаров ≠ статус заказа MEDIUM

Симптом: Заказ "Delivered", но один товар "Not bought"

Объяснение: При частичном выкупе статусы товаров отличаются от статуса заказа

Решение: Отслеживайте статусы на уровне товаров (items[].status), а не только заказа. Используйте нотификации типа itemStatusChanged.

Чек-лист перед обращением в поддержку

Прежде чем писать в поддержку, проверьте:

1. Токен не истек (TTL = 15 минут)
2. Используете правильный endpoint (Seller vs B2B)
3. Указан warehouseCode в отгрузках
4. Правильный метод для вашей модели (FBS vs FBO)
5. Цена кратна 10 рублям
6. Формат материалов соответствует справочнику

Как сообщить об ошибке

При обращении в поддержку обязательно укажите:

• Время запроса (с часовым поясом)
• Полный curl запроса (без секретов)
• Тело запроса (JSON)
• Тело ответа (полностью)
• HTTP-код ответа

См. также

• Полный справочник кодов ошибок
• Seller API vs B2B Platform API
• Карантин цен