---
title: "Получить документы «Налоги за месяц»"
method: GET
path: "/api/v1/finance/taxes/months"
tags: ["Finance registers"]
---

# Получить документы «Налоги за месяц»

`GET /api/v1/finance/taxes/months`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/taxes/months`
- 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

- `company_id` string, uuid
- `limit` integer
- `offset` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Документы с телом

- FinanceTaxMonthPage
  - `items` FinanceTaxMonth[], required
    - `id` string, uuid, required
    - `number` string, required
    - `date` string, date, required: Последний день месяца
    - `status` string, required: Статус документа
    - `company_id` string, required: Юрлицо
    - `comment` string, required
    - `updated_at` string, required
    - `payload` FinanceTaxMonthPayload, required
      - `version` integer, required
      - `year` integer, required
      - `month` integer, required
      - `lines` FinanceTaxMonthLine[], required
        - `kind` string, required: Код вида налога
        - `amount` string, required: Сумма со знаком; минус — уменьшение по декларации
        - `comment` string: Комментарий строки
        - `source` 'payroll' | 'vat_quarter' | 'calc': Строку заполнил сервер — из начислений зарплаты, «НДС за квартал» или предварительного расчёта по режиму; во входе такие строки игнорируются
        - `regime` string: Режим юрлица строки «из расчёта»
        - `rate` string: Ставка режима в процентах
        - `base_income` string: Доходы базы с начала года
        - `base_expense` string: Расходы базы с начала года; только у режимов «доходы минус расходы»
        - `accrued_before` string: Начислено «из расчёта» в прошлых месяцах года
        - `payroll_outside` string: Неофициальная часть зарплаты — исключена из расходов базы
        - `for_contact` string, uuid: Налог юрлица за собственника: контрагент-собственник; начисление идёт на расчёты с ним (Дт 75), а не в расход ОПиУ
        - `declared` string: Сумма по декларации; строка с ней — строка декларации за прошлый период
        - `calculated` string: Расчёт раздела за период декларации; заполняет сервер
        - `period_from` string, date: Начало периода декларации
        - `period_to` string, date: Конец периода декларации; не позже конца месяца документа
      - `payments` FinanceTaxMonthPayment[]
        - `document` string, required: Документ банковской операции
        - `date` string, date, required
        - `amount` string, required: Сумма платежа
      - `opening` string: Сальдо ЕНС на начало учёта; плюс — долг перед бюджетом, минус — переплата

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