---
title: "Свести приход с возвратами"
method: POST
path: "/api/v1/finance/settlements/refunds"
tags: ["Finance settlements"]
---

# Свести приход с возвратами

`POST /api/v1/finance/settlements/refunds`

## Request

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

Сводит приход с возвратом денег тому же контрагенту: на каждую пару «приход ↔ возврат» заводит и проводит документ сведения на меньший из остатков. Перед вызовом покажите план financePreviewRefundSettlement. Нечего сводить — 409 finance.settlement.refund_nothing. Повтор с тем же Idempotency-Key отдаёт прежний ответ.

## Headers

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

## Request body

- FinanceRefundSettlementInput
  - `business_id` string, uuid
  - `company_id` string, uuid
  - `contact_id` string, uuid, required
  - `currency` string, required: Валюта прихода и возвратов, код ISO 4217
  - `date` string, date, required: Дата сведения
  - `payment` string, uuid, required
  - `returns` UUID[], required: Возвраты денег тому же контрагенту: документы оплат или строки выписки
  - `comment` string: Комментарий к документам сведения
  - `source` object: Происхождение внешнего вызова
    - `source_system` string: Внешняя система
    - `source_ref` string: Ссылка во внешней системе
    - `external_id` string: Внешний идентификатор

## Response `200`

Проведённые документы сведения

- FinanceRefundSettlementResult
  - `documents` FinanceRefundSettlementDocument[]
    - `id` string: Документ сведения
    - `number` string: Номер документа
    - `return_number` string: Номер возврата
    - `amount` string: Сведённая сумма
  - `currency` string: Валюта
  - `total` 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/3c60ded179f2?raw)