# Передача заказа в производство

```
POST /v1/conversations/{id}/handoff
{ "seat": "Цех на Ленина" }
```

Ради этого всё и затевалось: лид приходит в производство **собранным заказом**,
а не текстом переписки, который менеджер пересказывает конструктору.

## Что происходит на самом деле

Заказ разговора ложится строкой на **рабочее место** мебельной компании
и появляется карточкой в её кабинете — ровно так же, как появляется заказ
после удачного хода самого проектировщика. Проектировщик открывает карточку,
видит состав, чертёж и расход и продолжает работу своими средствами.

```json
{ "ok": true, "handoff": {
  "seat_id": 5, "seat_title": "Цех на Ленина",
  "order_id": "кухня-иванов", "turn": 3 } }
```

## Чего эта ручка НЕ делает

**Она не кладёт мебель в модель Базис-Мебельщика.** Класть туда может только
агент, запущенный на машине проектировщика при открытом Базисе; сервер сам
в чужую программу ничего не записывает и записать не может.

Говорим об этом прямо, чтобы вы не строили на этом обещание клиенту:
`/handoff` кладёт заказ проектировщику **на стол**, а собирает его в модели
он — своим ходом, когда сядет за работу.

## `seat` — это место, а не человек

`seat` — id рабочего места или его название, как оно записано в кабинете
мебельной компании («Цех на Ленина», «Замерщик», «Иван»). Спросите список
у компании один раз и держите его у себя в настройках.

Место чужой учётной записи или отозванное отвечает **403**. Это защита
по построению: список мест берётся из учётной записи, на которую выдан ваш
ключ, и места из него просто не существует для вашего запроса.

## Повторная передача

Передавать один и тот же разговор можно сколько угодно: строка на паре
«место + заказ» одна, и каждая передача её обновляет. Разговор, у которого
после передачи было ещё три хода, передайте заново — проектировщик увидит
свежий состав.

Хотите держать на месте два варианта — передайте второй раз с другим
`order_id`:

```json
{ "seat": "Цех на Ленина", "order_id": "кухня-иванов-вариант-2" }
```

## Когда передавать

Разумная граница — когда клиент сказал «да, примерно так»: состав собран,
техника названа, стены известны. Ходы после передачи ничему не мешают —
просто передайте ещё раз.

Передать разговор, в котором ничего не собрано, нельзя: **400**.