Create Document

---
name: create-document
description: Создание и проведение документа 1С через гейт записи ONEC_WRITE_MODE
argument-hint: "<тип документа> [данные]"
---

# /create-document — Запись в 1С

Запись в боевую базу необратима на уровне данных. Работай строго по шагам.

## Алгоритм

1. Уточни тип документа: `get_config_preset` (типовые имена) → `list_entities` (что реально есть в этой базе).
2. `describe_entity` (entity) — точные имена и состав полей. **Не угадывай имена полей**: неверное поле 1С молча проигнорирует или вернёт ошибку.
3. Подставь ссылки: `find_by_description` (entity, query) для контрагента и номенклатуры, `get_by_key` для проверки найденного GUID. В data кладутся значения полей с суффиксом _Key.
4. `create_document` (document_type, data) — создание. Из ответа возьми Ref_Key.
5. `post_document` (document_type, ref_key, operational) — проведение. Только после проведения пишутся движения по регистрам.
6. Покажи пользователю созданный документ: `get_by_key` или `get_recent_documents` (document_type, top, posted_only).

## Гейт записи ONEC_WRITE_MODE

Поведение зависит от режима, в котором запущен сервер. Определи его по ответу первой же записи:

| Режим | Что происходит |
|-------|----------------|
| off (по умолчанию) | Гейта нет, запись выполняется сразу. Максимум внимания к шагу 2. |
| deny | Пишущие инструменты не зарегистрированы — их просто нет в списке. Режим только для чтения, обходить нечем. |
| preview | Запись **никогда** не выполняется, вместо результата приходит конверт write_safety: preview с разбором «было → стало». |
| approval | Первый вызов возвращает preview с op_hash. Затем `approve_write` (op_hash, reason) и **повтор того же вызова с теми же аргументами**. |

- Пришёл конверт write_safety: preview — **ничего не записано**. Покажи разбор пользователю и жди явного «да» перед `approve_write`.
- В конверте write_safety: executed может быть rollback-токен → `rollback_write` (token) откатит операцию. Токен одноразовый и живёт в памяти процесса: после перезапуска сервера его нет.
- Поля reversible и irreversible_reason в preview говорят, откатываемо ли действие. Создание нового документа автоматического отката не имеет — обратный ход только `set_deletion_mark`.

## Ещё

- Ошиблись в проведённом документе: `unpost_document` → `update_document` → `post_document`. Физический `delete_document` не предлагать: `set_deletion_mark` (entity, ref_key, mark) — восстановимая пометка на удаление.
- Много однотипных документов — `batch_create_documents` (document_type, documents, concurrency); гейт записи применяется к каждому элементу.

## Формат ответа

```
## Документ 1С

Тип: Document_РеализацияТоваровУслуг
Ref_Key: 8a1f0c22-...-...
Номер: ТД-00123 от 2026-09-02
Проведён: да

Гейт: ONEC_WRITE_MODE=approval, op_hash=3f9a2c11d4e07b58 — одобрено пользователем.
Токен отката: rb-3f9a2c11d4e07b58
```

## Примеры

```
/create-document реализация ООО Ромашка
/create-document поступление товаров
/create-document откати последнюю запись
```