E-Invoice EN 16931 для WooCommerce — ZUGFeRD, Factur-X і XRechnung із замовлень

E-Invoice EN 16931 для WooCommerce — плагін, який робить з кожного замовлення електронний рахунок за європейським стандартом EN 16931: ZUGFeRD / Factur-X (PDF/A-3, у який вбудовано XML) і XRechnung 3.0 у синтаксисах CII та UBL — формати, які читають і люди (PDF), і програми (XML). Плагін робить це всередині WooCommerce — без зовнішнього сервісу, без підписки й без передачі даних замовлень третім особам.

Чесно про перевірку. Плагін пройшов повний прогін на WordPress 7.1 і WooCommerce 11.1 (класичний і блоковий чекаут, HPOS увімкнено й вимкнено, реальна пошта): 25 з 25 XML — ACCEPTABLE в офіційному валідаторі KoSIT 1.6.3 з конфігурацією XRechnung 3.0.2, усі PDF і factur-x.xml валідні в Mustang 2.26 (EN 16931 і veraPDF PDF/A-3b), сума кожного документа дорівнює сумі замовлення. Реальні портали й програми — ZRE / OZG-RE, Peppol, DATEV, lexoffice — ми ще не перевіряли: перевірте на своєму магазині в 7-денному тріалі Pro. Податковий зміст рахунку (категорії, тексти звільнень) — налаштування продавця, а не податкова консультація.

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

• Поле ПДВ-номера (USt-IdNr.) для бізнес-клієнтів — на класичному і блоковому чекауті. Номер нормалізується («de 123 456 789» → DE123456789), а явно неправильний формат зупиняє замовлення з підказкою.
• Buyer reference / Leitweg-ID — необов’язкове поле для держзамовників; воно потрапляє в рахунок як BT-10, без якого портали XRechnung рахунок не приймають.
• Рахунок у листі (Pro): PDF із вбудованим XML приходить разом з листом WooCommerce про виконання замовлення, а для замовлень з Leitweg-ID — ще й XRechnung XML.
• Рахунки в «Мій акаунт» (Pro): покупець завантажує свої рахунки й кредит-ноти сам, без листування з магазином.

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

• Блок E-invoice у замовленні: видати рахунок, завантажити PDF, XML (CII), XRechnung CII або UBL, бачити кредит-ноти й поправити ПДВ-номер чи Leitweg-ID покупця.
• Перевірка налаштувань на реальному замовленні: плагін будує рахунок з вашими даними і каже, чого бракує до валідних ZUGFeRD і XRechnung, ще до першого справжнього рахунку. Є й зразок PDF без номера.
• Категорії ПДВ автоматично: стандартна ставка S, reverse charge K / AE для B2B-клієнта з іншої країни ЄС з USt-IdNr., експорт G, малий бізнес за §19 UStG — E; для кожної — текст причини і код VATEX. Товар може мати свою категорію вручну.
• Нумерація без пропусків за шаблоном на кшталт RE-{YYYY}-{N:5}, з обнуленням щороку й продовженням з номера попередньої програми. Номер не «з’їдається» при видаленні й перевстановленні плагіна.
• Оплата: IBAN / BIC, строк оплати, текст умов; спосіб оплати за кодом UNTDID 4461 і позначка «Customer pays after the invoice» для кожного методу оплати WooCommerce.

Pro: автовидача, кредит-ноти, кабінет і ZIP для бухгалтера

• Автоматична видача при переході замовлення в обраний статус і PDF у листах WooCommerce клієнту.
• Кредит-ноти (Gutschrift, тип 381) з повернень — рядкових і «лише сумою», окремою нумерацією (GS-…) і з посиланням на рахунок. Повернення лише сумою розкладається по групах ПДВ рахунку пропорційно — сума кредит-ноти точна.
• ZIP для бухгалтера за період: усі PDF, XRechnung і CSV-список (UTF-8 з BOM, відкривається в Excel з умлаутами).
• Перевірка USt-IdNr. у VIES на чекауті і лого магазину на PDF.

Разом з іншими модулями для Німеччини та ЄС

E-Invoice EN 16931 зроблено в парі з трьома іншими нашими модулями, і їхню спільну роботу перевірено в одному магазині:

• EU VAT Check для WooCommerce перевіряє ПДВ-номер покупця у VIES і знімає ПДВ за reverse charge — E-Invoice бере вже перевірений номер і ставить категорії K / AE. На чекауті лишається одне поле номера.
• DATEV Export для WooCommerce вивантажує проводки для податкового консультанта з номером рахунку E-Invoice у полі документа.
• Unit Price Grundpreis для WooCommerce показує ціну за 1 кг / 1 л на вітрині; рахунки з такими товарами проходять валідатори без змін у позиціях.

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

1. Заповніть реквізити продавця (назва, адреса, USt-IdNr. або Steuernummer, контакт) і платіжні дані.
2. У блоці «Check with order» оберіть будь-яке замовлення — плагін покаже, чи буде рахунок валідним, і що дописати.
3. Покупець оформлює замовлення; бізнес-клієнт вводить USt-IdNr., держзамовник — Leitweg-ID.
4. Ви натискаєте «Issue invoice» у замовленні (з Pro — рахунок видається сам при обраному статусі й іде в листі).
5. Повернення в WooCommerce → з Pro одразу кредит-нота з посиланням на рахунок.
6. Наприкінці місяця — ZIP з усіма рахунками для бухгалтера або вивантаження в DATEV Export.

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

• Стандарти: EN 16931 (urn:cen.eu:en16931:2017), ZUGFeRD 2.5 / Factur-X 1.09 з XMP-метаданими і вкладенням factur-x.xml (AFRelationship Alternative), XRechnung 3.0 (CustomizationID xrechnung_3.0) у CII та UBL.
• PDF/A-3b з профілем sRGB і вбудованими шрифтами Liberation Sans (OFL); символи поза шрифтом у PDF друкуються як «?», у XML лишаються коректними.
• Суми за правилами EN 16931: ПДВ рахується від бази групи (BR-CO-17), а різниця з округленням WooCommerce по рядках закривається RoundingAmount — до сплати завжди рівно сума замовлення.
• Доступ до файлів перевіряється: покупець завантажує лише свої документи, анонім і інший клієнт отримують 403.
• Нумерація в окремих лічильниках, які не видаляються при деінсталяції, як і мета рахунків у замовленнях — документи мають зберігатися за законом.

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть catcode-e-invoice-en-16931-for-woocommerce-1.0.0.zip і активуйте.
2. WooCommerce → E-Invoice: реквізити продавця, платіжні дані, нумерація, категорії ПДВ.
3. «Check with order» — оберіть замовлення й переконайтесь, що рахунок буде валідним.
4. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал, потім оберіть статус для автовидачі.