Материал статьи
У покупателя уже есть заявка в таблице: артикулы, количество, иногда комментарии по объектам. Перепечатывать её в каталоге долго, но кнопка загрузки сама по себе не решает задачу. Надёжный импорт должен показать, как сайт понял каждую строку, какие позиции требуют исправления и что именно попадёт в корзину. Исходный файл при этом остаётся потребностью покупателя, а не готовым подтверждённым заказом.

Строки исходной таблицы должны сохранять связь с товарами.
Оглавление
- Ограничьте задачу импортом потребности
- Дайте шаблон, который трудно понять неправильно
- Артикулы обрабатывайте как идентификаторы, а не числа
- Количество проверяйте вместе с единицей
- Разделите ошибки файла, строки и бизнес-условия
- Предпросмотр должен объяснять будущие изменения
- Дубли и повторная загрузка требуют разных правил
- Не теряйте контекст организации и актуальность условий
- Загрузка таблицы остаётся обработкой недоверенного файла
- Длинную обработку превратите в понятное задание
- Принимайте импорт по известному ожидаемому результату
Ограничьте задачу импортом потребности
Сначала договоритесь, какие данные пользователь вправе передать файлом. Для обычной закупки это код товара, количество и при необходимости обозначение единицы или внутренний комментарий. Цена из клиентской таблицы не должна автоматически становиться ценой магазина. Остаток, скидка и допустимость заказа также определяются системой продавца. Иначе привычная загрузка заявки превращается в обход правил расчёта: достаточно отредактировать ячейку, чтобы получить не предусмотренное договором условие.
Этот процесс отличается от импорта самого каталога. Покупатель выбирает из существующих товаров, а не создаёт новые карточки и не меняет их свойства. Неизвестный артикул следует показать как нерешённую строку, а не добавлять в справочник на лету. Если бизнес принимает заявки на отсутствующие в каталоге позиции, для них нужен отдельный согласованный сценарий запроса. Он должен явно отделять известный товар с проверяемыми условиями от описания потребности, которую ещё предстоит уточнить менеджеру.
Определите конечный результат: предварительный список, корзина или запрос коммерческого предложения. Загрузка файла, успешный разбор и размещение заказа — три разных события. В сообщениях полезно сохранять эти границы. «Файл прочитан, проверьте 24 строки» не обещает, что все товары доступны и зарезервированы. Пользователь должен видеть следующий шаг и иметь возможность остановиться, прежде чем сайт изменит текущую корзину или отправит кому-либо заявку от его имени.
Дайте шаблон, который трудно понять неправильно
Шаблон должен быть коротким и соответствовать действующему импорту. Если обязательны только артикул и количество, не добавляйте десяток необязательных колонок ради будущих возможностей. Названия полей, единицы и пример заполнения должны совпадать с объяснениями на сайте. Отдельно укажите, какую строку считать заголовком, допустимы ли пустые строки и где заканчиваются данные. Чем меньше догадок остаётся парсеру, тем проще человеку заранее проверить свою заявку.
Для XLSX решите, какой лист читается. Файл может содержать инструкции, несколько объектов закупки и скрытые служебные листы. Автоматический выбор первого листа удобен только при предсказуемой структуре. Если поддерживается выбор, покажите названия и предварительный просмотр. Объединение всех листов без предупреждения опасно: итоги, справочники и копии одной заявки могут попасть в заказ как дополнительные позиции. Не стоит обещать поддержку произвольной рабочей книги, если фактически реализован один простой табличный формат.
Версия шаблона помогает пережить изменения. Если добавилась обязательная единица измерения, старый файл не должен молча интерпретироваться по новым правилам. Можно поддерживать прежнюю схему с явным объяснением либо предложить обновлённый образец и показать, каких данных не хватает. Храните доступный пример рядом с формой, а не только в письме от менеджера полугодовой давности. Для постоянных покупателей это рабочий интерфейс, поэтому изменение колонок требует такой же аккуратности, как переименование важного поля в кабинете.
Артикулы обрабатывайте как идентификаторы, а не числа
Табличный редактор способен изменить код ещё до загрузки на сайт: убрать ведущие нули, представить длинную последовательность цифр в экспоненциальной форме или распознать похожее значение как дату. Поэтому колонку артикулов полезно заранее подготовить как текстовую. Если исходные символы уже потеряны, простое переключение формата не восстановит их достоверно. Сайт не должен угадывать, сколько нулей было в начале, если это не следует из документированного правила вашего справочника.
В предпросмотре сохраните исходное значение и отдельно покажите распознанный товар. Учебный код «00127» и «127» могут обозначать разные позиции. Даже если в одном каталоге они случайно совпадают, это не основание делать такое преобразование общим правилом. Для надёжной связи нужны согласованные идентификаторы, о чём подробнее написано в статье про артикул и SKU. Название товара в соседней колонке помогает человеку свериться, но не должно незаметно заменять точный поиск по коду.
Полезные исправления вроде удаления пробелов по краям нужно отличать от смысловых преобразований. Замена похожих букв, удаление разделителей и объединение кодов производителя с кодами продавца могут менять результат. Если поддерживается несколько систем обозначений, пусть пользователь выберет нужную или увидит однозначное объяснение распознавания. При нескольких кандидатах строка остаётся нерешённой до выбора. Уверенное сообщение «всё найдено» не стоит ошибки, которая проявится только при получении не той детали.

Неполные строки разбирают отдельно от готовых к заказу.
Количество проверяйте вместе с единицей
В таблице может стоять число «10», но без единицы оно не описывает заказ. Это десять штук, коробок, метров или комплектов? Если единица определяется артикулом, покажите её в результате. Если покупатель вправе указывать разные единицы, проверяйте допустимые преобразования для конкретного товара. В условном примере одна коробка содержит восемь деталей: три коробки — это двадцать четыре штуки. Нельзя принять три штуки как три коробки только потому, что так устроено поле в каталоге.
Отдельно задайте правила дробей, десятичного разделителя и разделителей разрядов. Строка с запятой может означать дробное количество, а в CSV запятая может разделять колонки. Эти уровни нужно обрабатывать последовательно, не пытаясь читать файл простым разбиением каждой строки по любому знаку. В предпросмотре покажите нормализованное количество и единицу. Если запись неоднозначна, попросите исправить её, а не выбирать наиболее правдоподобный вариант без ведома пользователя.
Минимум, максимум и кратность — бизнес-проверки после чтения значения. Файл может быть технически корректным и всё равно содержать недопустимый заказ. Предложение изменить семь единиц на двенадцать допустимо только как видимое решение, если продажа идёт упаковками по шесть. Не округляйте все строки автоматически. Подробнее ограничения разобраны в материале о минимальном заказе и кратности упаковки. Импорт должен помогать выполнить эти правила, а не скрывать их за общим сообщением «некорректный файл».
Разделите ошибки файла, строки и бизнес-условия
Для пользователя важно понять масштаб проблемы. Повреждённый файл или неподдерживаемый формат мешают начать разбор. Отсутствующий артикул относится к конкретной строке. Нехватка остатка или недоступная договорная цена выясняются уже после распознавания товара. Если все случаи назвать «ошибкой загрузки», покупатель будет пересохранять исправный документ вместо того, чтобы уточнить одну позицию. Сообщение должно объяснять, что известно системе и что можно сделать дальше.
Сохраняйте номер исходной строки, даже если пустые строки пропущены или список отсортирован. Он связывает отчёт с файлом покупателя. Для большой заявки полезны фильтр проблемных строк и возможность скачать безопасный отчёт об ошибках. Но отчёт не должен быть единственным способом исправления: несколько простых ошибок удобнее поправить на экране. После правки показывайте, что изменено относительно файла, чтобы человек не потерял связь с исходной ведомостью при последующей сверке.
Не включайте в сообщения внутренние пути, технические исключения библиотеки и фрагменты чужих данных. Сложный сбой можно связать с номером задания, который поможет поддержке найти диагностику. При этом честность важнее успокаивающего текста: если чтение завершилось с ошибкой, нельзя оставлять вечное «Обрабатываем». У процесса должен быть определённый неуспешный результат, сохранённый исходный контекст и возможность повторить попытку без случайного удвоения уже принятых строк.
Предпросмотр должен объяснять будущие изменения
Хороший предпросмотр отвечает на четыре вопроса: что было в файле, что найдено, какие условия действуют сейчас и что произойдёт после подтверждения. Для каждой строки нужны хотя бы исходный номер, код, распознанный вариант, количество с единицей и статус. Цена и доступность показываются в том объёме, который действительно известен. Если расчёт предварительный, обозначьте это рядом с результатом, а не мелким общим примечанием внизу длинной страницы.
Итоговые счётчики должны иметь ясный смысл. В условной заявке двадцать строк: пятнадцать готовы, три требуют выбора варианта, две не найдены. Сумма состояний должна соответствовать двадцати исходным строкам. Если две строки объединяются в одну позицию корзины, это отдельный показатель, а не пропавшая строка. Различайте число строк, число уникальных товаров и суммарное количество единиц. Они отвечают на разные вопросы, и подмена одного другим мешает заметить неполный результат.
Перед подтверждением явно покажите режим: добавить к текущей корзине, заменить её состав или создать отдельный список. Замена особенно чувствительна, если в корзине уже есть ручные изменения. Не выбирайте разрушительное поведение по умолчанию только потому, что так проще реализовать импорт. Если функция предназначена для новой заявки, можно предложить отдельный черновик. В любом случае человек должен увидеть последствия и получить понятный итог, а не обнаружить исчезновение предыдущих покупок на следующем экране.
Дубли и повторная загрузка требуют разных правил
Две строки одного файла могут намеренно описывать один товар для разных объектов. Если комментарии по объектам сохраняются в заказе, слияние только по артикулу потеряет эту информацию. Если назначение не имеет значения, строки можно предложить объединить, предварительно проверив вариант и единицу. В учебном примере две и четыре одинаковые упаковки дают шесть упаковок. Но два метра и четыре рулона нельзя складывать в шесть без знания длины рулона и правил продажи.
Повторная загрузка того же файла — другой вопрос. Человек мог не заметить результат, исправить одну ячейку или действительно захотеть создать ещё одну заявку. Контрольная сумма помогает распознать одинаковые байты, но не объясняет намерение. Покажите ранее созданный результат и предложите осознанный выбор, если это уместно. Не запрещайте любой повтор навсегда и не добавляйте товары повторно молча. Смысл операции определяется действием пользователя и состоянием задачи, а не только именем файла.
Защита от двойного применения нужна и без повторной загрузки. После нажатия «Добавить» соединение может оборваться, хотя сервер уже выполнил запрос. Повтор должен проверять результат того же действия, а не создавать ещё один набор позиций. У задания и применения должен быть устойчивый идентификатор. Это не то же самое, что просто отключить кнопку на экране: запросы могут прийти из другой вкладки или после обновления страницы. Решение о повторе должно приниматься на сервере.

Проверенный состав не заменяет исходный документ.
Не теряйте контекст организации и актуальность условий
Импорт в B2B-кабинете выполняется от имени конкретной компании и пользователя с определёнными правами. Этот контекст нужно фиксировать для задачи. Если человек переключил организацию после предпросмотра, нельзя применить прежние договорные цены к новой корзине. Требуется повторная проверка условий или явное начало нового действия. Сам список потребности можно сохранить, но доступность товара, цена и разрешённые операции не должны считаться переносимыми между организациями автоматически.
Между чтением файла и подтверждением проходит время. Остаток, цена, упаковка или статус товара могут измениться. Перед применением проверьте значимые условия заново и покажите отличия, которые требуют решения. Не оставляйте кнопку активной с обещанием неизменной суммы, если срок актуальности расчёта закончился. В то же время не заставляйте загружать файл повторно ради обновления цены: данные потребности уже известны, нужно лишь пересчитать и подтвердить текущий результат.
Права проверяются не только при показе формы. Пользователь может открыть старую ссылку на задание или попытаться получить отчёт другой компании. Доступ к исходному файлу, предпросмотру и итоговой корзине должен соответствовать актуальным полномочиям. Отзыв доступа к организации не должен оставлять рабочий экспорт заявки по постоянному общедоступному адресу. Для поддержки полезен номер операции, но он сам по себе не должен открывать содержимое чужой закупки.
Загрузка таблицы остаётся обработкой недоверенного файла
Ограничьте поддерживаемые форматы, размер, число строк, листов и время обработки. XLSX внутри представляет собой упакованную структуру, поэтому небольшой размер файла не всегда означает небольшой объём работы после распаковки. Проверяйте ограничения на стороне сервера, а не только в браузере. Парсер должен работать в предсказуемой среде без исполнения макросов и внешних действий из документа. Обычная загрузка заявки не даёт файлу права запускать код или обращаться к внутренним ресурсам сервиса.
Не рассчитывайте значения формул как доверенные команды из файла. Для заказа нужен согласованный набор данных, а не выполнение чужой рабочей книги. Определите, принимаются ли только значения ячеек и как сообщается о формулах в обязательных полях. Отдельно проверяйте формирование отчёта об ошибках: пользовательский текст, выгруженный в CSV, не должен неожиданно интерпретироваться табличным редактором как формула. Это задача безопасного экспорта, а не повод незаметно менять сами артикулы в бизнес-данных.
Срок хранения исходных файлов должен быть осмысленным. В них могут оказаться лишние листы, внутренние комментарии и контакты, которые не нужны для заказа. Не сохраняйте всё бессрочно только ради удобства отладки. Минимизируйте диагностические данные и ограничьте доступ к ним. Базовые меры для входящих вложений разобраны в статье о безопасной загрузке файлов на сайт. Для импорта заявки к ним добавляется проверка смысла каждой строки и изоляция данных организаций.
Длинную обработку превратите в понятное задание
Если файл нельзя разобрать достаточно быстро в обычном запросе, создайте отдельную задачу со статусами. «Принят», «Проверяется», «Нужны исправления», «Готов к применению» и «Применён» описывают разные этапы. Пользователь должен знать, можно ли закрыть страницу и где найти результат позже. Не показывайте точный процент, если система не умеет его обоснованно посчитать. Лучше назвать текущий этап и сохранить путь возвращения, чем обещать оставшиеся секунды наугад.
Отмена до применения и отмена уже изменённой корзины — разные действия. Пока идёт проверка, можно прекратить задачу и не использовать результат. После добавления позиций возможное восстановление требует знания того, какие изменения были внесены и что пользователь успел сделать затем. Не обещайте универсальную кнопку отката, если она удалит ручные правки, появившиеся после импорта. Границы отмены нужно определить заранее и проверить на конкурирующих изменениях.
Для частичного применения выберите явную политику. Можно блокировать весь импорт до устранения критических ошибок либо разрешать перенос выбранных готовых строк. Во втором случае сохраните остальные как нерешённые, а итог обозначьте как частичный. Нельзя оставлять общий зелёный статус «успешно», если часть заявки пропущена. Покупателю нужна возможность понять полноту потребности, а команде — отличить технически обработанный файл от действительно завершённого заказа.
Принимайте импорт по известному ожидаемому результату
Подготовьте набор файлов с конкретными ожиданиями: корректный, пустой, с неверным листом, дублирующимися строками, ведущими нулями, дробными количествами и недоступными товарами. Добавьте файл с большим объёмом данных и документ, который не соответствует заявленному формату. Для каждого заранее запишите результат по строкам и итоговое состояние корзины. Проверка «не упало» недостаточна: функция может без ошибок обработчика принять неверное количество или пропустить половину заявки.
Затем проверьте прерывания: закрытие страницы, повторный запрос после сетевого сбоя, смену компании, отзыв доступа и изменение цены между предпросмотром и применением. Особое внимание уделите уже непустой корзине. Приёмщик должен суметь объяснить итог каждой позиции без чтения серверного журнала. Если это невозможно, интерфейс не даёт достаточной обратной связи, даже когда внутренняя обработка формально правильна.
В разработке интернет-магазина импорт заказа полезен там, где он сохраняет структуру реальной закупки и уменьшает ручной перенос. Начните с небольшого поддерживаемого шаблона и прозрачного предпросмотра. Расширяйте форматы только после того, как понятны потребности и цена усложнения. Хороший результат — не максимально терпимый парсер, а заказ, состав которого покупатель может проверить и которому доверяет после загрузки своей таблицы.