Валідатор KoSIT: покрокове керівництво з перевірки XRechnung та ZUGFeRD
Перш ніж завантажувати XRechnung на ZRE або відправляти ZUGFeRD-рахунок діловому партнеру, потрібно перевірити файл на відповідність EN 16931. Це запобігає дорогим відхиленням та затримкам платежів.
> Коротка відповідь: Валідатор KoSIT — офіційний Java-інструмент перевірки XRechnung. Для простішого способу використовуйте Валідатор TaxLayer: працює в браузері, без встановлення, підтримує XRechnung та ZUGFeRD.
Що таке KoSIT і навіщо потрібен валідатор?
KoSIT (Koordinierungsstelle für IT-Standards) — ІТ-координаційна рада земель Німеччини, що розробила стандарт XRechnung. Їхній валідатор — офіційний еталон перевірки для XRechnung.
Валідатор перевіряє:
- Синтаксичну відповідність (XML-схема)
- Семантичну відповідність (бізнес-правила EN 16931)
- XRechnung CIUS (Core Invoice Usage Specification)
- Коди помилок BR-DE-* (специфічні для Німеччини бізнес-правила)
Як використовувати офіційний валідатор KoSIT?
Крок 1: Встановлення Java
Валідатор KoSIT вимагає Java 11 або вище. Якщо Java не встановлена, завантажте з adoptium.net.
Крок 2: Завантаження валідатора
Завантажте актуальну версію валідатора KoSIT з GitHub. Завантажте файл validator-x.x.x-release.zip та розпакуйте його.
Крок 3: Завантаження сценаріїв перевірки
Додатково завантажте Validator Configuration (сценарії перевірки для XRechnung) з GitHub KoSIT.
Крок 4: Запуск перевірки
`bash
java -jar validationtool-x.x.x-standalone.jar \
-s scenarios.xml \
-o output/ \
your-invoice.xml
`
Крок 5: Інтерпретація результату
Валідатор створює XML- та HTML-звіт. Шукайте:
— файл пройшов перевіркуtrue — знайдені помилки, дивіться блокиfalse
Найбільш поширені повідомлення про помилки
| Код помилки | Значення | Рішення |
|---|---|---|
| BR-DE-01 | BT-10 (Leitweg-ID) порожньо | Заповніть [Leitweg-ID](/blog/leitweg-id-poyasnennya) |
| BR-DE-02 | Відсутній специфічний для DE елемент | Перевірте обов'язкові поля |
| BR-DE-26 | BT-48 (VAT ID) відсутній | Вкажіть ПДВ-номер постачальника |
| UBL-SR-01 | Недопустимий елемент UBL 2.1 | Перевірте XML-схему |
| PEPPOL-EN16931-R001 | Порушення правил EN 16931 | Перевірте [обов'язкові поля](/blog/en-16931-obovyazkovi-polya) |
Альтернатива: Валідатор TaxLayer
Якщо Ви не хочете встановлювати Java і працювати з командним рядком, Валідатор TaxLayer — практична альтернатива:
Переваги перед KoSIT:
- Працює прямо в браузері — без встановлення
- Підтримує і XRechnung, і ZUGFeRD (пряме завантаження PDF)
- Показує помилки зрозумілою мовою з BT-посиланнями
- Додатково відображає дані рахунку як перегляд
Обидва валідатори працюють локально в браузері — Ваші рахунки не завантажуються на сервер.
Як перевірити ZUGFeRD за допомогою KoSIT?
Офіційний валідатор KoSIT розроблений для XML-файлів XRechnung. Для ZUGFeRD необхідно спочатку витягти вбудований XML:
- Відкрийте ZUGFeRD PDF в Adobe Acrobat або аналогічній програмі
- Перейдіть до Інструменти → Вкладення і завантажте
factur-x.xml - Запустіть цей XML через валідатор KoSIT
Простіше: Валідатор TaxLayer приймає ZUGFeRD PDF безпосередньо і автоматично витягує та перевіряє вбудований XML.
Що робити після успішної перевірки?
Після успішної перевірки:
- Для XRechnung: Завантажте файл на ZRE або відправте через OZG-RE
- Для ZUGFeRD: Відправте файл діловому партнеру електронною поштою
TaxLayer автоматично перевіряє кожен згенерований файл за EN 16931 перед завантаженням. Вам не потрібно запускати окремий валідатор — перевірка інтегрована в робочий процес. Перші 2 конвертації на місяць безкоштовно — спробуйте зараз.
Часті запитання
Що таке валідатор KoSIT?
Валідатор KoSIT — це офіційний інструмент перевірки для XRechnung від ІТ-координаційної ради (KoSIT). Він перевіряє XML-файли на відповідність EN 16931 та XRechnung CIUS. Доступний як Java-застосунок або через онлайн-сервіси.
Чи безкоштовний валідатор KoSIT?
Так, офіційний валідатор KoSIT з відкритим вихідним кодом і безкоштовний. Потрібна Java. Альтернативно: Валідатор TaxLayer працює в браузері без встановлення та також безкоштовний.
Чи може валідатор KoSIT перевіряти ZUGFeRD?
KoSIT розроблений для XRechnung та EN 16931. Для ZUGFeRD потрібно спочатку витягти вбудований XML, потім перевірити його. Валідатор TaxLayer перевіряє як XRechnung, так і ZUGFeRD-файли безпосередньо.
Що означає помилка BR-DE-01?
BR-DE-01 означає: поле BT-10 (Buyer Reference / Leitweg-ID) порожнє або відсутнє. Це обов'язкове поле для XRechnung при рахунках державним органам. Заповніть Leitweg-ID, отриманий від замовника.
Чи потрібно мені встановлювати Java для валідатора KoSIT?
Для офіційного Java-валідатора KoSIT — так. Для Валідатора TaxLayer нічого встановлювати не потрібно — він працює повністю в браузері.
Чи перевіряє валідатор, чи буде рахунок прийнятий на ZRE?
Якщо файл проходить перевірку KoSIT без помилок, він відповідає формальним вимогам. Фактичне прийняття ZRE також залежить від правильного Leitweg-ID та наявності отримувача в системі.
Безкоштовні інструменти
Схожі статті
Конвертуйте PDF-рахунки прямо зараз
Спробуйте TaxLayer безкоштовно — 2 конвертації на місяць, кредитна картка не потрібна.
Почати