---
title: "Погасить минус по материалам"
method: POST
path: "/api/v1/stock/negative-balances/settle"
tags: ["Stock documents"]
---

# Погасить минус по материалам

`POST /api/v1/stock/negative-balances/settle`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/negative-balances/settle`
- 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-2183): там, где минус
есть, а материал уже лежит, заводит и проводит «Погашение минуса»
(`stock_negative_cover`, ПГМ-{YY}-{N:5}) — одно на склад и юрлицо.
Количество уходит из партий прихода в партию недостачи по её оценке;
разница фактической стоимости с оценкой — туда, куда материал ушёл:
лежащий набор дооценивается суммой без количества, ушедшее — в
себестоимость статьёй списавшего документа (вторая сторона — правило
вида на 90.02). Пустой отбор — весь кабинет; пустая `date` — рабочая
дата. Не провелось — черновик убирается, причина в `failed`.

Читает `Idempotency-Key` так же, как `stockCreateDocument`.

## Headers

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

## Request body

- StockNegativeSettleInput: Отбор «Погасить»: пусто — весь кабинет
  - `business_id` string, uuid
  - `company_id` string, uuid
  - `warehouse_id` string, uuid
  - `product_ids` UUID[]
  - `date` string, date: Дата погашения; пусто — рабочая дата кабинета

## Response `200`

Проведённые погашения и отказы

- StockNegativeSettleResult
  - `documents` object[], required
    - `document_id` string, uuid, required
    - `number` string, required
    - `status` string, required
    - `lines` integer, required
  - `failed` object[], required: Погашения, которые не провелись: минус остаётся в отчёте
    - `warehouse_id` string, uuid, required
    - `company_id` string, uuid
    - `reason` string, required

## Other responses

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

---

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