🔒 #26564 Затраты по сущности для вкладки «Затраты»: время, оклад и премия по сотрудникам, ролям, задачам и итерациям, коррекции. #26659 По привилегии *:costs сущности; оклад и премия строки раздельно - при user:employment к её сотруднику, коррекции - при user:employment «вся компания». #26673 Оклад и премия ворклогов - с маржой (свои тоже) или без маржи на весь отчёт: margin не передан - без маржи, если сущность покрыта привилегией worklog:no-margin, true - с маржой, false - без маржи (не покрыта - 403); применённый режим - поле margin. Коррекции - без маржи. #26808 Коррекции с процентом входят в стоимость (correction строк, ворклогов и итога, с маржой суммы) - тоже только при user:employment «вся компания»: без неё стоимость - оклад и премия; автокоррекции правки ворклога (без автора и процента) - только в списке.
#26564 Затраты по сущности для вкладки «Затраты»: время, оклад и премия по сотрудникам, ролям, задачам и итерациям, коррекции. #26659 По привилегии *:costs сущности; оклад и премия строки раздельно - при user:employment к её сотруднику, коррекции - при user:employment «вся компания». #26673 Оклад и премия ворклогов - с маржой (свои тоже) или без маржи на весь отчёт: margin не передан - без маржи, если сущность покрыта привилегией worklog:no-margin, true - с маржой, false - без маржи (не покрыта - 403); применённый режим - поле margin. Коррекции - без маржи. #26808 Коррекции с процентом входят в стоимость (correction строк, ворклогов и итога, с маржой суммы) - тоже только при user:employment «вся компания»: без неё стоимость - оклад и премия; автокоррекции правки ворклога (без автора и процента) - только в списке.
Access: authorized (10 ) · Scope: read
Allows: task:costs, feature:costs, version:costs, product:costs, meeting:costs, user:employment, worklog:no-margin (все обязательны; проверка в команде по ресурсу из запроса)
TypeScript (copy-paste)
GET /costs/entity
<details open><summary><b>Params</b></summary>export interface CostsEntityParams {
entityType: costs_entity_entityType
entityID: string
iterationKey?: number | null
margin?: boolean | null
}
</details>
<details open><summary><b>Response</b></summary>
export type CostsEntityResponse = IServerResponse<Resp_costs_entity>
export interface IServerResponse<T = any> {
code: number
data: T
srvTS: number
rkey: string
}
</details>
Полный файл типов: /docs/types · raw: /docs/api-types.ts
Request
- Base URL: http://localhost
- URL: http://localhost/costs/entity
- Auth: one of:
- API key in header sid and API key in header rts and API key in header sig
- HTTP bearer
Query parameters
task = "task", bug = "bug", feature = "feature", version = "version", product = "product", meeting = "meeting"
Можно передать header entityType (сервер мержит headers+query)
Можно передать header entityID (сервер мержит headers+query)
Можно передать header iterationKey (сервер мержит headers+query)
Можно передать header margin (сервер мержит headers+query)
Headers
UUID устройства клиента
Таймзона клиента (IANA или offset)
Имя клиентского приложения
Версия клиента
Уникальный ключ запроса для логов/саппорта
Response
OK — IServerResponse<Resp_costs_entity>
Example response
{
"code": 200
}Changes
No recorded changes to this operation across all 1 revision of this API.