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

Зв'язатись
WooCommerce

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

Фактура TOConline з кожного замовлення WooCommerce: клієнт за NIF, ПДВ материка, Мадейри й Азорів, PDF; у Pro документи за статусом, кредит-ноти, AT, журнал.

Завантажити Free
Pro · ліцензія на рік Тестові копії сайтів у ціні. Чим більше сайтів, тим дешевше кожен
Сумісність
WordPress 6.4+ · WooCommerce 8.6+ (HPOS, блокова каса) · PHP 7.4+ · валюта EUR · мови: English, Português (у Pro)
Ліцензія
сайт + тестова копія, річна
Тріал
7 днів, без картки, один на сайт
Або всі 509 Pro-модулів з All Access — 3 244 грн / рік

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

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

Функція Free Pro
Підключення через OAuth: Client ID, Secret (зашифровано), адреси OAuth і API ✔ ✔
Блок «TOConline» у замовленні: рядки, ставки ПДВ і сума до відправки ✔ ✔
Один документ на замовлення: FR для оплати на чекауті, FT чи FS для оплати пізніше ✔ ✔
Клієнт за NIF: пошук у TOConline чи створення, без NIF — кінцевий споживач, перевірка контрольної цифри ✔ ✔
Номер документа в замовленні й нотатці, PDF однією кнопкою ✔ ✔
Перевірки до відправки: сума рядків, від’ємний збір, 0 % без причини звільнення ✔ ✔
ПДВ: з замовлення, ціни з ПДВ чи продавець без ПДВ; материк, Мадейра, Азори; коди M01–M99 ✔ ✔
Серії FR/FT/FS, строк оплати, засіб оплати, примітка на документі ✔ ✔
Захист від другого документа: пошук за референсом після втраченої відповіді ✔ ✔
Документ автоматично за статусом замовлення з чергою й повторами — ✔
Масова дія «Create TOConline documents» — ✔
Кредит-ноти на все замовлення кнопкою чи за статусом — ✔
Комунікація документів до AT через TOConline — ✔
E-mail документа покупцю з TOConline — ✔
До 3 додаткових компаній TOConline — ✔
Журнал документів, «Totals differ», експорт CSV за період — ✔
Переклади: Português (Portugal) — ✔
Оновлення з catcode.com.ua — ✔

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

Блок TOConline в замовленні WooCommerce
Екран замовлення: рядки, ставки ПДВ і сума, які підуть у документ, поле NIF і кнопка «Create the document».
Створений документ
Блок TOConline після створення: тип документа, номер, сума, статус і кнопка PDF; для Pro — кнопка кредит-ноти на все замовлення.
Налаштування документів
WooCommerce → TOConline: типи документів для оплати на чекауті й пізніше, серії, строк оплати, режим ПДВ, регіон ПДВ, причина звільнення.

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

Що відбувається із замовленням

У замовленні зʼявляється блок «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.

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

v1.0.0 Поточна

Листопад 2026.

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

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

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

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 встиг завершити документ, і лише тоді шукає його.
  • Який тип документа, серія й звільнення правильні для вашого магазину, вирішуєте разом із бухгалтером: модуль не дає податкових порад.

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

  1. Встановіть плагін і активуйте його (WooCommerce має бути активним).
  2. У TOConline (Empresa → Configurações → Dados API) додайте інтегратора й скопіюйте client id, secret, адреси OAuth і API з листа.
  3. У WooCommerce → TOConline введіть ці дані й натисніть «Check the connection and load the series».
  4. Оберіть типи документів, серії, режим ПДВ і регіон та збережіть.
  5. Відкрийте замовлення, перевірте рядки й суму та натисніть «Create the document».
  6. У 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 хвилин.

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

  1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
  2. WooCommerce → TOConline: введіть дані з листа TOConline й натисніть «Check the connection and load the series».
  3. Оберіть серії, типи документів і режим ПДВ та збережіть налаштування.
  4. Для Pro: вставте ліцензійний ключ або запустіть пробний період у розділі «Licence» на тій самій сторінці.

Магазин на OpenCart? Для нього є окремий модуль: TOConline для OpenCart (4.x, 3.x, 2.3).

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

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

@catcode_support Налаштування, сумісність, активація
Це офіційний плагін 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.

На скільки сайтів ключ?

Один ключ працює на два сайти: магазин і тестову копію.

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

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

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