
Invoices with TOConline для WooCommerce — фактури TOConline із замовлень, NIF (Португалія)
Фактура TOConline з кожного замовлення WooCommerce: клієнт за NIF, ПДВ материка, Мадейри й Азорів, PDF; у Pro документи за статусом, кредит-ноти, AT, журнал.
- Сумісність
- WordPress 6.4+ · WooCommerce 8.6+ (HPOS, блокова каса) · PHP 7.4+ · валюта EUR · мови: English, Português (у Pro)
- Ліцензія
- сайт + тестова копія, річна
- Тріал
- 7 днів, без картки, один на сайт
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що відбувається із замовленням
У замовленні зʼявляється блок «TOConline»: рядки, які підуть у документ, ставка ПДВ кожного рядка, сума з ПДВ і поле NIF для цього замовлення.
Налаштування
WooCommerce → TOConline: введіть Client ID, Secret, адресу OAuth і адресу API з листа TOConline та натисніть «Check the connection and load the series».
Що додає Pro
Документи за статусом. Оберіть статуси (наприклад «Completed»): кожне замовлення отримує документ у фоні, один раз.

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

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
WordPress 6.4+, WooCommerce 8.6+ (HPOS, блокова каса), PHP 7.4+.
Компанія в TOConline з активним планом виставлення рахунків (GC) і доступом до API через бухгалтера.
Валюта магазину — євро (EUR); адреса магазину за https.
Історія версій
Листопад 2026.
Разом з Invoices with TOConline купують


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

Invoices with InvoiceXpress для WooCommerce — сертифіковані фактури InvoiceXpress із замовлень (Португалія)

Набори товарів і подарунок від суми для WooCommerce
Повний опис модуля
Invoices with TOConline для WooCommerce виписує в португальському сервісі TOConline фактуру (FT), фактуру-рецибо (FR) або спрощену фактуру (FS) із замовлення магазину. Кнопка на сторінці замовлення створює документ, клієнта знаходять у TOConline за NIF або створюють, а номер документа й PDF лишаються в замовленні. Модуль працює через API вашої власної компанії в TOConline і призначений для магазинів у Португалії (материк, Мадейра, Азори).
Що потрібно в TOConline. Компанія в TOConline з активним планом виставлення рахунків (GC) і доступом до API: його компанія отримує через свого сертифікованого бухгалтера (Contabilista Certificado). У TOConline: Empresa → Configurações → Dados API → додати інтегратора; на e-mail приходить посилання (діє 72 години) з client id, secret, адресою OAuth і адресою API. Магазин у євро (EUR).
Що відбувається із замовленням
У замовленні зʼявляється блок «TOConline»: рядки, які підуть у документ, ставка ПДВ кожного рядка, сума з ПДВ і поле NIF для цього замовлення. Замовлення, оплачене на чекауті, отримує фактуру-рецибо (FR) або спрощену фактуру (FS) на ваш вибір; замовлення з оплатою пізніше (переказ, чек, накладений платіж) — фактуру (FT) зі строком оплати.
Покупець із NIF знаходиться в TOConline за NIF або створюється; без NIF документ виписується на кінцевого споживача. NIF береться з поля замовлення (за замовчуванням _billing_nif, ключ можна змінити) або вводиться вручну для одного замовлення; контрольна цифра перевіряється. Купони враховуються в цінах рядків, доставка й збори йдуть окремими рядками. Номер документа зберігається в замовленні й нотатці, а PDF відкривається однією кнопкою.
TOConline робить документ остаточним у момент створення, тому модуль перевіряє замовлення до відправки: сума рядків дорівнює сумі замовлення, нема від’ємного збору, рядок із 0 % має причину звільнення, у рядку не два податки. Якщо хоч одна перевірка не пройшла, документа не існує, а в блоці видно причину. Повторне натискання чи друга вкладка другого документа не створить; коли відповідь TOConline загубилась, наступна спроба спершу шукає документ за референсом WC-<номер>.
Налаштування
WooCommerce → TOConline: введіть Client ID, Secret, адресу OAuth і адресу API з листа TOConline та натисніть «Check the connection and load the series». Модуль завантажить серії документів і ставки ПДВ регіону. Нижче — типи документів, серії, строк оплати, режим ПДВ, регіон, причина звільнення для рядків з 0 %, засіб оплати, примітка на документі й поле NIF.
ПДВ береться з замовлення (податки WooCommerce), або ціни вже містять ПДВ за вказаною ставкою, або продавець — звільнений від ПДВ: тоді кожен рядок отримує 0 % і вибрану причину звільнення. Токени доступу (4 години) й оновлення (8 годин) зберігаються зашифрованими й поновлюються самі. Режим налагодження пише журнал WooCommerce без секретів і токенів.
Що додає Pro
Документи за статусом. Оберіть статуси (наприклад «Completed»): кожне замовлення отримує документ у фоні, один раз. Якщо TOConline не відповів, документ ставиться на повтор із наростаючою паузою до восьми спроб, а перед повтором шукається за референсом. Масова дія «Create TOConline documents» у списку замовлень робить те саме для вибраних замовлень.
Кредит-ноти. Кредит-нота (NC) на все замовлення кнопкою в замовленні або за статусом (наприклад «Refunded»), з окремою серією.
Комунікація до AT. Кожен документ передається в Autoridade Tributária через TOConline: автоматично одразу після створення або кнопкою. Потрібен субкористувач Portal das Finanças для комунікації документів; пароль зберігається зашифрованим.
E-mail покупцю. TOConline надсилає документ покупцю сам: автоматично чи кнопкою.
До трьох додаткових компаній. Для кожної — свої дані доступу й префікс серії; компанію можна вибрати в блоці замовлення. Кредит-нота йде в компанію свого документа.
Журнал документів. Усі документи магазину з фільтрами «In progress», «Stopped», «Created», «Totals differ», «Credit notes»; зупинені — з причиною й кнопкою Retry; «Totals differ» показує документи, де сума в TOConline відрізняється від замовлення; лічильник зупинених у меню; експорт CSV за період для бухгалтера.
Мови й оновлення. Інтерфейс: English і Português (Portugal); оновлення з catcode.com.ua.
Обмеження
- Документ у TOConline після створення остаточний: його не можна змінити чи видалити, виправлення — кредит-нота. Для перших замовлень перевіряйте рядки й суму в блоці замовлення.
- Кредит-нота виписується на все замовлення; часткове повернення вносите в TOConline.
- Документи можна створювати, лише поки активний план виставлення рахунків (GC) компанії в TOConline.
- Магазин у євро (EUR).
- Рядок із 0 % ПДВ потребує причини звільнення; без неї модуль нічого не надсилає.
- Ставку ПДВ іншої країни ЄС (OSS) TOConline у португальському регіоні може відхилити: причина видна в нотатці.
- Подарункова картка чи кредит магазину, що змінюють суму поза рядками замовлення, зупиняють відправку: сума рядків мусить дорівнювати сумі замовлення.
- Після втраченої відповіді повторна спроба чекає хвилину, щоб TOConline встиг завершити документ, і лише тоді шукає його.
- Який тип документа, серія й звільнення правильні для вашого магазину, вирішуєте разом із бухгалтером: модуль не дає податкових порад.
Як це працює, крок за кроком
- Встановіть плагін і активуйте його (WooCommerce має бути активним).
- У TOConline (Empresa → Configurações → Dados API) додайте інтегратора й скопіюйте client id, secret, адреси OAuth і API з листа.
- У WooCommerce → TOConline введіть ці дані й натисніть «Check the connection and load the series».
- Оберіть типи документів, серії, режим ПДВ і регіон та збережіть.
- Відкрийте замовлення, перевірте рядки й суму та натисніть «Create the document».
- У Pro увімкніть документи за статусом, кредит-ноти, AT і e-mail.
Що під капотом
- TOConline Open API (api-docs.toconline.pt): OAuth authorization_code з оновленням токена; запити йдуть з вашого сервера лише після збереження даних доступу і лише для дій, які ви запускаєте чи вмикаєте.
- У TOConline передаються дані, потрібні для документа: NIF, імʼя чи компанія й e-mail покупця, адреса й країна виставлення рахунку, рядки замовлення з ціною й ставкою ПДВ, номер замовлення, дати й засіб оплати.
- Secret, токени й пароль Portal das Finanças (Pro) зберігаються зашифрованими й не виводяться в браузер.
- Документи Pro за статусом і повтори працюють у фоні через WP-Cron кожні 5 хвилин.
Як встановити
- Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
- WooCommerce → TOConline: введіть дані з листа TOConline й натисніть «Check the connection and load the series».
- Оберіть серії, типи документів і режим ПДВ та збережіть налаштування.
- Для Pro: вставте ліцензійний ключ або запустіть пробний період у розділі «Licence» на тій самій сторінці.
Магазин на OpenCart? Для нього є окремий модуль: TOConline для OpenCart (4.x, 3.x, 2.3).
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний плагін TOConline?
Ні, це незалежна інтеграція від CatCode. TOConline — торгова марка її власника; модуль не афілійований із TOConline і не схвалений ним.
Як отримати доступ до API TOConline?
Через свого сертифікованого бухгалтера (Contabilista Certificado): у TOConline Empresa → Configurações → Dados API додається інтегратор, і на e-mail приходить посилання з client id, secret, адресою OAuth і адресою API.
Чи можна видалити виписаний документ?
Ні: документ, створений через API, остаточний. Виправляється кредит-нотою (Pro: кнопка в замовленні або статус повернення). Тому модуль перевіряє замовлення до відправки.
Що буде з покупцем без NIF?
Документ піде на кінцевого споживача. Якщо NIF введено, але контрольна цифра хибна, документ не створюється, а в блоці видно причину.
Що, коли TOConline не відповів?
Статус покаже, що документ міг бути створений. Наступна спроба спершу шукає його за референсом замовлення й залишає, якщо він є. Якщо пошук неможливий, перевірте в TOConline й натисніть «It is not in TOConline».
Чи можна виписувати документи автоматично?
Так, у Pro: за обраними статусами замовлення, у фоні, з повторами. Вручну з блоку замовлення — і в безкоштовній версії.
Чи передається документ до AT?
У Pro: через TOConline, автоматично чи кнопкою, з субкористувачем Portal das Finanças.
Що буде після пробного періоду?
Pro вимкнеться, чергу за статусами буде зупинено з причиною, а безкоштовна частина продовжить працювати: підключення, документ із замовлення, NIF, ПДВ, PDF.
На скільки сайтів ключ?
Один ключ працює на два сайти: магазин і тестову копію.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















