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 новий архів просто встановлюється поверх старого, налаштування лишаються.