B2B Order Import для WooCommerce — заказ из заявки клиента в Excel, CSV и PDF

B2B Order Import для WooCommerce — плагин для магазинов, которые продают оптом. Оптовый клиент редко оформляет заказ через корзину: он присылает менеджеру файл — таблицу в Excel, выгрузку CSV или PDF из учётной программы — со своими артикулами, названиями и количеством. Дальше менеджер вручную ищет каждую позицию в каталоге, переносит количества в заказ WooCommerce и ошибается на двадцатой строке.

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

Оптовые цены клиента плагин берёт из нашего плагина Оптовые цены для WooCommerce: если он активен, каждая строка заказа получает цену для роли клиента и его количества — так же, как в корзине.

Магазин на OpenCart? Для него есть отдельный модуль B2B Order Import для OpenCart (версии 4.x, 3.x и 2.3) с тем же подходом: файл заявки, проверка менеджером, заказ.

Как это выглядит для покупателя

Для обычных покупателей ничего не меняется: плагин не трогает корзину и оформление заказа. Оптовый клиент получает заказ так же, как после корзины — с обычными письмами WooCommerce (если статус нового заказа их отправляет) и заказом в личном кабинете.

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

Что получает админ

Пункт WooCommerce → «Импорт B2B-заказов» с вкладками «Импорты», «Настройки» и «Лицензия». На вкладке «Импорты» — форма «Новый заказ из файла» (файл, клиент, номер заявки) и список всех импортов с фильтрами «Ждёт проверки», «Заказ создан», «Отклонено».

Проверка заявки

• Клиент и номер заявки: покупатель из вашего магазина и номер, который плагин нашёл в шапке файла («Заказ покупателя № …», «Purchase Order …», «Заявка № …») — или впишите свой.
• Строки: что написано в файле, какое количество прочитано, какой товар магазина найден и как — «по артикулу», «по штрихкоду», «по названию, схожесть 100%», «выбрано вручную». Рядом остаток на складе, цена из файла и цена в заказе.
• Что требует внимания — подсвечено: товар не найден, вариативный товар без выбранной вариации, слабое совпадение по названию, нехватка на складе. Такие строки остаются без отметки, пока вы их не подтвердите.
• «Колонки файла»: если строка прочитана неправильно — выберите, где код, название, количество и цена, и плагин прочитает файл заново.

Заказ

«Создать заказ» добавляет обычный заказ WooCommerce: позиции, адреса клиента, статус из настроек, налоги по вашим правилам. Номер заявки и оригинал файла — в боковой панели «Заявка клиента», номер ищется в списке заказов. Двойной клик не создаёт дубль.

PDF-заявки (Pro)

PDF с текстовым слоем плагин разбирает на вашем сервере, без внешних сервисов: таблицу восстанавливает по положению текста на странице, склеивает названия, перенесённые на несколько строк, и повтор шапки на каждой странице. На скрине — заявка из Word, сохранённая в PDF, с включёнными ценами из файла: разница с вашей ценой подсвечена в каждой строке.

Настройки

• Заказ: статус нового заказа («В ожидании оплаты» не отправляет писем; «На удержании» и «Обработка» отправляют обычные письма WooCommerce и резервируют остатки), оптовые цены клиента.
• Сопоставление: гибкий артикул, поиск по названию и порог схожести (по умолчанию 85%; более слабое совпадение — только предложение).
• Файлы: наибольший размер (по умолчанию 10 МБ, но не больше лимита сервера) и сколько дней хранить оригиналы (по умолчанию 180).
• Pro: память сопоставлений и разметки файлов, цены из файла и порог разницы, страница в кабинете клиента, роли и адреса для уведомлений, AI-распознавание — ключ OpenAI хранится зашифрованным.

Как это работает — шаг за шагом

1. Менеджер загружает файл (или клиент — в своём кабинете в Pro). Плагин проверяет содержимое, а не только расширение, кладёт оригинал в приватную папку под случайным именем и читает его без сторонних сервисов: Excel — как архив XML, CSV — с определением кодировки и разделителя, PDF — разбором текстового слоя.
2. Ищет строку заголовков по словам «артикул», «код», «SKU», «наименование», «количество», «цена» и аналогам на пяти языках — даже под шапкой с реквизитами. Строки «Итого», «НДС», «Total» и повтор заголовка пропускает. Номер заявки берёт из текста над таблицей.
3. Сопоставляет строки по очереди: (Pro) память этого клиента → артикул точно → артикул без пробелов, дефисов и точек → штрихкод → название со схожестью. Вариации находятся по собственному артикулу.
4. Считает цену: цену магазина или оптовую цену клиента из плагина оптовых цен; в Pro — цену из файла.
5. Менеджер проверяет строки и нажимает «Создать заказ». Заказ создаёт WooCommerce: остатки, письма и налоги работают так же, как для заказа из корзины.

Что под капотом

• Без тяжёлых библиотек. Excel плагин читает собственным кодом на ZipArchive и XMLReader с лимитом размера против «zip-бомб». Для PDF в Pro встроена библиотека smalot/pdfparser 2.12.5 (LGPL) — байт в байт из официального релиза, загружается только во время чтения PDF.
• Заказ создаёт WooCommerce своими штатными функциями, поэтому остатки, письма, налоги и хуки других плагинов не обходятся. Атомарный «захват» импорта не даёт двойному клику создать два заказа.
• Сотни строк: строки формы проверки отправляются одним полем, поэтому заявка на сотни строк не упирается в лимит PHP max_input_vars.
• Файлы заявок лежат в uploads/ccboi-private/ под случайными именами с запретом прямого доступа; отдаются только менеджеру с проверкой nonce и удаляются после заданного срока.
• Данные: бесплатная версия не делает никаких внешних запросов. Файл уходит за пределы сервера только в Pro, только с включённым AI и только после клика менеджера.
• Удаление плагина убирает его таблицы, настройки, приватную папку и задачи крона; заказы остаются.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите catcode-b2b-order-import-for-woocommerce-free-1.0.0.zip и активируйте (WooCommerce должен быть активен).
2. WooCommerce → «Импорт B2B-заказов» → выберите файл клиента и по желанию клиента → «Прочитать файл».
3. Проверьте подсвеченные строки, выберите товар или вариацию, где нужно, и нажмите «Создать заказ».
4. Во вкладке «Настройки» выберите статус новых заказов и порог схожести названий.
5. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro бесплатно 7 дней» во вкладке «Лицензия».