> Усі статті WIKI Helomi: /wiki/llms.txt

# Правила передачі між розділами

Правила передачі роблять те, що інакше довелося б зашивати в код: поле одного розділу само потрапляє в поле іншого. Склад передає назву товару в «Назву Checkbox» прайс-листа, клієнт передає сегмент у свої угоди, угода дає назву своїм завданням. Налаштовує людина в «Налаштування → Автоматизація → Правила передачі», код тут не потрібен (ПРАВИЛА §2).

## З чого складається правило

- **Звідки**: розділ-джерело і його поле. Розділи: Склад (товари), Прайс-лист, Угоди, Клієнти, Завдання. Поля — вбудовані (назва, артикул, коментар, ціна, дати…) і додаткові з «Типів даних» (позначені групою «Додаткові поля»).
- **Куди**: розділ призначення і поле, у яке дозволено писати (поля лише для читання, як-от суми угоди, у списку не пропонуються).
- **Як пов'язані записи**: звідки система знає, якому запису призначення віддати значення. Зараз є зв'язки: Склад ↔ Прайс-лист (через «Зв'язок зі складом» позиції), Клієнт ↔ його угоди, Угода ↔ її завдання, Клієнт ↔ його завдання, Угода ↔ її оплати й операції у «Фінансах», Клієнт ↔ його операції (напр. назва клієнта в «Контрагента» операції, поле угоди у власне поле операції). Якщо між двома розділами зв'язку нема, форма так і скаже.
- **Коли спрацьовує**: коли з'являється зв'язок між записами (позицію зв'язали з товаром, угоду створили в клієнта, завдання додали до угоди) та/або коли змінюється поле джерела.
- **Режим**: «іти за джерелом, поки людина не вписала своє» (типовий) — поле призначення перезаписується лише доки воно порожнє або дорівнює попередньому значенню джерела; «завжди перезаписувати»; «лише якщо порожньо».

Назву правила можна не писати, вона складеться сама: «Склад: Назва → Прайс-лист: Назва Checkbox».

## Як користуватися

1. «+ Нове правило» → оберіть джерело, призначення, зв'язок, коли й режим → «Додати правило». Правило одразу ввімкнене.
2. «Перевірити» у формі показує на конкретному записі джерела (ID або останній), які записи призначення зачепить і що в них стане.
3. «До наявних» у рядку правила проходить усі записи джерела один раз, щоб заповнити вже наявні довідники (наприклад, позиції прайсу, зв'язані зі складом раніше).
4. Перемикач у рядку вимикає правило без видалення. Лічильник «Разів» і остання помилка показують, чи воно працює.

Кожен запис, змінений правилом, отримує позначку в журналі картки від імені «правило передачі». Імпорт і дзеркало KeepinCRM правил не запускають, як і зміни, зроблені самим механізмом.

## Типове правило

При першому запуску створюється «Склад: Назва → Прайс-лист: Назва Checkbox» (режим «за джерелом», при зв'язці й при зміні): назва в фіскальному чеку одна на артикул, хоч би скільки оголошень із різними назвами було в прайсі. Його можна змінити або вимкнути, як будь-яке інше.

## Для ШІ-співробітників

Інструменти `transfer_rules_meta` (розділи, поля, зв'язки, режими), `transfer_rules_list`, `transfer_rules_create`, `transfer_rules_update`, `transfer_rules_delete`, `transfer_rules_check` (перевірка на записі), `transfer_rules_apply_all` (підтвердження). Ключі полів — як у `meta`: вбудовані — `title`, `comment`…, додаткові — `cf:<ключ>`.