Возвращает ресурсы компании, отсортированные по названию. Архивные ресурсы тоже входят в список.
v1/resources/get_list.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| limit | int | Нет | Размер страницы, от 1 до 1000 |
| offset | int | Нет | Сколько записей пропустить |
Без limit возвращается весь список. Подробнее о постраничной выдаче в статье Общие правила.
Ответ
Массив resources с полями ресурса и его категориями. Поле total содержит общее число ресурсов.
| Поле | Тип | Описание |
|---|---|---|
| id | int | ID ресурса |
| name | string | Название |
| type | string | Тип расчета: «rate», «percent» или «amortized» |
| dynamic | int | 1, если цена или процент указывается в составе продукта |
| base | string | База расчета процентного ресурса: «cost» или «price». У других типов null |
| unit | string | Единица измерения, код из статьи Единицы измерения. Есть только у фиксированной ставки и амортизации, у остальных null |
| price | float | Цена за единицу |
| percent | float | Процент процентного ресурса |
| initial_cost | float | Первоначальная стоимость оборудования |
| useful_life | float | Срок службы в единицах ресурса |
| left_life | float | Остаток срока службы. Уменьшается, когда ресурс списывается в производстве |
| notes | string | Заметки |
| archived | int | 1, если ресурс в архиве |
| categories | array | Категории ресурса: объекты с id и name |
Пример запроса
{
"limit": 100,
"offset": 0
}
Пример ответа
{
"success": true,
"resources": [
{
"id": 57,
"name": "Работа столяра",
"type": "rate",
"dynamic": 0,
"base": null,
"unit": "ч",
"price": 600,
"percent": 0,
"initial_cost": 0,
"useful_life": 0,
"left_life": 0,
"notes": "",
"archived": 0,
"categories": [
{
"id": 31,
"name": "Персонал"
}
]
},
{
"id": 59,
"name": "Фрезерный станок",
"type": "amortized",
"dynamic": 0,
"base": null,
"unit": "ч",
"price": 300,
"percent": 0,
"initial_cost": 600000,
"useful_life": 2000,
"left_life": 1874.5,
"notes": "",
"archived": 0,
"categories": []
}
],
"total": 2
}
Ошибки
| Ошибка | Причина |
|---|---|
| Invalid limit value. Must be between 1 and 1000 | Неверный limit |
| Invalid offset value. Must be 0 or greater | Неверный offset |
| Offset requires limit | Передан offset без limit |