
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. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















