Создает ресурс. Набор обязательных полей зависит от типа расчета.
v1/resources/add.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| name | string | Да | Название |
| type | string | Да | Тип расчета: «rate», «percent» или «amortized» |
| dynamic | int | Нет | 1: цена фиксированной ставки или процент процентного ресурса указывается в составе продукта. По умолчанию 0. У амортизации не используется |
| unit | string | Для rate и amortized | Единица измерения, код из статьи Единицы измерения. У ставки с dynamic 1 не нужна |
| price | float | Для rate | Цена за единицу. У ставки с dynamic 1 не нужна |
| base | string | Для percent | База расчета: «cost» (себестоимость) или «price» (цена продажи) |
| percent | float | Для percent | Процент. При dynamic 1 не нужен |
| initial_cost | float | Для amortized | Первоначальная стоимость |
| useful_life | float | Для amortized | Срок службы в единицах unit |
| notes | string | Нет | Заметки |
| categories | array | Нет | Категории: объекты с id или name |
Категорию можно передать по названию: если такой нет, она будет создана. ID существующих категорий возвращает v1/categories/get_list.
Типы ресурсов
Тип расчета определяет, какие поля нужны при создании ресурса.
| Тип | Описание | Обязательные поля |
|---|---|---|
| «rate», Фиксированная ставка | Оплата труда, электроэнергия, контрактное производство | unit, price |
| «rate» с dynamic 1, Цена указывается в составе продукта | Сумма задается в составе каждого продукта | Нет |
| «percent», Процент | Накладные расходы, комиссии | base, percent |
| «percent» с dynamic 1, Процент указывается в составе продукта | Процент задается в составе каждого продукта | base |
| «amortized», Амортизация | Оборудование, транспорт, инструменты | unit, initial_cost, useful_life |
База расчета (base) процентного ресурса:
- «cost»: себестоимость продукта без учета процентных ресурсов;
- «price»: цена продажи из карточки продукта.
Единицы измерения
Ресурсу можно назначить любую единицу, в том числе единицы времени и энергии, которые доступны только ресурсам: «ч», «мин», «кВт-ч». Список единиц в статье Единицы измерения.
Примеры запросов
Фиксированная ставка: часовая ставка столяра.
{
"name": "Работа столяра",
"type": "rate",
"unit": "ч",
"price": 600,
"categories": [{ "id": 31 }]
}
Процент от себестоимости, одинаковый для всех продуктов:
{
"name": "Накладные расходы",
"type": "percent",
"base": "cost",
"percent": 10
}
Комиссия маркетплейса, процент которой задается в составе каждого продукта:
{
"name": "Комиссия маркетплейса",
"type": "percent",
"dynamic": 1,
"base": "price"
}
Амортизация оборудования:
{
"name": "Фрезерный станок",
"type": "amortized",
"unit": "ч",
"initial_cost": 600000,
"useful_life": 2000
}
Пример ответа
{
"success": true,
"resource_id": 57
}
Ошибки
| Ошибка | Причина |
|---|---|
| No name in input | Не передано обязательное поле (вместо name будет имя поля: type или поле, обязательное для типа) |
| Name must not be empty | Пустое название |
| Name must be a string | Название передано не строкой, например массивом |
| Invalid type value. Must be one of: rate, percent, amortized | Неверный type |
| Unit not set | Передана пустая единица измерения |
| Unit not found | Неизвестная единица измерения |
| Invalid price value. Must be a number, 0 or greater | Цена не число или меньше 0 (так же для initial_cost) |
| Invalid base value. Must be one of: cost, price | Неверная база расчета |
| Percent must be greater than 0 and not exceed 100 | Процент 0, меньше 0 или больше 100 |
| Useful life must be greater than 0 | Срок службы 0 или меньше |
| Category 12 not found | Категория не найдена |