
TaxJar Sales Tax для OpenCart — податок з продажу США в кошику й чекауті, звіти в TaxJar
TaxJar Sales Tax для OpenCart 4.x, 3.x, 2.3 (США): рядок податку з продажу в кошику й чекауті; Pro додає замовлення й повернення в TaxJar, податкові коди, звільнених покупців, журнал. Ліцензія назавжди.
- Сумісність
- OpenCart 4.0.2.0–4.1.x, 3.0.x, 2.3.0.2 · мова модуля: English
- PHP
- 7.0 і новіший
- Версія
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Ліцензія
- сайт + тестова копія, назавжди
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- 15.11.2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує продавець
Покупець вводить адресу у США, і в підсумках зʼявляється рядок податку з назвою, у якій можна показувати штат («Sales Tax (CA)»).
Що в адмінці
Extensions → Extensions → Order Total → TaxJar Sales Tax. Вкладки: «Connection», «Calculation», «Reports», «Product tax codes», «Exempt customers», «Log», «Licence».

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

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
OpenCart 4.0.2.0–4.1.x, 3.0.x або 2.3.0.2; PHP 7.0+ для 2.3, розширення cURL.
Акаунт TaxJar з API-токеном (Account → TaxJar API). Кожен розрахунок і кожна передача замовлення рахуються в плані TaxJar, тому модуль кешує відповіді й ходить лише по nexus-штатах.
У магазині має бути валюта з кодом USD (System → Localisation → Currencies): TaxJar працює в доларах.
Порядок суми в підсумках (sort order) має бути вищим за «Taxes»; модуль ставить 6 під час встановлення. Якщо порядок змінено, модуль не додає податок і пише причину в лог.
TaxJar рахує лише адреси США зі штатом і ZIP із 5 цифр; для інших країн діють ставки OpenCart.
Якщо в магазині ще налаштовані штатні ставки США і ввімкнено показ цін з податком, ціни товарів на вітрині показуються зі штатним податком: вимкніть показ цін з податком або приберіть ці ставки.
Повернення йде у TaxJar цілим замовленням: часткові повернення модуль не передає.
Перевірка адреси в API TaxJar доступна з плану Professional, за документацією TaxJar.
Історія версій
Для OpenCart 4.x, 3.x і 2.3: розрахунок податку з продажу США через TaxJar у кошику, міні-кошику, чекауті й замовленнях з адмінки, адреса відправлення, штати з nexus, кеш відповідей…
Разом з TaxJar Sales Tax купують


Shippo & EasyPost Shipping Labels для OpenCart 2.3, 3.x і 4.x — живі тарифи й етикетки USPS, UPS, FedEx, DHL

Sales Tax Nexus Monitor для OpenCart 2.3, 3.x і 4.x — пороги податку з продажів по штатах США

Prop 65 Warnings для OpenCart 2.3, 3.x і 4.x — попередження Каліфорнії на товарі, у кошику й на чекауті
Повний опис модуля
TaxJar Sales Tax для OpenCart 4.x, 3.x і 2.3 рахує податок з продажу США (sales tax) через TaxJar: для кошика з адресою у США зі штатом і ZIP модуль питає TaxJar і показує в підсумках один рядок податку, наприклад «Sales Tax (CA)», замість рядків «Taxes» OpenCart. Те саме працює в міні-кошику, на чекауті й в замовленнях, створених з адмінки.
Що отримує продавець
Покупець вводить адресу у США, і в підсумках зʼявляється рядок податку з назвою, у якій можна показувати штат («Sales Tax (CA)»). Рядок рахує TaxJar за адресою доставки, а модуль замінює ним рядки «Taxes», які OpenCart додав до цього. Знижки (купон, бали) розкладаються по рядках товарів, збори на кшталт «Handling Fee» ідуть окремими рядками, подарункові сертифікати й кредит модуль не чіпає. Ціни товарів на вітрині лишаються за налаштуваннями магазину: TaxJar рахує рядок податку в підсумках.
Модуль звертається до TaxJar лише для адрес США зі штатом і ZIP, а за налаштуванням ще й лише для штатів, де у вашому акаунті є nexus: для решти штатів запиту нема. Адреси інших країн лишаються на штатних ставках OpenCart. Товар без податкового класу не оподатковується, як у OpenCart, або віддається на розсуд TaxJar: це вибирає продавець.
Кожне замовлення зберігає свій розрахунок: на сторінці замовлення видно, чим рахували, суму податку, ставку, юрисдикцію й тип джерела (destination чи origin). Якщо TaxJar не відповів за 8 секунд або відхилив токен, покупець усе одно оформлює замовлення зі штатними ставками, а причина потрапляє в лог; після помилки модуль чекає хвилину (10 хвилин для відхиленого токена), перш ніж звернутися знову.
Що в адмінці
Extensions → Extensions → Order Total → TaxJar Sales Tax. Вкладки: «Connection», «Calculation», «Reports», «Product tax codes», «Exempt customers», «Log», «Licence». У TaxJar відкрийте Account → TaxJar API, скопіюйте токен і вставте його на вкладці «Connection»: токен зберігається зашифрованим і назад у форму не повертається. Натисніть «Check connection»: модуль покаже, до якого середовища підключився, і підтягне штати з nexus та податкові категорії з вашого акаунта. Тут же задається адреса відправлення: для штатів, де податок рахують за місцем відправлення (Техас та інші), вона йде в запит.
На вкладці «Calculation» — назва рядка (з штатом або без), показ нульового рядка, лише nexus-штати, обробка товарів без податкового класу, час життя кешу в хвилинах (за замовчуванням 60) і позиція в підсумках: модуль сам ставить 6 під час встановлення і не додає податок, якщо порядок стоїть раніше за «Taxes».
Pro відкриває три вкладки. «Reports» — статуси, при яких замовлення йде в TaxJar, статуси для повного повернення й для видалення, префікс ID замовлення для кількох магазинів і перевірка адреси. «Product tax codes» — податкові коди TaxJar на категорію й на товар зі списком кодів з вашого акаунта. «Exempt customers» — групи покупців, звільнені від податку (оптові, державні, інші), з передачею покупців у TaxJar. У замовленні зʼявляється блок «Reports in TaxJar» з кнопками «Update in TaxJar», «Send a refund», «Remove from TaxJar» і «Validate the address».
Журнал показує всі замовлення з фільтрами «Waiting», «Stopped», «Done» і «Shop rates used», кнопки «Send what is waiting now» і «Retry the stopped ones», а також «Send past orders»: дозавантаження замовлень за період, до 200 за раз.
Як це працює, крок за кроком
- Встановіть архів для вашої версії OpenCart, потім у Extensions → Extensions оберіть тип «Order Total», встановіть «TaxJar Sales Tax» і відкрийте налаштування.
- Вставте токен з TaxJar (Account → TaxJar API), заповніть адресу відправлення й натисніть «Check connection»: зʼявляться штати з nexus.
- Переконайтеся, що в магазині є валюта USD: TaxJar рахує в доларах, суми в іншій валюті модуль переводить за курсом магазину й назад.
- Увімкніть статус, збережіть налаштування й додайте в кошик товар з податковим класом, вказавши адресу у США.
- У підсумках зʼявиться рядок «Sales Tax (штат)»; після оформлення розрахунок видно на сторінці замовлення.
- У Pro оберіть статуси, при яких замовлення й повернення йдуть у TaxJar, за потреби задайте податкові коди й групи звільнених покупців.
- Стежте за чергою в журналі: зупинені записи можна повторити однією кнопкою.
Що під капотом
- TaxJar REST API: розрахунок податку для замовлення (POST /taxes), штати з nexus, податкові категорії, замовлення й повернення (transactions), покупці (customers), перевірка адреси.
- Авторизація Bearer-токеном, токен зашифровано й у налаштуваннях не показується; версія API зафіксована.
- Розрахунок не блокує оформлення: загальний бюджет очікування на чекауті близько 7 секунд, перевірка адреси в ньому не довше 3, а після таймауту модуль якийсь час не звертається до API.
- Відповіді 400, 401, 403, 422, 429 і 5xx показуються поруч із розрахунком словами, без сирого JSON; для відхиленого токена пауза 10 хвилин.
- Кеш за вмістом кошика й адресою: однакові запити не йдуть удруге.
- Передача замовлень іде чергою з повторами (до 6 спроб із наростаючою паузою); повторне оформлення статусу не створює другий продаж, а після повернення замовлення не йде в TaxJar як продаж повторно.
- У Free усі три Pro-вкладки замкнені, а підроблений запит не змінює Pro-значень.
- Інтерфейс англійською. Суми показуються у форматі магазину.
Встановлення
- OpenCart 4: Extensions → Installer, завантажте cc_taxjar.ocmod.zip, не перейменовуючи його.
- OpenCart 3.x: Extensions → Installer, завантажте cc_taxjar-oc3.ocmod.zip, потім Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, завантажте cc_taxjar-oc23.ocmod.zip (потрібні налаштування FTP у System → Settings → FTP; інакше розпакуйте архів і залийте вміст теки upload/ у корінь магазину вручну), потім Extensions → Modifications → Refresh.
- Extensions → Extensions → Order Total → TaxJar Sales Tax: встановіть і відкрийте налаштування.
- Вставте токен TaxJar, заповніть адресу відправлення, натисніть «Check connection» і збережіть.
- Для Pro: вставте ключ ліцензії або запустіть пробний період на вкладці «Licence».
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний модуль TaxJar?
Ні, це незалежна інтеграція через публічний API. TaxJar є торговою маркою свого власника.
Де взяти токен?
У TaxJar: Account → TaxJar API. Вставте його на вкладці «Connection» і натисніть «Check connection».
Скільки коштують запити до TaxJar?
Вони оплачуються за вашим планом TaxJar. Модуль зменшує їх кількість: відповіді кешуються, запити йдуть лише для штатів з nexus, а коли TaxJar недоступний, діють штатні ставки магазину.
Що з цінами товарів на вітрині?
TaxJar рахує рядок податку в підсумках. Ціни товарів на вітрині лишаються за налаштуваннями магазину, тому штатні ставки США краще прибрати або вимкнути показ цін з податком.
Що буде, якщо TaxJar не відповідає?
Покупець оформлює замовлення зі штатними ставками OpenCart, причина записується в лог, наступна спроба буде через хвилину.
Чи рахує модуль податок поза США?
Ні: TaxJar викликається лише для адрес США зі штатом і ZIP. Для інших країн діють ставки OpenCart.
Чи працює безкоштовна версія без Pro?
Так: підключення, розрахунок у кошику й чекауті, nexus-штати, кеш і лог працюють у безкоштовній версії. Передача замовлень і повернень, податкові коди, звільнені покупці, перевірка адреси та журнал у Pro.
Які версії OpenCart підтримуються?
OpenCart 4.0.2.0–4.1.x, 3.0.x і 2.3.0.2: три окремі архіви в одному продукті.
Ліцензія назавжди?
Так, для OpenCart це одна оплата і ліцензія назавжди, на два сайти.
Що буде після пробного періоду?
Pro вимикається, замовлення в черзі зупиняються з причиною, безкоштовна частина працює далі.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—



















