snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/import-companies-via-csv.mdx

@@ -0,0 +1,201 @@
+---
+title: Импорт компаний через CSV
+description: Полное пошаговое руководство по импорту компаний в Twenty.
+---
+
+## Обзор
+
+Это руководство проведет вас через процесс импорта ваших компаний в Twenty. **Компании следует импортировать в первую очередь**, поскольку Люди и Сделки связываются с Компаниями.
+
+## Перед началом
+
+### Контрольный список предварительных требований
+
+<Check>
+Ваш файл в формате CSV, XLSX или XLS
+</Check>
+
+<Check>
+В файле менее 10 000 записей
+</Check>
+
+<Check>
+В вашем файле нет повторяющихся доменов
+</Check>
+
+<Check>
+Все пользовательские поля созданы в **Настройки → Модель данных**
+</Check>
+
+<Note>
+Нужно импортировать более 10 000 компаний? Разбейте на несколько файлов или используйте [импорт через API](/l/ru/user-guide/data-migration/how-tos/import-data-via-api).
+</Note>
+
+## Шаг 1: Подготовьте данные о компаниях
+
+### Обязательные и рекомендуемые поля
+
+| Поле                      | Обязательно?  | Формат               | Заметки                             |
+| ------------------------- | ------------- | -------------------- | ----------------------------------- |
+| **Название**              | Рекомендуется | Текст                | Отображаемое название компании      |
+| **Домен**                 | Рекомендуется | `https://domain.com` | Уникальный идентификатор            |
+| **Адрес**                 | Необязательно | Несколько столбцов   | См. ниже                            |
+| **Сотрудники**            | Необязательно | Число                | Количество сотрудников              |
+| **Пользовательские поля** | Необязательно | Различается          | Должны существовать в модели данных |
+
+### Формат домена
+
+<Warning>
+**Используйте формат `https://domain.com` для доменов.**
+
+Это соответствует формату, используемому, когда Компании автоматически создаются при синхронизации почты/календаря, что предотвращает появление дубликатов в дальнейшем.
+</Warning>
+
+**Столбцы домена:**
+
+* **Domain / Domain Label**: `acme.com`
+* **Domain / Domain URL**: `https://acme.com`
+
+### Формат адреса
+
+Адрес — это вложенное поле с несколькими столбцами:
+
+```
+Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
+123 Main Street,San Francisco,CA,USA,94105
+```
+
+### Пример структуры CSV
+
+```csv
+name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
+Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
+Widget Co,https://widgets.co,widgets.co,New York,USA,50
+```
+
+<Note>
+**Совет профессионала:** Нажмите **Download sample file** во время импорта, чтобы увидеть точные названия столбцов, которые ожидает Twenty.
+</Note>
+
+## Шаг 2: Откройте функцию импорта
+
+**Вариант 1: Из представления Компании**
+
+1. Перейдите к разделу **Компании** в левой боковой панели
+2. Нажмите значок **⋮** в правом верхнем углу
+3. Выберите **Импорт записей**
+
+**Вариант 2: Через командное меню**
+
+1. Нажмите `Cmd + K` (Mac) или `Ctrl + K` (Windows)
+2. Введите "import"
+3. Выберите **Импорт записей**
+4. Выберите **Компании**
+
+## Шаг 3: Загрузите свой файл
+
+1. Нажмите **Выбрать файл**
+2. Выберите свой файл CSV, XLSX или XLS
+3. Подождите, пока Twenty проанализирует ваш файл
+
+## Шаг 4: Сопоставьте ваши столбцы
+
+Twenty автоматически пытается сопоставить ваши столбцы с полями. Проверьте и при необходимости скорректируйте:
+
+1. **Проверьте автоматические сопоставления** — убедитесь, что они верны
+2. **Исправьте неверные сопоставления** — нажмите на раскрывающийся список, чтобы выбрать нужное поле
+3. **Пропустите столбцы** — выберите **Do not map** для столбцов, которые вы не хотите импортировать
+
+### Важные правила сопоставления
+
+* **Домен**: сопоставьте с **Domain / Domain URL** (не с Domain Label)
+* **Адрес**: сопоставьте каждую часть с соответствующим столбцом (City, State и т. д.)
+* **Поля Select**: значения должны соответствовать существующим вариантам (или вы сопоставите их на следующем шаге)
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+## Шаг 5: Сопоставление значений полей Select
+
+Если у вас есть поля Select или Multi-Select:
+
+1. Twenty показывает ваши значения рядом с существующими вариантами
+2. Сопоставьте каждое значение в вашем файле с вариантом Twenty
+3. Или при необходимости создайте новые варианты
+
+<Note>
+Для вариантов Select используются **имена API**, а не отображаемые метки. Перейдите в **Настройки → Модель данных** → включите **Расширенный режим**, чтобы увидеть имена API.
+</Note>
+
+## Шаг 6: Проверьте и исправьте ошибки
+
+Перед завершением импорта Twenty проверяет ваши данные:
+
+1. Нажмите **Следующие шаги**
+2. Строки с ошибками выделены **желтым**
+3. **Исправляйте ошибки напрямую** — нажмите на ячейку и отредактируйте значение
+4. **Удалите проблемные строки** — нажмите X, чтобы пропустить эту строку
+
+### Распространенные ошибки импорта компаний
+
+| Ошибка                            | Причина                       | Решение                                           |
+| --------------------------------- | ----------------------------- | ------------------------------------------------- |
+| **Дублирующийся домен**           | Домен уже существует в Twenty | Удалите из файла или обновите существующую запись |
+| **Недопустимый формат домена**    | Неверный формат               | Используйте `https://domain.com`                  |
+| **Отсутствует обязательное поле** | Обязательное поле пусто       | Заполните значение или удалите строку             |
+
+## Шаг 7: Завершите импорт
+
+1. Просмотрите сводку импорта
+2. Нажмите **Подтвердить**, чтобы импортировать
+3. Дождитесь завершения импорта
+4. Проверьте, просмотрев несколько записей
+
+## После импорта компаний
+
+Теперь вы можете импортировать записи, которые привязываются к Компаниям:
+
+1. **[Импортируйте Людей](/l/ru/user-guide/data-migration/how-tos/import-contacts-via-csv)** — привяжите их к Компаниям с помощью домена
+2. **Импортируйте Сделки** — свяжите их с Компаниями
+3. **Проверьте импорт** — выборочно просмотрите несколько записей, чтобы убедиться в корректности данных
+
+## Обновление существующих компаний
+
+Чтобы обновлять компании вместо создания новых:
+
+1. Добавьте в файл столбец `domain` или `id`
+2. Twenty сопоставляет записи по этому уникальному идентификатору
+3. Существующие компании обновляются; новые создаются
+
+См. [как обновить существующие записи](/l/ru/user-guide/data-migration/how-tos/update-existing-records-via-import) для подробностей.
+
+## Часто задаваемые вопросы
+
+<AccordionGroup>
+  <Accordion title="Почему две компании не могут иметь одинаковый домен?">
+    Домен — уникальный идентификатор в Twenty. Это предотвращает дубли компаний и обеспечивает корректную привязку писем к нужной компании при синхронизации электронной почты.
+  </Accordion>
+
+  <Accordion title="Что делать, если у некоторых компаний нет домена?">
+    Вы можете оставить домен пустым. Однако мы рекомендуем по возможности добавлять домены для улучшения качества данных и автоматической привязки писем.
+  </Accordion>
+
+  <Accordion title="Могу ли я импортировать компании без связанных контактов?">
+    Да! Сначала вы можете импортировать компании, а позже импортировать контакты и связать их с помощью домена компании.
+  </Accordion>
+
+  <Accordion title="Что произойдет, если я импортирую домен, который уже существует?">
+    Если вы укажете уникальный идентификатор (домен или id), который совпадает с существующей компанией, Twenty обновит эту компанию вместо создания дубликата.
+  </Accordion>
+
+  <Accordion title="Как исправить ошибки 'duplicate domain'?">
+    Либо удалите дубликат из вашего файла, либо добавьте `id` компании, чтобы вместо этого обновить существующую запись.
+  </Accordion>
+</AccordionGroup>
+
+## Устранение неполадок
+
+Возникли проблемы? Проверьте:
+
+* [Как исправить ошибки импорта](/l/ru/user-guide/data-migration/how-tos/fix-import-errors)
+* [Справочник по сопоставлению полей](/l/ru/user-guide/data-migration/capabilities/field-mapping)
+* [Ограничения уникальности](/l/ru/user-guide/data-migration/capabilities/uniqueness-constraints)