---
title: "Изменить воронку продаж или закупок"
method: PUT
path: "/api/v1/core/trade/funnels/{id}"
tags: ["Core trade"]
---

# Изменить воронку продаж или закупок

`PUT /api/v1/core/trade/funnels/{id}`

## Request

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

Новая версия воронки. Этап с id правится, без id — заводится, убранный — выключается (на него ссылается история продаж или закупок). Состояние этапа, на котором стоят продажи или закупки, не меняется.

## Request body

- CoreOrderFunnelInput
  - `side` 'sale' | 'purchase', required
  - `name` string, required
  - `source` string: Источник заказа: общий вид или точное приложение app.издатель.ключ; точное приложение имеет приоритет. Пусто — по источнику не выбирать
  - `is_default` boolean: Воронка стороны по умолчанию — одна на сторону
  - `is_archived` boolean
  - `steps` CoreOrderFunnelStep[]
    - `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[]
    - `id` string, uuid
    - `name` string, required
    - `category` 'draft' | 'confirmed' | 'executing' | 'executed' | 'closed' | 'cancelled', required
    - `color` string
    - `position` integer

## Response `200`

Воронка после правки

- CoreOrderFunnel
  - `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

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

---

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