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».