---
title: "Получить воронки продаж или закупок кабинета"
method: GET
path: "/api/v1/core/trade/funnels"
tags: ["Core trade"]
---

# Получить воронки продаж или закупок кабинета

`GET /api/v1/core/trade/funnels`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/core/trade/funnels`
- 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

## Response `200`

Воронки кабинета

- CoreOrderFunnelList
  - `funnels` CoreOrderFunnel[], required
    - `id` string, uuid, required
    - `side` 'sale' | 'purchase', required
    - `name` string, required
    - `source` string, required
    - `is_default` boolean, required
    - `is_archived` boolean, required
    - `version` integer, required
    - `steps` CoreOrderFunnelStep[], required
      - `key` string: Пусто — вид и номер шага
      - `kind` 'contract' | 'approval' | 'prepayment_invoice' | 'payment' | 'shipment' | 'act' | 'upd' | 'closing' | 'custom', required
      - `title` string, required
      - `required` boolean: Участвует ли шаг в воронке: ненужный шаг продаже или закупке не строится
      - `due` CoreOrderFunnelStepDue
        - `after` '' | 'created' | 'confirmed' | 'delivery_date': От чего считается срок; пусто — без срока
        - `days` integer
      - `done_when` string: Что закрывает шаг: manual — человек отметит (пусто так же); state:<состояние> — продажа или закупка дошёл до состояния; paid:<N> — оплачено не меньше N % суммы продажи или закупки (финансы); paper:act_signed, paper:upd_signed — контрагент подписал акт или УПД в ЭДО (документооборот)
      - `remind_days` integer: За сколько дней до срока прийти событию «срок подходит»
    - `stages` CoreOrderFunnelStage[], required
      - `id` string, uuid
      - `name` string, required
      - `category` 'draft' | 'confirmed' | 'executing' | 'executed' | 'closed' | 'cancelled', required
      - `color` string
      - `position` integer
    - `updated_at` string, date-time, required

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

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