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

В этой статье вы узнаете, какие типы полей поддерживает коннектор «Своя CRM» и как он преобразует присланные значения. О приёме событий и структуре таблицы — в статье [Своя CRM: как работает коннектор](https://help-ru.romi.center/svoya-crm-kak-rabotaet-konnektor).

Фиксированного набора колонок нет: колонки — это поля, которые вы завели на шаге «Выбор полей», плюс служебные `rc_data_id` и `rc_created_at`.

## Типы и преобразование значений

| Тип в мастере | Тип колонки | Как пишется значение |
| --- | --- | --- |
| Текст | Строка | Как есть; `true` → `1`, `false` → пустая строка; вложенный объект или массив — строкой JSON, где кириллица и `/` экранированы (`М`, `\/`) |
| Целое число | Целое число | Из значения выбрасывается всё, кроме цифр, и берётся целая часть: `-7` → 7, `1 234,5` → 12345 |
| Дробное число | Дробное число | Выбрасывается всё, кроме цифр и точки: `-5.5` → 5.5, `1234,50` → 123450 |
| Дата | Дата | Сдвигается вместе с часовым поясом, см. ниже |
| Дата и время | Дата и время | Сдвигается на часовой пояс, см. ниже |
| Логический | Логический | `false`, `0`, `"0"` и пустая строка — ложь; строка `"false"` — истина |

> **Важно**
> В числовых полях знак минус и запятая теряются: `-7` запишется как 7, а `1234,50` — как 123450. Присылайте числа без пробелов и с точкой в качестве разделителя, а отрицательные значения храните в текстовом поле.

Отсутствующий ключ и `null` дают пустую ячейку. Пустая строка в текстовом поле так и пишется пустой строкой, в числовом даёт 0, в поле даты — пустую ячейку.

## Даты и часовые пояса

> **Важно**
> Даты без часового пояса считаются UTC и сдвигаются на пояс из настроек. Настройка «Часовой пояс вашей CRM» переводит время в этот пояс, а не читает его в нём. Если система присылает московское время, а в настройках стоит «Москва», в таблице время окажется на 3 часа больше: пришедшее `15:23:50` запишется как `18:23:50`. Правильно запишутся только даты с явным поясом (`2026-09-23T15:23:50+03:00`), метка Unix числом или время в UTC. Чтобы время записывалось ровно как пришло, выберите в настройках пояс «UTC».

В поле «Дата» сдвиг тоже есть: значение со временем ближе к полуночи может перейти на соседний день, а дата без времени у поясов западнее UTC — на день назад.

> **Важно**
> Пояс хранится смещением на момент сохранения. У поясов с летним временем — Берлина, Лондона, Киева, Нью-Йорка, Лос-Анджелеса — оно не переключается вместе с сезоном. При редактировании мастер показывает город из списка с тем же смещением, а при сохранении берёт текущее смещение этого города: «UTC» откроется как «Лондон (UTC+0)», и сохранение с конца марта по конец октября запишет UTC+1 — время в новых строках станет на час больше прежнего. Перед сохранением проверяйте пояс на шаге «Дополнительные настройки». Это касается и подключений из старой формы: у многих из них смещение +0:00, и в мастере они откроются как «Лондон».

> **Важно**
> Значение, которое не читается как дата, срывает запись. Если в поле «Дата» или «Дата и время» пришли `31/12/2026`, `2026.09.23`, текст или метка Unix строкой (`"1695470000"`), в таблицу не попадёт ни одно событие подключения из того же прохода. Они повторяются раз в 30 минут и после пяти неудачных повторов больше не отправляются. Читаются, например, `2026-09-23 15:23`, `23.09.2026`, `23-09-2026`, метка Unix числом, а через косую черту — только с месяцем впереди: `09/23/2026`.

## Служебные колонки

| Колонка в БД | Тип поля | Что внутри |
| --- | --- | --- |
| `rc_data_id` | Целое число без знака | Номер события в буфере ROMI. У таблиц, созданных до 23.07.2026, — присланный `id` |
| `rc_created_at` | Дата и время | Когда строка впервые записана в хранилище, по Москве |