Загрузка кодов из файла — самый быстрый способ наполнить запас большой партией ключей. Экран импорта открывается кнопкой «Импорт кодов» на странице «Управление товарными кодами» и проходит в три шага: 1. Файл → 2. Столбцы → 3. Импорт.
Шаг 1. Файл
- Выберите вид кода — в списке только виды, включённые в настройках плагина.
- Выберите CSV-файл и нажмите «Далее».
Требования к файлу: формат CSV, не более 20 000 строк данных. Предел размера показан на экране — это меньшее из 20 МБ и ограничений вашего сервера на загрузку файлов. Кодировка — UTF-8; файлы из Excel в кодировке Windows-1251 плагин перекодирует сам. Разделитель определяется автоматически: запятая, точка с запятой, вертикальная черта или табуляция.
Шаг 2. Столбцы
Плагин показывает первые строки файла. У каждого столбца выберите назначение: «Товар», «Артикул», «Значение кода», «Примечание» или «Не использовать». Один столбец — одна роль.
Ниже укажите, как искать товар и артикул в магазине:
- Идентифицировать товары по: названию, ID товара или «Не идентифицировать»;
- Идентифицировать артикулы по: ID артикула, коду артикула, названию артикула или «Не идентифицировать».
Правила простые: если столбец артикула не назначен, код ложится на товар целиком и годится любому артикулу. Если товар не назначен, а артикул — есть, товар определяется по артикулу. Оба значения «Не идентифицировать» одновременно выбрать нельзя.
Галочка «Первая строка — заголовок» исключает строку с названиями столбцов из данных — обычно плагин определяет её сам.
Нажмите «Проверить». Появится результат: «Пригодно: N, пропущено: M» и список пропущенных строк с причиной по каждой (не более первых 200). На этом шаге в магазин ничего не записывается — проверьте список и, если всё верно, нажмите «Импортировать».

[Скриншот: шаг сопоставления столбцов — таблица предпросмотра файла с выпадающими списками ролей столбцов]
Шаг 3. Импорт
После импорта экран показывает итог: «Добавлено: N, пропущено: M» и список пропущенных строк. Все пригодные коды попадают в запас свободными.
Повторы и пустые строки
- Код, который уже встречается в самом файле, попадает в запас один раз — остальные строки пропускаются с причиной «Повтор кода в файле» и номером первой строки.
- Код, который уже есть в запасе магазина, не дублируется — строка пропускается с причиной «Код уже есть в запасе».
- Пустые строки и строки без значения кода пропускаются с причиной «Пустой код».
Типичные ошибки файла
| Сообщение или причина | Что делать |
|---|---|
| Файл пуст или превышает предел загрузки | проверьте размер файла и число строк (не больше 20 000) |
| Не удалось распознать кодировку файла | пересохраните файл в UTF-8 или Windows-1251 |
| CSV-файл пуст | проверьте, что файл сохранён именно как CSV, а не как книга Excel |
| Товар не найден / Товар по названию не найден | сверьте значение в столбце с названием или ID товара в магазине |
| Название неоднозначно | несколько товаров с одинаковым названием — используйте ID товара |
| Артикул не найден / Артикул не принадлежит товару | сверьте код артикула с карточкой товара |
| Типу товара не назначен выбранный вид кода | назначьте этот вид кода типу товара в разделе «Типы и характеристики товаров» |
| Код длиннее 512 символов / Примечание длиннее 255 символов | сократите значение |
| Файл устарел. Загрузите его заново | файл хранится на сервере час — начните загрузку заново |
| Другой импорт ещё выполняется. Повторите позже | дождитесь завершения предыдущего импорта |

