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

Полный список кодов ошибок API с описаниями на русском и английском языках.

Системные коды ошибок

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

REST API (B2B Platform)

{
  "error": {
    "code": 50400,
    "message": "Bad Request",
    "description": "Описание ошибки"
  }
}

JSON-RPC (Seller API)

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "error": {
    "code": 50401,
    "message": "Unauthorized"
  }
}

JSON-RPC с деталями валидации

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

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

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

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

Цены

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

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

Цены (price)

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

SKU и идентификаторы

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

Типы отгрузок (shipment_types)

Страны (country)

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

def handle_lamoda_error(response):
    """Обработка ошибок Lamoda API"""
    
    if response.status_code == 401:
        # Токен истёк — обновляем
        refresh_token()
        return retry_request()
    
    error = response.json().get("error", {})
    code = error.get("code")
    message = error.get("message", "")
    
    if code == 50400:
        if "Partner not found" in message:
            raise AuthError("Проверьте client_id и client_secret")
        elif "Price must be rounded" in message:
            raise ValidationError("Цена должна быть кратна 10")
    
    elif code == 50422:
        # Ошибка валидации — смотрим детали
        errors = error.get("errors", [])
        for err in errors:
            print(f"Поле {err['field']}: {err['message']}")
    
    elif code == 50500:
        # Внутренняя ошибка — повторяем с задержкой
        time.sleep(5)
        return retry_request()
    
raise APIError(f"Ошибка {code}: {message}")

См. также

• OAuth 2.0 авторизация
• Известные проблемы
• Best Practices: обработка ошибок