---
title: "Получить состояние месяца зарплаты по юрлицам"
method: GET
path: "/api/v1/finance/payroll/month-status"
tags: ["Finance payroll"]
---

# Получить состояние месяца зарплаты по юрлицам

`GET /api/v1/finance/payroll/month-status`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/payroll/month-status`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

По каждому юрлицу штата (и по неоформленным позициям бизнеса) за месяц
показывает начисление зарплаты со статусом, отметку о завершении
расчёта и нужно ли начислять (в штате есть занятые позиции с окладом
или премией). Проверка закрытия периода «Зарплата за месяц завершена»
засчитывает проведённое начисление или проведённую отметку.

## Query parameters

- `month` string, required

## Headers

- `X-Tenant` string, required

## Response `200`

Состояние месяца по юрлицам

- FinancePayrollMonthStatus
  - `month` string, required: Месяц YYYY-MM
  - `scopes` FinancePayrollMonthScope[], required
    - `key` string, required: Область: company:<id> или business:<id>
    - `name` string, required: Название юрлица или бизнеса
    - `company_id` string, uuid
    - `business_id` string, uuid
    - `needs_accrual` boolean, required: В штате области есть кого начислять за месяц
    - `accrual` FinancePayrollMonthAccrual, required
      - `id` string, uuid, required
      - `number` string, required
      - `status` 'draft' | 'posted', required
    - `mark` FinancePayrollMonthMark, required
      - `id` string, uuid, required
      - `reason` 'completed' | 'nobody_to_accrue', required
      - `comment` string, required
      - `by` string, required: Кто поставил отметку
      - `at` string, required: Когда отметка проведена
    - `onec` FinancePayrollMonthOneC: Зарплата месяца из 1С; поля нет — приёма из 1С за месяц не было
      - `status` 'applied' | 'received', required: applied — легла (возможно, не по всем людям), received — ждёт
      - `warnings` string[], required: Что из цифр 1С не перенесено: отрицательная сумма (возврат НДФЛ, сторно) — в строке 0
      - `numbers` string: Номера документов 1С месяца
      - `message` string: Что не легло и что сделать; пусто — легла вся
      - `unknown` FinancePayrollMonthOneCPerson[], required: Люди 1С без сотрудника Акеды с тем же ИНН: их зарплата не легла
        - `inn` string, required: ИНН физлица в 1С
        - `snils` string: СНИЛС физлица в 1С
        - `name` string, required: ФИО в 1С
        - `accrued` string, required: Начислено за месяц
        - `ndfl` string, required: НДФЛ
        - `insurance` string, required: Страховые взносы

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `500`: Внутренняя ошибка без раскрытия server-only деталей

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)