Импорт контактов

Редактировал(а) Татьяна Брыкова 2026/03/10 13:08

Импорт контактов осуществляется аналогично импорту любой другой сущности по шагам, описанным здесь.

Необходимо обратить внимание на особенности заполнения шаблона импорта, какие поля обязательные и какой тип данных должен применяться к столбцам файла шаблона

 Скачать шаблон:Импорт → Создать → Скачать шаблон → выбрать «Контакт».
2.Открыть в Excel.Первая строка — заголовки (56 столбцов). Не изменять и не удалять!
3.Настроить форматы:Выделить все столбцы → ПКМ → Формат ячеек → Текстовый. Столбцы с датами (№ 11, 24, 47, 48, 53) → Дата (ДД.ММ.ГГГГ).
4.Заполнить данныеСо второй строки. Справочники — строго как в таблице выше. Макс. 40 000 строк, файл до 8 Мб.
5.Сохранить как .xlsx(не .xls). Загрузить: Импорт → Загрузить файл → Импортировать.
6.Проверить результат:Статус импорта, вкладки «Импортированные строки» и «Ошибки импорта», «Детали импорта»

Как работать с шаблоном

Перед заполнением проверить, что:

  •  все столбцы → формат «Текстовый»,
  • столбцы с датами → формат «Дата» (ДД.ММ.ГГГГ).
  • значения справочников введены точно как указано - «Да»/«Нет»

Рекомендуем сначала загрузить 1–2 тестовые строки. При успешном импорте заполнять весь файл.

Для обновления существующего контакта — заполняется  поле «ID записи (для обновления)» (GUID из системы).

Типы полей: Строка — текст  |  Справ. — строго из списка  |  Дата — ДД.ММ.ГГГГ  |  Ссылка — GUID записи  |  URL — полный адрес
 

№ПолеСистемное имяТипФорматОбязательноеДопустимые значения
1Внешний IDExternalIdСтрокаТекстНет—
2ПартнерPartnerIdСсылкаТекстДаGUID
3StateCodeStateCodeСтрокаТекстДа—
4StatusCodeStatusCodeСтрокаТекстДа—
5Персональные заметкиDescriptionСтрокаТекстНет—
6Субъект правоотношенийSubjectOfLegalRelationsСправ.ТекстДаФиз. лицо | Юр. лицо | Гражд. союз
7Предпочтительный способ связиPreferredCommunicationChannelСправ.ТекстДаЛюбой | Телефон | Почта | SMS | WhatsApp | В офисе | Telegram
8ИмяFirstNameСтрокаТекстДа—
9ОтчествоMiddleNameСтрокаТекстНет—
10ФамилияLastNameСтрокаТекстДа—
11День рожденияBirthdayДатаДатаНетДД.ММ.ГГГГ
12ПолGenderСправ.ТекстНетМужчина | Женщина
13Имеет детейChildrenStatusСправ.ТекстНетДа | Нет | Неизвестно
14Семейное положениеMaritalStatusСправ.ТекстНетХолост/Не замужем | Женат/Замужем | В разводе | Вдовец/Вдова
15Электронная почтаEMailAddress1СтрокаТекстДаuser@domain.com
16Электронная почта 2EMailAddress2СтрокаТекстНет—
17Мобильный телефонMobilePhoneСтрокаТекстДа+79991234567
18Есть в мобильном приложенииMobileAppСправ.ТекстНетДа | Нет
19Дополнительный телефонTelephone1СтрокаТекстНет+79991234567
20Коммуникации по E-mailAllowEMailSendingСправ.ТекстНетДа | Нет
21Коммуникации по телефонуAllowMobilePhoneCallingСправ.ТекстНетДа | Нет
22ЛогинLoginСтрокаТекстНет—
23Статус контактаParticipantStatusСправ.ТекстДаАктивный | В черном листе | Заблокирован | Отложен
24Дата регистрацииRegistrationOnДатаДатаНетДД.ММ.ГГГГ
25Коммуникации по SMSAllowSmsSendingСправ.ТекстНетДа | Нет
26Источник анкетыQuestionnaireSourceСправ.ТекстДа23 значения (см. ниже)
27ТранслитерацияUseTransliterationForSmsСправ.ТекстНетДа | Нет
28Валидность анкетыValidityStatusСправ.ТекстНетПусто | Проверен | Не прошел проверку | На проверке
29Мобильный телефон проверенHasVerifiedMobileСправ.ТекстНетДа | Нет
30E-mail проверенHasVerifiedEMailСправ.ТекстНетДа | Нет
31Временная зонаTimezoneСтрокаТекстНетUTC+3
32Разрешить уведомленияAllowNotificationСправ.ТекстНетДа | Нет
33Согласен на обработку персональных данныхHasAgreeToTermsСправ.ТекстДаДа | Нет
34Тип контактаTypeСправ.ТекстДаУчастник ПЛ | Подписчик | Сотрудник | Не участник ПЛ | Технический
35Редактируемый уровеньAllowLevelEditableСправ.ТекстНетДа | Нет
36Магазин частых покупокFrequentShopIdСсылкаТекстНетGUID
37Магазин регистрацииRegistrationShopIdСсылкаТекстНетGUID
38Любимый магазинPreferableShopIdСсылкаТекстНетGUID
39Cсылка на картинкуImageUrlURLТекстНетhttps://...
40РегионAddressRegionСтрокаТекстНет—
41ГородAddressCityСтрокаТекстНет—
42УлицаAddressStreetСтрокаТекстНет—
43ДомAddressHouseСтрокаТекстНет—
44ЭтажAddressFloorСтрокаТекстНет—
45КвартираAddressFlatСтрокаТекстНет—
46Наличие карты в WalletHasWalletСправ.ТекстНетДа | Нет
47Дата привязки карты в WalletWalletBindOnДатаДатаНетДД.ММ.ГГГГ
48Дата отвязки карты в WalletWalletUnbindOnДатаДатаНетДД.ММ.ГГГГ
49Согласие на электронный чекAllowReceiveChequeByEmailСправ.ТекстНетДа | Нет
50Карта по умолчаниюDefaultBonusCardIdСсылкаТекстНетGUID
51УровеньLevelIdСсылкаТекстНетGUID
52Роль в личном кабинетеWebAreaRoleIdСсылкаТекстНетGUID
53Дата окончания действия уровняLevelFinishDateДатаДатаНетДД.ММ.ГГГГ
54Полнота анкетыIsActivatedСправ.ТекстНетДа | Нет
55Кристалл IDCrystalIdСтрокаТекстНет—
56ID записи (для обновления)IdGUIDТекстТолько при обновленииGUID существующей записи

Частые ошибки при импорте

ПроблемаРешение
Телефон +79991234567 → 79991234567 или 7.999E+10Формат столбца «Текстовый» ДО ввода данных. Если уже ввели — удалите, смените формат, введите заново.
GUID обрезается / научная нотация (1.23E+15)Формат «Текстовый». Пример GUID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Дата 01.02.2024 → 02.01.2024 (день/месяц перепутаны)Формат «Дата» → ДД.ММ.ГГГГ. Не использовать ММ/ДД/ГГГГ.
«Да» / «Нет» → TRUE / FALSEФормат «Текстовый». Вводить  «Да» или «Нет» как текст.
Лишние пробелы: « Да» ≠ «Да»Значения справочников — точное совпадение. Используйте СЖПРОБЕЛЫ() / TRIM().
Ведущие нули пропадают: этаж «01» → «1»Формат «Текстовый» сохраняет ведущие нули.
Не заполнены обязательные поляПроверьте столбец «Обязательное» = Да в таблице выше. Без них строка не импортируется.
Значение справочника не из спискаВводить строго как указано. «Мужской» ≠ «Мужчина», «да» ≠ «Да».