---
title: "Получить коммерческую позицию по контрагенту"
method: GET
path: "/api/v1/finance/settlements/position"
tags: ["Finance counterparty terms"]
---

# Получить коммерческую позицию по контрагенту

`GET /api/v1/finance/settlements/position`

## Request

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

Объединяет действующие условия с подтверждённой дебиторской позицией из регистра расчётов. Разрез без единого проведённого движения не сверен — 409 с code finance.settlement_position.not_reconciled; сверенный ноль фиксируется документом finance_settlement_baseline.

## Query parameters

- `contact_id` string, uuid, required
- `company_id` string, uuid, required
- `currency` string
- `at` string, date-time

## Headers

- `X-Tenant` string, required

## Response `200`

Условия и подтверждённая позиция

- FinanceCommercialPosition
  - `terms` FinanceCounterpartyTerms, required
    - `id` string, uuid, nullable, required: Версия условий; null при configured=false — настройки нет, а не запись с нулевым id
    - `contact_id` string, uuid, required
    - `company_id` string, uuid
    - `currency` string, required
    - `credit_limit` string: Decimal string; отсутствие означает, что лимит не задан
    - `payment_delay_days` integer, required
    - `prepayment_percent` string, required: Decimal string от 0 до 100
    - `valid_from` string, date-time, nullable, required: Момент начала действия; null при configured=false
    - `valid_from_date` string, date: Дата начала действия в поясе кабинета: 01.01.2026 по Москве — 2026-01-01, хотя valid_from — 2025-12-31T21:00:00Z
    - `valid_to` string, date-time
    - `valid_to_date` string, date: Первый день в поясе кабинета, когда версия уже не действует
    - `reason` string, required
    - `created_by` integer
    - `created_at` string, date-time, nullable, required: null при configured=false
    - `configured` boolean, required
  - `exposure` FinanceSettlementExposure, required
    - `available` boolean, required
    - `as_of` string, date-time, required
    - `contact_id` string, uuid, required
    - `company_id` string, uuid, required
    - `currency` string, required
    - `receivable` string, required: Decimal string. What the counterparty owes us (side receivable); equals the receivable column of settlement positions for the same scope.
    - `overdue` string, required: Decimal string. Part of receivable whose due date has passed.
    - `undated` string, required: Decimal string. Part of receivable without a due date; it is never overdue, so zero overdue does not mean everything is on time.
    - `open_obligations` integer, required
    - `source` string, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `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)