Costs

🔒 #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

get/costs/entity

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

entityType'task' | 'bug' | 'feature' | 'version' | 'product' | 'meeting' required

task = "task", bug = "bug", feature = "feature", version = "version", product = "product", meeting = "meeting"

Можно передать header entityType (сервер мержит headers+query)

entityIDstring uuid required

Можно передать header entityID (сервер мержит headers+query)

iterationKeyinteger nullable

Можно передать header iterationKey (сервер мержит headers+query)

marginboolean nullable

Можно передать header margin (сервер мержит headers+query)

Headers

devIDstring uuid required

UUID устройства клиента

tzstring required
Example:Europe/Moscow

Таймзона клиента (IANA или offset)

appstring required
Example:kosmodrom-web

Имя клиентского приложения

appVerstring required
Example:1.0.0

Версия клиента

rKeystring

Уникальный ключ запроса для логов/саппорта

Response

OK — IServerResponse<Resp_costs_entity>

codeinteger required
srvTSinteger required

Server timestamp (ms)

rkeystring required

Request key

Example response

{
  "code": 200
}

Changes

No recorded changes to this operation across all 1 revision of this API.