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

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

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

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

{"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. Ошибка при создании отгрузки без warehouseCode

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

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

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

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

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

Причина: С 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 при передаче токена не в заголовке

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

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

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

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

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

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

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

Причины:

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

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

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

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

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

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