KronclAPI
Мои приложения
Введение
Публичные методы
Аккаунт
Компания
Базовые действия
Хранилище
Тарификация
Участники
Логи
Документы
Поддержка
Персонал (HRM)
Финансы (FM)
Клиенты (CRM)
Склад (WM)
POST Отчёт
Каталог
Склад
GET Остатки
Партии
GET Список
POST Создать
GET Детали
Позиции
Сделки (DM)
Создать приложение
Документация API платформы. Последняя сборка v1.5.30

Партии

Методы для управления складскими партиями.

# Список партий

GET
/companies/{id}/modules/wm/stocks/batches

Возвращает список партий с пагинацией и фильтрацией.

Структура ответа

RESPONSE_DATA:
application/json
batchesrequired
array
Партии
Список партий (StockBatch[])
paginationrequired
array
pagination

Партия

STOCK_BATCH:
application/json
idrequired
string
ID
Уникальный идентификатор партии
directionrequired
enum
incomeoutcome
Направление
Направление движения
commentoptional
string
Комментарий
Комментарий к партии
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)

Параметры запроса

GET_STOCK_BATCHES_PARAMS:
application/json
pageoptional
int
Страница
Номер страницы (по умолчанию 1)
limitoptional
int
Лимит
Записей на странице (по умолчанию 20)
directionoptional
enum
incomeoutcome
Направление
Фильтр по направлению
unit_idoptional
string
ID позиции
Фильтр по товарной позиции
searchoptional
string
Поиск
Поиск по комментарию

Примеры ответов

200
{
    "status": true,
    "message": "Stock batches retrieved successfully",
    "data": {
        "batches": [
            {
                "id": "g00e8400-e29b-41d4-a716-446655440120",
                "direction": "income",
                "comment": "Поставка от поставщика",
                "metadata": null,
                "created_at": "2026-06-14T12:00:00Z",
                "updated_at": "2026-06-14T12:00:00Z"
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pages": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/wm/stocks/batches",
        "method": "GET"
    }
}

# Создание партии

POST
/companies/{id}/modules/wm/stocks/batches

Создаёт новую складскую партию (оприходование или списание).

Структура запроса

CREATE_REQUEST:
application/json
directionrequired
enum
incomeoutcome
Направление
Направление движения
commentoptional
string
Комментарий
Комментарий к партии
positionsrequired
array
Позиции
Список позиций в партии (StockBatchPosition[])
metadataoptional
array
Метаданные
Дополнительные данные

Структура ответа

CREATE_RESPONSE:
application/json
batch_idrequired
string
ID партии
Идентификатор созданной партии
directionrequired
enum
incomeoutcome
Направление
Направление движения
commentoptional
string
Комментарий
Комментарий к партии
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
positionsrequired
array
Позиции
Список позиций в партии (PositionWithUnit[])

Примеры ответов

201
{
    "status": true,
    "message": "Stock batch created successfully",
    "data": {
        "batch_id": "g00e8400-e29b-41d4-a716-446655440121",
        "direction": "income",
        "comment": "Новая поставка",
        "metadata": null,
        "created_at": "2026-06-14T12:05:00Z",
        "updated_at": "2026-06-14T12:05:00Z",
        "positions": [
            {
                "id": "h00e8400-e29b-41d4-a716-446655440131",
                "type": "batch",
                "unit_id": "f00e8400-e29b-41d4-a716-446655440110",
                "quantity": 5,
                "created_at": "2026-06-14T12:05:00Z",
                "batch_id": "g00e8400-e29b-41d4-a716-446655440121",
                "unit": {
                    "id": "f00e8400-e29b-41d4-a716-446655440110",
                    "name": "Ноутбук Dell XPS",
                    "type": "product",
                    "unit": "шт",
                    "sale_price": 150000,
                    "currency": "RUB"
                }
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-14T12:05:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/wm/stocks/batches",
        "method": "POST"
    }
}

# Получение партии

GET
/companies/{id}/modules/wm/stocks/batches/{batchId}

Возвращает детальную информацию о партии с позициями.

Структура ответа

BATCH_WITH_POSITIONS:
application/json
idrequired
string
ID
Уникальный идентификатор партии
directionrequired
enum
incomeoutcome
Направление
Направление движения
commentoptional
string
Комментарий
Комментарий к партии
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
positionsrequired
array
Позиции
Список позиций в партии (PositionWithUnit[])

Позиция

POSITION_WITH_UNIT:
application/json
idrequired
string
ID
Идентификатор позиции
typerequired
enum
batchserial
Тип
Тип позиции
unit_idrequired
string
ID товарной позиции
Идентификатор товарной позиции
quantityrequired
int
Количество
Количество в позиции
created_atrequired
string
Создана
Дата создания (RFC 3339)
batch_idrequired
string
ID партии
Идентификатор партии
unitrequired
array
Товарная позиция
Данные товарной позиции (CatalogUnit)

Примеры ответов

200
{
    "status": true,
    "message": "Stock batch retrieved successfully",
    "data": {
        "id": "g00e8400-e29b-41d4-a716-446655440120",
        "direction": "income",
        "comment": "Поставка от поставщика",
        "metadata": null,
        "created_at": "2026-06-14T12:00:00Z",
        "updated_at": "2026-06-14T12:00:00Z",
        "positions": [
            {
                "id": "h00e8400-e29b-41d4-a716-446655440130",
                "type": "batch",
                "unit_id": "f00e8400-e29b-41d4-a716-446655440110",
                "quantity": 10,
                "created_at": "2026-06-14T12:00:00Z",
                "batch_id": "g00e8400-e29b-41d4-a716-446655440120",
                "unit": {
                    "id": "f00e8400-e29b-41d4-a716-446655440110",
                    "name": "Ноутбук Dell XPS",
                    "type": "product",
                    "unit": "шт",
                    "sale_price": 150000,
                    "currency": "RUB"
                }
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/wm/stocks/batches/...",
        "method": "GET"
    }
}