e-Factura ANAF для OpenCart — е-фактури RO e-Factura в ANAF (SPV) прямо із замовлень

e-Factura ANAF для OpenCart — модуль для магазинів у Румунії на OpenCart 4, які мусять передавати рахунки в національну систему RO e-Factura (SPV) податкової служби ANAF. Модуль перетворює замовлення на електронний рахунок у форматі UBL 2.1 за румунською специфікацією CIUS-RO 1.0.1 і сам надсилає його в API ANAF через ваш власний OAuth-застосунок — без бухгалтерського SaaS посередині й без щомісячної підписки. Індекс завантаження, статус ANAF і підписана відповідь Міністерства фінансів зберігаються з рахунком.

Що потрібно від вас. Фірма, зареєстрована в SPV; кваліфікований електронний сертифікат особи з правами SPV для CUI фірми; власний застосунок ANAF для сервісу «E-Factura», зареєстрований на порталі ANAF з адресою колбеку, яку показує модуль. OpenCart 4.0.2+ або 4.1.

Чесно про перевірку. Модуль перевірено на локальних магазинах OpenCart 4.1.0.3 і 4.0.2.3 (драйвери бази mysqli і pdo), де відповіді ANAF змодельовано за офіційною документацією API (upload, stareMesaj, descarcare, uploadb2c) і прикладами Мінфіну Румунії: встановлення штатним інсталятором, чекаут гостем, рахунки B2B, B2C, кредит-ноти, EUR з курсом BNR, покупець з ЄС, відмова і повторна відправка. XML з тестових замовлень пройшли офіційний валідатор ANAF (XSD UBL 2.1 + схематрон CIUS-RO 1.0.9); документ покупця з ЄС офлайн-валідатор ідентифікувати не вміє (extern=DA), він пройшов XSD і схематрон. З живим ANAF, тестовим чи робочим, ми модуль ще не запускали: потрібен сертифікат румунської фірми. Почніть із середовища TEST у 7-денному тріалі Pro — якщо ANAF відповість не так, як описано в документації, виправимо оперативно.

Відповідальність за зміст рахунку лишається за магазином. Модуль будує рахунок з даних замовлення OpenCart і з налаштувань ПДВ, які ви обираєте: категорії рядків без ПДВ, режим неплатника, «TVA la încasare», звітування B2C, курс BNR для валют. Це рішення вашого бухгалтера — покажіть йому налаштування до переходу на PRODUCTION.

Що отримує адмін

• Extensions → Modules → e-Factura ANAF: вкладки «Invoices», «Settings», «Tools» і «Licence».
• Журнал рахунків: номер, замовлення, покупець з CUI, сума й валюта, статус («In SPV», «Rejected by ANAF», «Not delivered»), індекс завантаження або повідомлення ANAF; фільтр і пошук. «Send queued invoices now» надсилає чергу одразу.
• Сторінка рахунку: XML, підписана відповідь ANAF, перевірка й PDF через публічні сервіси ANAF, «Regenerate and send» для відхиленого рахунку.
• Повідомлення вгорі модуля: немає з’єднання або воно закінчилось, рахунки давно не дійшли в SPV.

На сторінці замовлення в адмінці — панель «e-Factura»: податковий номер покупця з результатом перевірки, поле, щоб виправити CUI для рахунку (дані покупця не змінюються), і рахунки замовлення зі статусом ANAF. Відхилений рахунок показує список помилок з відповіді ANAF; після виправлення — «Regenerate and send» з тим самим номером.

Невизначене завантаження. Якщо ANAF не відповів після старту завантаження (таймаут), модуль не надсилає рахунок повторно наосліп — інакше в SPV міг би з’явитися дубль. Рахунок стає «Not delivered», а кнопка «Send again as it is» надсилає той самий XML після того, як ви перевірили в SPV, що перший не дійшов.

Як це виглядає для покупця

На штатному чекауті OpenCart з’являється поле «CUI / CIF (company)» — власне поле OpenCart (Customers → Custom Fields), яке модуль створює кнопкою в налаштуваннях. Заповнювати його необов’язково: без CUI замовлення — звичайне, для фірми з CUI буде рахунок у RON. Приймаються записи «14399840», «RO14399840» і «RO 14399840».

Румунський CUI з хибною контрольною цифрою не пройде: помилка з’являється під полем, і замовлення не оформлюється, доки номер не виправлено. Номери платників ПДВ інших країн ЄС і іноземні податкові номери поле приймає.

Як це працює — крок за кроком

1. Застосунок ANAF. На порталі ANAF у розділі розробників реєструєте застосунок для сервісу «E-Factura» з адресою колбеку з налаштувань модуля; ANAF видає Client ID і Client Secret.
2. Підключення. Settings → Connection to ANAF: Client ID і Client Secret, «Connect with ANAF», вибір кваліфікованого сертифіката, «Check the connection».
3. Продавець. CUI, назва, адреса, повіт або сектор Бухареста, платник ПДВ чи ні, серія номерів; кнопка «Create the CUI field».
4. Статус замовлення. Замовлення отримує статус, який ви обрали (наприклад, «Complete»), — модуль будує XML з наступним номером і ставить у чергу.
5. Відправка. Рахунок завантажується в ANAF одразу після зміни статусу; планувальник OpenCart перевіряє чергу щогодини, а для швидших статусів додайте на хостингу крон з адресою з вкладки «Tools» кожні 5 хвилин.
6. Відповідь. Прийнято — статус «In SPV», індекс і підписана відповідь ANAF у рахунку; відхилено — список помилок і «Regenerate and send».
7. Збої. ANAF недоступний — рахунок чекає в черзі й іде пізніше; невизначене завантаження чекає вашого рішення.

Pro. Статус «Refunded» (або обраний вами) дає повну кредит-ноту 381 з посиланням на рахунок; часткову кредит-ноту створюєте вручну по рядках або сумою. Замовлення без CUI звітуються через uploadb2c з CNP (окреме поле за бажанням) або 13 нулями. Покупці з ЄС з VAT-номером отримують категорію K, поза ЄС — G, обидва з extern=DA. Замовлення в EUR, USD та інших валютах отримують рахунок з курсом BNR і сумою ПДВ у RON.

Що під капотом

• UBL 2.1, CustomizationID CIUS-RO 1.0.1: рахунок 380 і кредит-нота 381; повіти в коді ISO 3166-2:RO, сектори Бухареста як SECTOR1–6.
• OAuth ANAF: authorization code на logincert.anaf.ro, token_content_type=jwt, state проти підробки колбеку. Токени й Client Secret зберігаються зашифрованими; ключ шифрування — у теці storage магазину.
• API RO e-Factura: upload / uploadb2c, stareMesaj, descarcare з урахуванням лімітів ANAF — опитування з наростаючою паузою, відповідь завантажується один раз.
• Відповіді ANAF зберігаються в базі даних магазину, а не файлами в теці сайту: за прямим посиланням їх не відкрити, завантаження — лише з адмінки.
• Події OpenCart (зміна статусу замовлення, чекаут, панель замовлення) і завдання планувальника OpenCart — без правки файлів ядра.
• Журнал cc_efactura.log у теці логів магазину, перегляд у вкладці «Tools».
• Видалення: без «Delete data» реєстр рахунків і лічильники лишаються для бухгалтерії; з «Delete data» прибираються також створені модулем поля CUI/CNP.

Як встановити

1. Extensions → Installer → Upload: cc_efactura.ocmod.zip, потім Install.
2. Extensions → Extensions → Modules → e-Factura ANAF → Install → Edit.
3. Зареєструйте застосунок «E-Factura» на порталі ANAF з адресою колбеку з вкладки «Settings».
4. Вставте Client ID і Client Secret, «Connect with ANAF», увійдіть сертифікатом, «Check the connection».
5. Заповніть дані продавця, натисніть «Create the CUI field», увімкніть рахунки, лишіть середовище TEST.
6. Оформіть тестове замовлення з CUI і переведіть у «Complete» — рахунок з’явиться в журналі зі статусом ANAF.
7. Покажіть налаштування ПДВ бухгалтеру і перемкніть середовище на PRODUCTION. Для Pro — ключ з листа після оплати або 7-денний тріал.