Частые проблемы

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

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

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

Симптом:

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

Причины:

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

Решение:

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

2. Ошибка при создании отгрузки без warehouseCode

Симптом: POST-запрос на создание отгрузки возвращает ошибку валидации (код 400/422)

Причина: Не указан обязательный параметр warehouseCode (обязателен с 30 сентября 2025 г.)

Важно: В некоторых версиях API отсутствие warehouseCode может приводить к timeout запроса. Если запрос зависает — проверьте наличие этого параметра в первую очередь.

Решение:

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

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

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

Симптом: 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. Ошибка 404 при передаче токена не в заголовке

Симптом: 404 Not Found при любых запросах к API

Причина: Токен передаётся как GET-параметр (?access_token=...) или в теле запроса вместо заголовка

Решение: Токен должен передаваться только в заголовке Authorization:

// Правильно:
Authorization: Bearer YOUR_ACCESS_TOKEN

// Неправильно:
GET /api/v1/orders?access_token=YOUR_TOKEN

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

• Отсутствие пробела после Bearer
• Кавычки вокруг токена
• Передача токена через GET-параметр или тело запроса

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

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

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

Причины:

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

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

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

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

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

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

Как отличить интерпункт от пробела:

Символ	Unicode	Внешний вид	Статус
Обычный пробел	U+0020	"Полиэстер - 100%"	Правильно
Интерпункт (·)	U+00B7	"Полиэстер·- 100%"	Ошибка
Неразрывный пробел	U+00A0	"Полиэстер - 100%" (визуально идентичен)	Ошибка

Совет: Если копируете данные из Excel или Word, проверьте символы программно — они часто заменяют обычные пробелы на неразрывные.

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

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

Причины:

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

Решение:

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

Подробнее: Ценовой карантин

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

Симптом:

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

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

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

8. Ссылки на этикетки истекают

Симптом: Ссылка на PDF-этикетку возвращает ошибку или пустой ответ через несколько дней после генерации

Причина: Ссылки на этикетки (товарные, паковые, паллетные) имеют ограниченный срок действия. Этикетки доступны только в определённых статусах заказа/поставки.

Условия доступности:

• FBS: этикетки доступны, пока заказ в статусе Ждёт сборки, Ждёт отгрузки или Отправлен
• FBO: этикетки доступны до закрытия поставки

Решение:

• Скачивайте этикетки сразу после генерации — не рассчитывайте, что ссылка будет работать через неделю
• Сохраняйте PDF-файлы в своей системе
• Если этикетка недоступна — попробуйте перегенерировать через ЛК (только если заказ в нужном статусе)

9. Не удаётся получить вторую этикетку / разделить заказ

Симптом: Нужно разделить заказ на 2+ посылки, но этикетка уже сгенерирована для одной

Решение: Вызовите pack-numbers с нужным количеством грузовых мест:

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

Когда разделять:

• Товары не помещаются в одну коробку
• Товары нужно отправить из разных мест
• Крупногабаритные товары требуют отдельных упаковок

10. Размеры этикеток и качество печати

Симптом: Стандартные этикетки плохо читаются при печати на нестандартном оборудовании

Решение: Lamoda допускает увеличение размера этикеток при условии:

• Штрих-коды остаются читаемыми сканером
• Текст не искажён
• Общая структура этикетки сохранена

Совет: Протестируйте печать и сканирование на первых 5-10 заказах перед массовой отправкой.

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

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

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

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

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

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

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

Решение:

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

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

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

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

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

14. Уникальность номеров PAL

Симптом: Ошибка при приёмке поставки на складе Lamoda

Правило: Номер PAL (штрих-код на этикетке грузового места) должен быть уникальным в рамках одной поставки.

Решение:

• Не дублируйте PAL-номера между грузовыми местами
• Убедитесь, что каждая паллета/коробка имеет уникальный штрих-код
• При перепечатке этикеток проверяйте, что старые номера не используются повторно

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

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

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

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

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

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

См. также

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