API InventoryMod

Список товаров

Список товаров (опц. фильтр по категории/производителю/валюте/типу). Модели вариантов по умолчанию ИСКЛЮЧЕНЫ (V18): список используется для выбора товара в складских операциях. includeParents: true — для мест, где модели нужны (набор SKU при импорте, экспорт).

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "sku": "ABC-1",
      "barcode": "CODE",
      "name": "Sample",
      "manufacturerId": 1,
      "categoryId": 1,
      "price": 9.99,
      "priceOld": 9.99,
      "rrp": 9.99,
      "currencyId": 1,
      "purchaseCost": 9.99,
      "purchaseCostCurrencyId": 1,
      "url": "string",
      "imageUrl": "string",
      "minQty": 9.99,
      "customFieldValues": {},
      "isArchived": false,
      "kind": "simple",
      "laborCost": 9.99,
      "laborCostCurrencyId": 1,
      "componentsUpdatedAt": "2026-01-01T00:00:00.000Z",
      "parentId": 1,
      "variantKey": "string",
      "nameLocked": false,
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Поиск товаров

Список товаров с фильтрами, поиском, статусом остатка, сортировкой и пагинацией + общее количество.

{
  "data": {
    "items": [
      {
        "id": 1,
        "campaignId": 1,
        "sku": "ABC-1",
        "barcode": "CODE",
        "name": "Sample",
        "manufacturerId": 1,
        "categoryId": 1,
        "price": 9.99,
        "priceOld": 9.99,
        "rrp": 9.99,
        "currencyId": 1,
        "purchaseCost": 9.99,
        "purchaseCostCurrencyId": 1,
        "url": "string",
        "imageUrl": "string",
        "minQty": 9.99,
        "customFieldValues": {},
        "isArchived": false,
        "kind": "simple",
        "laborCost": 9.99,
        "laborCostCurrencyId": 1,
        "componentsUpdatedAt": "2026-01-01T00:00:00.000Z",
        "parentId": 1,
        "variantKey": "string",
        "nameLocked": false,
        "createdAtUtc": "2026-01-01T00:00:00.000Z",
        "updatedAtUtc": "2026-01-01T00:00:00.000Z"
      }
    ],
    "totalCount": 1
  }
}

Сменить тип товара

Сменить тип товара (единственный путь смены kind у существующего товара — V13/D15 планов). updateProduct/bulkUpdateProducts/upsertBySku kind игнорируют.

{
  "opts": {}
}

{
  "data": {}
}

Данные для смены типа

Метрики товара, нужные правилам смены типа. Последовательно: может вызываться внутри транзакции.

{
  "data": {}
}

Выгрузка товаров

Постраничная выгрузка товаров для экспорта — keyset по id (id > afterId). O(n) на весь проход, без деградации глубокого OFFSET; сервер отдаёт по одному батчу, не весь каталог разом. Все товары (включая архивные), порядок по id.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "sku": "ABC-1",
      "barcode": "CODE",
      "name": "Sample",
      "manufacturerId": 1,
      "categoryId": 1,
      "price": 9.99,
      "priceOld": 9.99,
      "rrp": 9.99,
      "currencyId": 1,
      "purchaseCost": 9.99,
      "purchaseCostCurrencyId": 1,
      "url": "string",
      "imageUrl": "string",
      "minQty": 9.99,
      "customFieldValues": {},
      "isArchived": false,
      "kind": "simple",
      "laborCost": 9.99,
      "laborCostCurrencyId": 1,
      "componentsUpdatedAt": "2026-01-01T00:00:00.000Z",
      "parentId": 1,
      "variantKey": "string",
      "nameLocked": false,
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Данные товара для строки заказа

Цена, валюта и доступный остаток товара по складам для строки заказа; для комплекта — расчётный остаток и состав.

{
  "data": {}
}

Получить товар

Товар по id (undefined — нет).

{
  "data": {
    "id": 1,
    "campaignId": 1,
    "sku": "ABC-1",
    "barcode": "CODE",
    "name": "Sample",
    "manufacturerId": 1,
    "categoryId": 1,
    "price": 9.99,
    "priceOld": 9.99,
    "rrp": 9.99,
    "currencyId": 1,
    "purchaseCost": 9.99,
    "purchaseCostCurrencyId": 1,
    "url": "string",
    "imageUrl": "string",
    "minQty": 9.99,
    "customFieldValues": {},
    "isArchived": false,
    "kind": "simple",
    "laborCost": 9.99,
    "laborCostCurrencyId": 1,
    "componentsUpdatedAt": "2026-01-01T00:00:00.000Z",
    "parentId": 1,
    "variantKey": "string",
    "nameLocked": false,
    "createdAtUtc": "2026-01-01T00:00:00.000Z",
    "updatedAtUtc": "2026-01-01T00:00:00.000Z"
  }
}

Найти товар по SKU

Найти товар по SKU.

{
  "data": {
    "id": 1,
    "campaignId": 1,
    "sku": "ABC-1",
    "barcode": "CODE",
    "name": "Sample",
    "manufacturerId": 1,
    "categoryId": 1,
    "price": 9.99,
    "priceOld": 9.99,
    "rrp": 9.99,
    "currencyId": 1,
    "purchaseCost": 9.99,
    "purchaseCostCurrencyId": 1,
    "url": "string",
    "imageUrl": "string",
    "minQty": 9.99,
    "customFieldValues": {},
    "isArchived": false,
    "kind": "simple",
    "laborCost": 9.99,
    "laborCostCurrencyId": 1,
    "componentsUpdatedAt": "2026-01-01T00:00:00.000Z",
    "parentId": 1,
    "variantKey": "string",
    "nameLocked": false,
    "createdAtUtc": "2026-01-01T00:00:00.000Z",
    "updatedAtUtc": "2026-01-01T00:00:00.000Z"
  }
}

Найти товар по SKU или штрихкоду

Найти товар по SKU или штрихкоду.

{
  "data": {
    "id": 1,
    "campaignId": 1,
    "sku": "ABC-1",
    "barcode": "CODE",
    "name": "Sample",
    "manufacturerId": 1,
    "categoryId": 1,
    "price": 9.99,
    "priceOld": 9.99,
    "rrp": 9.99,
    "currencyId": 1,
    "purchaseCost": 9.99,
    "purchaseCostCurrencyId": 1,
    "url": "string",
    "imageUrl": "string",
    "minQty": 9.99,
    "customFieldValues": {},
    "isArchived": false,
    "kind": "simple",
    "laborCost": 9.99,
    "laborCostCurrencyId": 1,
    "componentsUpdatedAt": "2026-01-01T00:00:00.000Z",
    "parentId": 1,
    "variantKey": "string",
    "nameLocked": false,
    "createdAtUtc": "2026-01-01T00:00:00.000Z",
    "updatedAtUtc": "2026-01-01T00:00:00.000Z"
  }
}

История цен

История цен товара.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "productId": 1,
      "price": 9.99,
      "currencyId": 1,
      "createdAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать товар

Создать товар (возвращает id).

{
  "product": {
    "sku": "ABC-1",
    "barcode": "CODE",
    "name": "Sample",
    "manufacturerId": 1,
    "categoryId": 1,
    "price": 9.99,
    "priceOld": 9.99,
    "rrp": 9.99,
    "currencyId": 1,
    "purchaseCost": 9.99,
    "purchaseCostCurrencyId": 1,
    "url": "string",
    "imageUrl": "string",
    "minQty": 9.99,
    "customFieldValues": {},
    "isArchived": false,
    "kind": "simple",
    "laborCost": 9.99,
    "laborCostCurrencyId": 1
  }
}

{
  "data": 1
}

Изменить товар

Обновить поля товара.

{
  "patch": {
    "sku": "ABC-1",
    "barcode": "CODE",
    "name": "Sample",
    "manufacturerId": 1,
    "categoryId": 1,
    "price": 9.99,
    "priceOld": 9.99,
    "rrp": 9.99,
    "currencyId": 1,
    "purchaseCost": 9.99,
    "purchaseCostCurrencyId": 1,
    "url": "string",
    "imageUrl": "string",
    "minQty": 9.99,
    "customFieldValues": {},
    "isArchived": false,
    "kind": "simple",
    "laborCost": 9.99,
    "laborCostCurrencyId": 1
  }
}

{
  "data": null
}

Массовое изменение товаров

Массовое обновление товаров по списку id.

{
  "ids": {},
  "patch": {}
}

{
  "data": null
}

Создать или обновить товар по SKU

Создать или обновить товар по SKU.

{
  "product": {
    "sku": "ABC-1",
    "barcode": "CODE",
    "name": "Sample",
    "manufacturerId": 1,
    "categoryId": 1,
    "price": 9.99,
    "priceOld": 9.99,
    "rrp": 9.99,
    "currencyId": 1,
    "purchaseCost": 9.99,
    "purchaseCostCurrencyId": 1,
    "url": "string",
    "imageUrl": "string",
    "minQty": 9.99,
    "customFieldValues": {},
    "isArchived": false,
    "kind": "simple",
    "laborCost": 9.99,
    "laborCostCurrencyId": 1
  }
}

{
  "data": 1
}

Связи товара

Посчитать всё, что ссылается на товар (для диалога удаления).

{
  "data": {}
}

Удалить товар

Удалить товар физически. - cascade=false (по умолчанию): удаляет только товар и его историю цен, но ТОЛЬКО если нет движений/заказов/резервов/остатка. Иначе бросает ошибку (UI должен предложить архив). - cascade=true: удаляет товар и ВСЕ связанные строки (движения, позиции заказов, резервы, остатки).

{
  "opts": {}
}

{
  "data": null
}

Состав товара

Состав товара с данными компонентов. warehouseId — склад (или набор складов) для колонки «доступно» (без склада — сумма по всем складам, как остаток в списке товаров).

{
  "data": []
}

Добавить или изменить компонент

Добавить компонент в состав или обновить его количество (upsert по паре productId+componentId). Проверки: qty > 0; компонент ≠ товар; нет цикла; компонент складской (simple/assembled); у товара тип с составом (assembled/virtual_kit). Новая строка встаёт в конец (sort_order = max+1).

{
  "input": {}
}

{
  "data": 1
}

Удалить компонент

Удалить компонент из состава.

{
  "data": {}
}

Порядок компонентов

Новый порядок строк состава: componentIds — id товаров-компонентов, ровно текущий набор.

{
  "componentIds": {}
}

{
  "data": null
}

Где используется товар

В составе каких изделий/комплектов используется товар.

{
  "data": []
}

Недопустимые компоненты

id товаров, которые нельзя добавить в состав productId (сам товар + его «предки» — иначе цикл).

{
  "data": {}
}

Себестоимость сборки

Себестоимость единицы изделия по текущим закупочным ценам компонентов (+ стоимость работ).

{
  "data": {}
}

Список осей

Оси модели со значениями и числом вариантов на каждое значение.

{
  "data": []
}

Создать ось

Добавить ось модели. При существующих вариантах — только с defaultValue (иначе нарушится V6).

{
  "name": {},
  "input": {}
}

{
  "data": {}
}

Переименовать ось

Переименовать ось (пересчитывает названия вариантов).

{
  "patch": {}
}

{
  "data": {}
}

Удалить ось

Удалить ось (V10): без вариантов — всегда; с вариантами — если после удаления комбинации остаются уникальными (значения оси у вариантов удаляются, названия пересчитываются). Иначе — ошибка со списком пар.

{
  "data": {}
}

Порядок осей

Порядок осей (влияет на порядок значений в названии варианта).

{
  "optionIds": {}
}

{
  "data": null
}

Добавить значение оси

Добавить значение оси. code — для SKU (по умолчанию транслит значения).

{
  "value": {},
  "code": {}
}

{
  "data": 1
}

Изменить значение оси

Изменить значение/код (пересчитывает названия вариантов с этим значением).

{
  "patch": {}
}

{
  "data": {}
}

Удалить значение оси

Удалить значение — только если ни один вариант его не использует (V10).

{
  "data": null
}

Порядок значений оси

Порядок значений оси.

{
  "valueIds": {}
}

{
  "data": null
}

Список вариантов

Варианты модели (или нескольких моделей — пакетно, для печати этикеток) с значениями осей и остатками.

{
  "data": []
}

Сгенерировать варианты

Сгенерировать варианты модели (V7–V9): копии полей-шаблонов модели, автоназвание, SKU из кодов значений (+ суффикс -2, -3 при занятом SKU). Существующие комбинации пропускаются (в т.ч. архивные — их возвращают в skipped).

{
  "input": {}
}

{
  "data": {}
}

Сменить значения варианта

Сменить комбинацию значений у существующего варианта (проверка V6).

{
  "values": {}
}

{
  "data": {}
}

Привязать товар как вариант

Привязать существующий товар к модели как вариант (переход с «плоских» товаров). Название не меняется.

{
  "values": {}
}

{
  "data": {}
}

Отвязать вариант

Отвязать вариант: станет обычным товаром (значения осей удаляются, название не меняется).

{
  "data": {}
}

Матрица вариантов

Данные для матрицы «ось × ось»: остатки по ВСЕМ складам в ячейке (переключение склада без запроса).

{
  "data": {}
}

Список изображений

Список изображений товара (метаданные, БЕЗ байтов), обложка (sortOrder=0) первой.

{
  "data": []
}

Получить изображение

Данные одного изображения для показа. Для kind='url' вернёт ссылку (dataBase64=null), для kind='blob' — байты в base64. Единственный метод, читающий колонку data.

{
  "data": {}
}

Обложки товаров

Первое изображение каждого товара из списка (миниатюры в списках товаров).

{
  "productIds": {}
}

{
  "data": []
}

Добавить изображение

Добавить изображение (в конец галереи). Валидирует инвариант гибрида: - kind='url' → нужен непустой url, data не задаётся; - kind='blob' → нужен dataBase64 (+ желательно mimeType), url не задаётся. sortOrder = (max по товару) + 1, т.е. первое добавленное становится обложкой (0 при пустой галерее).

{
  "input": {}
}

{
  "data": 1
}

Удалить изображение

Удалить изображение.

{
  "data": null
}

Порядок изображений

Переупорядочить изображения товара по переданному списку id (индекс = новый sortOrder). Так задаётся обложка (первый id в списке). Неупомянутые id не трогаются.

{
  "orderedIds": {}
}

{
  "data": null
}

Список штрихкодов

Все штрихкоды товара (основной — первым).

{
  "data": []
}

Добавить штрихкод

Добавить штрихкод товару. Код нормализуется, тип определяется автоматически (если не задан). Если isPrimary или это первый код товара — становится основным (флаг снимается с прочих, products.barcode синхронизируется).

{
  "input": {}
}

{
  "data": 1
}

Сделать штрихкод основным

Сделать код основным (снять флаг с прочих + синхронизировать products.barcode).

{
  "data": null
}

Удалить штрихкод

Удалить код. Если удалили основной — назначаем основным первый оставшийся (и синхроним product).

{
  "data": null
}

Список складов

Склады. Архивные — только с includeArchived (страница «Склады»); в выборе склада их нет (W1).

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "name": "Sample",
      "code": "CODE",
      "type": "string",
      "address": "string",
      "contact": "string",
      "comment": "string",
      "capacity": 9.99,
      "isDefault": false,
      "isArchived": false,
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать склад

Создать склад.

{
  "warehouse": {
    "name": "Sample",
    "code": "CODE",
    "type": "string",
    "address": "string",
    "contact": "string",
    "comment": "string",
    "capacity": 9.99,
    "isDefault": false,
    "isArchived": false
  }
}

{
  "data": 1
}

Изменить склад

Обновить склад. Смена типа и архив — только у склада без остатков, резервов и открытых заказов (W1/W2).

{
  "data": {
    "name": "Sample",
    "code": "CODE",
    "type": "string",
    "address": "string",
    "contact": "string",
    "comment": "string",
    "capacity": 9.99,
    "isDefault": false,
    "isArchived": false
  }
}

{
  "data": null
}

Удалить склад

Удалить склад (W1). Нельзя: есть ненулевой остаток, активный резерв или открытый заказ на складе. Есть история (движения, строки заказов, резервы) — удалить нельзя, только архивировать (ошибка с кодом, UI предлагает архив). Пустые строки остатка (qty = 0) удаляются вместе со складом.

{
  "data": null
}

Склад по умолчанию

Сделать склад складом по умолчанию: существует, не архивный, не витрина поставщика (W3).

{
  "data": null
}

Список категорий

Список категорий.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "name": "Sample",
      "parentId": 1,
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать категорию

Создать категорию.

{
  "category": {
    "name": "Sample",
    "parentId": 1
  }
}

{
  "data": 1
}

Изменить категорию

Обновить категорию.

{
  "data": {
    "name": "Sample",
    "parentId": 1
  }
}

{
  "data": null
}

Удалить категорию

Удалить категорию.

{
  "data": null
}

Список производителей

Список производителей.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "name": "Sample",
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать производителя

Создать производителя.

{
  "manufacturer": {
    "name": "Sample"
  }
}

{
  "data": 1
}

Изменить производителя

Обновить производителя.

{
  "data": {
    "name": "Sample"
  }
}

{
  "data": null
}

Удалить производителя

Удалить производителя.

{
  "data": null
}

Список валют

Список валют.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "name": "Sample",
      "rate": 9.99,
      "isDefault": false,
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать валюту

Создать валюту.

{
  "currency": {
    "name": "Sample",
    "rate": 9.99,
    "isDefault": false
  }
}

{
  "data": 1
}

Изменить валюту

Обновить валюту.

{
  "data": {
    "name": "Sample",
    "rate": 9.99,
    "isDefault": false
  }
}

{
  "data": null
}

Удалить валюту

Удалить валюту.

{
  "data": null
}

Сделать валюту основной

Сделать валюту основной. Курсы всех валют — «к основной», поэтому при смене основной они пересчитываются (R2): курс := курс / курс новой основной. Было RUB=1 (основная), USD=90 → основная USD: USD=1, RUB=1/90. Раньше новой основной ставился курс 1, а остальные оставались прежними — отчёты считали рубли как доллары.

{
  "data": null
}

Список поставщиков

Список поставщиков.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "name": "Sample",
      "code": "CODE",
      "contact": "string",
      "email": "user@example.com",
      "phone": "string",
      "address": "string",
      "comment": "string",
      "isArchived": false,
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать поставщика

Создать поставщика.

{
  "supplier": {
    "name": "Sample",
    "code": "CODE",
    "contact": "string",
    "email": "user@example.com",
    "phone": "string",
    "address": "string",
    "comment": "string",
    "isArchived": false
  }
}

{
  "data": 1
}

Изменить поставщика

Обновить поставщика.

{
  "data": {
    "name": "Sample",
    "code": "CODE",
    "contact": "string",
    "email": "user@example.com",
    "phone": "string",
    "address": "string",
    "comment": "string",
    "isArchived": false
  }
}

{
  "data": null
}

Удалить поставщика

Удалить поставщика: с закупками — нельзя (K1), только архив.

{
  "data": null
}

Список клиентов

Список клиентов.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "name": "Sample",
      "code": "CODE",
      "contact": "string",
      "email": "user@example.com",
      "phone": "string",
      "address": "string",
      "comment": "string",
      "isArchived": false,
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать клиента

Создать клиента.

{
  "customer": {
    "name": "Sample",
    "code": "CODE",
    "contact": "string",
    "email": "user@example.com",
    "phone": "string",
    "address": "string",
    "comment": "string",
    "isArchived": false
  }
}

{
  "data": 1
}

Изменить клиента

Обновить клиента.

{
  "data": {
    "name": "Sample",
    "code": "CODE",
    "contact": "string",
    "email": "user@example.com",
    "phone": "string",
    "address": "string",
    "comment": "string",
    "isArchived": false
  }
}

{
  "data": null
}

Удалить клиента

Удалить клиента: с заказами — нельзя, только архив.

{
  "data": null
}

Список пользовательских полей

Список кастомных полей товара.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "name": "Sample",
      "type": "string",
      "sortOrder": 1,
      "createdAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Создать поле

Создать кастомное поле товара (возвращает id).

{
  "data": {}
}

{
  "data": 1
}

Изменить поле

Изменить название или тип кастомного поля.

{
  "data": {}
}

{
  "data": null
}

Удалить поле

Удалить кастомное поле.

{
  "data": null
}

Приход

Приход товара на склад (возвращает id операции).

{
  "input": {}
}

{
  "data": 1
}

Расход

Расход/списание товара со склада.

{
  "input": {}
}

{
  "data": 1
}

Корректировка остатка

Корректировка остатка до заданного количества.

{
  "input": {}
}

{
  "data": 1
}

Перемещение

Перемещение товара между складами.

{
  "input": {}
}

{
  "data": 1
}

Зарезервировать

Зарезервировать товар.

{
  "input": {}
}

{
  "data": 1
}

Массовый резерв

Массовый резерв (R5): несколько складов — одной транзакцией (ошибка на любом — ничего не записано).

{
  "inputs": {}
}

{
  "data": {}
}

Снять резерв

Снять резерв.

{
  "input": {}
}

{
  "data": 1
}

Отгрузить из резерва

Списать зарезервированное (отгрузка из резерва).

{
  "input": {}
}

{
  "data": 1
}

Возврат

Возврат товара (приход).

{
  "input": {}
}

{
  "data": 1
}

Списание

Списание товара.

{
  "input": {}
}

{
  "data": 1
}

Пакетные операции

Пакетная обработка складских операций.

{
  "input": {}
}

{
  "data": 1
}

Отменить движение

Откатить складское движение (одно). Правила (D11 планов): - только в окне UNDO_WINDOW_MINUTES; - движение сборки/разборки отменяется только всей операцией (undoOperation); - обратное движение (отмену) отменить нельзя; одно движение — не больше одного раза (UNIQUE reverses_movement_id).

{
  "data": null
}

Проверить остатки

Отчёт расхождений; ничего не меняет.

{
  "data": {}
}

Исправить остатки

Исправить расхождения: reserved = сумма активных резервов, available = qty − reserved. Физический остаток не меняется; если журнал с ним не сходится — пишется корректировка журнала (движение Adjustment с комментарием), чтобы история совпала с остатком. Строки по удалённому складу/товару здесь не трогаются — для них «Очистка осиротевших данных».

{
  "data": {}
}

Сверка с файлом

Серверная сверка: по строкам из CSV ({sku, warehouse, uploadedQty}) резолвит товары/склады и текущие остатки ОДНИМ набором запросов (без выгрузки каталога и без getBalance на строку), считает расхождения. Склад матчится по имени (регистронезависимо) или по id. Возвращает готовую таблицу для UI.

{
  "rows": {}
}

{
  "data": {}
}

Сверка инвентаризации

Сверка подсчёта с остатками. Повторы (SKU, склад) суммируются; количество — parseNumber (запятая, пробелы), пустое/нечисло/отрицательное — ошибка строки (I6). Витрина поставщика и архивный склад — ошибка строки (I5).

{
  "rows": {},
  "opts": {}
}

{
  "data": {}
}

Применить инвентаризацию

Применить инвентаризацию (I1/I2/I11): ОДНОЙ транзакцией и одной операцией по всем складам. Строка применяется, только если остаток не изменился с момента сверки (иначе — в changed, сверить заново); остаток := подсчитано. Документ — номер инвентаризации (по умолчанию INV-ГГГГММДД-ЧЧММ), тип «Inventory».

{
  "input": {}
}

{
  "data": {}
}

Собрать изделия

Собрать N шт.: одна операция Assembly, AssemblyOut по каждому компоненту (qty × N), AssemblyIn изделия с себестоимостью (purchase_price + валюта; при неполной себестоимости — NULL, D13).

{
  "input": {}
}

{
  "data": {}
}

Разобрать изделия

Разобрать N шт. по ТЕКУЩЕМУ составу (D9): DisassemblyOut изделия, DisassemblyIn компонентов (purchase_price = текущая закупочная цена компонента в её валюте).

{
  "input": {}
}

{
  "data": {}
}

Отменить сборку

Отменить операцию сборки/разборки целиком (D11): обратные движения 'Adjustment' со ссылкой на исходные, операция 'Undo' со ссылкой на исходную операцию. Окно — UNDO_WINDOW_MINUTES, повторная отмена запрещена. Если сборка меняла закупочную цену изделия и с тех пор её не меняли — цена и валюта возвращаются (B3/F9).

{
  "data": {}
}

Сколько можно собрать

Сколько изделий можно собрать на складе (только прямые компоненты; полуфабрикат — по его остатку).

{
  "data": {}
}

Остаток товара

Остаток товара на складе (qty/reserved/available).

{
  "data": {
    "id": 1,
    "campaignId": 1,
    "warehouseId": 1,
    "productId": 1,
    "qty": 9.99,
    "reservedQty": 9.99,
    "availableQty": 9.99,
    "lastMovementAtUtc": "2026-01-01T00:00:00.000Z",
    "updatedAtUtc": "2026-01-01T00:00:00.000Z"
  }
}

Список остатков

Остатки (опц. фильтр по складу).

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "warehouseId": 1,
      "productId": 1,
      "qty": 9.99,
      "reservedQty": 9.99,
      "availableQty": 9.99,
      "lastMovementAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Поиск по остаткам

Постраничные остатки: фильтр по складу/статусу, поиск по имени/SKU и сортировка — всё на стороне БД. Поиск и статус 'low' используют products, поэтому джойним products (и warehouses для сортировки/выдачи).

{
  "data": {
    "items": [
      {
        "id": 1,
        "campaignId": 1,
        "warehouseId": 1,
        "productId": 1,
        "qty": 9.99,
        "reservedQty": 9.99,
        "availableQty": 9.99,
        "lastMovementAtUtc": "2026-01-01T00:00:00.000Z",
        "updatedAtUtc": "2026-01-01T00:00:00.000Z"
      }
    ],
    "totalCount": 1
  }
}

Итоги по складам

Суммарный физический остаток по каждому складу (для индикатора загрузки склада).

{
  "data": {}
}

Остатки комплектов

Страница комплектов с расчётным остатком (C5/F8). Пагинация — по комплектам, расчёт пакетный: компоненты страницы и их остатки — двумя запросами (без N+1 вызовов calcBuildable).

{
  "data": {
    "items": [],
    "totalCount": 0
  }
}

Список движений

Складские движения (опц. фильтры).

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "warehouseId": 1,
      "productId": 1,
      "sku": "ABC-1",
      "movementType": "string",
      "qtyDelta": 9.99,
      "reservedDelta": 9.99,
      "qtyBefore": 9.99,
      "qtyAfter": 9.99,
      "reservedBefore": 9.99,
      "reservedAfter": 9.99,
      "purchasePrice": 9.99,
      "purchaseCurrencyId": 1,
      "documentType": "string",
      "documentNumber": "string",
      "operationId": 1,
      "comment": "string",
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "createdBy": "string",
      "createdBySource": "string",
      "reversesMovementId": 1
    }
  ]
}

Поиск движений

Постраничные складские движения.

{
  "data": {
    "items": [
      {
        "id": 1,
        "campaignId": 1,
        "warehouseId": 1,
        "productId": 1,
        "sku": "ABC-1",
        "movementType": "string",
        "qtyDelta": 9.99,
        "reservedDelta": 9.99,
        "qtyBefore": 9.99,
        "qtyAfter": 9.99,
        "reservedBefore": 9.99,
        "reservedAfter": 9.99,
        "purchasePrice": 9.99,
        "purchaseCurrencyId": 1,
        "documentType": "string",
        "documentNumber": "string",
        "operationId": 1,
        "comment": "string",
        "createdAtUtc": "2026-01-01T00:00:00.000Z",
        "createdBy": "string",
        "createdBySource": "string",
        "reversesMovementId": 1
      }
    ],
    "totalCount": 1
  }
}

Список резервов

Резервы (опц. фильтр по статусу/датам). Перед чтением прогоняет истечение просроченных.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "warehouseId": 1,
      "productId": 1,
      "qtyReserved": 9.99,
      "status": "Active",
      "reasonType": "string",
      "documentType": "string",
      "documentNumber": "string",
      "expiresAtUtc": "2026-01-01T00:00:00.000Z",
      "comment": "string",
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z",
      "releasedAtUtc": "2026-01-01T00:00:00.000Z",
      "orderItemId": 1
    }
  ]
}

Поиск резервов

Страница резервов (R7/R8): фильтры, поиск и сортировка — в SQL; ответ — {items, totalCount}.

{
  "data": {
    "items": [
      {
        "id": 1,
        "campaignId": 1,
        "warehouseId": 1,
        "productId": 1,
        "qtyReserved": 9.99,
        "status": "Active",
        "reasonType": "string",
        "documentType": "string",
        "documentNumber": "string",
        "expiresAtUtc": "2026-01-01T00:00:00.000Z",
        "comment": "string",
        "createdAtUtc": "2026-01-01T00:00:00.000Z",
        "updatedAtUtc": "2026-01-01T00:00:00.000Z",
        "releasedAtUtc": "2026-01-01T00:00:00.000Z",
        "orderItemId": 1
      }
    ],
    "totalCount": 1
  }
}

Список заказов

Список заказов покупателей.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "orderNumber": "string",
      "customerId": 1,
      "source": "string",
      "status": "Active",
      "comment": "string",
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z",
      "cancelledAtUtc": "2026-01-01T00:00:00.000Z",
      "shippedAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Поиск заказов

Постраничный список заказов.

{
  "data": {
    "items": [
      {
        "id": 1,
        "campaignId": 1,
        "orderNumber": "string",
        "customerId": 1,
        "source": "string",
        "status": "Active",
        "comment": "string",
        "createdAtUtc": "2026-01-01T00:00:00.000Z",
        "updatedAtUtc": "2026-01-01T00:00:00.000Z",
        "cancelledAtUtc": "2026-01-01T00:00:00.000Z",
        "shippedAtUtc": "2026-01-01T00:00:00.000Z"
      }
    ],
    "totalCount": 1
  }
}

Получить заказ

Заказ по id (с позициями).

{
  "data": {
    "id": 1,
    "campaignId": 1,
    "orderNumber": "string",
    "customerId": 1,
    "source": "string",
    "status": "Active",
    "comment": "string",
    "createdAtUtc": "2026-01-01T00:00:00.000Z",
    "updatedAtUtc": "2026-01-01T00:00:00.000Z",
    "cancelledAtUtc": "2026-01-01T00:00:00.000Z",
    "shippedAtUtc": "2026-01-01T00:00:00.000Z"
  }
}

Создать заказ

Создать заказ.

{
  "input": {}
}

{
  "data": 1
}

Следующий номер заказа

Следующий свободный номер документа с префиксом (напр. «ORD-20261006-»): максимум существующих номеров за этот префикс + 1, три цифры (Z6). Раньше форма считала «все документы + 1» и грузила их целиком.

{
  "data": {}
}

Изменить заказ

Изменить заказ (Z13). Нельзя: отгруженный (в т.ч. частично) и отменённый. Строки — полный список: id есть — существующая (товар не меняется), нет id — новая, отсутствующая в списке — удаляется. Резервы приводятся в соответствие автоматически: удаление строки или смена склада снимают весь её резерв, уменьшение количества — излишек (у комплекта — по каждому компоненту по снимку состава).

{
  "input": {}
}

{
  "data": {}
}

Зарезервировать заказ

Зарезервировать товары под заказ. Обычные строки и комплекты — одинаково (O3): резервируется недостающее, сколько есть на складе (частичный резерв → статус «Частично зарезервирован»). Ошибка — только если резерв нужен, а по заказу не удалось зарезервировать ничего.

{
  "data": {}
}

Отгрузить заказ

Отгрузить заказ (списать со склада).

{
  "data": null
}

Отменить заказ

Отменить заказ (снять резервы). Атомарно (O2): резервы и статус — в одной транзакции.

{
  "data": null
}

Список закупок

Список заказов поставщикам.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "orderNumber": "string",
      "supplierId": 1,
      "status": "Active",
      "expectedAtUtc": "2026-01-01T00:00:00.000Z",
      "comment": "string",
      "createdAtUtc": "2026-01-01T00:00:00.000Z",
      "updatedAtUtc": "2026-01-01T00:00:00.000Z",
      "cancelledAtUtc": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Поиск закупок

Постраничный список заказов поставщикам: поиск по номеру, фильтр статуса, пагинация — в БД.

{
  "data": {
    "items": [
      {
        "id": 1,
        "campaignId": 1,
        "orderNumber": "string",
        "supplierId": 1,
        "status": "Active",
        "expectedAtUtc": "2026-01-01T00:00:00.000Z",
        "comment": "string",
        "createdAtUtc": "2026-01-01T00:00:00.000Z",
        "updatedAtUtc": "2026-01-01T00:00:00.000Z",
        "cancelledAtUtc": "2026-01-01T00:00:00.000Z"
      }
    ],
    "totalCount": 1
  }
}

Получить закупку

Заказ поставщику по id.

{
  "data": {
    "id": 1,
    "campaignId": 1,
    "orderNumber": "string",
    "supplierId": 1,
    "status": "Active",
    "expectedAtUtc": "2026-01-01T00:00:00.000Z",
    "comment": "string",
    "createdAtUtc": "2026-01-01T00:00:00.000Z",
    "updatedAtUtc": "2026-01-01T00:00:00.000Z",
    "cancelledAtUtc": "2026-01-01T00:00:00.000Z"
  }
}

Создать закупку

Создать заказ поставщику.

{
  "input": {}
}

{
  "data": 1
}

Следующий номер закупки

Следующий свободный номер закупки с префиксом (напр. «PO-20261006-»), Z6.

{
  "data": {}
}

Изменить закупку

Изменить закупку (Z13). Нельзя: полностью полученную и отменённую. Строки — полный список (id — существующая, без id — новая, отсутствующая — удаляется). Количество не меньше уже принятого; строку с принятым товаром удалить нельзя. Цена/валюта не переданы (undefined) — остаются прежними (участник со скрытыми ценами).

{
  "input": {}
}

{
  "data": {}
}

Принять поставку

Оприходовать поставку по заказу.

{
  "input": {}
}

{
  "data": 1
}

Отменить закупку

Отменить заказ поставщику.

{
  "data": null
}

Сводка по остаткам и марже

Сводный отчёт по остаткам, себестоимости и марже.

{
  "data": {}
}

Отчёты за период

Сводный набор отчётов за период: инвентарь, продажи, закупки, движения, ABC, оборачиваемость; фильтр по складу.

{
  "data": {}
}

Сводка для дашборда

Сводка для дашборда: число товаров, суммы остатков, «нет в наличии», «ниже минимума», графики по категориям и складам.

{
  "data": {}
}

Получить настройки

Получить настройки кампании.

{
  "data": {
    "id": 1,
    "campaignId": 1,
    "locale": "string",
    "allowNegativeStock": false,
    "allowOverReservation": false,
    "defaultExportQuantityMode": "string",
    "dateFormat": "2026-01-01T00:00:00.000Z",
    "timeFormat": "string",
    "decimalSeparator": "string",
    "thousandsSeparator": "string",
    "lastWarehouseId": 1,
    "lastBackupReminderDate": "2026-01-01T00:00:00.000Z",
    "lastBackupAtUtc": "2026-01-01T00:00:00.000Z",
    "defaultBackupTarget": "string",
    "featureKits": false,
    "featureVariants": false,
    "featuresRolloutDone": false,
    "timeZone": "string"
  }
}

Изменить настройки

Обновить настройки кампании.

{
  "updates": {
    "locale": "string",
    "allowNegativeStock": false,
    "allowOverReservation": false,
    "defaultExportQuantityMode": "string",
    "dateFormat": "2026-01-01T00:00:00.000Z",
    "timeFormat": "string",
    "decimalSeparator": "string",
    "thousandsSeparator": "string",
    "lastWarehouseId": 1,
    "lastBackupReminderDate": "2026-01-01T00:00:00.000Z",
    "lastBackupAtUtc": "2026-01-01T00:00:00.000Z",
    "defaultBackupTarget": "string",
    "featureKits": false,
    "featureVariants": false,
    "featuresRolloutDone": false,
    "timeZone": "string"
  }
}

{
  "data": null
}

История импорта

История задач импорта/экспорта.

{
  "data": [
    {
      "id": 1,
      "campaignId": 1,
      "type": "string",
      "fileName": "string",
      "fileType": "string",
      "format": "string",
      "profileId": 1,
      "updateMode": "2026-01-01T00:00:00.000Z",
      "stockImportMode": "string",
      "defaultWarehouseId": 1,
      "status": "Active",
      "rowsTotal": 1,
      "rowsProcessed": 1,
      "productsCreated": 1,
      "productsUpdated": 1,
      "categoriesCreated": 1,
      "manufacturersCreated": 1,
      "currenciesCreated": 1,
      "stockBalancesUpdated": 1,
      "rowsSkipped": 1,
      "errorsCount": 1,
      "warningsCount": 1,
      "messages": {},
      "startedAtUtc": "2026-01-01T00:00:00.000Z",
      "finishedAtUtc": "2026-01-01T00:00:00.000Z",
      "resultBlob": "string",
      "undoData": {}
    }
  ]
}

Создать задачу импорта

Создать задачу импорта.

{
  "job": {
    "type": "string",
    "fileName": "string",
    "fileType": "string",
    "format": "string",
    "profileId": 1,
    "updateMode": "2026-01-01T00:00:00.000Z",
    "stockImportMode": "string",
    "defaultWarehouseId": 1,
    "status": "Active",
    "rowsTotal": 1,
    "rowsProcessed": 1,
    "productsCreated": 1,
    "productsUpdated": 1,
    "categoriesCreated": 1,
    "manufacturersCreated": 1,
    "currenciesCreated": 1,
    "stockBalancesUpdated": 1,
    "rowsSkipped": 1,
    "errorsCount": 1,
    "warningsCount": 1,
    "messages": {},
    "startedAtUtc": "2026-01-01T00:00:00.000Z",
    "finishedAtUtc": "2026-01-01T00:00:00.000Z",
    "resultBlob": "string",
    "undoData": {}
  }
}

{
  "data": 1
}

Изменить задачу импорта

Обновить задачу импорта.

{
  "updates": {
    "type": "string",
    "fileName": "string",
    "fileType": "string",
    "format": "string",
    "profileId": 1,
    "updateMode": "2026-01-01T00:00:00.000Z",
    "stockImportMode": "string",
    "defaultWarehouseId": 1,
    "status": "Active",
    "rowsTotal": 1,
    "rowsProcessed": 1,
    "productsCreated": 1,
    "productsUpdated": 1,
    "categoriesCreated": 1,
    "manufacturersCreated": 1,
    "currenciesCreated": 1,
    "stockBalancesUpdated": 1,
    "rowsSkipped": 1,
    "errorsCount": 1,
    "warningsCount": 1,
    "messages": {},
    "startedAtUtc": "2026-01-01T00:00:00.000Z",
    "finishedAtUtc": "2026-01-01T00:00:00.000Z",
    "resultBlob": "string",
    "undoData": {}
  }
}

{
  "data": null
}

Отменить импорт

Отменить импорт: удалить записи, СОЗДАННЫЕ этой задачей (из job.undoData). Возвращает число удалённых.

{
  "data": {}
}

Импорт товаров

Импорт товаров: все смапленные поля, числа через parseNumber, refs по имени (createMissing), тип и варианты.

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт остатков

Импорт остатков/движений по SKU. Неизвестные SKU — в отчёт (или создаются при createMissingProducts).

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт клиентов

Импорт клиентов.

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт поставщиков

Импорт поставщиков.

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт категорий

Импорт категорий (с поддержкой иерархии через ->).

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт производителей

Импорт производителей.

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт складов

Импорт складов.

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт валют

Импорт валют.

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт заказов

Импорт заказов покупателей (строки группируются по номеру заказа).

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт закупок

Импорт заказов поставщикам / закупок (строки группируются по номеру).

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт движений

Импорт движений: каждая строка — приход (qty>0) или списание (qty<0) по складу; если заполнен «На склад» — перемещение со склада строки на этот склад (qty>0, T5).

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт резервов

Импорт резервов: каждая строка — резерв товара на складе.

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Импорт составов

Импорт составов: строки «SKU изделия, SKU компонента, кол-во»; режим «заменить состав», авто-смена типа на «Изделие».

{
  "items": {},
  "opts": {}
}

{
  "data": {}
}

Удалить все данные

Полная очистка БД: удаляет ВСЕ данные (товары, склад, документы, справочники, история импорта). Настройки (settings) сохраняются, чтобы уцелели язык/форматы. Работает на всех адаптерах (Dexie/SQLite), т.к. использует тот же Drizzle-инстанс. Возвращает число очищенных таблиц.

{
  "data": {}
}

Очистка осиротевших данных

Очистка «осиротевших» складских строк — тех, что ссылаются на уже удалённый товар (product_id, которого нет в products). Такие появляются, если товар удалили, а связанные строки остались. В списках они выглядят как «Unknown Product / SKU: N/A». Возвращает число удалённых строк по каждой таблице.

{
  "data": {}
}

Журнал действий

Действия, последние сверху. search — по описанию и имени метода.

{
  "data": {}
}

Сводка действий

userId — только действия этого пользователя (участник с ограничением по складам; ставит сервер).

{
  "data": {}
}