
TOConline для OpenCart — счета из заказов, кредит-ноты, NIF и ATCUD (Португалия)
TOConline для OpenCart 4.x, 3.x, 2.3 (Португалия): документы со страницы заказа и NIF на чекауте бесплатно, в Pro — по статусу, кредит-ноты, AT, журнал. Лицензия навсегда.
- Совместимость
- 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
Что есть во Free,
а что даёт Pro
Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.
Главное о модуле
Что получает продавец
На странице заказа появляется блок «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 — только по контрольной цифре.
История версий
Первый выпуск для OpenCart 4.x, 3.x и 2.3.
Вместе с TOConline покупают


Скидки от суммы и N+1 для OpenCart

InvoiceXpress для OpenCart 4.x — fatura со страницы заказа

Moloni для OpenCart — счета-фактуры из заказов, кредит-ноты и NIF на чекауте (Португалия)
Полное описание модуля
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.
Как это работает, шаг за шагом
- Установите архив для вашей версии OpenCart и установите модуль в Extensions → Modules.
- В TOConline откройте Empresa → Configurações → Dados API, укажите имя и e-mail интегратора и скопируйте client id, secret, адрес OAuth и адрес API из полученной ссылки.
- На вкладке «Connection» введите эти значения и нажмите «Save and check the connection».
- На вкладке «Buyer» включите поле NIF; на вкладке «Document» выберите тип документа, серию, регион НДС и режим НДС.
- Откройте заказ, проверьте строки и сумму и нажмите кнопку создания документа.
- Для 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) не создаёт дубля: повтор ищет документ по референсу заказа. Один документ не выписывается дважды.
- Интерфейс на английском и португальском, документ — на языке заказа.
Как установить
- 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/ копируется в корень магазина).
- Для 3.x и 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → TOConline Invoices: установите и откройте настройки.
- На вкладке «Connection» введите данные со страницы Dados API и нажмите «Save and check the connection».
- Для Pro: введите ключ или запустите пробный период на вкладке «Pro».
Магазин на WooCommerce? Для него есть отдельный плагин: Invoices with TOConline для WooCommerce.
Вопросы
о модуле
Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.
Это официальный модуль 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 отключится, документы в очереди по статусу остановятся с причиной, а бесплатная часть продолжит работать.
Пока нет ни одного отзыва. Будьте первым.
Пока вопросов нет. Спроси — мы ответим в течение 24 часов.
Не тот вариант, что искали?
Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















