---
title: "Закрыть авансы поставщикам расходом"
method: POST
path: "/api/v1/finance/settlements/closing-awaited/close-expense-batch"
tags: ["Finance settlements"]
---

# Закрыть авансы поставщикам расходом

`POST /api/v1/finance/settlements/closing-awaited/close-expense-batch`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/settlements/closing-awaited/close-expense-batch`
- 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

Закрывает расходом от одного до пяти авансов поставщикам (ERP-1457): на остаток каждого аванса сервер заводит и проводит закупку со статьёй расхода и зачёт аванса в неё. Аванс уходит из списка «Ждём закрывающие». Принимает и авансы отключённого юрлица — их список не показывает, а закрыть их нужно. Исход каждой строки — в results: closed, already_closed, not_found, item_required, period_closed или failed с причиной. Повтор с тем же Idempotency-Key отдаёт прежний ответ.

## Headers

- `X-Tenant` string, required
- `Idempotency-Key` string

## Request body

- FinanceCloseAdvancesToExpenseInput
  - `ids` UUID[], required: От одного до пяти авансов: идентификаторы обязательств аванса
  - `reason` string: Почему закрывающего документа нет; пишется в историю
  - `item_id` string, uuid
  - `date` string: Дата расхода ГГГГ-ММ-ДД; пусто — дата аванса

## Response `200`

Исход по каждому авансу

- FinanceCloseAdvancesToExpenseResult
  - `results` object[], required
    - `id` string, required: Аванс из запроса
    - `status` 'closed' | 'already_closed' | 'not_found' | 'item_required' | 'period_closed' | 'failed', required: Исход строки
    - `reason` string: Почему строка не закрылась, словами

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Idempotency-Key уже использован для другого запроса: другое тело, другой адрес или другая операция. Код `idempotency.key_mismatch`; сохранённый ответ не раскрывается. Для новой команды берут новый ключ.
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

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