Aruba Fatturazione Elettronica для OpenCart — электронные счета FatturaPA через Aruba

Aruba Fatturazione Elettronica собирает из заказа OpenCart итальянский электронный счёт FatturaPA (XML), передаёт его через API Aruba в систему обмена SdI и показывает статус на странице заказа. Данные покупателя: codice fiscale, P.IVA, codice destinatario и PEC. В Pro счёт отправляется по статусу, на возврат идёт кредит-нота TD04. Среди материалов Aruba найден только плагин для WooCommerce, коннектора для OpenCart нет.

Мок написан по документации API (v1.21.0). Это юридический документ: файл счёта не сверяли с официальной XSD, и перед боевым запуском его стоит показать бухгалтеру.

Что делает бесплатная версия

Панель на странице заказа: кнопка «Создать и отправить счёт» строит XML, передаёт его в Aruba и показывает статус (принят, отправлен, доставлен или отклонён с причиной). Данные покупателя берутся из полей оформления или вводятся в панели. Повторный клик не отправляет файл второй раз; если Aruba не ответила на передачу, модуль честно говорит, что счёт мог дойти, и предлагает найти его в кабинете Aruba.

Что добавляет Pro

Отправка по выбранному статусу, кредит-нота TD04 на статус возврата (один раз), соответствие способов оплаты кодам MP, пропуск стран, режим «только с налоговыми данными».

Как это работает, шаг за шагом

1. Получите доступы Aruba.
2. Введите их в модуле и нажмите «Проверить».
3. Проведите один тестовый заказ.
4. Включите автоматику (Pro), когда убедитесь.

Под капотом

• Пароль шифруется; токен Aruba обновляется сам (лимит Aruba: один вход в минуту).
• Нумерация счетов отдельная для demo и боевого режима.
• Языки: English, italiano.

Как установить

1. Расширения → Установка расширений: загрузите zip.
2. Расширения → Модули: установите и откройте модуль.
3. Настройки модуля: данные продавца, логин и пароль Aruba (режим demo/боевой), поля CF, P.IVA, SDI и PEC.
4. Попробуйте на одном тестовом заказе.

Нужен OpenCart 4.0.2 или новее. Имя архива не меняйте.