---
title: "🔒 #26532 Штраф или бонус - часть премии месяца (#26797 переданного, иначе текущего). #26564 Коррекция - процент от премии по выработке за ресурс."
method: POST
path: "/team/payment/award-part/create"
tags: ["Team: Payments"]
---

# 🔒 #26532 Штраф или бонус - часть премии месяца (#26797 переданного, иначе текущего). #26564 Коррекция - процент от премии по выработке за ресурс.

`POST /team/payment/award-part/create`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/team/payment/award-part/create`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - HTTP bearer

#26532 Штраф или бонус - часть премии месяца (#26797 переданного, иначе текущего). #26564 Коррекция - процент от премии по выработке за ресурс.

**Access:** `authorized` (10 ) · **Scope:** `write`

**Allows:** `user:bonus`, `company:payments` (все обязательны; проверка в команде по ресурсу из запроса)

### TypeScript (copy-paste)

**`POST /team/payment/award-part/create`**

<details open><summary><b>Body</b></summary>

```typescript
export interface TeamPaymentAwardPartCreateBody {
  userID: string
  type: PaymentAwardPart_MANUAL_TYPES
  amount?: number | null
  title?: string | null
  /** Day key (YYYYMMDD or internal day index) */
  monthDK?: number | null
  resource?: {
  worklogID?: string | null
  entityID?: string | null
  entityType?: SystemEntityType | null
  startDk?: number | null
  endDk?: number | null
  roleType?: UserRole_Type | null
} | null
  percent?: number | null
  note?: string | null
}
```

</details>

<details open><summary><b>Response</b></summary>

```typescript
export type TeamPaymentAwardPartCreateResponse = IServerResponse<Record<string, any>>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Request body

- TeamPaymentAwardPartCreateBody: JSON body for `team/payment/award-part/create`
  - `userID` string, uuid, required
  - `type` 20 | 30 | 40, required: `20` = 20, `30` = 30, `40` = 40
  - `amount` number, nullable
  - `title` string, nullable
  - `monthDK` integer, nullable: Day key (YYYYMMDD or internal day index)
  - `resource` object, nullable
    - `worklogID` string, uuid, nullable
    - `entityID` string, uuid, nullable
    - `entityType` 'project' | 'product' | 'module' | 'component' | 'version' | 'feature' | 'task' | 'bug' | 'meeting': `project` = "project", `product` = "product", `module` = "module", `component` = "component", `version` = "version", `feature` = "feature", `task` = "task", `bug` = "bug", `meeting` = "meeting"
    - `startDk` integer, nullable: Day key (YYYYMMDD or internal day index)
    - `endDk` integer, nullable: Day key (YYYYMMDD or internal day index)
    - `roleType` 10 | 20 | 30 | 40 | 50 | 60 | 70: `management` = 10, `analytics` = 20, `marketing` = 30, `design` = 40, `development` = 50, `qa` = 60, `support` = 70
  - `percent` integer, nullable
  - `note` string, nullable

## Response `200`

OK — `IServerResponse<Record<string, any>>`

- object
  - `code` integer, required
  - `data` object, required: Response payload (нет ResponseData / doc.schema)
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest: Missing amount and title for fine/bonus or resource and percent for correction; monthDK is not the first day of a month
- `401`: Unauthorized: Active user session required
- `403`: AccessNotAllowed: Privilege user:bonus (correction) or company:payments required
- `404`: NotFound: User not found in company
- `406`: TimeResync — расхождение rts с сервером
- `422`: UnprocessableContent: No worklogs for correction resource; month of fine/bonus is in the future or its award is formed

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)
