📚 WMS API Документация

🔐 Аутентификация

Все API endpoints требуют Bearer токен для доступа (кроме этой документации).

Как получить API ключ:

  1. Войдите в систему как администратор
  2. Откройте раздел "Ключи" в правом верхнем углу
  3. Введите название ключа (например, "IKEA Integration")
  4. Нажмите "Сгенерировать ключ"
  5. ⚠️ ВАЖНО: Скопируйте ключ сразу! Он показывается только один раз

Использование в запросах:

Добавьте заголовок Authorization со значением:

Authorization: Bearer ВАШ_API_КЛЮЧ

Пример с cURL:

curl -X GET https://your-domain.com/api.php?path=list-packages \
  -H "Authorization: Bearer abc123def456..."

1. Создание ожидаемой посылки

POST /api.php?path=create-package

Создаёт новую ожидаемую посылку в системе.

Пример запроса:

{
  "source_type": "ikea",
  "source_order_id": "IKEA-12345",
  "customer_id": "CUST-001",
  "customer_name": "Иван Иванов",
  "tracking_number": "TRACK123456789",
  "shop_order_number": "ORD-999",
  "items": [
    {
      "sku": "ITEM-001",
      "name": "Товар 1",
      "quantity": 2
    },
    {
      "sku": "ITEM-002",
      "name": "Товар 2",
      "quantity": 1
    }
  ]
}

Пример ответа:

{
  "success": true,
  "package_id": 1,
  "order_id": 1,
  "tracking_number": "TRACK123456789",
  "items_count": 3,
  "message": "Посылка успешно создана"
}

2. Получение информации о посылке

GET /api.php?path=get-package&tracking_number=TRACK123

Возвращает информацию о посылке по трек-номеру или ID.

Пример ответа:

{
  "success": true,
  "package": {
    "id": 1,
    "tracking_number": "TRACK123456789",
    "status": "pending",
    "expected_items_count": 3,
    "received_items_count": 0,
    "items": [...]
  }
}

3. Список посылок

GET /api.php?path=list-packages&status=pending&limit=10

Возвращает список посылок с возможностью фильтрации.

Параметры:

4. Обновление статуса

POST /api.php?path=update-status

Пример запроса:

{
  "tracking_number": "TRACK123456789",
  "status": "received"
}

💡 Примечания:

⚠️ Безопасность:

← Вернуться к WMS