Товарные позиции
Методы для управления товарными позициями (товары и услуги) в каталоге.
# Список товарных позиций
GET/companies/{id}/modules/wm/catalog/units
Возвращает список товарных позиций с пагинацией и фильтрацией.
Структура ответа
RESPONSE_DATA:
application/json
unitsrequired
array
Позиции
Список товарных позиций (Unit[])
Товарная позиция
idrequired
string
ID
Уникальный идентификатор товарной позиции
namerequired
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typerequired
enum
productservice
Тип
Тип позиции
statusrequired
enum
activeinactive
Статус
Статус
inventory_typerequired
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitrequired
string
Единица
Единица измерения
sale_pricerequired
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idrequired
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
Параметры запроса
GET_UNITS_PARAMS:
application/json
pageoptional
int
Страница
Номер страницы (по умолчанию 1)
limitoptional
int
Лимит
Записей на странице (по умолчанию 20)
typeoptional
enum
productservice
Тип
Фильтр по типу
statusoptional
enum
activeinactive
Статус
Фильтр по статусу
inventory_typeoptional
enum
trackeduntracked
Тип учёта
Фильтр по типу учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Фильтр по детализации учёта
category_idoptional
string
ID категории
Фильтр по категории
searchoptional
string
Поиск
Поиск по названию
Примеры ответов
{
"status": true,
"message": "Units retrieved successfully",
"data": {
"units": [
{
"id": "f00e8400-e29b-41d4-a716-446655440110",
"name": "Ноутбук Dell XPS",
"comment": "Флагманская модель",
"type": "product",
"status": "active",
"inventory_type": "tracked",
"tracking_detail": "serial",
"tracked_type": "fifo",
"unit": "шт",
"sale_price": 150000,
"purchase_price": 120000,
"currency": "RUB",
"category_id": "e00e8400-e29b-41d4-a716-446655440101",
"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/catalog/units",
"method": "GET"
}
}
# Создание товарной позиции
POST/companies/{id}/modules/wm/catalog/units
Создаёт новую товарную позицию (товар или услугу) в каталоге.
Структура запроса
CREATE_REQUEST:
application/json
namerequired
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typerequired
enum
productservice
Тип
Тип позиции
statusoptional
enum
activeinactive
Статус
Статус (по умолчанию active)
inventory_typerequired
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitrequired
string
Единица
Единица измерения
sale_pricerequired
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idrequired
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
Структура ответа
idrequired
string
ID
Уникальный идентификатор товарной позиции
namerequired
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typerequired
enum
productservice
Тип
Тип позиции
statusrequired
enum
activeinactive
Статус
Статус
inventory_typerequired
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitrequired
string
Единица
Единица измерения
sale_pricerequired
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idrequired
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
Примеры ответов
{
"status": true,
"message": "Unit created successfully",
"data": {
"id": "f00e8400-e29b-41d4-a716-446655440111",
"name": "Консультация",
"comment": null,
"type": "service",
"status": "active",
"inventory_type": "untracked",
"tracking_detail": null,
"tracked_type": null,
"unit": "ч",
"sale_price": 5000,
"purchase_price": null,
"currency": "RUB",
"category_id": "e00e8400-e29b-41d4-a716-446655440102",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:05:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:05:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/wm/catalog/units",
"method": "POST"
}
}
# Получение товарной позиции
GET/companies/{id}/modules/wm/catalog/units/{unitId}
Возвращает информацию о товарной позиции.
Структура ответа
idrequired
string
ID
Уникальный идентификатор товарной позиции
namerequired
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typerequired
enum
productservice
Тип
Тип позиции
statusrequired
enum
activeinactive
Статус
Статус
inventory_typerequired
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitrequired
string
Единица
Единица измерения
sale_pricerequired
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idrequired
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
Примеры ответов
{
"status": true,
"message": "Unit retrieved successfully",
"data": {
"id": "f00e8400-e29b-41d4-a716-446655440110",
"name": "Ноутбук Dell XPS",
"comment": "Флагманская модель",
"type": "product",
"status": "active",
"inventory_type": "tracked",
"tracking_detail": "serial",
"tracked_type": "fifo",
"unit": "шт",
"sale_price": 150000,
"purchase_price": 120000,
"currency": "RUB",
"category_id": "e00e8400-e29b-41d4-a716-446655440101",
"metadata": null,
"created_at": "2026-06-14T12:00:00Z",
"updated_at": "2026-06-14T12:00:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/wm/catalog/units/...",
"method": "GET"
}
}
# Обновление товарной позиции
PATCH/companies/{id}/modules/wm/catalog/units/{unitId}
Обновляет данные товарной позиции.
Структура запроса
UPDATE_REQUEST:
application/json
nameoptional
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typeoptional
enum
productservice
Тип
Тип позиции
statusoptional
enum
activeinactive
Статус
Статус
inventory_typeoptional
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitoptional
string
Единица
Единица измерения
sale_priceoptional
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idoptional
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
Структура ответа
idrequired
string
ID
Уникальный идентификатор товарной позиции
namerequired
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typerequired
enum
productservice
Тип
Тип позиции
statusrequired
enum
activeinactive
Статус
Статус
inventory_typerequired
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitrequired
string
Единица
Единица измерения
sale_pricerequired
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idrequired
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
Примеры ответов
{
"status": true,
"message": "Unit updated successfully",
"data": {
"id": "f00e8400-e29b-41d4-a716-446655440111",
"name": "Консультация (обновлено)",
"comment": "Часовая консультация",
"type": "service",
"status": "active",
"inventory_type": "untracked",
"tracking_detail": null,
"tracked_type": null,
"unit": "ч",
"sale_price": 5500,
"purchase_price": null,
"currency": "RUB",
"category_id": "e00e8400-e29b-41d4-a716-446655440102",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:10:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:10:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/wm/catalog/units/...",
"method": "PATCH"
}
}
# Деактивация товарной позиции
POST/companies/{id}/modules/wm/catalog/units/{unitId}/deactivate
Деактивирует товарную позицию.
Структура ответа
idrequired
string
ID
Уникальный идентификатор товарной позиции
namerequired
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typerequired
enum
productservice
Тип
Тип позиции
statusrequired
enum
activeinactive
Статус
Статус
inventory_typerequired
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitrequired
string
Единица
Единица измерения
sale_pricerequired
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idrequired
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
Примеры ответов
{
"status": true,
"message": "Unit deactivated successfully",
"data": {
"id": "f00e8400-e29b-41d4-a716-446655440111",
"name": "Консультация (обновлено)",
"comment": "Часовая консультация",
"type": "service",
"status": "inactive",
"inventory_type": "untracked",
"tracking_detail": null,
"tracked_type": null,
"unit": "ч",
"sale_price": 5500,
"purchase_price": null,
"currency": "RUB",
"category_id": "e00e8400-e29b-41d4-a716-446655440102",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:15:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:15:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/wm/catalog/units/.../deactivate",
"method": "POST"
}
}
# Активация товарной позиции
POST/companies/{id}/modules/wm/catalog/units/{unitId}/activate
Активирует деактивированную товарную позицию.
Структура ответа
idrequired
string
ID
Уникальный идентификатор товарной позиции
namerequired
string
Название
Название товарной позиции
commentoptional
string
Комментарий
Комментарий
typerequired
enum
productservice
Тип
Тип позиции
statusrequired
enum
activeinactive
Статус
Статус
inventory_typerequired
enum
trackeduntracked
Тип учёта
Тип складского учёта
tracking_detailoptional
enum
batchserial
Детали учёта
Детализация учёта
tracked_typeoptional
enum
fifolifo
Способ учёта
Способ списания
unitrequired
string
Единица
Единица измерения
sale_pricerequired
int
Цена продажи
Цена продажи в рублях
purchase_priceoptional
int
Цена закупки
Цена закупки в рублях
category_idrequired
string
ID категории
Идентификатор категории
metadataoptional
array
Метаданные
Дополнительные данные
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)
Примеры ответов
{
"status": true,
"message": "Unit activated successfully",
"data": {
"id": "f00e8400-e29b-41d4-a716-446655440111",
"name": "Консультация (обновлено)",
"comment": "Часовая консультация",
"type": "service",
"status": "active",
"inventory_type": "untracked",
"tracking_detail": null,
"tracked_type": null,
"unit": "ч",
"sale_price": 5500,
"purchase_price": null,
"currency": "RUB",
"category_id": "e00e8400-e29b-41d4-a716-446655440102",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:20:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:20:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/wm/catalog/units/.../activate",
"method": "POST"
}
}