
Shipping with GHN для WooCommerce — тариф, відправлення й відстеження (В’єтнам)
GHN (Giao Hàng Nhanh) у WooCommerce: тариф на касі, відправлення із замовлення, відстеження; у Pro масові відправлення, етикетки, вебхук і звіт про накладений платіж.
- Сумісність
- WordPress 6.4+ · WooCommerce 8.6+ · PHP 7.4+ · HPOS, блокова каса · потрібні акаунт GHN, токен API і ShopId · мова інтерфейсу: English (у Pro також tiếng Việt)
- Ліцензія
- сайт + тестова копія, річна
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- 15.11.2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує покупець
На касі покупець обирає провінцію й комуну зі списку, який дає GHN: з 1 липня 2025 року у В’єтнамі діє дворівнева адреса без району, і плагін передає GHN його власні назви провінції та комуни.
Що отримує адмін
WooCommerce → GHN: токен API (зберігається зашифрованим), ShopId, середовище (бойове чи тестове GHN), адреса відправника (необов’язково), вага й габарити товару без них, курс до VND для магазинів в іншій валюті, страхування (оголошена цінність, до 5 000 000), інструкція доставки (дивитися, але не приміряти; приміряти; не відкривати), хто платить GHN (магазин чи одержувач) і способи оплати, для яких GHN збирає накладений платіж.

Тріал стартує, коли ви попросите
Свіжий інстал — безкоштовна версія, нічого не вмикається само. Кнопка «Спробувати Pro 7 днів» → e-mail → ключ одразу у вікні і листом.

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
WordPress 6.4+, WooCommerce 8.6+ (HPOS і блокова каса підтримуються), PHP 7.4+.
Акаунт GHN, токен API й ShopId.
Мова інтерфейсу: English; в’єтнамська входить у Pro-збірку.
Історія версій
Тариф GHN на класичній і блоковій касі за новою дворівневою адресою, в’єтнамські поля адреси зі списком комун від GHN, відправлення з замовлення з накладеним платежем, статус і скасування…
Разом з Shipping with GHN купують


Shipping with GHTK для WooCommerce — тариф, відправлення й відстеження (В’єтнам)

Кинуті кошики для WooCommerce

Набори товарів і подарунок від суми для WooCommerce
Повний опис модуля
Shipping with GHN для WooCommerce підключає магазин до служби доставки Giao Hàng Nhanh (GHN) у В’єтнамі. На касі покупець обирає провінцію й комуну та бачить тариф GHN; у замовленні одна кнопка створює відправлення з товарами, вагою, габаритами, накладеним платежем і даними покупця, а код відстеження й статус показуються покупцеві.
Що потрібно від вас. Власний акаунт GHN, токен API (портал розробника GHN → меню акаунта → Manage token) і ShopId вашого магазину. Вставте токен у WooCommerce → GHN, натисніть «Check connection», вкажіть ShopId і додайте метод «GHN» у зону доставки В’єтнаму. Доставку виставляє рахунком ваш акаунт GHN.
Що отримує покупець
На касі покупець обирає провінцію й комуну зі списку, який дає GHN: з 1 липня 2025 року у В’єтнамі діє дворівнева адреса без району, і плагін передає GHN його власні назви провінції та комуни. На класичній касі й у «Моєму акаунті» поле комуни — список GHN; на блоковій касі введену комуну плагін зіставляє зі списком GHN із діакритикою й без неї та з префіксом «Phường / Xã» чи без нього.
Одразу після вибору адреси покупець бачить тариф GHN для свого кошика, за бажанням і дату доставки. Там, куди GHN не доставляє або не повертає ціну, метод не показується: покупець ніколи не бачить помилкового нуля.
Після замовлення покупець бачить код відстеження й статус GHN на сторінці замовлення та в листах про замовлення.
Що отримує адмін
WooCommerce → GHN: токен API (зберігається зашифрованим), ShopId, середовище (бойове чи тестове GHN), адреса відправника (необов’язково), вага й габарити товару без них, курс до VND для магазинів в іншій валюті, страхування (оголошена цінність, до 5 000 000), інструкція доставки (дивитися, але не приміряти; приміряти; не відкривати), хто платить GHN (магазин чи одержувач) і способи оплати, для яких GHN збирає накладений платіж. «Check connection» показує магазини вашого акаунта GHN і перевіряє ShopId, «Test the fee» дає тариф для будь-якої адреси й ваги.
У WooCommerce → Налаштування → Доставка додайте метод «GHN — Giao Hàng Nhanh» у зону: назва для покупця й податковий статус. Дату доставки поруч із ціною вмикає галочка в налаштуваннях GHN. У замовленні з’являється блок «GHN».
«Create GHN shipment» надсилає в GHN товари з ціною, вагою, габаритами й кількістю, оголошену цінність, ім’я, телефон, адресу й нотатку покупця; для замовлень з накладеним платежем GHN збирає суму замовлення. Повторне натискання чи втрачена відповідь ніколи не створюють друге відправлення. Далі блок показує код відстеження, статус, тариф GHN, накладений платіж і очікувану дату доставки. «Update status» читає статус із GHN, «Cancel shipment» скасовує відправлення до забору, після чого можна створити нове.
Що додає Pro
- Автоматично за статусом. Відправлення створюється саме, коли замовлення досягає обраного статусу.
- Масово. «Create GHN shipments» зі списку замовлень (до 15 за запуск) і «Print GHN labels» для кількох замовлень (до 100 етикеток).
- Етикетка. Друк етикетки GHN із замовлення: A5, 80 × 80 мм або 52 × 70 мм.
- Статуси вебхуком. GHN повідомляє магазин про кожну зміну статусу, суму накладеного платежу, тариф і дату переказу накладеного платежу; замовлення можна переводити в обраний статус, коли посилку доставлено або повернено. Статус ніколи не повертається назад, а повторні події ігноруються. Адреса вебхука захищена секретом.
- Щогодинна перевірка відкритих відправлень (по 20 за запуск) на випадок, коли вебхук не дійшов.
- Правила цін. Безкоштовна доставка від суми кошика, фіксована чи відсоткова націнка до тарифу GHN, округлення.
- Кілька магазинів GHN. ShopId обирається в замовленні зі списку магазинів вашого акаунта.
- Звіт про накладений платіж. Відправлення зі статусом, тарифом, зібраною сумою й датою її переказу, з експортом у CSV.
- В’єтнамський інтерфейс і оновлення з catcode.com.ua.
Обмеження
- Потрібен власний акаунт GHN, токен API й ShopId; доставку GHN виставляє вашому акаунту.
- Для тарифу покупець має обрати провінцію й комуну, відому GHN. Метод не показується, якщо GHN не знає комуну, не доставляє за цією адресою, не повертає ціну чи не відповів, а також для посилок понад 50 кг або 200 см з одного боку.
- Для запиту тарифу GHN потрібні ім’я й телефон одержувача, яких покупець на касі ще міг не ввести, тому в запиті тарифу стоять назва й телефон вашого магазину. Покупець передається в GHN лише під час створення відправлення.
- Тариф на касі — це відповідь GHN на момент оформлення; GHN рахує вартість ще раз під час створення відправлення, а плату за накладений платіж додає лише тоді, тож суми можуть відрізнятися.
- GHN розраховує тариф у донгах. Для магазину в іншій валюті вкажіть курс до VND: без нього метод на касі не показується.
- Список комун від GHN у вигляді випадного списку є на класичній касі й у «Моєму акаунті»; на блоковій касі комуну вводять текстом, і стара назва комуни до 2025 року тариф не дає.
- Скасувати відправлення можна, поки воно не забране. Адресу вебхука з налаштувань потрібно передати в GHN.
- Масове створення обробляє до 15 замовлень за запуск.
- Список провінцій додається, лише коли інший плагін не дає в’єтнамські області; поля адреси можна вимкнути в налаштуваннях.
Як це працює, крок за кроком
- Встановіть плагін і активуйте його (WooCommerce має бути активним).
- У WooCommerce → GHN вставте токен API, натисніть «Check connection», вкажіть ShopId і збережіть.
- У WooCommerce → Налаштування → Доставка додайте метод «GHN» у зону В’єтнаму.
- Покупець обирає провінцію й комуну та бачить тариф на касі.
- У замовленні натисніть «Create GHN shipment».
- Код відстеження й статус з’являються в замовленні й у покупця; «Update status» оновлює їх, у Pro статуси приходять самі.
Що під капотом
- Відкрите API GHN (online-gateway.ghn.vn): довідники провінцій і комун, розрахунок тарифу, створення відправлення, статус, скасування, друк етикеток і вебхук.
- Усі виклики йдуть з вашого сервера, токен зберігається зашифрованим і не потрапляє в браузер покупця.
- До GHN передаються лише дані, потрібні для тарифу й відправлення: провінція, комуна й вулиця покупця, товари з вагою, габаритами й ціною, оголошена цінність, ім’я, телефон і нотатка покупця, сума накладеного платежу, адреса відправника, якщо ви її вказали.
- Без токена й ShopId нічого не надсилається.
Як встановити
- Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
- WooCommerce → GHN: вставте токен, натисніть «Check connection», вкажіть ShopId, збережіть.
- Додайте метод «GHN» у зону доставки В’єтнаму.
- Для Pro: вставте ключ ліцензії або запустіть пробний період у розділі «Licence» на тій самій сторінці.
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний плагін GHN?
Ні, це незалежна інтеграція від CatCode. Назви GHN і Giao Hàng Nhanh належать їхньому власнику; плагін не пов’язаний із GHN і не схвалений ним.
Чи потрібен акаунт GHN?
Так. Плагін працює з вашим акаунтом, токеном API й ShopId; доставку виставляє GHN.
Чому GHN не пропонується на касі?
Покупець має обрати провінцію й комуну, яку знає GHN. Метод ховається, коли GHN не доставляє за цією адресою, не повертає ціну чи не відповів, посилка перевищує 50 кг або 200 см, або магазин в іншій валюті без курсу до VND. Остання причина запиту показана вгорі налаштувань плагіна.
Що з районами?
З 1 липня 2025 року райони у В’єтнамі скасовано. Плагін передає GHN нову дворівневу адресу: провінцію й комуну з назвами GHN.
Чому в запиті тарифу стоять мої назва й телефон?
GHN рахує тариф за тими самими полями, що й справжнє відправлення, серед яких ім’я й телефон одержувача. Покупець на касі міг ще їх не ввести, тому підставляються дані вашого магазину. Нічого в GHN не створюється; дані покупця йдуть, коли ви створюєте відправлення.
Тариф на касі збігається з тим, що візьме GHN?
На касі показано тариф, який GHN повернув для цієї адреси й посилки на цей момент. GHN рахує вартість ще раз під час створення відправлення, а плату за накладений платіж додає лише тоді, тому суми можуть відрізнятися.
Чи можна скасувати відправлення?
Так, «Cancel shipment» скасовує його до забору, після чого можна створити нове.
Що буде після пробного періоду?
Pro вимикається, безкоштовна частина працює далі: тариф на касі, створення відправлення із замовлення, статус і код відстеження.
Скільки сайтів покриває ключ?
Один ключ працює на двох сайтах: магазин і копія для розробки.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















