Проверка и исправление ошибок импорта

Импорт редко проходит идеально с первого раза — и это нормально. Важно уметь читать отчёт об ошибках, понимать их причины и аккуратно исправлять, не сломав уже загруженное. Разберём типичные ошибки импорта в RetailCRM и способы их устранить.

Как читать отчёт об импорте

После загрузки RetailCRM показывает итоговый отчёт: сколько записей создано, сколько обновлено и сколько пропущено с ошибками. Это первое, что нужно изучить — до того, как радоваться «загрузилось».

• Создано — новые записи. Сверьте с ожидаемым числом строк.
• Обновлено — совпал ключ; убедитесь, что это ожидаемое поведение.
• Ошибки — строки, которые не прошли; их разбирают в первую очередь.

Многие ошибки в отчёте типовые: «не указано обязательное поле», «неверный формат телефона», «значение не найдено в справочнике». Каждая формулировка прямо указывает на колонку в файле, которую нужно поправить. Сгруппируйте сбойные строки по причине — почти всегда окажется, что это две-три системные проблемы, а не сотни разных.

Кодировка и «кракозябры»

Самая заметная ошибка — нечитаемая кириллица: «Ð˜Ð²Ð°Ð½» вместо «Иван». Причина одна — файл не в UTF-8.

1. Откройте исходник и пересохраните в кодировке UTF-8.
2. Удалите уже загруженные испорченные записи (по метке импорта или дате).
3. Повторите импорт исправленным файлом.

Дубли после импорта

Дубли возникают, когда не задан ключ сопоставления или телефоны в разном формате. Один клиент попадает в базу дважды, история дробится.

Точечно дубли устраняют в карточке через блок «Похожие клиенты» и действие «Объединить дубли» с выбором главной записи. При массовых дублях проще откатить импорт и загрузить заново с правильным ключом.

Несовпадение и потеря полей

Частая тихая ошибка — данные загрузились, но не в те поля или не загрузились вовсе. Строки прошли без ошибок, а телефон лежит в примечании.

• Проверьте, что в мастере импорта каждая колонка сопоставлена нужному полю RetailCRM.
• Убедитесь, что тип поля совпадает: дату нельзя грузить в текстовое поле как ключ сортировки.
• Для полей-справочников значения должны точно совпадать со списком в RetailCRM.

Такие ошибки не видны в отчёте — их ловят выборочной проверкой карточек после загрузки.

Практичный приём — проверять не одну, а несколько разнотипных карточек: клиента с несколькими телефонами, заказ с несколькими позициями, запись с заполненными пользовательскими полями. Крайние случаи вскрывают ошибки маппинга, которые не видны на «простых» записях. Если все они выглядят корректно, вероятность системной ошибки резко падает.

Битые связи и статусы

При импорте заказов встречаются оборванные связи: заказ без клиента, позиция без товара, неизвестный статус.

• Заказ без клиента — клиенты не были загружены заранее или не совпал ключ. Загрузите клиентов, повторите импорт заказов.
• Позиция без товара — каталог отсутствует или артикул не совпал. Загрузите каталог до заказов.
• Неизвестный статус — статуса нет в системе. Создайте статус или поправьте маппинг.

Откат неудачной загрузки

Если импорт прошёл плохо, лучший ход — откатить его и загрузить заново, а не латать записи вручную.

1. Отметьте загруженную партию — тегом при импорте или фильтром по дате/времени загрузки.
2. Удалите её через массовые действия в разделе.
3. Исправьте исходный файл и повторите импорт.

Именно поэтому боевому импорту всегда предшествует тестовый на выборке: ошибку в 10 строках исправить легко, а разгребать 50 000 испорченных карточек — долго и дорого. Перед крупным импортом полезен бэкап или экспорт текущего состояния.

Итог

Работа над ошибками импорта строится по кругу: читаем отчёт → находим причину (кодировка, дубли, маппинг, порядок, связи) → правим исходный файл → откатываем неудачную партию → грузим заново. Тихие ошибки ловим выборочной проверкой карточек, а не только по отчёту.

Если импорт упорно не идёт или база уже засорена дублями, мы разберём причины, откатим неудачные загрузки и перенесём данные в RetailCRM чисто — в рамках миграции и поддержки.