---
title: "Сохранить черновик «Налоги за месяц»"
method: POST
path: "/api/v1/finance/taxes/months"
tags: ["Finance registers"]
---

# Сохранить черновик «Налоги за месяц»

`POST /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

Один документ на юрлицо в месяц, датой последнего дня месяца. Строки начислений вносит человек (сумма со знаком — уменьшение по декларации со знаком «минус»); пополнения ЕНС за месяц сервер собирает сам по настройке раздела.

## Headers

- `X-Tenant` string, required

## Request body

- FinanceTaxMonthInput: Новый черновик «Налоги за месяц».
  - `company_id` string, uuid
  - `year` integer
  - `month` integer
  - `lines` FinanceTaxMonthLine[]
    - `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: Конец периода декларации; не позже конца месяца документа
  - `opening` string, nullable: Сальдо ЕНС на начало учёта — только в первом документе юрлица; плюс — долг, минус — переплата
  - `comment` string, nullable

## Response `201`

Сохранённый черновик

- FinanceTaxMonth: Документ «Налоги за месяц».
  - `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`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `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)