HTTP API склада Sklad F5

Проверка живости сервиса и соединения с PostgreSQL.

Copycurl -s "$BASE/health"
# { "ok": true, "service": "sklad-f5-backend" }

Copycurl -s "$BASE/api/warehouses"
# { items: [{ id, name, code, is_default, is_active, sort_order }] }

Copycurl -s -X POST "$BASE/api/warehouses" \
  -H "Content-Type: application/json" \
  -d '{"name":"Склад СПб","code":"spb"}'

Переименовать, сменить code, is_active, назначить is_default: true.

Только если нет ненулевых остатков и pending-резервов. Иначе 409. Нельзя удалить единственный / основной без замены.

Copycurl -s "$BASE/api/products?search=кабель&status=ok&warehouse_id=UUID"

Один товар. 404 если не найден.

Copycurl -s -X POST "$BASE/api/products" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Кабель ВВГ 3×2.5",
    "sku": "KB-001",
    "category": "Электрика",
    "unit": "м",
    "quantity": 100,
    "min_quantity": 20,
    "purchase_price": 45,
    "sale_price": 69
  }'

Обновление. Нельзя поставить quantity ниже текущего резерва — ответ 409.

Удаляет товар, связанные движения и позиции сделок; пытается убрать из каталога amoCRM.

Copycurl -s -X POST "$BASE/api/products/bulk-delete" \
  -H "Content-Type: application/json" \
  -d '{"ids":["uuid-1","uuid-2"]}'

Массовый импорт. До 5000 позиций. При update_quantity: true количество прибавляется к существующему артикулу.

Copycurl -s -X POST "$BASE/api/products/import" \
  -H "Content-Type: application/json" \
  -d '{
    "update_quantity": true,
    "items": [
      {"name":"Саморез","sku":"SR-1","quantity":100,"sale_price":3.5}
    ]
  }'

Выгрузить весь каталог в список товаров amoCRM.

Шаблоны сопоставления колонок для Excel/CSV-импорта в UI.

Поступление (+quantity). 201 → { product, movement }.

Copycurl -s -X POST "$BASE/api/stock/incoming" \
  -H "Content-Type: application/json" \
  -d '{"productId":"UUID","warehouseId":"WAREHOUSE_UUID","quantity":50,"comment":"Приход от поставщика"}'

Списание (−quantity). 409 если не хватает физического остатка.

Отгрузка (−quantity). Аналогично write-off, тип движения shipment.

Инвентаризация: установить абсолютный targetQuantity.

Copycurl -s -X POST "$BASE/api/stock/adjustment" \
  -H "Content-Type: application/json" \
  -d '{"productId":"UUID","warehouseId":"WAREHOUSE_UUID","targetQuantity":120,"comment":"Инвентаризация"}'

Последние 200 движений. Query: warehouse_id — фильтр по складу. В ответе есть поля склада.

Copycurl -s "$BASE/api/deals/12345678/products"
# { items, total_amount, positions, total_quantity }

Создаёт/обновляет резерв pending на выбранном складе. Один товар можно резервировать с разных складов отдельными строками. При нехватке — 409 INSUFFICIENT_STOCK.

Пакетное добавление. Транзакция: при ошибке одной позиции откатывается весь пакет.

Copycurl -s -X POST "$BASE/api/deals/12345678/products/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "warehouse_id": "WAREHOUSE_UUID",
    "items": [
      {"product_id":"uuid-1","quantity":2,"price":1500,"warehouse_id":"WAREHOUSE_UUID"},
      {"product_id":"uuid-2","quantity":1,"price":990,"warehouse_id":"WAREHOUSE_UUID"}
    ]
  }'

Изменить количество/цену/статус позиции. Для pending снова проверяется свободный остаток.

Copycurl -s -X PUT "$BASE/api/deals/12345678/products/POSITION_UUID" \
  -H "Content-Type: application/json" \
  -d '{"quantity":3,"price":1400,"status":"pending"}'

Снять позицию (резерв). Ответ 204.

Возврат. Для shipped увеличивает остаток; для pending снимает резерв. Может создать примечание/задачу/смену этапа по настройкам.

Copycurl -s -X POST "$BASE/api/deals/12345678/return" \
  -H "Content-Type: application/json" \
  -d '{
    "deal_name": "Заказ Иванова",
    "items": [{"deal_product_id":"POSITION_UUID","quantity":1}]
  }'

Copycurl -s "$BASE/api/deals/orders/active?scope=current&limit=50&warehouse_id=UUID"

В заказе: имя сделки, контакт, компания, телефон/ИНН (если синхронизированы), позиции с остатками.

Хранит правила этапов, права, return_rules и widget_settings.webhook.endpoints[] (несколько исходящих URL со своими events/fields).

Copycurl -s -X PUT "$BASE/api/settings" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": 123,
    "write_off_rules": [
      {"pipelineId":"111","statusId":"222","action":"shipment"}
    ],
    "widget_settings": {
      "webhook": {
        "enabled": true,
        "endpoints": [{
          "id": "ep1",
          "name": "Make",
          "url": "https://hook.example/in/xxx",
          "enabled": true,
          "events": ["write_off","shipment","low_stock"],
          "fields": ["product","quantity","deal","stock"]
        }]
      }
    }
  }'

Copycurl -s "$BASE/api/analytics?period=month&warehouse_id=UUID"

Установка: создать каталог товаров в amoCRM, поля, сиды. Используется виджетом при сохранении настроек.

Последние 50 событий установки.

URL для настройки в amoCRM Digital Pipeline / Webhooks. При смене этапа сделки применяет правила склада (отгрузка/списание pending-позиций).

Copy# Укажите в amoCRM:
$BASE/api/webhooks/amocrm

# Ответ:
# { "ok": true, "processed": 1, "results": [ ... ] }