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