# Особенности работы в YCLIENTS: данные записи и «Записать в карточку»

> Какие данные записи YCLIENTS подставляются в документ, как настроить «Поля YClients» и перенести данные документа обратно в карточку записи.

Статья базы знаний DataDoc, раздел «Плагины для CRM → YCLIENTS». Страница: https://datadoc.ru/ru/knowlege/u-crm-yc-osobennosti/. Обновлено: 2026-11-08. Автор: DataDoc.RU - документы и подписание.
Карта всей базы знаний: https://datadoc.ru/ru/knowlege/llms.txt

В YCLIENTS плагин DataDoc открывается из **карточки записи** клиента. Общий порядок создания документа такой же, как в других CRM: [документ из карточки CRM](https://datadoc.ru/ru/knowlege/u-crm-dokument-vse-etapy/llms.txt). Ниже то, что есть только в YCLIENTS.

## Откуда создаётся документ

1. Откройте запись клиента в YCLIENTS.
2. Перейдите на вкладку DataDoc и нажмите **«Создать документ»**.
3. Выберите шаблон: данные записи подставятся в документ.

## Какие данные подставляются

При сопоставлении полей вы выбираете поля YCLIENTS из нескольких групп:

- **Запись**: данные визита, в том числе ваши пользовательские поля записи и **«Порядковый номер записи YCLIENTS»**, его удобно подставлять, например, как номер договора;
- **Клиент**: ФИО, телефон и другие данные клиента, его пользовательские поля;
- **Сотрудник**: мастер или специалист записи;
- **Компания**: данные салона или филиала;
- **Посетитель**: тот, кто пришёл на визит, если это не сам клиент. Доступны фамилия, имя, отчество, дата рождения, пол и дополнительный телефон посетителя. Если посетитель в записи — транспортное средство, подставляется его номер (поле «Посетитель: Транспортное средство»).

Например, клиент — родитель, а посетитель — ребёнок-пациент; или клиент — владелец автомобиля, а посетитель — сам автомобиль с госномером.

Услуги и товары записи попадают в таблицы документа вместе с ценами, количеством и итогами позиций, как в записи: [товары и услуги записи](https://datadoc.ru/ru/knowlege/u-crm-yc-tovary-uslugi/llms.txt).

## Данные документа можно записать обратно в карточку

Только в YCLIENTS данные из документа можно перенести обратно в карточку записи. Например, сотрудник вписал в договор паспорт клиента, и эти данные сохраняются в YCLIENTS, чтобы не вводить их ещё раз.

### Этап 1. Сопоставьте «Поля YClients»

1. В плагине нажмите **шестерёнку** справа вверху. Откроется **«Поля YClients»**.

![Шестерёнка «Поля YClients» справа вверху плагина](https://api.forma.today/api/v1/knowledgepublic/files/68a9667a3162649043bddaf3082951d0.png)

_Шестерёнка «Поля YClients» справа вверху плагина_

2. Для переменных DataDoc выберите поля YCLIENTS, в которые их записывать: комментарий к записи, пользовательские поля записи или клиента, а также стандартные поля клиента: фамилию, имя, отчество, телефон, email и дату рождения (они записываются в карточку клиента). Рядом с названием каждого поля YCLIENTS показано его текущее значение из открытой записи и данных клиента: так понятно, что это за поле.
3. Сохраните. Сопоставление общее для всех филиалов вашего рабочего пространства.

### Этап 2. Запишите данные в карточку

1. Создайте документ и откройте его на вкладке **«Документы»**.
2. В окне документа нажмите **«Записать в карточку»**.

![Кнопка «Записать в карточку» в окне документа](https://api.forma.today/api/v1/knowledgepublic/files/8e3204b0ea03899f0b42b1581821eaff.png)

_Кнопка «Записать в карточку» в окне документа_

3. Если поля ещё не сопоставлены, появится окно «Сначала необходимо сопоставить поля YC с переменными DataDoc!». Нажмите **«Настроить»**: откроется сопоставление, в которое уже подставлены переменные этого шаблона. Выберите для них поля YCLIENTS и сохраните.

![Окно «Сначала необходимо сопоставить поля YC с переменными DataDoc!»](https://api.forma.today/api/v1/knowledgepublic/files/06a5882d5cd4bec21e71cfc9b1151d9e.png)

_Окно «Сначала необходимо сопоставить поля YC с переменными DataDoc!»_

4. Если поля сопоставлены, DataDoc запишет данные и покажет итог.

### Этап 3. Проверьте итог

1. В блоке **«Записано в карточку»** видно, какие переменные в какие поля YCLIENTS записаны и с какими значениями.
2. В блоке **«Не записано»** видно, что не записалось и почему: например, переменная не сопоставлена с полем YCLIENTS или значение не подходит к типу поля.
3. Кнопка **«Настроить сопоставление»** сразу открывает настройку полей.

![Итог записи в карточку](https://api.forma.today/api/v1/knowledgepublic/files/cf623f890b91b07bd261cc81925fa6e3.png)

_Итог записи в карточку_

### Как записываются значения

- Пустые значения не записываются: заполненное поле в карточке не сотрётся.
- Если поле в карточке уже заполнено, новое значение из документа заменит старое.
- Значение должно подходить к типу поля YCLIENTS. В числовое поле запишется только число, в поле-дату только дата, в поле со списком только значение из этого списка. Остальное попадёт в «Не записано».
- Таблицы товаров и услуг обратно в карточку не переносятся.

## Филиалы сети

Если у сети несколько филиалов, все они могут работать в одном рабочем пространстве DataDoc с общими шаблонами и документами: [филиалы YCLIENTS](https://datadoc.ru/ru/knowlege/u-crm-yc-filialy/llms.txt).

## Что дальше

- [Несколько филиалов YCLIENTS в одном рабочем пространстве](https://datadoc.ru/ru/knowlege/u-crm-yc-filialy/llms.txt)
- [Товары и услуги записи в таблице документа](https://datadoc.ru/ru/knowlege/u-crm-yc-tovary-uslugi/llms.txt)
- [Сопоставление полей CRM и полей шаблона](https://datadoc.ru/ru/knowlege/u-crm-sopostavlenie/llms.txt)