API DepotKey

Для сервисов клиента: n8n, Make, Zapier, интернет-магазина, CRM. Ключ создаёт администратор клиента в кабинете (раздел «API и интеграции») или оператор склада. Ключ видит только данные своей компании и только открытые ей разделы.

Авторизация

Authorization: Bearer ffk_…

Ответы — JSON. Ошибка — код HTTP и поле error с описанием. Даты — YYYY-MM-DD.

Чтение

Запрос	Что возвращает
GET /api/v1/me	Компания, склады и открытые разделы
GET /api/v1/products?q=	Товары: поиск по названию, артикулу, штрихкоду
GET /api/v1/stock?warehouse=	Остатки: на складе, резерв, свободно, ожидается
GET /api/v1/moves?from=&to=&type=in\|out\|return	Движение товара
GET /api/v1/orders?from=&to=&status=	Заказы со статусом и трек-номером
GET /api/v1/orders/{id}	Один заказ
GET /api/v1/inbounds?from=&to=&status=	Уведомления о поставке
GET /api/v1/returns?from=&to=	Возвраты

Статусы заказа: new, waiting, ready, picking, shipped, returned, cancelled.

Создание (ключ с правом создавать)

POST /api/v1/orders

curl -X POST https://depotkey.com/api/v1/orders \
  -H "Authorization: Bearer ffk_…" -H "Content-Type: application/json" \
  -d '{
    "number": "SHOP-10045",
    "recipient": {"name": "Lena Hoffmann", "street": "Torstraße 12", "zip": "10115",
                  "city": "Berlin", "country": "DE", "phone": "+49 151 000000", "email": "lena@example.com"},
    "lines": [{"sku": "SKU-20011", "qty": 2}, {"barcode": "8594001200351", "qty": 1}],
    "note": "gift wrap"
  }'

Товар — по артикулу или штрихкоду (sku / barcode) либо по product_id из /products. Повтор номера заказа вернёт 409 — дубль не создаётся. Необязательно: warehouse (код склада), note, recipient.company.

POST /api/v1/orders/{id}/cancel

Отмена, пока заказ не начали собирать.

POST /api/v1/inbounds

{"expected": "2026-11-20", "reference": "CMR-4471", "lines": [{"sku": "SKU-20011", "qty": 120}]}

n8n

Узел HTTP Request → Authentication: Generic Credential Type → Header Auth.
Name: Authorization, Value: Bearer и ключ через пробел.
Чтобы передавать заказы из магазина: триггер магазина (например, новый заказ в Shopify или WooCommerce) → HTTP Request POST /api/v1/orders с полями из заказа.