Чорний листопад: −35% на всі модулі до 30 листопада Чорний листопад: −35% до 30 листопада Обрати модуль

Зв'язатись
OpenCart

TOConline для OpenCart — фактури із замовлень, кредит-ноти, NIF і ATCUD (Португалія)

TOConline для OpenCart 4.x, 3.x, 2.3 (Португалія): документи зі сторінки замовлення і NIF на чекауті безкоштовно, у Pro — за статусом, кредит-ноти, AT, журнал. Ліцензія назавжди.

Pro · ліцензія назавжди Тестові копії сайтів у ціні. Чим більше сайтів, тим дешевше кожен
Сумісність
OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · мова інтерфейсу: English, Português
Версія
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3)
Ліцензія
сайт + тестова копія, назавжди
Тріал
7 днів, без картки, один на сайт
Оновлено
листопад 2026
Або всі 509 Pro-модулів з All Access — 3 244 грн / рік

Що є в Free,
а що дає Pro

Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.

Функція Free Pro
Підключення TOConline через OAuth: client id, secret, адреси OAuth і API, токени зашифровані ✔ ✔
Поле NIF і перевірка португальського NIF на чекауті ✔ ✔
Документ зі сторінки замовлення вручну: FR, FT, FS з переглядом рядків і суми ✔ ✔
Ставки ПДВ материка, Мадейри й Азорів, причини звільнення M01–M99 ✔ ✔
Інша валюта з курсом до євро, купон як знижка рядка, доставка як послуга ✔ ✔
PDF, публічне посилання, ATCUD і номер документа в історії замовлення ✔ ✔
Втрачена відповідь: пошук за референсом перед повтором, без другого документа ✔ ✔
Інтерфейс англійською і португальською ✔ ✔
Документ автоматично за статусом замовлення — ✔
Кредит-нота на весь рахунок кнопкою чи за статусом — ✔
Комунікація до AT автоматично й кнопкою — ✔
E-mail покупцю з TOConline автоматично й кнопкою — ✔
Масове виписування для замовлень без рахунку, повтор усіх зупинених — ✔
Журнал документів, фільтри, підсумки й CSV-експорт — ✔
Кілька компаній TOConline (до 3 додаткових) за магазинами — ✔
Окремі звільнення для компаній ЄС і експорту — ✔

Як це виглядає

Блок TOConline в замовленні
Блок «TOConline document» на сторінці замовлення: тип, номер, ATCUD, сума, статус AT, PDF і посилання.
Налаштування документа TOConline
Вкладка «Document»: типи документів, серія, регіон ПДВ, режим ПДВ, звільнення, код товару.
Автоматизація TOConline
Вкладка «Automation» (Pro): статуси для документа й кредит-ноти, e-mail, AT, звільнення ЄС і експорту.

Головне про модуль

Що отримує продавець

На сторінці замовлення зʼявляється блок «TOConline document»: NIF покупця (його можна змінити й зберегти для цього замовлення), рядки з кодом товару, кількістю, ціною, знижкою й ставкою та підсумок.

Що в адмінці

Extensions → Extensions → Modules → TOConline Invoices: шість вкладок «Connection», «Buyer», «Document», «Automation», «Companies» і «Pro».

Тріал стартує, коли ви попросите

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

Один ключ — сайт і тестова копія

Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.

Технічні вимоги

  • OpenCart 4.0.2.x–4.1.x, 3.0.x або 2.3.0.2; розширення cURL; адреса магазину за https.
  • Акаунт TOConline з компанією й доступом до Dados API.
  • Документ у TOConline після створення остаточний: його не можна анулювати, змінити чи видалити, виправлення — лише кредит-нота (Pro). Для перших замовлень перевіряйте рядки й суму в блоці замовлення перед відправкою.
  • Невідомий результат (таймаут, помилка сервера, нечитабельна відповідь) зупиняє документ до вашого рішення: модуль спершу шукає документ у TOConline за референсом замовлення і другого документа сам не надсилає.
  • Кредит-нота виписується лише на весь рахунок, часткових повернень нема.
  • Магазини, привʼязані до додаткової компанії, без Pro зупиняються з поясненням і не потрапляють до основної компанії.
  • Рядок з 0 % ПДВ потребує причини звільнення; без неї модуль нічого не надсилає. Номер платника ЄС не перевіряється у VIES, NIF — лише за контрольною цифрою.

Історія версій

v1.0.0 Поточна листопад 2026

Перший випуск для OpenCart 4.x, 3.x і 2.3.

Разом з TOConline купують

All Access Потрібно більше? Усі модулі (509) однією ліцензією, нові додаються самі. 3 244 грн Детальніше →

Повний опис модуля

TOConline Invoices для OpenCart 4.x, 3.x і 2.3 виписує документи в португальському сервісі TOConline прямо із замовлень магазину: кнопка на сторінці замовлення створює в TOConline рахунок-квитанцію (FR), фактуру (FT) або спрощену фактуру (FS) і показує номер документа, ATCUD, PDF і публічне посилання.

Що потрібно від TOConline. Акаунт TOConline з компанією; адміністратор компанії відкриває Empresa → Configurações → Dados API, вказує імʼя й e-mail інтегратора й отримує посилання (діє 72 години) з client id, secret, адресою OAuth і адресою API. Сам сервіс оплачується в TOConline за вашим тарифом: модуль не додає плати за документи.

Що отримує продавець

На сторінці замовлення зʼявляється блок «TOConline document»: NIF покупця (його можна змінити й зберегти для цього замовлення), рядки з кодом товару, кількістю, ціною, знижкою й ставкою та підсумок. Кнопка створює документ; далі в блоці видно тип, номер, ATCUD, суму, статус AT і кнопки PDF та «Link».

Замовлення, оплачене на чекауті, отримує рахунок-квитанцію (FR) або спрощену фактуру (FS) на вибір; замовлення з оплатою пізніше (накладений платіж, чек — перелік кодів ви задаєте) отримує фактуру (FT) зі строком оплати, за замовчуванням 15 днів. Купон іде як знижка рядка, доставка — як послуга. Модуль звіряє суму документа із сумою замовлення до відправки й після неї; розбіжність видно в примітці.

Що в адмінці

Extensions → Extensions → Modules → TOConline Invoices: шість вкладок «Connection», «Buyer», «Document», «Automation», «Companies» і «Pro». На першій ви вводите client id, secret, адресу OAuth і адресу API зі сторінки Dados API й натискаєте «Save and check the connection»: модуль проходить OAuth, зберігає токени зашифрованими й показує кількість знайдених серій документів.

На вкладці «Buyer» ви вмикаєте поле NIF на чекауті й перевірку португальського NIF за контрольною цифрою: хибний номер відхиляється біля поля. На вкладці «Document» — тип документа для оплати на чекауті й для оплати пізніше, перелік способів оплати «пізніше», строк оплати, префікс серії (серія мусить уже існувати в TOConline), код способу оплати, регіон ПДВ (материк, Мадейра, Азори), ПДВ «як у замовленні», «з ПДВ» або «без ПДВ», причина звільнення для рядків з 0 %, тип рядків (Product або Service), код товару (модель чи SKU) і примітка.

Вкладки «Automation» і «Companies» — для Pro. Без ключа вони відкриваються з поясненням і вимкненими полями, нічого не ламаючи.

Pro виписує документи самі: коли замовлення досягає одного з обраних вами статусів (наприклад «Processing»), і створює кредит-ноту на весь рахунок кнопкою або за статусом повернення («Refunded»). TOConline може сам надіслати документ покупцю e-mail, а модуль — передати його до AT автоматично чи кнопкою (потрібен логін Portal das Finanças компанії, він зберігається зашифрованим). Для компаній ЄС і експорту задаються окремі причини звільнення.

Журнал «TOConline documents» у меню Sales показує кожен документ зі статусом, ATCUD і статусом AT словами, фільтри за статусом, періодом і компанією та підсумки періоду. «Orders without an invoice» дає масове виписування для минулих замовлень, «Retry all stopped» повторює все зупинене, «Download CSV» вивантажує журнал. До трьох додаткових компаній TOConline прив’язуються до магазинів OpenCart.

Як це працює, крок за кроком

  1. Встановіть архів для вашої версії OpenCart і встановіть модуль у Extensions → Modules.
  2. У TOConline відкрийте Empresa → Configurações → Dados API, вкажіть імʼя й e-mail інтегратора й скопіюйте client id, secret, адресу OAuth і адресу API з отриманого посилання.
  3. На вкладці «Connection» введіть ці значення й натисніть «Save and check the connection».
  4. На вкладці «Buyer» увімкніть поле NIF; на вкладці «Document» оберіть тип документа, серію, регіон ПДВ і режим ПДВ.
  5. Відкрийте замовлення, перевірте рядки й суму та натисніть кнопку створення документа.
  6. Для Pro: ключ або пробний період на вкладці «Pro», далі «Automation».

Що під капотом

  • TOConline Open API (api-docs.toconline.pt): OAuth authorization_code з оновленням токена; документи (commercial_sales_documents), PDF (url_for_print), публічне посилання, ATCUD, серії, причини звільнення, відправка до AT і e-mail покупцю. Токени й секрет зберігаються зашифрованими.
  • Сума документа дорівнює сумі замовлення: рядки, купон як знижка рядка, доставка як послуга й ПДВ передаються з точними значеннями; сума TOConline звіряється із замовленням.
  • Фонова робота (повтор після тимчасових збоїв, статуси, масові дії) іде з планувальника OpenCart 4 щогодини й з відкриттів сторінок; серверний cron за адресою з вкладки «Automation» кожні 5 хвилин пришвидшує її.
  • Збій TOConline (5xx, не JSON, таймаут, 429) не створює дубля: повтор шукає документ за референсом замовлення. Один документ не виписується двічі.
  • Інтерфейс англійською і португальською, документ — мовою замовлення.

Як встановити

  1. Extensions → Installer: завантажте архів для вашої версії, не перейменовуючи файл (OpenCart 4 — cc_toconline.ocmod.zip, 3.x — cc_toconline-oc3.ocmod.zip, 2.3 — cc_toconline-oc23.ocmod.zip; для 2.3 вміст теки upload/ копіюється в корінь магазину).
  2. Для 3.x і 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → TOConline Invoices: встановіть і відкрийте налаштування.
  4. На вкладці «Connection» введіть дані зі сторінки Dados API й натисніть «Save and check the connection».
  5. Для Pro: введіть ключ або запустіть пробний період на вкладці «Pro».

Магазин на WooCommerce? Для нього є окремий плагін: Invoices with TOConline для WooCommerce.

Питання
про модуль

Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.

@catcode_support Налаштування, сумісність, активація
Це офіційний модуль TOConline?

Ні, це незалежна інтеграція з TOConline від CatCode. TOConline — торгова марка її власника.

Що потрібно, щоб почати?

Акаунт TOConline з компанією і сторінка Empresa → Configurações → Dados API: client id, secret, адреса OAuth і адреса API.

Чи можна видалити виписаний документ?

Ні: документ TOConline після створення остаточний. Виправляється кредит-нотою (Pro: кнопка в замовленні або статус повернення).

Що буде з покупцем без NIF?

Документ піде на кінцевого споживача («Consumidor final»). Якщо NIF введено, але контрольна цифра хибна, покупець бачить помилку біля поля на чекауті.

Що, коли в замовленні 0 % ПДВ?

Оберіть причину звільнення (M01–M99) у налаштуваннях. Без неї документ не виписується, а модуль пояснює чому.

Що, коли TOConline не відповів?

Модуль зупиняє документ і шукає його в TOConline за референсом замовлення. Якщо документа нема, ви вирішуєте: відправити ще раз чи зняти. Другого документа він сам не шле.

Чи можна виписувати документи масово?

Так, у Pro: для замовлень без рахунку; «Retry all stopped» повторює зупинені.

Які версії OpenCart?

OpenCart 4.0.2.x–4.1.x, 3.0.x і 2.3.0.2: три окремі архіви в одному товарі.

Ліцензія назавжди?

Так, для OpenCart одна оплата і ліцензія назавжди, на два сайти.

Що буде після пробного періоду?

Pro вимкнеться, документи в черзі за статусом зупиняться з причиною, а безкоштовна частина продовжить працювати.

Не той варіант, що шукаєте?

Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.

Замовити кастомний модуль