# EnvyCRM: описание выгружаемых полей

В этой статье собраны поля, которые коннектор EnvyCRM выгружает в хранилище ROMI center. О периодичности выгрузки и структуре таблиц — в статье [EnvyCRM: как работает коннектор](https://help-ru.romi.center/envycrm-kak-rabotaet-konnektor).

Фиксированного набора колонок нет: колонки — это поля, отмеченные на шаге «Выбор полей». Основные поля заданы коннектором, служебные и пользовательские приходят из вашего аккаунта EnvyCRM.

## Группы полей

| Группа на шаге «Выбор полей» | Что внутри |
| --- | --- |
| Основные поля | Идентификаторы сделки или лида, воронки, этапа, ответственного и типа входящего обращения, у сделки — и клиента; этап, воронка, ответственный, тип обращения; даты создания, обновления, смены этапа и удаления, у сделки — и завершения; «Дата события». У лида ещё статус, имя, телефон, email, комментарий, UTM-метки, Google Client ID и Yandex Client ID, часовой пояс и дата создания по МСК. Сюда же попадают служебные поля, которые отдаёт аккаунт |
| Основные поля клиента | ID, имя, даты создания, обновления и удаления, часовой пояс клиента |
| Поля клиента | Телефоны, email, должность и примечание клиента |
| Пользовательские поля, Пользовательские поля клиента | Пользовательские поля аккаунта; подгруппа поля EnvyCRM добавляется к названию группы через двоеточие |

Основные поля и основные поля клиента отмечены заранее. В таблице сделок доступны поля клиента, в таблице лидов — поля лида и клиента.

> **Примечание**
> Пользовательских полей самого лида в списке нет — только пользовательские поля клиента.

## Типы колонок

| Поле EnvyCRM | Тип поля |
| --- | --- |
| Идентификаторы | Целое число без знака |
| Число | Целое число |
| Сумма | Дробное число |
| Флажок, переключатель | Логический |
| Дата | Дата |
| Дата и время, даты создания и обновления | Дата и время |
| Текст, списки, телефон, многострочный текст, вычисляемое и остальные | Строка |

Поля-файлы не выгружаются.

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

> **Важно**
> Даты и время полей читаются как UTC и сдвигаются на пояс аккаунта из настроек подключения. А EnvyCRM отдаёт время без пояса: у сделок аккаунта с московским поясом это московское время, и в таблице оно окажется на 3 часа больше, чем в карточке. Верное время события — в колонке `rc_event_time_utc`. Поля «Дата» без времени у поясов восточнее UTC не сдвигаются. Пустая дата остаётся пустой.

> **Важно**
> Отрицательные значения полей «Число» и «Сумма» записываются без минуса: из значения выбрасывается всё, кроме цифр и точки.

> **Важно**
> Поле «Дата события» у подключений из мастера всегда пустое. Значение пишется в колонку `event_date`, а мастер называет колонку по подписи — `data_sobytiya`, и при записи значение отбрасывается. Время события берите из `rc_event_time_utc` и `rc_event_date_msk`.

*   Если контактов одного вида несколько — например, два телефона, — в колонку попадает первый.
*   В «Просмотре данных» у колонок UTM-меток есть подписи, остальные показываются под техническими именами.