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

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

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

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

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