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

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

Що потрібно від вас. Фірма, зареєстрована в SPV; кваліфікований електронний сертифікат особи з правами SPV для CUI фірми; власний застосунок ANAF для сервісу «E-Factura», зареєстрований у профілі розробника на anaf.ro з адресою колбеку, яку показує плагін. Рахунки — лише в RON.

Чесно про перевірку. Плагін перевірено на локальному магазині WooCommerce, де відповіді ANAF змодельовано за офіційною документацією API (upload, stareMesaj, descarcare, uploadb2c) і прикладами Мінфіну Румунії. Кожен XML з тестових замовлень — B2B, B2C, неплатник ПДВ, кредит-ноти — пройшов офіційний валідатор ANAF (XSD UBL 2.1 + схематрон CIUS-RO 1.0.9). З живим ANAF, тестовим чи робочим, ми його ще не запускали: для цього потрібен сертифікат румунської фірми. Почніть із середовища TEST на своїй фірмі у 7-денному тріалі Pro — якщо ANAF відповість не так, як описано в документації, виправимо оперативно.

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

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

• WooCommerce → e-Factura: вкладки «Invoices», «SPV messages», «Settings» і «Licence».
• Журнал рахунків: номер, замовлення, покупець з CUI, сума, статус ANAF, індекс завантаження або текст відмови; фільтр за статусом і пошук. Посилання на деталі, XML, ZIP відповіді ANAF і PDF (Pro).
• «Send / check now» надсилає чергу і перевіряє статуси одразу, не чекаючи крону.
• Повідомлення вгорі адмінки: відхилені або недоставлені рахунки, немає з’єднання з ANAF, з’єднання скоро закінчиться.

У кожному замовленні — блок «e-Factura»: номер рахунку, статус («Accepted by ANAF», «Rejected by ANAF», в черзі), індекс завантаження і посилання на XML та ZIP. Для замовлення без рахунку — кнопка «Send to e-Factura». Нотатки замовлення фіксують кожен крок: рахунок створено, завантажено з індексом, прийнято або відхилено з причиною.

Відхилений рахунок видно одразу: у журналі, у замовленні й у повідомленні вгорі адмінки, поруч — текст помилки з ZIP-відповіді ANAF (наприклад, BR-RO-111 про код повіту). Виправили замовлення — «Rebuild and send» перебудовує рахунок з тим самим номером, який так і не дійшов до покупця; непотрібний — «Discard».

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

На чекауті з’являються поля «CUI / CIF (for an invoice to a company)», «Trade register no.» і, поки WooCommerce ховає своє поле «Компанія», «Company name (for the invoice)». Без CUI замовлення оформлюється як звичайне. Якщо CUI введено, плагін перевіряє контрольну цифру (з префіксом RO і без), а CNP, введений у поле CUI, відхиляє з підказкою. CUI без назви фірми не проходить. Працює на класичному і блоковому чекауті.

ANAF вимагає для адреси в Бухаресті сектор (SECTOR1–SECTOR6). Покупця з Бухареста без сектора в полі «Місто» чекаут попросить дописати його, наприклад «Sector 3», — інакше рахунок відхилили б уже в ANAF.

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

1. Застосунок ANAF. У профілі розробника на anaf.ro реєструєте застосунок для сервісу «E-Factura» з адресою колбеку з налаштувань плагіна; ANAF видає Client ID і Client Secret.
2. Підключення. WooCommerce → e-Factura → Settings: Client ID і Client Secret, «Connect to ANAF», вибір кваліфікованого сертифіката. «Check the connection» перевіряє токен запитом до ANAF.
3. Продавець. CUI, назва, адреса, повіт (для Бухареста — сектор), IBAN, платник ПДВ чи ні, серія номерів.
4. Чекаут. Покупець-фірма вводить CUI; хибний CUI або Бухарест без сектора не пройдуть.
5. Статус замовлення. Замовлення стає «Виконано» (або «В обробці» — як оберете) — плагін перевіряє дані за правилами RO, будує XML з наступним номером і ставить у чергу. Номер не витрачається, поки дані не пройдуть перевірку.
6. Відправка. Action Scheduler одразу завантажує XML в ANAF (upload), крон — страховка. Далі плагін опитує стан (stareMesaj) з наростаючою паузою в межах лімітів ANAF.
7. Відповідь. Прийнято — ZIP із рахунком і підписом Мінфіну зберігається з замовленням; відхилено — текст помилок у журналі й у замовленні.
8. Збої. ANAF недоступний, технічна помилка чи 429 — рахунок чекає і повторюється сам із тим самим XML; дублікат «transmisa anterior» прив’язується до оригінального індексу.

Pro. Повернення WooCommerce — по позиціях або сумою — дає кредит-ноту 381 з посиланням на рахунок, яка йде в ANAF так само. Замовлення без CUI звітуються через uploadb2c з CNP (якщо покупець його дав) або 13 нулями. Покупці з ЄС з VAT-номером отримують категорію K, поза ЄС — G, обидва з extern=DA.

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

• UBL 2.1, CustomizationID CIUS-RO 1.0.1: рахунок 380 і кредит-нота 381; XML не змінюється після створення, тож повтор надсилає той самий файл байт-у-байт.
• OAuth ANAF: authorization code на logincert.anaf.ro, token_content_type=jwt, state проти підробки колбеку. Токен доступу — 90 днів, оновлюється автоматично за 10 днів до кінця; refresh-токен — 365 днів, далі новий вхід сертифікатом. Client Secret і токени — у базі в зашифрованому вигляді (AES-256 з ключами сайту).
• API RO e-Factura: upload / uploadb2c, stareMesaj, descarcare, listaMesajeFactura і transformare (PDF) — з урахуванням лімітів ANAF на кількість запитів.
• Відповіді ANAF (ZIP із підписом, списки помилок, повідомлення SPV, PDF) з версії 1.0.1 зберігаються в базі даних сайту, а не в теці uploads — жоден веб-сервер, зокрема nginx, не віддасть їх за прямим посиланням. Завантаження — лише через адмінку з перевіркою прав, PDF клієнта — з перевіркою ключа замовлення й власника.
• Нумерація з блокуванням: два замовлення в ту саму секунду не отримають однаковий номер; окремі лічильники для TEST і PRODUCTION.
• Режим імітації: константа CCEF_ANAF_MOCK у wp-config.php моделює відповіді ANAF у середовищі TEST — щоб перевірити магазин без сертифіката.
• Видалення плагіна прибирає токени, крони й кеші; реєстр рахунків і відповіді ANAF лишаються як бухгалтерські записи. Константа CCEF_DELETE_DATA прибирає все.

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть efactura-anaf-for-woocommerce-1.0.1.zip і активуйте.
2. Зареєструйте застосунок «E-Factura» у профілі розробника ANAF з адресою колбеку з налаштувань плагіна.
3. WooCommerce → e-Factura → Settings: Client ID і Client Secret, «Connect to ANAF», сертифікат, «Check the connection».
4. Заповніть дані продавця й серію номерів (окрема серія, якщо рахунки виписує ще й інша програма), залиште середовище TEST.
5. Оформіть тестове замовлення з CUI і переведіть його у «Виконано» — за хвилину в замовленні буде індекс і статус ANAF.
6. Покажіть налаштування ПДВ бухгалтеру і перемкніть середовище на PRODUCTION.
7. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал.