В этой статье собраны все поля, которые коннектор amoCRM выгружает в хранилище ROMI center. О периодичности выгрузки и структуре таблицы — в статье amoCRM: как работает коннектор.
Фиксированного набора колонок у amoCRM нет: таблица собирается под поля, отмеченные в настройках, а сам список полей визард запрашивает у вашего аккаунта — пользовательские поля у каждого клиента свои. Стандартных полей ровно двенадцать, они одинаковы у всех.
Как читать таблицу:
- Название — подпись колонки в «Просмотре данных» кабинета.
- Колонка в БД — имя колонки в таблице хранилища.
- Тип поля — смысловой тип.
- Что внутри — откуда берётся значение.
Стандартные поля
| Название | Колонка в БД | Тип поля | Что внутри |
|---|---|---|---|
| ID сделки | amo_id | Целое число | Идентификатор сделки в amoCRM |
| Дата события | event_date | Дата и время | Момент события, по которому создана строка. Пишется в UTC, без пересчёта в часовой пояс аккаунта |
| Название | name | Строка | Название сделки |
| Бюджет | budget | Дробное число | Сумма сделки |
| Статус | status | Строка | Название этапа, на котором сделка в момент события |
| Воронка | funnel | Строка | Название воронки |
| Ответственный | responsible_user | Строка | Имя ответственного сотрудника |
| ID Ответственного | responsible_user_id | Целое число | Идентификатор сотрудника |
| Дата создания | order_date | Дата и время | Когда сделка создана в amoCRM |
| Причина отказа | loss_reason | Строка | Причина отказа по сделке |
| ID контакта | contact_id | Целое число | Идентификатор главного контакта сделки |
| Имя контакта | contact_name | Строка | Имя главного контакта |
Пользовательские поля сделок и контактов
Выбираются там же, рядом со стандартными. Поля контакта попадают в те же строки, что и поля сделки — отдельных префиксов у них нет.
Тип поля не выбирается вручную — он выводится из типа поля в amoCRM:
| Тип поля в amoCRM | Тип поля |
|---|---|
| Числовое, денежное | Дробное число |
| Флажок | Целое число |
| Дата, День рождения | Дата |
| Всё остальное, включая текст, списки и мультисписки | Строка |
Примечание
Имя колонки — код поля из amoCRM строчными буквами, а если кода нет — транслитерация названия: «Сумма предоплаты» → summa_predoplaty. К повторяющемуся имени добавляется идентификатор поля или номер. Имя колонки закрепляется при первом сохранении и больше не меняется: переименованное в amoCRM поле сохранит прежнюю колонку, поменяется только подпись.
Название колонки в «Просмотре данных» подставляется сначала из словаря полей вашего аккаунта (кабинет подтягивает и обновляет его фоном), иначе — из названия, сохранённого в настройках подключения, а для стандартных полей — из встроенного списка выше. Пользовательское поле, которого нет ни там, ни там, показывается техническим именем колонки.
