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-дневный триал.