Ошибки API и типовые проблемы
Частые ошибки Integrations API (/api/integrations/v1). Готовые модули (PlanFix и др.) — в своих разделах.
401 Unauthorized
| Проверьте | |
|---|---|
| Заголовок | Authorization: Bearer {identifier}:{secret} — одно двоеточие, без лишних пробелов |
| Ключ | Создан в Система → Настройка API, секрет не устарел |
| HTTPS | Запросы только по HTTPS |
| URL | Префикс именно /api/integrations/v1/… (других партнёрских REST нет) |
403 Forbidden
| Причина | Что сделать |
|---|---|
| Нет права | В роли API включите нужное право (список прав) |
| Чужая точка | Ключ привязан к точке — не запрашивайте чужой pickup_point_id / заказ |
422 Validation
Ответ Laravel: message + объект errors по полям.
| Ситуация | Частая причина |
|---|---|
| Создание заказа | Нет items; неактивный delivery_method / payment_method; не настроен статус CREATED |
| Проценка | Не передан массив brands (обязателен, ≥1) |
| Пользователь | Нет ни email, ни phone |
| Платёж | amount ≤ 0 или не в копейках; нет module_id и у заказа нет оплаты |
| Остатки | Не заданы storage_id и pick_up_point_id (ни в теле, ни в настройках API) |
| Цены | Передали рубли вместо копеек при записи (1500 вместо 150000) |
| Каталог | Нет external_id у товара/категории |
404 Not Found
- Неверный id заказа / пользователя / платежа / документа / задачи прайса
- Заказ другой точки при привязке ключа
- Позиция не принадлежит указанному заказу
Пустой список заказов
- Есть ли право
orders.read? - Фильтр
status_code/sinceне слишком узкий? - Нужны архивные? Нужно право
orders.read_archived - Ключ привязан к точке, а заказы на другой?
Цены «в 100 раз меньше/больше»
| Направление | Единицы |
|---|---|
Запись (POST/PATCH) | копейки |
| Чтение snapshot | рубли |
Пример: в заказ передали "price": 150000 → в ответе у позиции "price": 1500.
Документы «не создаются»
Так и задумано: API умеет только GET /documents и POST /documents/{id}/external-ref. Документ печатается или формируется на сайте. Подробнее: Документы.
Проценка без результатов
- Точка активна и к ней привязаны поставщики?
- Верный артикул и бренд в
brands? - Таймауты/ошибки поставщика смотрите в
results[].status_codeиdata