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

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

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

Для оптового магазина также пригодятся наши модули для OpenCart: Опт — оптовые цены по группам покупателей (именно эти цены B2B Order Import берёт для группы клиента), Импорт прайсов поставщиков, BAS Exchange для обмена заказами с учётом и Stock Reserve & Reorder для резерва остатков под заказы.

Магазин на WooCommerce? Для него есть отдельный плагин B2B Order Import для WooCommerce с тем же подходом: файл заявки в Excel, CSV или PDF, проверка менеджером, заказ.

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

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

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

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

Пункт меню Продажи → «Импорт B2B-заказов» со счётчиком новых заявок от клиентов.

• Загрузка файла: сразу можно выбрать клиента, валюту заказа и источник цен — или указать это на следующем экране.
• Список импортов с вкладками «В работе», «От клиентов», «Заказ создан», «Все»: дата, клиент, файл, номер заявки, сколько строк сопоставлено.

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

• Клиент: аккаунт магазина (адрес по умолчанию и группа) или гость — компания, имя, e-mail, телефон, адрес и группа для цен.
• Колонки файла: модуль показывает, в какой строке нашёл заголовок и какую колонку взял под артикул, название, количество, единицу, цену, сумму и штрихкод. Ошибся — выберите колонку или строку заголовков и нажмите «Прочитать заново».
• Строки: что написано в файле, какой товар магазина найден и как — «по SKU», «по модели», «по названию», «похожее название — проверьте», «выбрано вручную». Рядом поиск товара, количество, цена, сумма и «Пропустить».
• Предупреждения: товар выключен, есть обязательные опции, на складе меньше, минимальное количество, цена в файле отличается от цены магазина.

После создания заказа

Импорт получает статус «заказ создан» и ссылку на заказ, строки блокируются от изменений. Оригинал файла клиента остаётся в истории — его можно скачать в любой момент.

Настройки

• Общие: статус нового заказа, названия способов оплаты и доставки в заказе, цены по умолчанию, максимальный размер файла.
• Сопоставление: в каких полях искать артикулы (SKU, модель, EAN, UPC, MPN, JAN, ISBN); в Pro — похожие названия с порогом и память сопоставлений.
• Загрузка клиентом (Pro): адрес страницы, разрешённые группы, e-mail для уведомлений, лимит в сутки.
• AI-распознавание (Pro): адрес API, ваш ключ, модель, автозапуск. Выключено по умолчанию.

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

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

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

• Без сторонних библиотек и платных сервисов. Excel, ODS, CSV и PDF модуль читает собственным кодом, совместимым с PHP 7.0. Одна библиотека классов одинакова в трёх сборках.
• Без правок ядра. Без OCMOD-патчей; пункт меню добавляется событием OpenCart. Заказ создаёт штатная логика заказов магазина, поэтому склад, письма и другие модули не обходятся.
• Собственные таблицы для импортов, строк, памяти сопоставлений и колонок. Таблицы ядра модуль не меняет.
• Защита создания: админка выдаёт подписанную одноразовую ссылку, а переход «подтверждено → создаётся» атомарный — двойной клик не даёт дубля.
• Файлы заявок лежат в storage/upload/cc_orderimport/ под случайными 32-символьными именами с запретом прямого доступа.
• Лицензия живёт в отдельной группе настроек: «Сохранить» её не трогает.
• Деинсталляция снимает событие и пункт меню, историю импортов оставляет — это история заказов ваших клиентов. Для полного удаления удалите таблицы oc_cc_orderimport_* вручную.

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

1. OpenCart 4: Расширения → Установщик → загрузите cc_orderimport.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Расширения → Установщик → cc_orderimport-oc3.ocmod.zip. OpenCart 2.3: залейте содержимое папки upload/ из cc_orderimport-oc2.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга).
2. Расширения → Расширения → Модули → CatCode B2B Order Import → «Установить».
3. Продажи → «Импорт B2B-заказов» → выберите файл клиента → «Прочитать файл».
4. Проверьте строки, выберите клиента или заполните гостя и нажмите «Создать заказ».
5. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro 7 дней» во вкладке «Лицензия».