FGO Invoices для OpenCart — счета FGO из заказов, CUI и e-Factura

FGO Invoices для OpenCart 4.x, 3.x и 2.3 выставляет счёт-фактуру (factura) из заказа в румынском сервисе FGO через его API v2. Покупатель указывает на кассе CUI и номер торгового реестра, а счёт появляется в вашей серии с правильным покупателем, строками и ставками НДС (TVA).

Какой тариф FGO нужен. Ключи API v2 FGO выдаёт компаниям на тарифах Premium и Enterprise. Чтение остатков всего склада FGO даёт только на Enterprise. Для пробы есть тестовая среда FGO (testuat.fgo.ro): в модуле это переключатель «Environment: Live / Test».

Что видит покупатель

На кассе OpenCart покупатель видит поля «CUI» и «Reg. Com.» (модуль сам создаёт их кнопкой «Create the fields» для всех групп покупателей, необязательными). Кто указал CUI, получает счёт на компанию; кто нет — как физическое лицо. Румынский CUI с неправильной контрольной цифрой касса не принимает и объясняет почему.

Что получает админ

Расширения → Модули → FGO Invoices: вкладки «Connection», «Buyer», «Invoice», «Automation», «Pro». Для подключения нужны ключ API (FGO → eCommerce → API → Chei API), CUI вашей компании и адрес магазина. Адрес должен совпадать с зарегистрированным в FGO (Setări eCommerce → API) символ в символ: модуль показывает, какой именно адрес он отправляет. «Save and check the connection» проверяет ключ, показывает его права и читает из FGO типы документов, ставки НДС и склады. Ключ хранится зашифрованным.

На странице заказа появляется панель «Invoice (FGO)»: покупатель, предпросмотр строк (цены с НДС, скидка отдельной строкой на каждую ставку, доставка), CUI можно исправить для этого заказа. После выставления — номер документа со ссылкой на PDF в FGO, сумма и состояние. В разделе «Продажи» — список счетов с фильтрами «In progress», «Stopped», «Issued», «Storno», «Cancelled». Остановленный счёт можно повторить или убрать.

Дважды счёт не выходит: каждый запрос идёт с номером заказа как внешним идентификатором и проверкой дубля на стороне FGO, поэтому после потерянного ответа модуль подбирает уже созданный счёт. Сумма счёта равна сумме заказа до бани, и во второй валюте тоже; если строки не сходятся с заказом, счёт не уходит, а модуль показывает обе суммы.

В Pro счёт выставляется сам по статусам заказа. Оплаченные на кассе заказы сразу отмечаются оплаченными в FGO, наложенный платёж и перевод — по статусу или кнопкой, с отдельным типом оплаты для наложенного платежа. Счета уходят в e-Factura (SPV): выключено, только компаниям или всем, состояние видно в заказе. FGO отправляет PDF покупателю письмом. Сторно на весь заказ и аннулирование — кнопкой или по статусу; сторно можно снять. Номер AWB курьера попадает в счёт до или после выставления. Физическим лицам можно дать отдельную серию.

Склад в Pro: строки счёта списывают товар со склада (gestiune) FGO, а остаток, который FGO возвращает после счёта, записывается на товар в магазине. Ежечасное чтение всего склада работает на тарифе FGO Enterprise. Товары сопоставляются по коду (Model или SKU); записывается количество самого товара, не значений опций.

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

1. Устанавливаете архив для своей версии OpenCart и включаете модуль.
2. В FGO создаёте ключ API и регистрируете адрес магазина (Setări eCommerce → API), создаёте серию в реестре документов.
3. На вкладке «Connection» выбираете среду, вставляете ключ и CUI компании, нажимаете «Save and check the connection».
4. На вкладке «Buyer» создаёте поля CUI и Reg. Com. одной кнопкой, на вкладке «Invoice» вписываете серию.
5. На странице заказа смотрите строки и выставляете счёт.
6. В Pro счёт, оплата, e-Factura, письмо и сторно идут сами по статусам.

Что под капотом

• FGO API v2; ключ зашифрован, права ключа показаны в настройках.
• Сумма счёта равна сумме заказа; строки, которые не сходятся, останавливают счёт до отправки.
• Защита от дубля после потерянного ответа.
• Серию счетов вы вписываете вручную: списка серий в API FGO нет.
• Сторно через модуль — на весь заказ; частичное делается в FGO.
• Аннулировать оплаченный полностью или переданный в SPV счёт FGO не даёт: для них есть сторно.
• Поля CUI и Reg. Com. — стандартные Custom Fields OpenCart.
• События OpenCart без правок ядра; при удалении таблицы счетов остаются.
• Интерфейс на английском и румынском.

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

1. Расширения → Установка: загрузите архив для своей версии без переименования файла (OpenCart 4 — cc_fgo.ocmod.zip, 3.x — cc_fgo-oc3.ocmod.zip, 2.3 — cc_fgo-oc23.ocmod.zip).
2. Для 3.x и 2.3: Расширения → Модификаторы → Обновить.
3. Расширения → Модули → FGO Invoices: установите и откройте.
4. Вставьте ключ API и CUI, проверьте соединение, создайте поля покупателя и впишите серию.
5. Для Pro: вставьте ключ или запустите пробный период на вкладке «Pro».