Обработка ошибок

Справочник ошибок API Lamoda. Формат ответа и коды ошибок различаются для Lamoda B2B Platform Partner API и Lamoda Seller Partner API. Убедитесь, что вы используете правильный раздел для вашего API.

Lamoda B2B Platform Partner API

REST API возвращает стандартные HTTP-коды состояния и структурированное тело ошибки с строковым кодом.

Структура ответа с ошибкой

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Проверьте переданные данные",
    "details": [
      {
        "field": "sellerId",
        "issue": "Обязательное поле"
      },
      {
        "field": "images[0].order",
        "issue": "Должно быть положительным числом"
      }
    ]
  }
}

Поля ответа:

• error.code — строковый машиночитаемый код (см. таблицу ниже)
• error.message — человекочитаемое описание ошибки
• error.details — массив подробностей валидации (может отсутствовать). Каждый элемент содержит field (путь к полю) и issue (описание проблемы)

Коды ошибок REST API

Примеры ответов REST API

400 — ошибка валидации:

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Invalid sellerId",
    "details": [
      { "field": "sellerId", "issue": "Обязательное поле" }
    ]
  }
}

401 — токен невалиден:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Токен отсутствует или невалиден"
  }
}

404 — ресурс не найден:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Not Found"
  }
}

503 — сервис недоступен:

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Сервис временно недоступен"
  }
}

Lamoda Seller Partner API (JSON-RPC 2.0)

Lamoda Seller Partner API всегда возвращает HTTP 200 и использует числовые коды ошибок в теле JSON-RPC ответа.

Структура ответа с ошибкой

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "error": {
    "code": -32600,
    "message": "validation failure list: seller_id is required",
    "data": {
      "errors": [
        { "field": "seller_id", "message": "is required" }
      ]
    }
  }
}

Поля ответа:

• error.code — числовой код ошибки (см. таблицу ниже)
• error.message — человекочитаемое описание
• error.data — дополнительные данные (может отсутствовать). Для ошибок валидации содержит массив errors с полями field и message

Коды ошибок JSON-RPC

Маппинг JSON-RPC → REST

Если вы мигрируете с Lamoda Seller Partner API на Lamoda B2B Platform Partner API, используйте эту таблицу для сопоставления кодов:

Бизнес-ошибки

Помимо системных кодов, API возвращает бизнес-ошибки в поле message. Ниже — наиболее частые.

Авторизация и партнёры

Товары (номенклатура)

Цены

Скидки и акции

Валидации полей

Правила валидации цен

Формула скидки: sale_price ≥ price × 0.20 и sale_price ≤ price × 0.95. Например, для цены 1000 ₽ допустимая скидочная цена — от 200 до 950 ₽.

Форматы идентификаторов

Доступные страны

Как обрабатывать ошибки

Lamoda B2B Platform Partner API

def handle_rest_error(response):
    """Обработка ошибок Lamoda B2B Platform Partner API"""
    
    if response.status_code == 200:
        return response.json()  # Успех
    
    error = response.json().get("error", {})
    code = error.get("code", "")      # Строка: "VALIDATION_FAILED", "UNAUTHORIZED", ...
    message = error.get("message", "")
    details = error.get("details", [])  # Массив {field, issue}
    
    if code == "UNAUTHORIZED":
        # Токен истёк — обновляем
        refresh_token()
        return retry_request()
    
    elif code == "VALIDATION_FAILED":
        for detail in details:
            print(f"Поле {detail['field']}: {detail['issue']}")
        raise ValidationError(message)
    
    elif code == "NOT_FOUND":
        raise NotFoundError(message)
    
    elif code == "SERVICE_UNAVAILABLE":
        # Внутренняя ошибка — повторяем с задержкой
        time.sleep(5)
        return retry_request()
    
    raise APIError(f"Ошибка {code}: {message}")

Lamoda Seller Partner API

def handle_jsonrpc_error(response):
    """Обработка ошибок Lamoda Seller Partner API"""
    
    data = response.json()  # HTTP всегда 200
    error = data.get("error")
    
    if error is None:
        return data.get("result")  # Успех
    
    code = error.get("code")       # Число: -32600, -32001, ...
    message = error.get("message", "")
    error_data = error.get("data")  # Объект с errors[]
    
    if code == -32001:
        # Unauthorized — обновляем токен
        refresh_token()
        return retry_request()
    
    elif code in (-32600, -32602) or (-32015 - 1000 <= code <= -32015):
        # Ошибка валидации — смотрим детали
        if error_data and "errors" in error_data:
            for err in error_data["errors"]:
                print(f"Поле {err['field']}: {err['message']}")
        raise ValidationError(message)
    
    elif code in (-32000, -32603):
        # Серверная ошибка — повторяем с задержкой
        time.sleep(5)
        return retry_request()
    
    raise APIError(f"Ошибка {code}: {message}")

См. также

• Авторизация
• Известные проблемы
• Best Practices
• Lamoda Seller Partner API vs Lamoda B2B Platform Partner API