
Moloni для OpenCart — счета-фактуры из заказов, кредит-ноты и NIF на чекауте (Португалия)
Moloni для OpenCart 4.x, 3.x, 2.3 (Португалия): документы со страницы заказа и NIF на чекауте бесплатно, в 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
Что есть во Free,
а что даёт Pro
Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.
Главное о модуле
Что получает продавец
На странице заказа появляется блок «Moloni document»: NIF покупателя (его можно изменить и сохранить для этого заказа), строки с референсом, количеством, ценой без НДС, скидкой и ставкой, итог с НДС.
Что в админке
Extensions → Extensions → Modules → Moloni Invoices: шесть вкладок: «Connection», «Buyer», «Document», «Automation», «Catalogue» и «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.
Аккаунт Moloni с компанией, включённый API (Developer ID и Chave Secreta).
Закрытый документ налоговый, о нём сообщается в AT, и он окончательный: исправляется кредит-нотой. Для первых заказов отключите закрытие и проверьте черновики в Moloni.
Документы выписываются только в евро: заказ в другой валюте останавливается с объяснением, и документ делается в Moloni вручную.
Ставка НДС или серия, которых нет в компании Moloni, останавливают документ с объяснением. Подарочный сертификат и фиксированный сбор без ставки тоже останавливаются с объяснением, а не выписываются с расхождением.
Строка с 0 % НДС требует кода освобождения; без него модуль ничего не отправляет.
История версий
Первый выпуск для OpenCart 4.x, 3.x и 2.3.
Вместе с Moloni покупают


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

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

TOConline для OpenCart — счета из заказов, кредит-ноты, NIF и ATCUD (Португалия)
Полное описание модуля
Moloni Invoices для OpenCart 4.x, 3.x и 2.3 выписывает документы в португальском сервисе Moloni прямо из заказов магазина: кнопка «Make the document» на странице заказа создаёт в Moloni счёт-квитанцию (FR), фактуру (FT) или упрощённую фактуру (FS), находит или создаёт клиента и товары и показывает номер документа с PDF.
Что нужно от Moloni. Аккаунт Moloni с компанией, включённый доступ к API (Configurações → Developers → «Ativar API») и ваш Developer ID. Документы и сам сервис оплачиваются в Moloni по вашему тарифу: модуль не добавляет платы за документы.
Что получает продавец
На странице заказа появляется блок «Moloni document»: NIF покупателя (его можно изменить и сохранить для этого заказа), строки с референсом, количеством, ценой без НДС, скидкой и ставкой, итог с НДС. Кнопка «Make the document» выписывает документ; дальше в блоке видны тип, номер, сумма, статус и кнопка PDF. Покупатель без NIF получает документ как «Consumidor final» (NIF 999999990).
Заказ, оплаченный на чекауте, получает счёт-квитанцию (FR) или упрощённую фактуру (FS) на выбор; заказ с оплатой позже (наложенный платёж, чек — перечень кодов задаёте вы) получает фактуру (FT) со сроком оплаты, по умолчанию 15 дней. Модуль сначала сохраняет черновик, сверяет его сумму с суммой заказа и только затем закрывает документ; если суммы не совпадают, черновик удаляется, а причина пишется в истории заказа.
Что в админке
Extensions → Extensions → Modules → Moloni Invoices: шесть вкладок: «Connection», «Buyer», «Document», «Automation», «Catalogue» и «Pro». На первой вы вводите Developer ID, Client Secret, логин и пароль Moloni и нажимаете «Save and connect»: пароль уходит в Moloni один раз и не сохраняется, Client Secret хранится зашифрованным. Если логин видит несколько компаний, вы выбираете нужную; каждый магазин работает с Developer ID и ключом собственного аккаунта Moloni.
На вкладке «Buyer» вы включаете поле NIF на чекауте (кнопка «Create the field») и проверку португальского NIF: номер с неверной контрольной цифрой отклоняется у поля, покупатели из-за пределов Португалии и пустое поле не проверяются. На вкладке «Document» — тип документа для оплаты на чекауте, серия, способ оплаты, единица новых товаров, режим закрытия (отключите «Close the documents», чтобы документы оставались черновиками в Moloni), дни на оплату фактуры, фискальная зона (материк, Мадейра, Азоры), НДС «как в заказе», с одной ставкой или без НДС, причина освобождения для строк с 0 %, референс товара и примечание на документе.
На вкладке «Catalogue» (Pro) кнопки «Send the products to Moloni» и «Send the customers to Moloni» передают товары и клиентов в фоне небольшими порциями: товар находится по референсу, клиент по NIF или e-mail, а то, что уже есть в Moloni, остаётся как есть.
Pro выписывает документы сам: когда заказ достигает одного из выбранных вами статусов (например «Processing»), и создаёт кредит-ноту кнопкой на странице заказа или когда заказ попадает в статус возврата («Refunded»). Кредит-нота забирает назад весь закрытый документ. Для покупателей из ЕС за пределами Португалии с налоговым номером и для покупателей из-за пределов ЕС вы задаёте отдельные коды освобождения; компанию Moloni можно назначить каждому магазину OpenCart.
Журнал «Moloni documents» в меню Sales показывает каждый документ со статусом «Waiting», «Stopped», «Closed» или «Removed» и причиной остановки словами: ставки НДС нет в компании Moloni, заказ не в евро, Moloni не отдал строки для кредит-ноты. Блок «Documents for past orders» выписывает документы по статусу и периоду (до 200 за раз), «Retry every stopped one» повторяет всё остановленное, «CSV report» выгружает журнал. Если ответ Moloni потерялся, повтор сначала ищет документ по пометке заказа, так что дубля не будет.
Как это работает, шаг за шагом
- Установите архив для вашей версии OpenCart и установите модуль в Extensions → Modules.
- В Moloni откройте Configurações → Developers → «Configuração de conta e API», включите «Ativar API», укажите Developer ID и адрес ответа (подойдёт адрес магазина) и нажмите «Atualizar»: Moloni покажет Chave Secreta.
- На вкладке «Connection» введите Developer ID, Client Secret, логин и пароль Moloni, нажмите «Save and connect» и выберите компанию.
- На вкладке «Buyer» создайте поле NIF и включите его проверку; на вкладке «Document» выберите тип документа, серию и способ оплаты.
- Для первых заказов отключите «Close the documents»: документы останутся черновиками в Moloni.
- Откройте заказ, проверьте строки и нажмите «Make the document»; когда всё совпадает, включите закрытие.
Что под капотом
- Moloni API (moloni.pt/dev): вход по Developer ID, Client Secret и логину владельца; клиенты, товары, документы (счета-квитанции, фактуры, упрощённые фактуры, кредит-ноты), PDF и справочники компании. Токены хранятся зашифрованными, пароль Moloni не сохраняется нигде.
- Сумма документа равна сумме заказа: строки, купон как скидка в процентах, доставка как услуга и НДС передаются с точными значениями; черновик сверяется с заказом до закрытия.
- Moloni требует обновления доступа: модуль делает это сам раз в час из планировщика OpenCart 4 и с открытий страниц, а на OpenCart 3 и 2.3 дополнительно из серверного cron по секретному адресу с вкладки «Automation». Если магазин долго молчит без посещений, в настройках появится предложение подключиться заново.
- Сбой Moloni (5xx, ответ не JSON, таймаут) не создаёт дубля: повтор ищет документ по пометке заказа. Один и тот же документ не выписывается дважды.
- Проверка NIF — по контрольной цифре, без запроса во внешние реестры; налоговый номер ЕС модуль в VIES тоже не проверяет.
- Интерфейс на английском и португальском, документы — на языке заказа.
Как установить
- Extensions → Installer: загрузите архив для вашей версии, не переименовывая файл (OpenCart 4 — cc_moloni.ocmod.zip, 3.x — cc_moloni-oc3.ocmod.zip, 2.3 — cc_moloni-oc23.ocmod.zip; для 2.3 содержимое папки upload/ копируется в корень магазина).
- Для 3.x и 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → Moloni Invoices: установите и откройте настройки.
- На вкладке «Connection» введите Developer ID, Client Secret, логин и пароль Moloni и нажмите «Save and connect».
- Для первых заказов отключите закрытие документов на вкладке «Document».
- Для Pro: введите ключ или запустите пробный период на вкладке «Pro».
Вопросы
о модуле
Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.
Это официальный модуль Moloni?
Нет, это независимая интеграция с Moloni от CatCode. Moloni — торговая марка её владельца.
Что нужно, чтобы начать?
Аккаунт Moloni с компанией, включённый «Ativar API» с вашим Developer ID и Chave Secreta.
Можно ли удалить выписанный документ?
Закрытый документ окончательный, его исправляют кредит-нотой (Pro: кнопка в заказе или статус возврата). Черновик модуль может удалить («Remove»). Для первых заказов отключите закрытие.
Что будет с покупателем без NIF?
Документ уйдёт на «Consumidor final» (NIF 999999990). Если NIF введён, но неверный, покупатель видит ошибку у поля на чекауте.
Что, если в заказе 0 % НДС?
Выберите код освобождения в настройках. Без него документ не выписывается, а модуль объясняет почему.
Можно ли выписывать документы массово?
Да, в Pro: по статусу и периоду, до 200 за раз; «Retry every stopped one» повторяет остановленные.
Какие версии OpenCart?
OpenCart 4.0.2.x–4.1.x, 3.0.x и 2.3.0.2: три отдельных архива в одном товаре.
Лицензия навсегда?
Да, для OpenCart одна оплата и лицензия навсегда, на два сайта.
Что будет после пробного периода?
Pro отключится, а бесплатная часть продолжит работать.
Пока нет ни одного отзыва. Будьте первым.
Пока вопросов нет. Спроси — мы ответим в течение 24 часов.
Не тот вариант, что искали?
Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















