Чёрный ноябрь: −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 грн / год ≈ 66 €

Что есть во 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 грн≈ 66 € Подробнее →

Полное описание модуля

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. Расскажите о задаче — подготовим оценку.

Заказать кастомный модуль