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 днів» у вкладці «Ліцензія».