E-Invoice EN 16931 для OpenCart — ZUGFeRD / Factur-X, XRechnung и Peppol BIS (Словакия, Бельгия) из заказов

E-Invoice EN 16931 для OpenCart превращает заказы в электронные счета по европейскому стандарту EN 16931: ZUGFeRD / Factur-X (PDF/A-3 с XML внутри), XRechnung 3.0 в синтаксисах CII и UBL и Peppol BIS Billing 3.0 для словацкой e-faktúra, обязательной между словацкими компаниями с 1 января 2027 года. Один модуль для OpenCart 4, 3 и 2.3; всё формируется в вашем магазине — без внешнего сервиса, без подписки, без передачи данных заказов третьим лицам.

Магазин на WooCommerce? Для него есть отдельный плагин — E-Invoice EN 16931 для WooCommerce: ZUGFeRD / Factur-X и XRechnung 3.0 из заказов WooCommerce.

Честно о тестировании. Модуль прошёл полные прогоны в чистых магазинах на OpenCart 4.1.0.3, 4.0.2.3 (драйвер pdo), 3.0.5.0 и 2.3.0.2 на PHP 7.0, установка штатным инсталлятором, настоящие оформления заказов на витрине: все 76 файлов XRechnung (CII и UBL, счета и кредит-ноты) — ACCEPTABLE в официальном валидаторе KoSIT 1.6.3 с конфигурацией XRechnung 3.0.2, все 76 PDF и CII валидны в Mustang 2.26 (EN 16931 и veraPDF PDF/A-3b), все 12 файлов Peppol BIS без ошибок по схеме UBL 2.1, правилам CEN EN 16931 и OpenPeppol BIS 3.0.20. Сумма каждого документа равна сумме заказа — и с купоном, и во второй валюте. Реальные порталы и поставщиков ещё не проверяли — ZRE / OZG-RE, Chorus Pro, Peppol access point, сертифицированную словацкую службу доставки счетов: попробуйте на своём магазине в 7-дневном триале Pro. Налоговое содержание счёта — это настройки продавца, а не налоговая консультация.

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

• Поля для компаний — VAT ID, референс покупателя / Leitweg-ID и, для Словакии, IČO и DIČ. Это обычные custom fields OpenCart, модуль создаёт их кнопкой, поэтому они работают на штатном чекауте, в регистрации и кабинете и рядом с One Page Checkout.
• Проверка прямо у поля: VAT ID в неверном формате, словацкий DIČ или IČO неверной длины останавливают заказ с сообщением у поля. С Pro и включённым VIES отклоняется и номер, который VIES называет незарегистрированным; недоступный VIES заказ никогда не блокирует.
• Счёт письмом (Pro): PDF с XML внутри, плюс XML XRechnung для заказов с Leitweg-ID и Peppol XML для словацкого B2B.
• Счета в кабинете (Pro): на странице заказа в кабинете покупателя есть блок «Invoices» с PDF и XML. Ссылки привязаны к каждому документу ключом: другой покупатель или посетитель ничего не получит.

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

• Панель электронного счёта на странице заказа: выдать счёт, посмотреть PDF, скачать PDF, CII, XRechnung CII и UBL, Peppol BIS; видеть кредит-ноты и исправить данные покупателя (VAT ID, референс, IČO, DIČ).
• Проверка перед выдачей на реальном заказе: модуль строит документ с вашими настройками и говорит, чего не хватает, не расходуя номер счёта.
• Категории НДС автоматически из заказа: стандартная ставка S, нулевая Z, reverse charge AE и внутриевропейская поставка K для компании из ЕС с VAT ID, экспорт G, услуги за рубеж и малый бизнес E — каждая с текстом причины и кодом VATEX.
• Суммы ровно как в заказе: товары, доставка и сборы с налогом по ставкам, купоны как скидки по группам НДС, сертификаты и баланс как предоплата, вторая валюта заказа.
• Нумерация без пропусков по шаблону вроде INV-{YYYY}-{N:5} под блокировкой, со сбросом каждый год и стартовым номером, чтобы продолжить из прежней программы; «Пересобрать» создаёт документ заново под тем же номером.
• Реестр документов с фильтрами и всеми файлами.

Словацкая e-faktúra: Peppol BIS и служба доставки счетов

С 1 января 2027 года словацкий плательщик НДС выставляет счета за внутренние поставки словацким компаниям в структурированном виде по EN 16931 и передаёт их через сертифицированную службу доставки (§ 85o и § 76a закона 222/2004 об НДС в редакции закона 385/2025). Модуль закрывает часть магазина:

• для словацкого продавца и словацкой компании-покупателя счёт выдаётся ещё и как Peppol BIS Billing 3.0 (UBL) с DIČ обеих сторон как Peppol-адресом 0245, группами 23 % / 5 % и документом на словацком;
• DIČ или IČO неверной длины отклоняются на чекауте;
• Pro отправляет Peppol XML в вашу службу доставки счетов: кнопкой на странице заказа или автоматически после выдачи счёта. Ответ поставщика записывается в реестр и историю заказа; неудачная передача помечается как неудачная, её можно повторить.

У каждого поставщика свой API. Модуль поддерживает распространённую форму — HTTPS-адрес, принимающий UBL XML в теле запроса, с API-ключом в заголовке с названием, которое вы указываете; ключ хранится зашифрованным, plain http отклоняется, сертификат поставщика проверяется. Мы проверили это на собственном HTTPS-эндпоинте (ключ принят, неверный ключ → HTTP 401 виден в заказе), на реальном сертифицированном поставщике — ещё нет.

Бельгия: Peppol BIS для B2B с 1 января 2026

С 1 января 2026 года бельгийские плательщики НДС выставляют друг другу только структурированные электронные счета — в формате Peppol BIS Billing 3.0 через сеть Peppol. Модуль закрывает часть магазина:

• для бельгийского продавца и бельгийской компании-покупателя счёт выдаётся ещё и как Peppol BIS Billing 3.0 (UBL): номер предприятия (KBO / BCE, 10 цифр) обеих сторон — это Peppol-адрес и идентификатор юрлица со схемой 0208. Номер берётся из поля «номер компании» или выводится из BE VAT ID;
• поле номера компании на чекауте проверяет контрольные цифры (mod 97): номер с ошибкой отклоняется у поля ещё до оформления заказа;
• ставки 21 % и 6 % — отдельными группами НДС; документ на нидерландском или французском, в зависимости от языка заказа;
• бельгийский потребитель получает обычный PDF / Factur-X, без Peppol-файла;
• Pro отправляет Peppol XML в ваш access point кнопкой на странице заказа или автоматически после выдачи счёта. Ответ записывается в реестр и историю заказа.

Передачу мы проверили на собственном тестовом HTTPS-эндпоинте, с реальным бельгийским access point — ещё нет. У каждого провайдера свой API: модуль поддерживает распространённую форму — HTTPS-адрес, принимающий UBL XML, с API-ключом в заголовке. Каждый Peppol-файл мы проверили официальными правилами OpenPeppol (PEPPOL-EN16931-UBL 3.0.21) и CEN EN 16931.

Франция: реформа электронных счетов 2026 / 2027

С 1 сентября 2026 года все французские компании должны принимать электронные счета, крупные и средние (ETI) — ещё и выставлять их. Малые и микропредприятия выставляют с 1 сентября 2027 года. Счета между компаниями проходят через платформу, одобренную налоговой (plateforme agréée), а продажи потребителям подаются как e-reporting. Модуль готовит Factur-X с данными реформы — файл загружается в вашу платформу:

• SIREN продавца и компании-покупателя (схема 0002), SIRET — как идентификатор (0009), электронные адреса со схемой 0225;
• категория операции (BT-23): товары, услуги или смешанная, отдельно — уже оплаченные счета; отметка B2B / B2C;
• опция «НДС по дебетам» для услуг: код BT-8 = 5 и обязательное примечание на каждом счёте;
• обязательные примечания PMD (пени за просрочку), PMT (фиксированная компенсация 40 €) и AAB (скидка за досрочную оплату) — с готовыми текстами, которые можно изменить;
• поле SIREN / SIRET на чекауте: номер неправильной длины отклоняется у поля. B2B или B2C модуль определяет по SIREN покупателя — из этого поля или из французского VAT ID;
• проверка перед выдачей по французским правилам BR-FR — показывает, чего не хватает; выдачу блокирует только валюта (пункт ниже);
• французский счёт выдаётся только в евро. Для счёта в другой валюте правило BR-FR-CO-12 требует ещё и сумму НДС в евро — по последнему курсу Banque de France (от курса ЕЦБ), известному на день возникновения налога (CGI, ст. 266-1 bis). Курс OpenCart другой (ручной или на момент заказа), поэтому честную сумму из него не получить. Поэтому заказ французского продавца не в евро модуль в счёт не превращает: причина видна на странице заказа, при автовыдаче — в истории заказа, номер не расходуется. Главный экран модуля предупреждает, если в магазине включены другие валюты; кредит-ноты к уже выданным счетам работают как обычно;
• Pro: CSV для e-reporting продаж потребителям — суммы по дням, валюте, виду операции и ставке НДС, чтобы внести их в платформу. Официальный поток e-reporting формирует сама платформа.

Каждый французский счёт мы проверили официальными правилами Factur-X / EN 16931 (Mustang, veraPDF) и французской схематроной BR-FR (FNFE-MPE, версия 1.4.0.04). Прямого подключения к конкретной платформе в модуле нет.

Pro: автоматизация, кредит-ноты, кабинет покупателя и ZIP для бухгалтера

• Автовыдача, когда заказ получает выбранные статусы, с письмом покупателю.
• Кредит-ноты (тип 381): полная, когда заказ становится Refunded / Reversed, и частичная на любую сумму со страницы заказа — с разбивкой по ставкам НДС счёта и ссылкой на счёт; сумму больше счёта модуль отклоняет.
• Счета в кабинете покупателя с ключевыми ссылками.
• Передача в словацкую службу доставки счетов кнопкой или автоматически.
• Передача бельгийских счетов в ваш Peppol access point кнопкой или автоматически.
• CSV для e-reporting во Франции — продажи потребителям по дням, валюте, виду операции и ставке НДС.
• Проверка VIES номера VAT ID на чекауте, ответы хранятся сутки.
• Ваш логотип на PDF и ZIP для бухгалтера за период: PDF, XML и CSV-список.

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

1. Внесите данные продавца (название, адрес, VAT ID, налоговый или регистрационный номер, контакт) и платёжные данные (IBAN, BIC, дней до оплаты).
2. Создайте поля покупателя — по кнопке на каждое: VAT ID, референс / Leitweg-ID, IČO, DIČ, номер компании (SIREN / SIRET, бельгийский номер предприятия).
3. Запустите проверку на любом заказе — модуль покажет, будет ли документ валидным и что добавить.
4. Компания оформляет заказ и вводит VAT ID (госзаказчик — Leitweg-ID, словацкая фирма — IČO и DIČ).
5. Нажмите «Issue invoice» на странице заказа — или, с Pro, счёт выдаётся сам на выбранном статусе, отправляется покупателю письмом и, для словацкого B2B, передаётся в службу доставки счетов.
6. Возврат → кредит-нота; в конце месяца — ZIP для бухгалтера.

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

• Стандарты: EN 16931 (urn:cen.eu:en16931:2017), профиль EN 16931 ZUGFeRD / Factur-X с XMP-метаданными и вложенным XML, XRechnung 3.0 в CII и UBL, Peppol BIS Billing 3.0 (CustomizationID urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0).
• PDF/A-3b с профилем sRGB и встроенными шрифтами — немецкая, французская и словацкая диакритика печатаются правильно.
• Суммы по правилам EN 16931: НДС от базы группы, разница с округлением OpenCart закрывается суммой округления — к оплате ровно сумма заказа.
• Номера под блокировкой: два заказа в одну секунду никогда не получат одинаковый номер; проверка перед выдачей номер не расходует.
• Малый бизнес без VAT ID: налоговый номер пишется как идентификатор продавца (BT-29), так что правило BR-CO-26 выполняется.
• События OpenCart и собственные таблицы (cc_einvoice_document, cc_einvoice_order, cc_einvoice_kv) — без правок файлов ядра. Деинсталляция оставляет реестр (документы нужно хранить по закону); «Удалять данные при деинсталляции» убирает таблицы и поля, созданные модулем.

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

1. OpenCart 4: Расширения → Установка расширений → загрузите cc_einvoice.ocmod.zip (не переименовывайте архив) и нажмите «Установить». OpenCart 3: Расширения → Установка расширений → cc_einvoice-oc3.ocmod.zip, затем Модификации → Обновить. OpenCart 2.3: скопируйте содержимое папки upload/ из cc_einvoice-oc2.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга).
2. Расширения → Модули → E-Invoice EN 16931 → «Установить», затем «Редактировать».
3. Данные продавца и оплаты, формат номера; создайте поля покупателя.
4. Проверка на заказе, затем «Issue invoice» на тестовом заказе.
5. Для Pro: вкладка «Licence» — ключ из письма после оплаты или 7-дневный триал; затем статусы автовыдачи и, для Словакии или Бельгии, адрес и ключ службы доставки счетов или Peppol access point.
6. Обновление с 1.0.0 на OpenCart 4: OpenCart принимает новую версию только после деинсталляции старой и при деинсталляции стирает настройки модуля. Перед обновлением перепишите настройки (продавец, оплата, форматы номеров, НДС, Pro), затем: Модули → E-Invoice EN 16931 → «Удалить» → Установка расширений → удалить старый архив → загрузить новый → «Установить» → Модули → «Установить» и внесите настройки снова. Поля покупателя из 1.0.0 (VAT ID, референс, IČO, DIČ) модуль привяжет сам — новые не создавайте; один раз он покажет, что именно ввести снова, и последние номера счёта и кредит-ноты. Документы, нумерация, данные покупателей и лицензия сохраняются. Ссылки на счета в уже отправленных письмах перестанут работать, в кабинете покупателя будут новые. С 1.1.0 модуль хранит копию настроек и возвращает их сам. На OpenCart 3.x и 2.3 новый архив просто устанавливается поверх старого, настройки остаются.